Netcool Licensing Administration Guide 1.0b31 - e IBM Tivoli ...

frontmatter.fm July 5, 2006 

Netcool® LicensingTM 1.0b31 

Administration Guide

© 2006 Micromuse Inc., Micromuse Ltd. 

All rights reserved. No part of this work may be reproduced in any form or by any 

person without prior written permission of the copyright owner. This document is 

proprietary and confidential to Micromuse, and is subject to a confidentiality 

agreement, as well as applicable common and statutory law. 

Micromuse Disclaimer of Warranty and Statement of Limited Liability 

Micromuse provides this document "as is", without warranty of any kind, either 

express or implied, including, but not limited to, the implied warranties of 

merchantability, fitness for a particular purpose or non-infringement. This 

document may contain technical inaccuracies or typographical errors. Micromuse 

may make improvements and changes to the programs described in this document 

or this document at any time without notice. Micromuse assumes no responsibility 

for the use of the programs or this document except as expressly set forth in the 

applicable Micromuse agreement(s) and subject to terms and conditions set forth 

therein. Micromuse does not warrant that the functions contained in the programs 

will meet your requirements, or that the operation of the programs will be 

uninterrupted or error-free. Micromuse shall not be liable for any indirect, 

consequential or incidental damages arising out of the use or the ability to use the 

programs or this document. 

Micromuse specifically disclaims any express or implied warranty of fitness for high 

risk activities. 

Micromuse programs and this document are not certified for fault tolerance, and 

are not designed, manufactured or intended for use or resale as on-line control 

equipment in hazardous environments requiring fail-safe performance, such as in 

the operation of nuclear facilities, aircraft navigation or communication systems, 

air traffic control, direct life support machines, or weapons systems ("High Risk 

Activities") in which the failure of programs could lead directly to death, personal 

injury, or severe physical or environmental damage. 

Compliance with Applicable Laws; Export Control Laws 

Use of Micromuse programs and documents is governed by all applicable federal, 

state and local laws. All information therein is subject to U.S. export control laws 

and may also be subject to the laws of the country where you reside. 

All Micromuse programs and documents are commercial in nature. Use, 

duplication or disclosure by the United States Government is subject to the 

restrictions set forth in DFARS 252.227-7015 and FAR 52.227-19. 

Trademarks and Acknowledgements 

Micromuse and Netcool are registered trademarks of Micromuse. 

Other Micromuse trademarks include but are not limited to: Netcool/OMNIbus, 

Netcool/OMNIbus for Voice Networks, Netcool/Reporter, Netcool/Internet 

Service Monitors, Netcool/ISM, Netcool/ISM Global Perspective, Netcool/NT 

Service Monitors, Netcool/Wireless Service Monitors, Netcool/WSM, 

Netcool/Usage Service Monitors, Netcool/USM, Netcool/Telco Service 

Monitors, Netcool/TSM, Netcool/Fusion, Netcool/Data Center Monitors, 

Netcool DCM, Netcool/Impact, Netcool/Visionary, Netcool/Precision, Netcool 

Probes & Monitors, Netcool Desktops, Netcool Gateways, Netcool Impact/Data 

Source Adaptors, Netcool EventList, Netcool Map, Netcool Virtual Operator, 

Netcool/Precision for IP Networks, Netcool/Precision for Transmission 

Networks, Netcool/Firewall, Netcool/Wave, Netcool/Webtop, Netcool TopoViz, 

Netcool/SM Operations, Netcool/SM Configuration, Netcool/OpCenter, 

Netcool/System Service Monitors, Netcool/SSM, Netcool/Application Service 

Monitors, Netcool/ASM, Netcool/ISM WAM, Netcool/SM Reporter, Netcool 

for Asset Management, Netcool/Realtime Active Dashboards, 

Netcool/Dashboards, Netcool/RAD, Netcool for Voice over IP, Netcool for 

Security Management, Netcool Security Manager, Netcool/Portal 2.0 Premium 

Edition, Netcool ObjectServer, Netcool/RAD, Netcool GUI Foundation, 

Netcool Installer, Netcool Licensing, Netcool/Software Developers Kit, NGF, 

Micromuse Alliance Program, Micromuse Channel Partner, Authorized Netcool 

Reseller, Netcool Ready, Netcool Solutions, Netcool Certified, Netcool Certified 

Consultant, Netcool Certified Trainer, Netcool CCAI Methodology, Micromuse 

University, Microcorrelation, Acronym, Micromuse Design, Integration Module 

for Netcool, The Netcool Company, VISIONETCOOL, Network Slice. 

Micromuse acknowledges the use of I/O Concepts Inc. X-Direct 3270 terminal 

emulators and hardware components and documentation in Netcool/Fusion. 

X-Direct ©1989-1999 I/O Concepts Inc. X-Direct and Win-Direct are 

trademarks of I/O Concepts Inc. 

Netcool/Fusion contains IBM Runtime Environment for AIX®, Java 

Technology Edition Runtime Modules © Copyright IBM Corporation 1999. All 

rights reserved. 

Netcool/Precision IP includes software developed by the University of California, 

Berkeley and its contributors. 

Micromuse acknowledges the use of MySQL in Netcool/Precision for IP 

Networks. Copyright © 1995, 1996 TcX AB & Monty Program KB & Detron 

HB Stockholm SWEDEN, Helsingfors FINLAND and Uppsala SWEDEN. All 

rights reserved. 

Micromuse acknowledges the use of the UCD SNMP Library in Netcool/ISM and 

the Netcool/OMNIbus SNMP Writer Gateway. Copyright © 1989, 1991, 1992 

by Carnegie Mellon University. Derivative Work - Copyright © 1996, 1998, 

1999, 2000 The Regents of the University of California. All rights reserved. 

Permission to use, copy, modify and distribute this software and its documentation 

for any purpose and without fee is hereby granted, provided that the above 

copyright notice appears in all copies and that both that copyright notice and this 

permission notice appear in supporting documentation, and that the name of 

CMU and The Regents of the University of California not be used in advertising 

or publicity pertaining to distribution of the software without specific written 

permission. 

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA 

DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 

INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 

AND FITNESS. IN NO EVENT SHALL CMU OR THE REGENTS OF THE 

UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, 

INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 

WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR 

PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 

OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN 

CONNECTION WITH THE USE OR PERFORMANCE OF THIS 

SOFTWARE. 

Portions of the Netcool/OMNIbus code are copyright (C) 1989-95 GROUPE 

BULL. 

Permission is hereby granted, free of charge, to any person obtaining a copy of this 

software and associated documentation files (the "Software"), to deal in the 

Software without restriction, including without limitation the rights to use, copy, 

modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, 

and to permit persons to whom the Software is furnished to do so, subject to the 

following conditions: 

The above copyright notice and this permission notice shall be included in all 

copies or substantial portions of the Software. 

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF 

ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 

TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 

PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT 

SHALL GROUPE BULL BE LIABLE FOR ANY CLAIM, DAMAGES OR 

OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT 

OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 

WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 

SOFTWARE. 

Portions of the Netcool/ISM code are copyright ©2001, Cambridge Broadband 

Ltd. All rights reserved. 

Portions of the Netcool/ISM code are copyright © 2001, Networks Associates 

Technology, Inc. All rights reserved. 

Micromuse acknowledges the use of Viador Inc. software and documentation for 

Netcool/Reporter. Viador © 1997-1999 is a trademark of Viador Inc.

Micromuse acknowledges the use of software developed by the Apache Group for 

use in the Apache HTTP server project. Copyright © 1995-1999 The Apache 

Group. Apache Server is a trademark of the Apache Software Foundation 

(http://www.apache.org/). All rights reserved. 

Micromuse acknowledges the use of software developed by Edge Technologies, 

Inc. 2003 Edge Technologies, Inc. and Edge enPortal are trademarks or registered 

trademarks of Edge Technologies Inc. All rights reserved. 

Micromuse acknowledges the use of Merant drivers. Copyright © MERANT 

Solutions Inc., 1991-1998. 

The following product names are trademarks of Tivoli Systems or IBM 

Corporation: AIX, IBM, OS/2, RISC System/6000, Tivoli Management 

Environment, and TME10. 

IBM, NetView/6000, Domino, Lotus, Lotus Notes, and WebSphere are either 

trademarks or registered trademarks of IBM Corporation. VTAM is a trademark 

of IBM Corporation. 

Omegamon is a trademark of Candle Corporation. 

Netspy is a trademark of Computer Associates International Inc. 

The Sun logo, Sun Microsystems, SunOS, Solaris, SunNet Manager, Java are 

trademarks of Sun Microsystems Inc. 

SPARC is a registered trademark of SPARC International Inc. Programs bearing 

the SPARC trademark are based on an architecture developed by Sun 

Microsystems Inc. SPARCstation is a trademark of SPARC International Inc., 

licensed exclusively to Sun Microsystems Inc. 

UNIX is a registered trademark of the X/Open Company Ltd. 

Sybase is a registered trademark of Sybase Inc. Adaptive Server is a trademark of 

Sybase Inc. 

Action Request System and Remedy are registered trademarks of Remedy 

Corporation. 

Peregrine System and ServiceCenter are registered trademarks of Peregrine Systems 

Inc. 

HP, HP-UX and OpenView are trademarks of Hewlett-Packard Company. 

InstallShield is a registered trademark of InstallShield Software Corporation. 

Microsoft, Windows 95/98/Me/NT/2000/XP are either registered trademarks or 

trademarks of Microsoft Corporation. 

Microsoft Internet Information Server/Services (IIS), Microsoft Exchange Server, 

Microsoft SQL Server, Microsoft perfmon, Windows Media, and Microsoft 

Cluster Service are either registered trademarks or trademarks of Microsoft 

Corporation in the United States and/or other countries. 

BEA and WebLogic are registered trademarks of BEA Systems Inc. 

FireWall-1 is a registered trademark of Check Point Software Technologies Ltd. 

Netscape and Netscape Navigator are registered trademarks of Netscape 

Communications Corporation in the United States and other countries. 

Netscape's logos and Netscape product and service names are also trademarks of 

Netscape Communications Corporation, which may be registered in other 

countries. 

Micromuse acknowledges the use of Xpm tool kit components. 

SentinelLM is a trademark of Rainbow Technologies Inc. 

GLOBEtrotter and FLEXlm are registered trademarks of Globetrotter Software 

Inc. 

Red Hat, the Red Hat "Shadow Man" logo, RPM, Maximum RPM, the RPM 

logo, Linux Library, PowerTools, Linux Undercover, RHmember, RHmember 

More, Rough Cuts, Rawhide and all Red Hat-based trademarks and logos are 

trademarks or registered trademarks of Red Hat Inc. in the United States and other 

countries. 

Linux is a registered trademark of Linus Torvalds. 

SUSE is a trademark of SUSE LINUX Products GmbH, a Novell business. 

Macromedia and Flash are trademarks or registered trademarks of Macromedia, 

Inc. in the United States and/or other countries. 

Nokia is a registered trademark of Nokia Corporation. 

WAP Forum and all trademarks, service marks and logos based on these 

designations (Trademarks) are marks of Wireless Application Protocol Forum Ltd. 

Micromuse acknowledges the use of InstallAnywhere software in Netcool/WAP 

Service Monitors. Copyright © Zero G Software Inc. 

Orbix is a registered trademark of IONA Technologies PLC. Orbix 2000 is a 

trademark of IONA Technologies PLC. 

NetCharts is a registered trademark of Visual Mining, Inc. and/or its affiliates. 

Micromuse acknowledges the use of Graph Layout Toolkit in Netcool/ Precision 

for IP Networks. Copyright © 1992 - 2001, Tom Sawyer Software, Berkeley, 

California. All rights reserved. 

Portions of Netcool/Precision for IP Networks are © TIBCO Software, Inc. 

1994-2003. All rights reserved. TIB and TIB/Rendezvous are trademarks of 

TIBCO Software, Inc. 

Portions of Netcool/Precision for IP Networks & Netcool/OMNIbus probes and 

monitors are copyright © 1996-2005, Daniel Stenberg, . All 

rights reserved. Permission to use, copy, modify, and distribute this software for 

any purpose with or without fee is hereby granted, provided that the above 

copyright notice and this permission notice appear in all copies. 

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF 

ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED 

TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 

PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY 

RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 

HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 

OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH 

THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 

SOFTWARE. 

Except as contained in this notice, the name of a copyright holder shall not be used 

in advertising or otherwise to promote the sale, use or other dealings in this 

Software without prior written authorization of the copyright holder. 

Portions of Netcool/SM Reporter are copyrighted by DataDirect Technologies 

Corp., 1991-2005. 

Portions of Netcool/SM Reporter are copyright (c) 1990-1999 Sleepycat Software. 

All rights reserved. 

Redistribution and use in source and binary forms, with or without modification, 

are permitted provided that the following conditions are met: 

1. Redistributions of source code must retain the above copyright notice, this list 

of conditions and the following disclaimer. 

2. Redistributions in binary form must reproduce the above copyright notice, this 

list of conditions and the following disclaimer in the documentation and/or other 

materials provided with the distribution. 

3. Redistributions in any form must be accompanied by information on how to 

obtain complete source code for the DB software and any accompanying software 

that uses the DB software. The source code must either be included in the 

distribution or be available for no more than the cost of distribution plus a nominal 

fee, and must be freely redistributable under reasonable conditions. For an 

executable file, complete source code means the source code for all modules it 

contains. It does not include source code for modules or files that typically 

accompany the major components of the operating system on which the executable 

file runs. 

THIS SOFTWARE IS PROVIDED BY SLEEPYCAT SOFTWARE `ÀS IS'' 

AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT 

NOT LIMITED TO, THE IMPLIED WARRANTIES OF 

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR 

NON-INFRINGEMENT, ARE DISCLAIMED. IN NO EVENT SHALL 

SLEEPYCAT SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, 

INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 

DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT 

OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR

PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 

ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 

LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 

ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 

IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 

Sleepycat software is available from 

http://downloads.sleepycat.com/db-3.0.55.zip. 

Portions of Netcool/SM Reporter are copyright (c) 1990, 1993, 1994, 1995. The 

Regents of the University of California. All rights reserved. 








3. Neither the name of the University nor the names of its contributors may be 

used to endorse or promote products derived from this software without specific 

prior written permission. 

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND 

CONTRIBUTORS `ÀS IS'' AND* ANY EXPRESS OR IMPLIED 

WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 

PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 

REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 

INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 

CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 

PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 

USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 

CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 

CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 

NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 

USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 

SUCH DAMAGE. 

Portions of Netcool/SM Reporter are copyright (c) 1995, 1996. The President and 

Fellows of Harvard University. All rights reserved. 








3. Neither the name of the University nor the names of its contributors may be 

used to endorse or promote products derived from this software without specific 

prior written permission. 

THIS SOFTWARE IS PROVIDED BY HARVARD AND ITS 

CONTRIBUTORS `ÀS IS'' AND ANY EXPRESS OR IMPLIED 



PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 

HARVARD OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 

INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 








SUCH DAMAGE. 

Copyright 2006 Micromuse. Portions of Netcool/WSM are licensed under the 

Apache License, Version 2.0 (the "License"); you may not use this file except in 

compliance with the License. You may obtain a copy of the License at 

http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law 

or agreed to in writing, software distributed under the License is distributed on an 

"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 

KIND, either express or implied. See the License for the specific language 

governing permissions and limitations under the License. 

Micromuse acknowledges the use of Digital X11 in Netcool/Precision for IP 

Networks. Copyright 1987, 1988 by Digital Equipment Corporation, Maynard, 

Massachusetts, All Rights Reserved. DIGITAL DISCLAIMS ALL 

WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL 

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN 

NO EVENT SHALL DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT 

OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER 

RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN 

AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS 

ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 

PERFORMANCE OF THIS SOFTWARE. 

Micromuse acknowledges the use of functionality within the Netcool/OMNIbus 

Probe for Ping that was developed by Stanford University. 

Netcool/SM Operations, Netcool/SM Configuration, and Netcool/OMNIbus 

probes and monitors include software developed by the OpenSSL Project for use 

in the OpenSSL Toolkit (http://www.openssl.org/. Copyright (c) 1998-2005 The 

OpenSSL Project. All rights reserved. Redistribution and use in source and binary 

forms, with or without modification, are permitted provided that the following 

conditions are met: 






3. All advertising materials mentioning features or use of this software must display 

the following acknowledgment:"This product includes software developed by the 

OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)" 

4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to 

endorse or promote products derived from this software without prior written 

permission. For written permission, please contact openssl-core@openssl.org. 

5. Products derived from this software may not be called "OpenSSL" nor may 

"OpenSSL" appear in their names without prior written permission of the 

OpenSSL Project. 

6. Redistributions of any form whatsoever must retain the following 

acknowledgment: "This product includes software developed by the OpenSSL 

Project for use in the OpenSSL Toolkit (http://www.openssl.org/)" 

THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT `ÀS IS'' 

AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT 


MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 

ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR 

ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 

INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 

DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT 

OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 

PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 

ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 

LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 

ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 

IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 

This product includes cryptographic software written by Eric Young 

(eay@cryptsoft.com). This product includes software written by Tim Hudson 

(tjh@cryptsoft.com). 

Original SSLeay License Copyright (C) 1995-1998 Eric Young 

(eay@cryptsoft.com). All rights reserved.

This package is an SSL implementation written by Eric Young 

(eay@cryptsoft.com). The implementation was written so as to conform with 

Netscapes SSL. This library is free for commercial and non-commercial use as long 

as the following conditions are adhered to. The following conditions apply to all 

code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not 

just the SSL code. The SSL documentation included with this distribution is 

covered by the same copyright terms except that the holder is Tim Hudson 

(tjh@cryptsoft.com). Copyright remains Eric Young's, and as such any Copyright 

notices in the code are not to be removed. If this package is used in a product, Eric 

Young should be given attribution as the author of the parts of the library used. 

This can be in the form of a textual message at program startup or in 

documentation (online or textual) provided with the package. Redistribution and 

use in source and binary forms, with or without modification, are permitted 

provided that the following conditions are met: 

1. Redistributions of source code must retain the copyright notice, this list of 

conditions and the following disclaimer. 




3. All advertising materials mentioning features or use of this software must display 

the following acknowledgement: "This product includes cryptographic software 

written by Eric Young (eay@cryptsoft.com)". 

4. If you include any Windows specific code (or a derivative thereof) from the apps 

directory (application code) you must include an acknowledgement: "This 

product includes software written by Tim Hudson (tjh@cryptsoft.com)" 

THIS SOFTWARE IS PROVIDED BY ERIC YOUNG `ÀS IS'' AND ANY 

EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 

LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 

AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN 

NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 

FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 

OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 

TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 

OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 

HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 

WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 

OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 

POSSIBILITY OF SUCH DAMAGE. 

The licence and distribution terms for any publically available version or derivative 

of this code cannot be changed, i.e. this code cannot simply be copied and put 

under another distribution licence [including the GNU Public Licence.] 

Micromuse acknowledges the use of software developed by ObjectPlanet. ©2003 

ObjectPlanet, Inc., Ovre Slottsgate, 0157 Oslo, Norway. 

Micromuse acknowledges the use of Expat in Netcool/ASM. Copyright 1998, 

1999, 2000 Thai Open Source Software Center Ltd. and Clark Cooper. Copyright 

2001, 2002 Expat maintainers. THE EXPAT SOFTWARE IS PROVIDED 

HEREUNDER "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 

OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 

OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR 

COPYRIGHT HOLDERS OF THE EXPAT SOFTWARE BE LIABLE FOR 

ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 

ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 

OUT OF OR IN CONNECTION WITH THE EXPAT SOFTWARE OR 

THE USE OR OTHER DEALINGS IN THE SOFTWARE. Expat explicitly 

grants its permission to any person obtaining a copy of any Expat software and 

associated documentation files (the "Expat Software") to deal in the Expat 

Software without restriction, including without limitation the rights to use, copy, 

modify, merge, publish, distribute, sublicense, and/or sell copies of the Expat 

Software. Expat's permission is subject to the following conditions: The above 

copyright notice and this permission notice shall be included in all copies or 

substantial portions of the Expat Software. Except as set forth hereunder, all 

software provided by Micromuse hereunder is subject to the applicable license 

agreement. 

Micromuse acknowledges that Netcool Security Manager includes Hypersonic 

SQL. Copyright (c) 2001-2002, The HSQL Development Group. All rights 

reserved. 

JABBER® is a registered trademark and its use is granted under a sublicense from 

the Jabber Software Foundation. 

Micromuse acknowledges the use of MySQL in Netcool/Precision for IP 

Networks and in Netcool/Precision for Transmission Networks. Copyright © 

1995, 1996 TcX AB & Monty Program KB & Detron. 

Micromuse acknowledges the use of Cryptix in Netcool/Precision IP. Copyright 

(c) 1995-2004 The Cryptix Foundation Limited. All rights reserved. 



1. Redistributions of source code must retain the copyright notice, this list of 





THIS SOFTWARE IS PROVIDED BY THE CRYPTIX FOUNDATION 

LIMITED AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR 

IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 


CRYPTIX FOUNDATION LIMITED OR CONTRIBUTORS BE LIABLE 

FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 

OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 

TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 

OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 

HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 

WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 




Micromuse acknowledges the use of PCRE in Netcool/Precision. Copyright 

©1997-2005 University of Cambridge. All rights reserved. Redistribution and use 

in source and binary forms, with or without modification, are permitted provided 

that the following conditions are met: 






3. Neither the name of the University of Cambridge nor the name of Google Inc. 

nor the names of their contributors may be used to endorse or promote products 

derived from this software without specific prior written permission. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 

CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED 




COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY 

DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 







USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 


Micromuse acknowledges the use of Net-SNMP in Netcool/ISM and

Netcool/OMNIbus probes & monitors. 

Part 1: CMU/UCD copyright notice: (BSD like) Copyright 1989, 1991, 1992 by 

Carnegie Mellon University Derivative Work - 1996, 1998-2000. Copyright 

1996, 1998-2000 The Regents of the University of California. All Rights 

Reserved. Permission to use, copy, modify and distribute this software and its 

documentation for any purpose and without fee is hereby granted, provided that 

the above copyright notice appears in all copies and that both that copyright notice 

and this permission notice appear in supporting documentation, and that the 

name of CMU and The Regents of the University of California not be used in 

advertising or publicity pertaining to distribution of the software without specific 

written permission. 

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA 

DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 

INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 

AND FITNESS. IN NO EVENT SHALL CMU OR THE REGENTS OF THE 

UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, 

INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 

WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR 

PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 

OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN 

CONNECTION WITH THE USE OR PERFORMANCE OF THIS 

SOFTWARE. 

Part 2: Networks Associates Technology, Inc copyright notice (BSD) Copyright 

(c) 2001-2003, Networks Associates Technology, Inc. All rights reserved. 



- Redistributions of source code must retain the above copyright notice, this list of 


- Redistributions in binary form must reproduce the above copyright notice, this 



- Neither the name of the Networks Associates Technology, Inc nor the names of 

its contributors may be used to endorse or promote products derived from this 

software without specific prior written permission. 






COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY 









SUCH DAMAGE. 

Part 3: Cambridge Broadband Ltd. copyright notice (BSD) Portions of this code 

are copyright (c) 2001-2003, Cambridge Broadband Ltd. All rights reserved. 








- The name of Cambridge Broadband Ltd. may not be used to endorse or promote 

products derived from this software without specific prior written permission. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER "AS IS" 

AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT 


MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 

ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER 

BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 

EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 

NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 

SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 

LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 




Part 4: Sun Microsystems, Inc. copyright notice (BSD) Copyright © 2003 Sun 

Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, USA. 

All rights reserved. Use is subject to license terms below. This distribution may 

include materials developed by third parties. Sun, Sun Microsystems, the Sun logo 

and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in 

the U.S. and other countries. Redistribution and use in source and binary forms, 

with or without modification, are permitted provided that the following 

conditions are met: 






- Neither the name of the Sun Microsystems, Inc. nor the names of its contributors 

may be used to endorse or promote products derived from this software without 

specific prior written permission. 














USE OF THIS SOFTWARE, EVEN IF DVISED OF THE POSSIBILITY OF 

SUCH DAMAGE. 

Part 5: Sparta, Inc copyright notice (BSD) Copyright (c) 2003-2004, Sparta, Inc. 

All rights reserved. Redistribution and use in source and binary forms, with or 

without modification, are permitted provided that the following conditions are 

met: 






- Neither the name of Sparta, Inc nor the names of its contributors may be used 

to endorse or promote products derived from this software without specific prior 

written permission. 








CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,







SUCH DAMAGE. 

Part 6: Cisco/BUPTNIC copyright notice (BSD) Copyright (c) 2004, Cisco, Inc 

and Information Network, Center of Beijing University of Posts and 

Telecommunications. All rights reserved. Redistribution and use in source and 

binary forms, with or without modification, are permitted provided that the 

following conditions are met: 






- Neither the name of Cisco, Inc, Beijing University of Posts and 

Telecommunications, nor the names of their contributors may be used to endorse 

or promote products derived from this software without specific prior written 

permission. 















SUCH DAMAGE. 

Micromuse acknowledges the use of STLport in Netcool Probes & Monitors. 

Copyright 1999, 2000 Boris Fomitchev This material is provided "as is", with 

absolutely no warranty expressed or implied. Any use is at your own risk. 

Permission to use or copy this software for any purpose is hereby granted without 

fee, provided the above notices are retained on all copies. Permission to modify the 

code and to distribute modified code is granted, provided the above notices are 

retained, and a notice that the code was modified is included with the above 

copyright notice. 

The Licensee may distribute binaries compiled with STLport (whether original or 

modified) without any royalties or restrictions. 

The Licensee may distribute original or modified STLport sources, provided that: 

The conditions indicated in the above permission notice are met; 

The following copyright notices are retained when present, and conditions 

provided in accompanying permission notices are met: 

Copyright 1994 Hewlett-Packard Company, 

Copyright 1996, 97 Silicon Graphics Computer Systems, Inc. 

Copyright 1997 Moscow Center for SPARC Technology. 

Permission to use, copy, modify, distribute and sell this software and its 

documentation for any purpose is hereby granted without fee, provided that the 

above copyright notice appear in all copies and that both that copyright notice and 

this permission notice appear in supporting documentation. Hewlett-Packard 

Company makes no representations about the suitability of this software for any 

purpose. It is provided "as is" without express or implied warranty. 




this permission notice appear in supporting documentation. Silicon Graphics 

makes no representations about the suitability of this software for any purpose. It 

is provided "as is" without express or implied warranty. 




this permission notice appear in supporting documentation. Moscow Center for 

SPARC Technology makes no representations about the suitability of this 

software for any purpose. It is provided "as is" without express or implied warranty. 

All other trademarks, registered trademarks and logos are the property of their 

respective owners. 

Micromuse Inc., 650 Townsend Street, San Francisco, USA CA 94103 

www.micromuse.com 

Document Version Number: 1.1

Contents 

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 

Audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 

About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 

Associated Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

Typographical Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 

Note, Tip, and Warning Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

Syntax and Example Subheadings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

Operating System Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 

Chapter 1: Overview of Netcool Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 

Contents 

Introduction to Netcool Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 

Licensing Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

Single License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

Redundant License Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 

Supported Platforms and Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

Platform Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

Hardware Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

FLEXlm Licensing Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 

Redundancy Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 

License Server Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

License Server Daemons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

License Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 

Command Line Tools (UNIX Platforms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

LMTOOLS (Windows Platforms). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 

Netcool Licensing 1.0b31 Administration Guide i

Contents 

ii 

Licensing Installation Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 

Overview of the Netcool Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 

Netcool Licensing Installation Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 

Installation and Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 

Chapter 2: UNIX Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 

Installing Netcool Licensing on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

Downloading Netcool Licensing from the IBM Download Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 

Running the Installation Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 

Installing a License File on the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 

Viewing the Installation Log and Installed Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 

Upgrading Netcool Licensing on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 

Managing the License Server on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 

Starting the License Server using nc_start_license. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 

Determining License Usage using nc_print_license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 

Adding New Licenses to the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 

Refreshing the License Server using nc_read_license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 

Using a License Server with your Netcool Product Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 

Stopping the License Server using nc_stop_license. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 

Uninstalling Netcool Licensing on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 

Uninstalling Netcool Licensing 1.0b21 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 

Uninstalling Netcool Licensing 1.0b31 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 

Chapter 3: Windows Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 39 

Installing Netcool Licensing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

Downloading Netcool Licensing from the IBM Download Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

Running the Installation Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

Installing a License File on the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 

Viewing the Installation Log and Installed Packages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 

Upgrading Netcool Licensing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 

Netcool Licensing 1.0b31 Administration Guide

Contents 

Managing the License Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 

LMTOOLS Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 

Starting the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 

Displaying the License Server Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 

Adding New Licenses to the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 

Refreshing the License Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 

Using a License Server with your Netcool Product Installations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 

Stopping the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 

Uninstalling Netcool Licensing on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 

Uninstalling Netcool Licensing 1.0b21 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 

Uninstalling Netcool Licensing 1.0b31 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 

Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 

Netcool Licensing 1.0b31 Administration Guide iii

Contents 

iv 


preface.fm July 5, 2006 

Preface 

This guide describes how to install and administer Netcool Licensing. The chapters within this guide 

provide an overview of the generic Netcool licensing component and provide task-oriented steps to assist 

administrators in installing, upgrading, configuring, and uninstalling licensing. 

This preface contains the following sections: 

• Audience on page 2 

About this Guide on page 3 

Associated Publications on page 4 

Typographical Notation on page 5 

Operating System Considerations on page 8 

Netcool Licensing 1.0b31 Administration Guide 1

Preface 

Audience 

2 

This guide is intended for Netcool administrators who are responsible for installing Netcool Licensing onto 

license servers and configuring such servers for dispensing licenses to Netcool clients. 

Netcool Licensing is part of the Netcool suite, and works in conjunction with Netcool products. It is 

assumed that you are familiar with the licensing requirements of your Netcool product. For more 

information, refer to the publications described in Associated Publications on page 4 and any other relevant 

product-specific documentation. 


About this Guide 

This book is organized as follows: 

Netcool Licensing 1.0b31 Administration Guide 

About this Guide 

Chapter 1: Overview of Netcool Licensing on page 9 provides an introduction to the Netcool Licensing 

components and installation requirements. 

Chapter 2: UNIX Installation and Configuration on page 23 describes the procedures for installing, 

upgrading, configuring, and uninstalling Netcool Licensing on UNIX platforms. 

Chapter 3: Windows Installation and Configuration on page 39 describes the procedures for installing, 

upgrading, configuring, and uninstalling Netcool Licensing on Windows platforms. 

3

Preface 

Associated Publications 

4 

Netcool Licensing is generic to products in the Netcool suite. To efficiently administer Netcool Licensing 

on a designated license server, you must understand the concepts of license dispensation using license servers, 

and be familiar with FLEXlm license management. For further information on FLEXlm, visit the 

Macrovision Corporation web site at: 

http://www.macrovision.com 

You must also understand the installation and licensing requirements of your Netcool products. To 

familiarize yourself with these requirements, refer to the Netcool guides that contain installation, 

deployment and license-specific information for your Netcool products. 


Typographical Notation 



Table 1 shows the typographical notation and conventions used to describe commands, SQL syntax, and 

graphical user interface (GUI) features. This notation is used throughout this book and other Netcool ® 

publications. 

Table 1: Typographical Notation and Conventions (1 of 2) 

Example Description 

Monospace The following are described in a monospace font: 

Commands and command line options 

Screen representations 

Source code 

Object names 

Program names 

SQL syntax elements 

File, path, and directory names 

Italicized monospace text indicates a variable that the user must populate. For example, -password 

password. 

Bold The following application characteristics are described in a bold font style: 

Buttons 

Note: Text in the pop-up tooltips is used to name buttons with icons. These button names are 

described in plain text. 

Frames 

Text fields 

Menu entries 

A bold arrow symbol indicates a menu entry selection. For example, File→Save. 

Italic The following are described in an italic font style: 

An application window name; for example, the Login window 

Information that the user must enter 

The introduction of a new term or definition 

Emphasized text 

References to external documents 

[1] Code or command examples are occasionally prefixed with a line number in square brackets. For 

example: 

[1] First command... 

[2] Second command... 

[3] Third command... 

5

Preface 

6 

Table 1: Typographical Notation and Conventions (2 of 2) 

Example Description 

{ a | b } In SQL syntax notation, curly brackets enclose two or more required alternative choices, separated by 

vertical bars. 

[ ] In SQL syntax notation, square brackets indicate an optional element or clause. Multiple elements or 

clauses are separated by vertical bars. 

| In SQL syntax notation, vertical bars separate two or more alternative syntax elements. 

... In SQL syntax notation, ellipses indicate that the preceding element can be repeated. The repetition is 

unlimited unless otherwise indicated. 

,... In SQL syntax notation, ellipses preceded by a comma indicate that the preceding element can be 

repeated, with each repeated element separated from the last by a comma. The repetition is unlimited 

unless otherwise indicated. 

a In SQL syntax notation, an underlined element indicates a default option. 

( ) In SQL syntax notation, parentheses appearing within the statement syntax are part of the syntax and 

should be typed as shown unless otherwise indicated. 

Many Netcool commands have one or more command line options that can be specified following a hyphen 

(-). 

Command line options can be string, integer, or BOOLEAN types: 

A string can contain alphanumeric characters. If the string has spaces in it, enclose it in quotation 

(") marks. 

An integer must contain a positive whole number or zero (0). 

A BOOLEAN must be set to TRUE or FALSE. 

SQL keywords are not case-sensitive, and may appear in uppercase, lowercase, or mixed case. Names of 

ObjectServer objects and identifiers are case-sensitive. 

Note, Tip, and Warning Information 

The following types of information boxes are used in the documentation: 

Note: Note is used for extra information about the feature or operation that is being described. Essentially, 

this is for extra data that is important but not vital to the user. 


! 



Tip: Tip is used for additional information that might be useful for the user. For example, when describing 

an installation process, there might be a shortcut that could be used instead of following the standard 

installation instructions. 

Warning: Warning is used for highlighting vital instructions, cautions, or critical information. Pay close 

attention to warnings, as they contain information that is vital to the successful use of our products. 

Syntax and Example Subheadings 

The following types of constrained subheading are used in the documentation: 

Syntax 

Syntax subheadings contain examples of ObjectServer SQL syntax commands and their usage. For example: 

CREATE DATABASE database_name; 

Example 

Example subheadings describe typical or generic scenarios, or samples of code. For example: 

[1] 

[2] 

[6] 

7

Preface 

Operating System Considerations 

8 

Unless otherwise specified, command files are located in the NCHOME/license/bin directory, where 

NCHOME is the environment variable that contains the path to the Netcool Suite home directory. 

On UNIX platforms, replace NCHOME with $NCHOME. UNIX is case-sensitive. You must type 

commands in the case shown in the book. 

On Microsoft Windows platforms, replace NCHOME with %NCHOME% and the forward slash (/) with 

a backward slash (\). 


Overview.fm July 5, 2006 

Chapter 1: Overview of Netcool Licensing 

This chapter provides an overview of the Netcool Licensing components and installation requirements. You 

should read this chapter to familiarize yourself with the concepts of Netcool Licensing. 

This chapter contains the following sections: 

Introduction to Netcool Licensing on page 10 

Licensing Configurations on page 11 

Supported Platforms and Requirements on page 12 

License Server Components on page 14 

Licensing Installation Details on page 18 



1.1 Introduction to Netcool Licensing 

10 

Netcool Licensing is a standalone server component that provides licensing functionality for the Netcool 

suite of products. This component is based on the premise that license administration and maintenance can 

be simplified by centralizing license data on one or more designated license servers, with licenses being drawn 

from a server as necessary. The Netcool Licensing system and accompanying tools are based upon the 

FLEXlm license manager by Macrovision Corporation. 

Before running any Netcool product, Netcool Licensing must be installed and configured on at least one 

license server in your environment. You must also ensure that you have the requisite license files containing 

license feature codes for the Netcool products and related components that you are authorized to use. A 

license server can be shared between multiple Netcool products. 

For more information on FLEXlm, see the FLEXlm User’s Guide. This guide is available from the 

Macrovision Corporation web site at: 



1.2 Licensing Configurations 

Two licensing configurations are supported for Netcool installations. They are: 

Single License Server 

Redundant License Servers 

Single License Server 


Licensing Configurations 

A single license server, accessible by all Netcool components, is the simplest method of licensing a Netcool 

installation. This configuration is recommended for smaller installations - for example, those with one 

Netcool/OMNIbus ObjectServer datasource. In this situation, the license server should be installed on the 

same machine as the ObjectServer. 

Redundant License Servers 

The redundant configuration comprises two or more license servers, each of which holds a copy of the 

available licenses. This provides greater resilience because licenses can still be dispensed if one server fails or 

becomes unavailable. 

Redundant licensing is configured on client machines using a license environment variable or license 

property setting, which lists connection details for each of the redundant license servers. Netcool clients will 

attempt to connect to each license server in the listed order, proceeding through the list until a license is 

obtained. 

For information on the requirements for a redundant configuration, see Redundancy Requirements on 

page 13. 

11


1.3 Supported Platforms and Requirements 

12 

This section provides information on the following: 

Platform Support 

Hardware Support 

Platform Support 

FLEXlm Licensing Support 

Redundancy Requirements 

The license server is supported on the following platforms: 

Sun Microsystems SPARC-based platforms: 

– Solaris 8, 9, and 10 

Intel x86 processor and chipset-based platforms: 

– Red Hat Enterprise Linux Advanced Server 2.1, 3.0, and 4.0 

– Microsoft Windows 2000, 2003, and XP 

IBM PowerPC-based platforms: 

– AIX 5.1, 5.2, and 5.3 

Hewlett-Packard PA-RISC-based platforms: 

– HP-UX 11 and 11.11 

Note: Micromuse recommends that your operating system has all the recommended patches, including the 

latest patch levels, installed. 

Hardware Support 

Hardware requirements for the license server vary depending on your environment and license usage. For 

recommendations on hardware sizing for the license server, contact your Micromuse account manager or 

Micromuse Technical Support. 


FLEXlm Licensing Support 

! 


Supported Platforms and Requirements 

The version of FLEXlm supplied with Netcool Licensing on UNIX and Windows platforms is version 9.2. 

Warning: You must always check that the FLEXlm version of the Netcool license server that you are 

running is the same as the version shipped with your Netcool product(s). Using earlier versions of the license 

server may operate correctly, but will not be supported. 

Redundancy Requirements 

If using redundant license servers, you must choose stable server machines that are not rebooted or taken 

offline frequently. Any number of multiple servers can be used, and the license server machines can be in 

different physical locations. 

13


1.4 License Server Components 

14 

The license server has the following components: 

License Server Daemons 

License Files 

Command Line Tools (UNIX Platforms) 

LMTOOLS (Windows Platforms) 

License Server Daemons 

License Files 

The license server has two daemons that provide the licensing functionality for the server: the license 

manager daemon and the vendor daemon. The license manager daemon handles initial contact with client 

applications, starts the vendor daemon, and passes requests to check in and check out licenses to the vendor 

daemon. The vendor daemon is responsible for the core operations of the license server, such as license 

allocation. 

On UNIX platforms, the license manager daemon is called lmgrd, and the vendor daemon is called 

netcool. 

On Windows platforms, the license manager daemon runs as a service called lmgrd.exe. The vendor 

daemon is called netcool.exe. 

The product license files are text files that contain Netcool licenses for the product components or features. 

The license server supports an unlimited number of license files, and recognizes any file with a name that 

ends in .lic as a license file. 

By default, license files are located in the $NCHOME/license/etc directory on UNIX, or the 

%NCHOME%\license\etc directory on Windows. When the license server is started, it reads all license 

files in this directory and then waits for incoming license requests. 

License files contain the following main elements: 

SERVER line 

VENDOR line 

FEATURE lines 

The sections that follow show a license file example and describe its elements. 


Example License File 

An example license file for a single-server configuration is shown below: 

SERVER nclicense01 anyhost 27500 

VENDOR netcool 

USE_SERVER 

FEATURE nco_nco netcool 20030430 permanent 9999 ck=174 \ 

SIGN=E440F1A01536 

FEATURE nco_auto netcool 20030430 permanent 9999 ck=235 \ 

SIGN=5F1317A4749E 

FEATURE nco_event netcool 20030430 permanent 9999 ck=174 \ 

SIGN=D54F2EC60530 

FEATURE nco_gate netcool 20030430 permanent 9999 ck=231 \ 

SIGN=E99A773C36D2 

FEATURE nco_objserv netcool 20030430 permanent 9999 ck=176 \ 

SIGN=FD3E0A744910 

FEATURE nco_proxyserv netcool 20030430 permanent 9999 ck=179 \ 

SIGN=5714D41A4210 

FEATURE cro_nco_confpack netcool 20040331.0 permanent 9999 SIGN="0075 \ 

8532 9B38 6661 34A6 DD9F D017 E600 C902 6AAD A949 A627 865A \ 

35F4 2F50" SIGN2="008A F333 ECA8 AD28 A1A9 4168 9845 8800 5541 \ 

3D83 A4D9 3B4B 7934 5401 6714" 

FEATURE cro_nco_config netcool 20040331.0 permanent 9999 SIGN="0045 \ 

C90E 1ABF E493 C45B BAEF 5202 0E00 FD6D A1F4 7AA2 070E 4EFC \ 

C90E 1ABF E493 C44B BAEF 5206 0E10 FD6D A1F8 7AA2 020E 4EFC \ 

E593 1D96" SIGN2="008C DAFC 0E4A AE1A C055 5667 895D 7100 AA6F \ 

7B70 7A37 4BAF B242 F4A8 630C" 

SERVER Line 


License Server Components 

The SERVER line identifies the host system where the license server is installed. The SERVER line appears 

in the license file in the following format: 

SERVER license_hostname anyhost port 

Where: 

license_hostname is the host name of the license server machine. 

anyhost is static information that represents the FLEXlm host ID of the server. Licenses are not 

node locked, so this string value applies to any host machine. 

port is the port (non-default) on which the license server listens for incoming requests. If a value is 

not specified, the default port is used. 

15


16 

VENDOR Line 

The VENDOR line specifies the vendor daemon details. The VENDOR line appears in the license file in the 

following format: 

VENDOR netcool port 

Where: 

netcool is static information defining the name of the vendor daemon. 

port is the port (non-default) used by this daemon. If a value is not specified, the default port is 

used. 

Note: The USE_SERVER line below the VENDOR line ensures performance is improved when a license 

server is used. 

FEATURE Lines 

FEATURE lines contain information about each licensed component. The license file contains one 

FEATURE line for each Netcool component or feature that you are authorized to use. FEATURE lines 

appear in the license file in the following format: 

FEATURE feature netcool feat_ver permanent 9999 ck SIGN 

Where: 

feature is the name of the component that is licensed. 

netcool is static information identifying the vendor daemon. 

feat_ver is the version of this feature that is supported by this license. This variable may be 

expressed as a date. 

permanent is static information depicting a permanent license that never expires. 

9999 is static information depicting an unlimited number of licenses for concurrent use. 

Note: Although the license file contains an unlimited number of licenses for each feature, you are 

entrusted to use no more than the maximum number of licenses purchased. You must, therefore, 

regularly monitor your license usage to ensure that you always fall within your entitlement, as described 

in Determining License Usage using nc_print_license on page 33 (UNIX) and Displaying the License 

Server Status on page 51 (Windows). 

ck and SIGN are attributes used by the license server for license validation. 


Command Line Tools (UNIX Platforms) 


License Server Components 

The license server provides a set of command line tools that allow you to manage licensing on UNIX 

platforms. You can use these tools to view the server status, view license usage, refresh licenses and perform 

other related tasks. These tools are located in the $NCHOME/license/bin directory. For more 

information on using the command line tools, see Managing the License Server on UNIX on page 33. 

LMTOOLS (Windows Platforms) 

On Windows platforms, the license server provides a program called LMTOOLS that you can use to 

manage licensing. You can use LMTOOLS to perform all of the license administration functionality 

provided by the UNIX command line tools. You can also use LMTOOLS to start and stop the license server. 

For more information on the usage of LMTOOLS, see Managing the License Server on Windows on page 49. 

17


1.5 Licensing Installation Details 

18 

Netcool Licensing must be installed on one or more network servers that can be accessed by your Netcool 

product installations. It is only necessary to install a license server and associated utilities if you do not 

already have the supported version of the FLEXlm license server running on your network. The license server 

can be installed on the same machine as your Netcool product, or on a separate machine within your 

network. If you decide to use a separate machine, you must ensure that it is accessible on the network. If 

using redundant license servers, Netcool Licensing must be installed on each of the server machines. You 

can only have one installation per machine. 

This section: 

Describes the common installation component that is used for installing Netcool products, and 

outlines the installation modes supported 

Provides details of the default locations into which Netcool Licensing is installed on the supported 

platforms, and describes the directory structure of your installation 

Identifies which installation and configuration option is relevant for your needs 

Overview of the Netcool Installer 

Netcool Licensing is installed using the Netcool Installer. The Netcool Installer provides a common 

installation interface for all Netcool products. Features and benefits of the Netcool Installer include: 

Ease of maintenance. Updated versions of the Netcool Installer are installed automatically with new 

Netcool products and patches. 

Better reuse and integration of Netcool software within a consolidated Netcool suite. The Netcool 

Installer is based around packages, or installable units, which can be shared between products. The 

Netcool Installer ensures that a given package is only installed once. A package used by one product 

can be automatically updated by another product that uses the same package. 

The ability to easily view the versions of all installed packages. For information on viewing installed 

packages, see Viewing Installed Packages on page 30 (UNIX) or Viewing Installed Packages on page 46 

(Windows). 

Consolidated installation logs. For information on viewing the installation log, see Viewing the 

Installation Log on page 29 (UNIX) or Viewing the Installation Log on page 45 (Windows). 


! 


Licensing Installation Details 

A common directory structure. For information on this common structure, see About the Netcool 

Home Location on page 19. For additional information on the directory structure for Netcool 

Licensing, see Netcool Licensing Installation Directory Structure on page 20. 

Warning: The directory structure for products using the Netcool Installer is not compatible with the 

directory structure of older Netcool products. You must install products using the Netcool Installer in 

a different directory to any existing, non-Netcool Installer products. 

Netcool Installer Modes 

The Netcool Installer supports three modes of operation: GUI, console, and silent. The different modes 

provide different degrees of user interaction. 

By default, the Netcool Installer runs in GUI mode. This mode uses a graphical user interface to present 

installation options within wizard pages that guide you through the installation process. 

The console mode of operation presents installation options within a command shell, using a set of 

text-based menus and prompts. You may need to run the Netcool Installer in console mode for remote 

installations or if the GUI mode is not currently supported on your installation platform. 

Note: On AIX and HP-UX platforms, the Netcool Installer runs in console mode by default because these 

platforms cannot run the Netcool Installer in GUI mode. 

The silent mode of operation runs without any user interaction and facilitates rapid deployment across 

multiple machines. In this mode, the Netcool Installer uses predefined installation options held in a file. 

Instructions for performing a silent installation are not included in this guide. 

Micromuse recommends running the Netcool Installer in GUI mode where possible. For detailed 

information on installing or upgrading Netcool Licensing in GUI or console mode, see Chapter 2: UNIX 

Installation and Configuration on page 23 or Chapter 3: Windows Installation and Configuration on page 39. 

Note: You must run the Netcool Installer as the same operating system user each time. Whichever user 

installs the first Netcool product on a given machine must also install, uninstall, or modify every subsequent 

Netcool product on that machine. 

About the Netcool Home Location 

The Netcool home location is the base directory where all products in the Netcool suite are installed. This 

location is determined when the first Netcool product is installed using the Netcool Installer. Subsequent 

Netcool product installations are made within this location. 

19


20 

The Netcool home location is defined by the NCHOME environment variable. On UNIX platforms, this 

defaults to /opt/netcool. On Windows platforms, the Netcool home location defaults to 

C:\Program Files\Micromuse\netcool. 

Each product or application installs its specific components and files into a dedicated product subdirectory 

in the Netcool home location. Files that are common to all products are additionally installed in a number 

of shared subdirectories within the Netcool home location. 

Netcool Licensing Installation Directory Structure 

Table 2 provides details of the default installation locations for Netcool Licensing. 

Table 2: Default Installation Locations 

Platform Default Location Notation used in This Guide 

UNIX Solaris, Linux, HP-UX, and AIX: 

/opt/netcool/license 

The installation procedure creates a number of subdirectories within the license directory of your 

NCHOME location. These subdirectories include: 

bin - This directory holds executable and system files such as: 

– The license server daemons 

– The FLEXlm utilities program (lmutil or lmutil.exe) for license administration 

– The Windows GUI interface program (lmtools.exe) for the FLEXlm utilities program 

– UNIX command line tools (nc_*) 

docs - This directory holds FLEXlm end-user documentation from Macrovision Corporation. 

etc - This directory holds the license files. 

$NCHOME/license 

Windows C:\Program Files\Micromuse\netcool\license %NCHOME%\license 

log - This directory holds the license server log file (license.log). This file contains status 

and error messages, and might be useful for troubleshooting purposes. 


Installation and Configuration Options 

To install or configure Netcool Licensing on any platform, choose the appropriate scenario: 


Licensing Installation Details 

If you are using UNIX and do not have a FLEXlm license server installed on your network and want 

to install one, see Installing Netcool Licensing on UNIX on page 24. 

If you are using UNIX and want to upgrade your FLEXlm license server installation, see Upgrading 

Netcool Licensing on UNIX on page 32. 

If you are using Windows and do not have a FLEXlm license server installed on your network and 

want to install one, see Installing Netcool Licensing on Windows on page 40. 

If you are using Windows and want to upgrade your FLEXlm license server installation, see 

Upgrading Netcool Licensing on Windows on page 47. 

Note: This document does not provide details of how to configure your FLEXlm license server to dispense 

non-Netcool licenses. Refer to the FLEXlm documentation for information on performing this task. 

Tip: To enable licensing on Netcool product installations, a number of configuration procedures will need 

to be carried out on each system. This includes setting a license server environment variable or license 

property to specify the host name of the license server and the port on which the server listens for requests. 

The relevant details are provided within each product installation or administration guide. 

21


22 


InstallationUNIX.fm July 5, 2006 

Chapter 2: UNIX Installation and 

Configuration 

This chapter describes how to install or upgrade, manage, and uninstall Netcool Licensing on a UNIX 

platform. 


Installing Netcool Licensing on UNIX on page 24 

Upgrading Netcool Licensing on UNIX on page 32 

Managing the License Server on UNIX on page 33 

Uninstalling Netcool Licensing on UNIX on page 36 


Chapter 2: UNIX Installation and Configuration 

2.1 Installing Netcool Licensing on UNIX 

24 

The steps involved in installing Netcool Licensing are: 

1. Downloading Netcool Licensing from the IBM Download Site 

2. Running the Installation Program 

3. Installing a License File on the License Server 

The sections that follow document these steps in detail. 

Downloading Netcool Licensing from the IBM Download Site 

The Netcool Licensing files are provided with each product download on the IBM site, and include the 

Netcool Licensing installer file and the product license file. 

To download the Netcool Licensing files: 

1. Go to the IBM download site. 

2. Select the relevant product hyperlink and locate the Netcool Licensing files for your UNIX platform. 

These include: 

– The Netcool Licensing 1.0b31 installation bundle - This is distributed as an archive bundle 

called NCLServer-version-arch.tar, where version is the version and build 

number of the package, and arch is the architectural platform. 

– The product license file - This is distributed as a lic file. 

Note: The product installer files are also inluded on the download page and can be downloaded 

at the same time. Instructions for downloading and installing products are described in the 

product installation guides. 

3. Download the tar and lic licensing files. 

Tip: Remember that it is only necessary to install a license server if you do not already have one 

installed. 

4. From a command prompt, change to the directory where you saved the downloaded files. 

5. Extract the contents of the tar bundle into a temporary location. 

You can now perform a new installation of Netcool Licensing, as described in Running the Installation 

Program on page 25, or upgrade your existing version, as described in Upgrading Netcool Licensing on UNIX 

on page 32. 


Running the Installation Program 

This section describes how to install Netcool Licensing using the GUI and console modes. 


Installing Netcool Licensing on UNIX 

Note: Micromuse recommends that you do not install the license server as user root. You can run the 

installer as any other user that has read, write, and execute permissions to the target directory. 

For further information on installing Netcool Licensing, see the relevant section: 

Running the Installation Program in GUI Mode on page 25 - Use this mode to present installation 

options within wizard pages in a graphical user interface. 

Running the Installation Program in Console Mode on page 26 - Use this mode if the GUI mode is not 

supported on your installation platform, or for remote installations. 

Note: If using redundant license servers, you must install Netcool Licensing on each license server machine. 

Running the Installation Program in GUI Mode 

To install Netcool Licensing in GUI mode: 

1. From a command prompt, change to the directory where you extracted the contents of the Netcool 

Licensing tar file. 

2. Run the installation program by entering the following command. An optional parameter is shown in 

square brackets. 

./INSTALL [-errorlevel ERRORLEVEL] 

Use the optional -errorlevel parameter if you want to set the level of detail in the installation 

log file for information or troubleshooting purposes. Omitting this parameter defaults the log file 

level to warning messages only. The ERRORLEVEL variable takes one of three values: 

– debug - Detailed logging for debug purposes 

– info - Warning and informational messages 

– warning - Warning messages only 

3. If the $NCHOME environment variable has not previously been set, you are prompted for the Netcool 

home location where Netcool Licensing will be installed. The default location is /opt/netcool. 

Specify an installation location and press Enter. 

4. Wait while the Netcool Installer installs itself - during this process, the screen shows a number of 

blocks being written. On completion, the Welcome page of the Netcool Installer Wizard appears. 

25


26 

5. Click Next to proceed to the Licence Agreement page. 

6. Read and accept the license conditions, and click Next to continue. 

The Netcool Home page appears, showing the installation location for the Netcool product suite, as set 

by the $NCHOME environment variable, or entered by you at the start of this installation. This value 

is read-only. 

Note: If, at this point, you prefer to choose a different installation location, you must cancel the 

current installation. You can then either modify the value of the $NCHOME environment variable if 

set, and restart the installation, or if $NCHOME is not set, simply restart the installation and specify the 

new location when prompted. 

7. Click Next to accept the specified installation directory. 

The Setup Type page appears. 

8. Accept the Default option and click Next. 

9. From the Ready to install page, review the installation settings chosen. You can additionally view the 

list of packages that will be installed by clicking the show details hyperlink. 

10. Click Install to start the installation. 

When the installation is complete, the Netcool Installer Wizard Completed page appears. 

11. Click Finish to close the wizard. Your Netcool Licensing files are stored in the location 

$NCHOME/license, typically: 

/opt/netcool/license 

You can view the installation log to verify that the process completed successfully. You can also view the list 

of installed packages. For further details, see Viewing the Installation Log and Installed Packages on page 29. 

Running the Installation Program in Console Mode 

The console mode uses a text-based user interface to present installation options using a series of menus and 

prompts. On AIX and HP-UX platforms, the Netcool Installer automatically runs in console mode because 

the GUI installation mode is not supported on these platforms. 


To install Netcool Licensing in console mode: 




Licensing tar file. 

2. Run the installation program using the following command. An optional parameter is shown in 


./INSTALL -console [-errorlevel ERRORLEVEL] 

Use the optional -errorlevel parameter to define the level of detail in the messages written to 

the Netcool Installer log. Omitting this parameter defaults the log file level to warning messages only. 

The ERRORLEVEL variable takes one of three values: 


– info - Logs warning and informational messages 

– warning - Logs warning messages only 

3. If the $NCHOME environment variable has not previously been set, you are prompted for the Netcool 

home location where Netcool Licensing will be installed. The default location is /opt/netcool. 

On AIX systems, you may prefer to use /usr/netcool as no /opt directory exists by default. 

Specify an installation location and press Enter. 

4. When the Welcome information appears, press Enter to continue. 

5. Read the Micromuse license agreement and type y to accept the terms. Then press Enter to proceed. 

The menu of installable features and installation options appears. The Server feature is the only 

installable feature and is selected by default, as denoted by the notation [I] in the Select column. 

6. To start the installation process, type i and press Enter. 

7. Do either of the following: 

– To confirm that you want to proceed with the installation, type i and press Enter. 

– To view the list of packages prior to installing, type m and press Enter. After reviewing the 

package listing, type y to confirm that you want to continue with the installation, and press 

Enter. 

Wait for the installation to complete. A message appears confirming that the installation was 

successful. 

You can view the installation log to verify that the process completed successfully. You can also view the list 

of installed packages. For further details, see Viewing the Installation Log and Installed Packages on page 29. 

27


Installing a License File on the License Server 

28 

The license server uses one or more license files to store the licenses that are required to make your Netcool 

products operational. Netcool license files are distributed as lic files and are available with the product 

downloads. An example partial license server file is shown below: 

SERVER license_hostname anyhost 


USE_SERVER 




3D83 A4D9 3B4B 7934 5401 6714" 


SIGN=E440F1A01536 


SIGN=93D3E17C2F9E 


SIGN=5F1317A4749E 

For a description of the license file contents, see License Files on page 14. 

To obtain and store a license file on a license server machine, proceed as follows: 

1. Download the license file from the IBM download site, as described in Downloading Netcool Licensing 

from the IBM Download Site on page 24. 

Note: If using a redundant configuration, you will require a copy of this file for each of the license 

server machines. Amend each copy separately, as described in the steps that follow. 

2. Overwrite the license_hostname variable in the SERVER line with the actual host name of 

your license server. This name must exactly match the output obtained by running the hostname 

command on the license server machine. 

3. Configure port specifications within the file, for the server and the vendor daemon. This step is 

applicable if the default port numbers for the server (any port between 27000 and 27009), and 

vendor (port 27001), are being used by other processes. For further information, see Using 

Non-Default Port Numbers for License Servers on page 29. 

4. Save the license file as filename.lic in the $NCHOME/license/etc directory of the 

system running the license server. Use a unique file name. 


! 

Using Non-Default Port Numbers for License Servers 



By default, the license server listens for incoming license requests on the first available port between 27000 

and 27009. If none of these ports are available for use, you must explicitly specify an alternative port 

number for the license server to listen on. 

To specify a port number for a license server, enter the port number at the end of the SERVER line in the 

license file. 

An example for a port specification of 27500 is given below: 

SERVER license_hostname anyhost 27500 


... 

You can also change the default port used by the FLEXlm vendor daemon. To change from the default port 

number of 27001, enter your preferred port number at the end of the VENDOR line in the license file. For 

example: 

... 

VENDOR netcool 27933 

... 

Note: If you change the port numbers in a license file, you must restart the license server for the changes to 

take effect. 

Warning: If you specify a non-default port for the license server to listen on, you must also specify the same 

port for clients. This can be done from the client machines by changing the port specification for the 

NETCOOL_LICENSE_FILE environment variable or the license property setting. For detailed 

information on setting environment variables or properties on client machines in a UNIX environment, 

refer to the relevant product installation or administration guide. 

Viewing the Installation Log and Installed Packages 

You can view the installer log, or view the list of currently installed packages, from the Netcool Installer 

Maintenance Wizard, as described in this section. You can also uninstall Netcool products using this wizard, 

as described in Uninstalling Netcool Licensing on UNIX on page 36. 

Viewing the Installation Log 

The Netcool Installer generates an installation log file of actions performed during the installation. You can 

use this file to verify that you installed Netcool Licensing successfully or to troubleshoot your installation. 

The level of detail in the log file is set by using the -errorlevel command line parameter when running 

the installation program. 

29


30 

You can view the installation log using the Netcool Installer Maintenance Wizard in GUI mode or in 

console mode. 

Note: If running on AIX or HP-UX platforms, you must use the console mode to view the installation log. 

To view the installation log using the Netcool Installer Maintenance Wizard in GUI mode: 

1. From a command prompt, enter the following command: 

$NCHOME/install/ncisetup 

The Welcome page of the Netcool Installer Maintenance Wizard appears. 

2. Select the Installer Log option and click Next to continue. The Installer Log page appears with the list 

of actions performed by the Netcool Installer. 

3. After reviewing the log, click Cancel to exit the Netcool Installer Maintenance Wizard. 

To view the installation log in console mode, enter the following command to obtain the log file listing: 

$NCHOME/install/ncisetup -report log 

The installation log is stored in the following location: 

$NCHOME/log/install/ncisetup.log 

Viewing Installed Packages 

Netcool products are made up of packages. You can view the versions of all installed packages at any time 

using the Netcool Installer Maintenance Wizard in GUI mode or in console mode. You may be asked for 

package information by Micromuse Support. 

Note: If running on AIX or HP-UX platforms, you must use the console mode to view packages. 

To view installed packages using the Netcool Installer Maintenance Wizard in GUI mode: 




2. Select the Package List option and click Next to continue. The Package List page appears with the list 

of all installed Netcool packages. 

3. After reviewing the list, click Cancel to exit the Netcool Installer Maintenance Wizard. 




To view the packages for all installed products in console mode, enter the following command: 

$NCHOME/install/ncisetup -report all 

The list of packages is displayed. 

31


2.2 Upgrading Netcool Licensing on UNIX 

32 

This section contains information on upgrading to the latest version of Netcool Licensing. During this 

process, the license server will be unavailable to users and no licensed features can be started. 

To upgrade Netcool Licensing on your existing license server machine: 

1. Back up your current license files (*.lic) to a safe location as these files will otherwise be deleted. 

Table 3 shows the license file locations in various Netcool Licensing versions. 

Table 3: License File Locations 

Netcool Licensing Version Default Location 

1.0b21 

This is an earlier version of Netcool 

Licensing (previously referred to as 

Netcool Common Licensing). 

1.0b31 

This is the Netcool Licensing upgrade, 

which is installed in a different location 

from version 1.0b21. 

$NCLICENSE/etc 

Solaris, HP-UX, Red Hat Linux: 

2. Uninstall your current version of Netcool Licensing, as described in Uninstalling Netcool Licensing on 

UNIX on page 36. 

3. Download the Netcool Licensing 1.0b31 tar file, as described in Downloading Netcool Licensing 


Note: You only need to download the license file if your current product licenses have expired, or are 

about to expire. 

4. Install Netcool Licensing 1.0b31, as described in Running the Installation Program on page 25. 

On completion of installation, you can view the installation log to verify that the process completed 

successfully. For further details, see Viewing the Installation Log on page 29. 

5. Copy the license files from the backup directory into the $NCHOME/license/etc location on 

the license server. If you downloaded a new license file, then you must install the file on the license 

server as described in Installing a License File on the License Server on page 28. 

6. Repeat this procedure on each redundant license server. 

/opt/netcool/common/license/etc 

AIX: 

/usr/netcool/common/license/etc 

$NCHOME/license/etc 

Solaris, HP-UX, Red Hat Linux, AIX: 

/opt/netcool/license/etc 


2.3 Managing the License Server on UNIX 


Managing the License Server on UNIX 

The license server provides a set of command line tools that allow you to start the server and manage 

licensing in your environment. When the license server is running and dispensing licenses, you can use the 

command line tools to view the license server status, view license usage, refresh licenses and perform other 

related tasks. 

The tasks involved in managing the license server include the following: 

Starting the License Server using nc_start_license 

Determining License Usage using nc_print_license 

Adding New Licenses to the License Server 

Refreshing the License Server using nc_read_license 

Using a License Server with your Netcool Product Installations 

Stopping the License Server using nc_stop_license 

The sections that follow document these tasks in detail. 

Starting the License Server using nc_start_license 

To start the license server, enter: 

$NCHOME/license/bin/nc_start_license & 

When the license server is started, it reads all license files in $NCHOME/license/etc and then waits for 

incoming license requests. 

Tip: When checking for the license server process using the UNIX command ps, the license server daemon 

is identified as lmgrd. 

Determining License Usage using nc_print_license 

You can determine the processes to which the license server is dispensing licenses using 

nc_print_license. To do this, enter: 

$NCHOME/license/bin/nc_print_license 

This lists all of the processes that are being served licenses, including non-Netcool processes if the license 

server is being used for other products. 

33


34 

Note: Although an unlimited number of licenses is provided for your Netcool product features, you are 

entrusted to use no more than the maximum number of licenses purchased. 

An example of the output of nc_print_license is shown below: 

serverhost# ./nc_print_license 

lmstat - Copyright (C) 1989-2002 Macrovision Corporation 

Flexible License Manager status on Wed 3/5/2006 17:12 

License server status: 27000@serverhost 

License file(s) on serverhost: /opt/netcool/license/etc/netcool.lic: 

serverhost: license server UP (MASTER) v8.3 

Vendor daemon status (on serverhost): 

netcool: UP v8.3 

Feature usage info: 

Users of nco_nco: (Total of 9999 licenses issued; Total of 5 licenses in use) 

"nco_nco" v20030430, vendor: netcool 

floating license 

ncadmin elist4 /dev/pts/14 (v8.0) (serverhost/27000 402), start Thu 3/6 14:51 

Users of nco_objserv: (Total of 9999 licenses issued; Total of 10 licenses in use) 

"nco_objserv" v20030430, vendor: netcool 

floating license 

ncroot observ1 /dev/pts/10 (v8.0) (serverhost/27000 101), start Wed 3/5 17:05 

ncroot observ2 /dev/pts/17 (v8.0) (serverhost/27000 201), start Thu 3/6 14:40 

ncroot observ3 /dev/pts/23 (v8.0) (serverhost/27000 301), start Thu 3/6 14:43 

... 


If you already have a license server installed and want to add a new license file for a newly-acquired Netcool 

product, proceed as follows: 

1. Download and store the license file on the license server machine, as described in Installing a License 

File on the License Server on page 28. 

2. Refresh the license server to make the new license file available. For further information, see 

Refreshing the License Server using nc_read_license on page 34. 

Refreshing the License Server using nc_read_license 

After adding new license files to the license server, the server must be refreshed before it can dispense any of 

these additional licenses. To refresh the license server, enter: 

$NCHOME/license/bin/nc_read_license 

Tip: You can also refresh the license server by shutting it down and restarting it. 


The refresh process makes the license server aware of any new license files added to the 

$NCHOME/license/etc directory. 


Managing the License Server on UNIX 


For information on the configuration required to enable licensing within each Netcool product installation, 

refer to the relevant product guide. 

Stopping the License Server using nc_stop_license 

When the license server is shut down, it cannot dispense any licenses. Netcool components cannot start 

without receiving a license from a license server. Netcool product components that are already running have 

a grace period in which they can continue to run without contacting a license server. After this period, the 

components will exit. 

To shut down the license server, enter: 

$NCHOME/license/bin/nc_stop_license 

35


2.4 Uninstalling Netcool Licensing on UNIX 

36 

This section contains information on uninstalling Netcool Licensing. Typically, you would uninstall 

Netcool Licensing if a license server is no longer required for dispensing licenses, or if you want to upgrade 

to Netcool Licensing 1.0b31. If using redundant license servers, you must uninstall Netcool Licensing from 

each license server machine. 

This section provides separate instructions for uninstalling Netcool Licensing 1.0b21 and Netcool Licensing 

1.0b31. 

Note: If you plan to upgrade to a higher version of Netcool Licensing (or to reinstall), you must back up 

your license files to a safe location before uninstalling. 

Uninstalling Netcool Licensing 1.0b21 

When you install Netcool Licensing 1.0b21 on UNIX platforms, all of the program files are copied to the 

$NCLICENSE directory, where $NCLICENSE defaults to one of the platform-specific locations listed in 

Table 4. 

You can safely uninstall Netcool Licensing by deleting this directory and all its contents. 

To uninstall Netcool Licensing 1.0b21 from a license server machine: 

1. Shut down the license server by entering the following command from a command prompt: 

$NCLICENSE/bin/nc_stop_license 

2. Enter the following command to remove the files from the file system: 

rm -rf $NCLICENSE 

Uninstalling Netcool Licensing 1.0b31 

! 

Table 4: Default $NCLICENSE Locations 

Platform Default Location 

Solaris, HP-UX, Red Hat Linux /opt/netcool/common/license 

AIX /usr/netcool/common/license 

You must use the Netcool Installer Maintenance Wizard to uninstall Netcool Licensing 1.0b31. 

Warning: Do not attempt to uninstall Netcool Licensing by deleting files or directories unless you intend 

to delete the entire Netcool suite installation. 



Uninstalling Netcool Licensing on UNIX 

You can uninstall Netcool Licensing 1.0b31 in GUI or console mode as described in the following sections. 

The uninstallation process removes all files except the following: 

Netcool Installer files 

Common packages required by other Netcool Installer-compliant products 

Tip: To completely remove the Netcool installation from the $NCHOME location, you must run the 

following command after uninstalling Netcool Licensing (and the other Netcool products): 

rm -rf $NCHOME 

Uninstalling Netcool Licensing 1.0b31 in GUI Mode 

To uninstall Netcool Licensing 1.0b31 in GUI mode: 

1. Shut down the license server as described in Stopping the License Server using nc_stop_license on 

page 35. 




3. Select Product View/Remove and click Next to continue.The Product View/Remove page appears 

with the list of Netcool products installed on your system. 

4. Double-click the Netcool Licensing application name to select it for removal. The icon to the left of 

the application name is marked with a red cross. You can also right-click over the application name 

and select Remove from the pop-up menu. 

5. Click Next. The Ready to remove page appears, listing the product and component packages that will 

be removed. 

6. Click Remove to proceed with the uninstallation. 

On completion, it is confirmed that Netcool Licensing has been removed. 

7. Click Finish to close the wizard. 

The Netcool Installer deletes the program files from the file system. 

37


38 

Uninstalling Netcool Licensing 1.0b31 in Console Mode 

To uninstall Netcool Licensing in console mode: 

1. Shut down the license server as described in Stopping the License Server using nc_stop_license on 

page 35. 


$NCHOME/install/ncisetup -console 

The list of Netcool products that are currently installed appears. 

3. Type the item number for Netcool Licensing and press Enter. In the Select column, the notation 

[R] marks Netcool Licensing for deletion. 

4. Type r and press Enter. The list of packages that will be removed appears. 

5. Type y to confirm the uninstallation and press Enter to proceed. 

On completion, it is confirmed that the Netcool Licensing packages have been removed. 


InstallationWindows.fm July 5, 2006 

Chapter 3: Windows Installation and 

Configuration 

This chapter describes how to install or upgrade, manage, and uninstall Netcool Licensing on a Windows 

platform. 


Installing Netcool Licensing on Windows on page 40 

Upgrading Netcool Licensing on Windows on page 47 

Managing the License Server on Windows on page 49 

Uninstalling Netcool Licensing on Windows on page 53 


Chapter 3: Windows Installation and Configuration 

3.1 Installing Netcool Licensing on Windows 

40 

The steps involved in installing Netcool Licensing are: 




The sections that follow document these steps in detail. 


The Netcool Licensing files are provided with each product download on the IBM site, and include the 

Netcool Licensing installer file and the product license file. 

To download Netcool Licensing: 

1. Go to the IBM download site. 

2. Select the relevant product hyperlink and locate the Netcool Licensing files for Windows. These 

include: 

– The Netcool Licensing 1.0b31 installation bundle - This is distributed as a zipped file named 

NCLServer-version-windows.zip, where version is the version and build 

number of the package. 

– The product license file - This is distributed as a lic file. 

Note: The product installer files are also inluded on the download page and can be downloaded 

at the same time. Instructions for downloading and installing products are described in the 

product installation guides. 

3. Download the zip and lic licensing files. 

Tip: Remember that it is only necessary to install a license server if you do not already have one 

installed. 

4. Extract the contents of the zip file into a temporary location. 

You can now perform a new installation of Netcool Licensing, as described in Running the Installation 

Program on page 41, or upgrade your existing version, as described in Upgrading Netcool Licensing on 

Windows on page 47. 




Installing Netcool Licensing on Windows 

This section describes how to install Netcool Licensing using the GUI and console modes. For further 

information on installing Netcool Licensing, see the relevant section: 

Running the Installation Program in GUI Mode on page 41 - Use this mode to present installation 

options within wizard pages in a graphical user interface. 

Running the Installation Program in Console Mode on page 42 - Use this mode for remote installations. 

Note: If using redundant license servers, you must install Netcool Licensing on each license server machine. 

Running the Installation Program in GUI Mode 

To install Netcool Licensing in GUI mode: 

1. From Windows Explorer, navigate to the directory where you extracted the contents of the Netcool 

Licensing zip file. 

2. Double-click setup.exe. 

Running this command on its own will set the installation log file level to a default of warning 

messages only. If you want to set the level of detail in the installation log file for information or 

troubleshooting purposes, open a command prompt, navigate to the location where you saved the 

extracted files, and then enter the following command: 

setup -errorlevel ERRORLEVEL 

Where ERRORLEVEL takes one of three values: 


– info - Warning and informational messages 

– warning - Warning messages only 

The Welcome page of the Netcool Installer Wizard appears. 

3. Click Next to proceed to the Licence Agreement page. 

4. Read and accept the license conditions, and click Next to continue. 

The Netcool Home page appears, showing the default installation location for the Netcool product 

suite. This default is C:\Program Files\Micromuse\netcool. 

5. Specify a different location if desired. Click Next to accept the installation directory. 

The Setup Type page appears. 

41


42 

6. Accept the Default option and click Next. 

7. From the Ready to install page, review the installation settings chosen. You can additionally view the 

list of packages that will be installed by clicking the show details hyperlink. 

8. Click Install to start the installation. 

When the installation is complete, the Netcool Installer Wizard Completed page appears. 

9. Click Finish to close the wizard. Your Netcool Licensing files are stored in the location 

%NCHOME%\license, typically: 

C:\Program Files\Micromuse\netcool\license 

On completion of installation: 

The license server is installed as a Windows service with Automatic startup. You can change this 

configuration from the Services window, which is accessible from Administrative Tools in the Control 

Panel. 

You can view the installation log to verify that the process completed successfully. You can also view 

the list of installed packages. For further details, see Viewing the Installation Log and Installed Packages 

on page 45. 

Running the Installation Program in Console Mode 

The console mode uses a text-based user interface to present installation options using a series of menus and 

prompts. You might use this installation mode to perform remote installations. 

To install Netcool Licensing in console mode: 


Licensing zip file. 

2. Run the installation program using the following command. An optional parameter is shown in 


setup -console [-errorlevel ERRORLEVEL] 

Use the optional -errorlevel parameter to define the level of detail in the messages written to 

the Netcool Installer log. Omitting this parameter defaults the log file level to warning messages only. 

The ERRORLEVEL variable takes one of three values: 


– info - Logs warning and informational messages 

– warning - Logs warning messages only 

3. When the Welcome information appears, press Enter to continue. 




4. Read the Micromuse license agreement and type y to accept the terms. Then press Enter to proceed. 

The menu of installable features and installation options appears. The License Server feature is 

the only installable feature and is selected by default, as denoted by the notation [I] in the Select 

column. 

5. Type n to configure additional installation options and press Enter. 

6. Type 1 to specify an installation location for the Netcool suite and press Enter. Then type a location 

and press Enter. The default location is C:\Program Files\Micromuse\netcool. 

7. To start the installation process, type i and press Enter. 

8. Do either of the following: 

– To confirm that you want to proceed with the installation, type i and press Enter. 

– To view the list of packages prior to installing, type m and press Enter. After reviewing the 

package listing, type y to confirm that you want to continue with the installation, and press 

Enter. 

Wait for the installation to complete. A message appears confirming that the installation was 

successful. 

If desired, you can view the installation log to verify that the process completed successfully. You can also 

view the list of installed packages. For further details, see Viewing the Installation Log and Installed Packages 

on page 45. 


The license server uses one or more license files to store the licenses that are required to make your Netcool 

products operational. Netcool license files are distributed as lic files and are available with the product 

downloads. An example partial license server file is shown below: 

SERVER license_hostname anyhost 


USE_SERVER 




3D83 A4D9 3B4B 7934 5401 6714" 


SIGN=E440F1A01536 


SIGN=93D3E17C2F9E 


SIGN=5F1317A4749E 

For a description of the license file contents, see License Files on page 14. 

43


44 

To obtain and store a license file on a license server machine, proceed as follows: 

1. Download the license file from the IBM download site, as described in Downloading Netcool Licensing 


Note: If using a redundant configuration, you will require a copy of this file for each of the license 

server machines. Amend each copy separately, as described in the steps that follow. 

2. Overwrite the license_hostname variable in the SERVER line with the actual host name of 

your license server. This name must exactly match the output obtained by running the hostname 

command from a command prompt on the license server machine. 

3. Configure port specifications within the file, for the server and the vendor daemon. This step is 

applicable if the default port numbers for the server (any port between 27000 and 27009), and 

vendor (port 27001), are being used by other processes. For further information, see Using 

Non-Default Port Numbers for License Servers on page 44. 

4. Save the license file as filename.lic in the %NCHOME%\license\etc directory of the 

system running the license server. Use a unique file name. 

Using Non-Default Port Numbers for License Servers 

By default, the license server listens for incoming license requests on the first available port between 27000 

and 27009. If none of these ports are available for use, you must explicitly specify an alternative port 

number for the license server to listen on. 

To specify a port number for a license server, enter the port number at the end of the SERVER line in the 

license file. 

An example for a port specification of 27500 is given below: 

SERVER license_hostname anyhost 27500 


... 

You can also change the default port used by the FLEXlm vendor daemon. To change from the default port 

number of 27001, enter your preferred port number at the end of the VENDOR line in the license file. For 

example: 

... 

VENDOR netcool 27933 

... 


! 



Note: If you change the port numbers in a license file, you must stop and restart the license server service 

for the changes to take effect. 

Warning: If you specify a non-default port for the license server to listen on, you must also specify the same 

port for clients. This can be done from the client machines by changing the port specification for the 

NETCOOL_LICENSE_FILE environment variable or the license property setting. For detailed 

information on setting environment variables or properties on client machines within a Windows 

environment, refer to the relevant product installation or administration guide. 

Viewing the Installation Log and Installed Packages 

You can view the installer log, or view the list of currently installed packages, from the Netcool Installer 

Maintenance Wizard, as described in this section. You can also uninstall Netcool products using this wizard, 

as described in Uninstalling Netcool Licensing on Windows on page 53. 

Viewing the Installation Log 

The Netcool Installer generates an installation log file of actions performed during the installation. You can 

use this file to verify that you installed Netcool Licensing successfully or to troubleshoot your installation. 

The level of detail in the log file is set by using the -errorlevel command line parameter when running 

the installation program. 

You can view the installation log using the Netcool Installer Maintenance Wizard in GUI mode or in 

console mode. 

To view the installation log using the Netcool Installer Maintenance Wizard in GUI mode: 

1. Select Start→Programs→Netcool Suite→Maintenance Wizard. 


2. Select the Installer Log option and click Next to continue. The Installer Log page appears with the list 

of actions performed by the Netcool Installer. 

3. After reviewing the log, click Cancel to exit the Netcool Installer Maintenance Wizard. 

45


46 

To view the installation log in console mode, enter the following command in a command prompt window: 

%NCHOME%\install\setup -report log 

The installation log is stored in the following location: 

%NCHOME%\log\install\ncisetup.log 

Viewing Installed Packages 

Netcool products are made up of packages. You can view the versions of all installed packages at any time 

using the Netcool Installer Maintenance Wizard in GUI mode or in console mode. You may be asked for 

package information by Micromuse Support. 

To view installed packages using the Netcool Installer Maintenance Wizard in GUI mode: 

1. Select Start→Programs→Netcool Suite→Maintenance Wizard. 


2. Select the Package List option and click Next to continue. The Package List page appears with the list 

of all installed Netcool packages. 

3. After reviewing the list, click Cancel to exit the Netcool Installer Maintenance Wizard. 

To view the packages for all installed products in console mode, enter the following command in a 

command prompt window: 

%NCHOME%\install\setup -report all 

The list of packages is displayed. 


3.2 Upgrading Netcool Licensing on Windows 


Upgrading Netcool Licensing on Windows 

This section contains information on upgrading to the latest version of Netcool Licensing. During this 

process, the license server will be unavailable to users and no licensed features can be started. 

To upgrade Netcool Licensing on your existing license server machine: 

1. Back up your current license files (*.lic) to a safe location as these files will otherwise be deleted. 

Table 5 shows the license file locations in various Netcool Licensing versions. 

Table 5: License File Locations 

Netcool Licensing Version Default Location 

1.0b21 

This is an earlier version of Netcool 

Licensing (previously referred to as 

Netcool Common Licensing). 

1.0b31 

This is the Netcool Licensing upgrade, 

which is installed in a different location 

from version 1.0b21. 

2. Uninstall your current version of Netcool Licensing, as described in Uninstalling Netcool Licensing on 

Windows on page 53. 

3. Download the Netcool Licensing 1.0b31 zip file, as described in Downloading Netcool Licensing 


Note: You only need to download the license file if your current product licenses have expired, or are 

about to expire. 

4. Install Netcool Licensing 1.0b31, as described in Running the Installation Program on page 41. 

On completion of installation: 

%NCLICENSE%\etc 

For example: 

C:\Program Files\Netcool\common\license\etc 

%NCHOME%\license\etc 

For example: 

C:\Program Files\Micromuse\netcool\license\etc 

– The license server is installed as a Windows service with Automatic startup. You can change this 

configuration from the Services window, which is accessible from Administrative Tools in the 

Control Panel. 

– You can view the installation log to verify that the process completed successfully. For further 

details, see Viewing the Installation Log on page 45. 

47


48 

5. Copy the license files from the backup directory into the %NCHOME%\license\etc location on 

the license server. If you downloaded a new license file, then you must install the file on the license 

server as described in Installing a License File on the License Server on page 43. 

6. Repeat this procedure on each redundant license server. 


3.3 Managing the License Server on Windows 


Managing the License Server on Windows 

The Netcool Licensing installation adds the LMTOOLS program to your system, for use in starting the 

server and managing licensing in your environment. For further details, see: 

LMTOOLS Overview 

Starting the License Server 

Displaying the License Server Status 


Refreshing the License Server 


Stopping the License Server 

The sections that follow document these tasks in detail. 

LMTOOLS Overview 

LMTOOLS is a Windows application that is provided as part of the licensing system installation. It allows 

you to: 

Start, stop and configure FLEXlm license servers 

Obtain system information such as settings, host IDs and server status 

Diagnose errors in the license file 

49


50 

To start LMTOOLS, select Start→Programs→Netcool Suite→Flex License→lmTools. The LMTOOLS 

window appears as shown in Figure 1. 

Figure 1: LMTOOLS Window 

For complete information about using LMTOOLS, see the FLEXlm user documentation at: 


Starting the License Server 

The Windows license server runs as a service. To start this service: 

1. Select Start→Programs→Netcool Suite→Flex License→lmTools. 

2. Ensure that the Configuration using Services radio button and NCOFlexLicense service name 

are selected in the Service/License File tab. 

3. Click the Start/Stop/Reread tab. 

4. Click the Start Server button. 

You can also start the license server service using the Windows Services Administrative Tools. Within the 

Windows Services panel, the service display name is shown as NCO Flex License Manager. 



Managing the License Server on Windows 

When the license server is started, it reads all license files in %NCHOME%\license\etc and then waits 

for incoming license requests. 

Displaying the License Server Status 

The license server status includes information such as whether the license server is running, the number of 

licenses issued for a component, and the number of licenses in current use. 

Note: Although an unlimited number of licenses is provided for your Netcool product features, you are 

entrusted to use no more than the maximum number of licenses purchased. 

To display the license server status: 


2. Click the Server Status tab. 

3. Click the Perform Status Enquiry button. The license server status is displayed in the area below. 

You can use the Options fields to view specific status information. For example, you can view information 

about the server, or an individual daemon or feature. 


If you already have a license server installed and want to add a new license file for a newly-acquired Netcool 

product, proceed as follows: 

1. Download and store the license file on the license server machine, as described in Installing a License 

File on the License Server on page 43. 

2. Refresh the license server to make the new license file available. For further information, see 

Refreshing the License Server on page 51. 

Refreshing the License Server 

After adding new license files to the license server, the server must be refreshed before it can dispense any of 

these additional licenses. To refresh the license server: 



51


52 

Note: The label on this tab might have slightly-varying text depending on the Configuration option 

selected in the Service/License File tab. 

3. Click the Reread License File button. 

Tip: You can also refresh the license server by stopping the license server service and restarting it. The service 

is defined within the Windows Services panel as NCO Flex License Manager. 

The refresh process makes the license server aware of any new license files added to the 

%NCHOME%\license\etc directory. 


For information on the configuration required to enable licensing within each Netcool product installation, 

refer to the relevant product guide. 

Stopping the License Server 

When the license server is shut down, it cannot dispense any licenses. Netcool components cannot start 

without receiving a license from a license server. Netcool product components that are already running have 

a grace period in which they can continue to run without contacting a license server. After this period, the 

components will exit. 

To stop the license server service: 


2. Ensure that Configuration using Services is selected in the Service/License File tab. 


4. Click the Stop Server button. 

You can also stop the license server service using the Windows Services Administrative Tools. Within the 

Windows Services panel, the service display name is shown as NCO Flex License Manager. 


3.4 Uninstalling Netcool Licensing on Windows 


Uninstalling Netcool Licensing on Windows 

This section contains information on uninstalling Netcool Licensing. Typically, you would uninstall 

Netcool Licensing if a license server is no longer required for dispensing licenses, or if you want to upgrade 

to Netcool Licensing 1.0b31. If using redundant license servers, you must uninstall Netcool Licensing from 

each license server machine. 

This section provides separate instructions for uninstalling Netcool Licensing 1.0b21 and Netcool Licensing 

1.0b31. 

Note: If you plan to upgrade to a higher version of Netcool Licensing (or to reinstall), you must back up 

your license files to a safe location before uninstalling. 

Uninstalling Netcool Licensing 1.0b21 

To uninstall Netcool Licensing 1.0b21 from a license server machine: 

1. Shut down the license server in the following sequence: 

– Select Start→Programs→Netcool→Flex License→lmTools. 

– Ensure that Configuration using Services is selected in the Service/License File tab. 

– Click the Start/Stop/Reread tab. 

– Click the Stop Server button. 

2. Select Start→Control Panel→Add/Remove Programs. 

3. Select Netcool License Server from the list of installed applications and click Remove. 

The Add/Remove Programs utility launches the license server uninstaller, which deletes the program 

files from the file system and removes license server information from the Windows registry file. 

Uninstalling Netcool Licensing 1.0b31 

! 

You must use the Netcool Installer Maintenance Wizard to uninstall Netcool Licensing 1.0b31. 

Warning: Do not attempt to uninstall Netcool Licensing by deleting files or directories. This leads to errors 

in the Netcool Installer database. 

53


54 

You can uninstall Netcool Licensing 1.0b31 as described below. The uninstallation process removes all files 

except the following: 

Netcool Installer files 

Common packages required by other Netcool Installer-compliant products 

Tip: To completely remove the Netcool installation from the %NCHOME% location, you must first 

uninstall Netcool Licensing (and any other Netcool products), and then delete the directory structure 

that remains. 

To uninstall Netcool Licensing 1.0b31 from a license server machine: 

1. Shut down the license server as described in Stopping the License Server on page 52. 

2. Select Start→Programs→Netcool Suite→Maintenance Wizard. The Welcome page of the Netcool 

Installer Maintenance Wizard appears. 

3. Select Product View/Remove and click Next to continue. The Product View/Remove page appears 

with the list of Netcool products installed on your system. 

4. Double-click the Netcool Licensing application name to select it for removal. The application name 

is marked with a red cross. You can also right-click over the application name and select Remove 

from the pop-up menu. 

5. Click Next. The Ready to remove page appears, listing the product and packages that will be removed. 

6. Click Remove to proceed with the uninstallation. 

On completion, the Netcool Installer Wizard Completed page appears, confirming that Netcool 

Licensing has been removed. 

7. Click Finish to close the wizard, and then wait for the Netcool Suite uninstall configuration to 

complete. 

Note: The Netcool Installer may prompt you to reboot if every product has been removed. In this case, 

you must reboot before reinstalling any part of the Netcool suite. 

The Netcool Installer deletes the program files from the file system and removes license server 

information from the Windows registry file. 


licensingIX.fm July 5, 2006 11:28 am 

Index 

A 

adding 

new licenses to UNIX license server 34 

new licenses to Windows license server 51 

C 

command line tools 17 

D 

daemons 

license manager 14 

lmgrd 14 

lmgrd.exe 14 

netcool 14 

netcool.exe 14 

default installation locations 20 

E 

example license file 15 

F 

FEATURE line 16 

FLEXlm licensing support 13 

I 

installation directory structure 20 

installation log 

viewing on UNIX 29 

viewing on Windows 45 

installed packages 

viewing on UNIX 30 

viewing on Windows 46 

installing 

license file 28, 43 

Netcool Licensing 1.0b31 Administration Guide 55 

L 

license file 

adding new licenses on UNIX 34 

adding new licenses on Windows 51 

components 14 

example 15 

FEATURE line 16 

installing 28, 43 

location 14 

non-default port numbers 29, 44 

port numbers 29, 44 

saving 28, 44 

SERVER line 15 

USE_SERVER line 16 

VENDOR line 16 

license manager daemon 14 

license server 

changing ports 29, 44 

components 14 

daemons 14 

displaying status on UNIX 33 

displaying status on Windows 51 

FLEXlm version 13 

hardware requirements 12 

installation directory structure 20 

installation options 21 

license file 14 

license usage on UNIX 33 

license usage on Windows 51 

managing on UNIX 33 

managing on Windows 49 

refreshing on UNIX 34 

refreshing on Windows 51 

Index

Index 

56 

SERVER port number 29, 44 

starting on UNIX 33 

starting on Windows 50 

stopping on UNIX 35 

stopping on Windows 52 

supported platforms 12 

UNIX installation 24 

using with Netcool products 35, 52 

VENDOR port number 29, 44 

Windows installation 40 

licensing configurations 

single server 11 

LMTOOLS 17 

LMTOOLS overview 49 

N 

nc_print_license 33 

nc_read_license 34 

nc_start_license 33 

nc_stop_license 35 

Netcool Licensing 

uninstalling on UNIX 36 

uninstalling on Windows 53 

upgrading on UNIX 32 

upgrading on Windows 47 

Netcool/Common Licensing 

FLEXlm version 13 

hardware requirements 12 

installation options 21 

installing on UNIX 24 

installing on Windows 40 

introduction 10 

supported platforms 12 

non-default port numbers 29, 44 

P 

packages installed on UNIX 30 

packages installed on Windows 46 

port number 

Q 

SERVER 29, 44 

VENDOR 29, 44 

quorum 11 

R 

redundant license servers 11 

refreshing 

license server on UNIX 34 

license server on Windows 51 

S 

saving 

license file on UNIX 28 

license file on Windows 44 

SERVER line 15 

SERVER port number 29, 44 

single license server 11 

specifying port numbers 29, 44 

starting 



stopping 



U 

uninstalling 

Netcool Licensing on UNIX 36 

Netcool Licensing on Windows 53 

UNIX 

command line tools 17 

default installation location 20 

upgrading 

Netcool Licensing on UNIX 32 

Netcool Licensing on Windows 47 


USE_SERVER line 16 

V 

vendor 14 

vendor daemon 14 

VENDOR line 16 

VENDOR port number 29, 44 

W 

Windows 

default installation location 20 

LMTOOLS 17 

Netcool Licensing 1.0b31 Administration Guide 57 

Index

Index 

58 


ackmatter.fm July 5, 2006 

Contact Information 

Corporate 

Region Address Telephone Fax World Wide Web 

USA Micromuse Inc. (HQ) 

650 Townsend Street 

San Francisco 

CA 94103 

USA 

Europe Micromuse Ltd. 

Disraeli House 

90 Putney Bridge Road 

London SW18 1DA 

United Kingdom 

Asia-Pacific Micromuse Ltd. 

Level 25 

77 St Georges Terrace 

Perth WA 6000 

Australia 

Technical Support 

1-800-Netcool (638 2665) 

+1 415 568 9800 

Region Telephone Fax 

USA 1-800-Netcool (800 638 2665) 

+1 415 568 9800 (San Francisco) 

+1 415 568 9801 http://www.micromuse.com 

+44 (0) 20 8875 9500 +44 (0) 20 8875 9995 http://www.micromuse.co.uk 

+61 (0) 8 9213 3400 +61 (0) 8 9325 5030 http://www.micromuse.com.au 

+1 415 568 9801 

Europe +44 (0) 20 8877 0073 (London, UK) +44 (0) 20 8875 0991 

Asia-Pacific +61 (0) 8 9213 3470 (Perth, Australia) 

Online 

+10 800 852 1012 (North China) 

+10 800 152 1012 (South China) 

+61 (0) 8 9486 1116 

Team E-Mail World Wide Web 

Licensing Temporary Licenses: temp.licensing@micromuse.com 

Permanent Licenses: perm.licensing@micromuse.com 

support.micromuse.com/helpdesk/licenses 

Support support@micromuse.com support.micromuse.com 


Contact Information 

60

Netcool Licensing Administration Guide 1.0b31 - e IBM Tivoli ...

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?