Netcool®/ImpactTM

frontmatter.fm December 15, 2004

3.1

Administration Guide

© 2004 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/ISMs, Netcool/ISM Global Perspective, Netcool/NT Service Monitors, Netcool/Wireless Service Monitors, Netcool/WSMs, Netcool/Usage Service Monitors, Netcool/USMs, Netcool/Telco Service Monitors, Netcool/TSMs, Netcool/Fusion, Netcool/Data Center Monitors, Netcool DCMs, 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/SSMs, Netcool/Application Service Monitors, Netcool/ASMs, 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/Software Developers Kit, 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, and 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. Micromuse acknowledges the use of the UCD SNMP Library Netcool/ISMs. 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. Portions of the Netcool/ISMs code are copyright ©2001, Cambridge Broadband Ltd. All rights reserved. Portions of the Netcool/ISMs 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 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. 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 and Microsoft Cluster Service are registered trademarks of Microsoft Corporation. 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. 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. 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 are Copyright © 1996-2003, Daniel Stenberg, <daniel@haxx.se>. 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. Netcool/SM Operations, Netcool/SM Configuration and Netcool/OpCenter include software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). 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 All other trademarks, registered trademarks and logos are the property of their respective owners. Micromuse Inc., 139 Townsend Street, San Francisco, USA CA 94107 www.micromuse.com Document Version Number: 1.1

. . . . . . . . . . . . . . .. . 13 Installation Components. . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . .. . . . . . . . . . . . . . . . . . . . . . . . .. . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2004 10:15 am Contents Preface . . . 12 What Are the Supported Installation Types? . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 8 Operating System Considerations . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .Contents MMGuideTOC. . . . . . . . . . . . . . . ... . ... . . . . .. . . . . . .. .. . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . 3 Associated Publications . 14 Netcool Common License Server. 4 Netcool/Impact Release Notes . . . . . . . . . 6 Note. . . . . . . . . . . . . . . . Tip.. . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide i . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .. . . . . . . .. . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . .. . . .. . . . . . . . .. . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . .. . . . . . . . .. . .. . . . . . . . . . . . . . . . .. . . . . . . . . . . . . 4 Netcool/Impact Web Services Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . .. . . . . . . . . . . . . . . . . . . . . .. . . . .. . . . . . . . . . . . . . .. . . . . . . .. . . . . . . . . . . . . .. . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . 5 Typographical Notation . . . . . . . .. . . . 1 Audience . . . . . . . . . . . .. .. . .. . . . . . . . . 2 About the Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . 14 Netcool/Impact . . . . . . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 14 Netcool Security Manager . 14 Installation Architecture . . . . . . . . . . .. . . . . . . . . . . .. . . . .. . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Netcool/Impact 3. . . . . . . . .. . .. . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 How Do I Manage an Installation? . . . . 11 About Netcool/Impact Installations . . . . . . .. . . . . . . . . . . . . . . . . . . . . . 12 What Is a Netcool/Impact Installation? . . . . . . . . .. . . . . . . . . . . . . . . . . 9 Chapter 1: Getting Started . . . .. . .. . . . . . . . . . . . . . . . 12 How Do I Set Up an Installation? . . . . . .. . .. . . . . . . . . . . . .. . . . . . . . . 14 Netcool GUI Server . . . . . . . . . . . . . . . .. . . . . . . . . . .1 Administration Guide . . . . . . . . . . . . . . and Warning Information . . . . .. . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . .. . . . . .. . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . 4 Netcool/Impact Solutions Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Netcool/Impact Policy Reference Guide .. . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .. . . . . . . 4 Netcool/Impact Online Help. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . .. . 8 Syntax and Example Subheadings . . . . . . . .. . . . . . . . . . .. . . . . . . . . . . . . . . . . . .fm December 15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Netcool/Impact User Interface Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . .. . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 How Do I Set Up the License Server? . . . . . . . . . . . . . . . . . . . . . . 29 How Do I Run the License Server? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Distributed Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Single System Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 How Do I Install Licenses?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Creating a Netcool/Impact Server Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Can I Run the License Server Under Process Control? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 How Do I Set Up Process Control? . . . . . . . . . . . . . . . . . . . . . . 30 ii Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Running an Installation Under Process Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Chapter 2: Netcool Common License Server . . . . . . . . . . . . . . . . . . . 18 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Running an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 How Do I Manage the License Server?. . . . . . . . . . . . . . . . . . . 16 Setting Up an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 What Is Process Control? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide . . . . . . . . 28 What Are the Supported Configurations?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Installing Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Sample Configuration File . . . . . . . . . . . . . . . . . . . . . . .Contents Installation Types . . . . . . . . . . . . . . . . . . . . . . . 28 What Are the License Server Components? . . . . . . . . . . . . 18 Planning an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 About the License Server . . . . . . . . . . . . 20 Configuring Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Managing an Installation . . . . . . . . . . . . 28 What Is the License Server? . . . . . . . . . . . . . . . . . . 19 Licensing Components. . . .

. 40 Requesting the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Generating the License Host ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Managing the License Server on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . 33 License Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Stopping the License Server . . 32 License Server Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 LMTOOLS (Windows Platforms). . . . . . . . . . . . . . . . . . . . . 38 Reading the Installation Log . . . . . . . . . . . 31 Limitations . . . 43 Refreshing the License Server . . . . . . . . . . . . . . . . . . . . . . . 33 License Server Daemons (UNIX Platforms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Hardware Support . . . . . . . 36 Running the License Server Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 License Server Service (Windows Platforms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Platform Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Viewing License Server Status . . . . . . . . . . . . . . 43 Starting the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Exceed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents System Requirements . . 44 Viewing the License Host ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Installing the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Installing Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Installing the License File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Licensing Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Command Line Tools (UNIX Platforms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Obtaining License Feature Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Setting the License Server Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide iii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Verifying Port Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . 51 Chapter 3: Netcool GUI Server . . . . .. . . . . . . . . . . . . . . . . . . . . . . . 51 Uninstalling on Windows . . . . . . . . . . . . . . . . . . .. . . . . . . . 56 Platform Support . . . .. . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 What Is the GUI Server? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 How Do I Set Up a Quorum? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 What Is Quorum Licensing? . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Java Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . 54 How Do I License the GUI Server? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . 55 How Do I Administer the GUI Server? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Using the FLEXlm Command Line Tools . . . . .. . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 54 How Do I Set Up the GUI Server? . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . 46 Viewing the License Host ID on Windows . . . . .. 47 Quorum Licensing . . . . . 49 Uninstalling the License Server . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 How Do I Run the GUI Server? . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . 45 Starting the License Server on Windows . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . 57 Hardware Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Uninstalling on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .. . . . . . . . . . . . . 53 About the GUI Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . 45 Viewing License Server Status on Windows . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .. . . . 57 Web Browser Support . . . . . . . . . . . . . 45 Refreshing the License Server on Windows . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Can I Run the GUI Server Under Process Control? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .. 48 How Do I Configure Netcool/Impact Components to Use a Quorum? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 iv Netcool/Impact 3. . . . . .. .. . . . .. . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .1 Administration Guide . . . . . . . . . . . . . . . 55 System Requirements . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . .. .. . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .Contents Managing the License Server on Windows . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .. . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . 56 Security Manager Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . 57 Exceed Limitations. . . . . . . . . . . . . . . . .. . . . . . . . 45 Stopping the License Server on Windows. . . . 56 License Server Compatibility . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 What Is Registry Clustering? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Configuring the Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Registry Clustering . . . . . . . . . . . . . . . . 59 Installing the GUI Server . . . . . . . . . . . 65 Stopping the GUI Server on UNIX . . . . . . . . 65 Stopping the GUI Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Configuring Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Installing the Java Development Kit (AIX and HP-UX Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Configuring the Servlet Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Reading the Installation Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 GUI Server Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Quorum Licensing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 How Do I Run a Registry Cluster?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Configuring Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Running the GUI Server Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide v . . . . . . . . . . . . . . 68 How Do I Set Up Registry Clustering? . 65 Configuring the GUI Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Starting the GUI Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 What Are the Clustering Components? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Verifying Port Settings. . . . . . . . . . . . . . . . . . . 62 Licensing the GUI Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Licensing Requirements . . . . . . . 60 Setting the GUI Server Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Application Registry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents GUI Server Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Servlet Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 How Does Registry Clustering Work? . . . 63 Running the GUI Server . . . . . . . . . . . . . . . . . . . . . 58 GUI Server Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 How Do I View Registry Status? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Starting the GUI Server on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 What Is Netcool/Impact? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 vi Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Netcool/Impact GUI . . . . . . . . 80 What Are the Netcool/Impact Components? . . . . . . . . 83 License Server Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents Uninstalling the GUI Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 How Do I License Netcool/Impact?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Netcool/Impact Server . . . 81 How Do I Configure Netcool/Impact? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Platform Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Netcool/Impact Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Netcool/Impact Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Java Support. . . . . . . . . . . . . 83 GUI Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Netcool/Impact CVS . . . . . . . . . . . . . . . . . . . . . . . . 86 Netcool/Impact Operator View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Netcool/Impact Architecture . . . . . . . . . . . . . 79 About Netcool/Impact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Security Manager Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Netcool/Impact DSAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Exceed Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Web Browser Support . . . . . . . . . . . . . . . . . . . . . . . . . 78 Uninstalling on UNIX . . . . . . . . . . . . . . 86 Netcool/Impact JRExec Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Uninstalling on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Netcool/OMNIbus Support . . . . . . . . . . . . . 80 How Do I Set Up Netcool/Impact? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Chapter 4: Netcool/Impact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Hardware Requirements. . . 81 How Do I Manage Netcool/Impact? . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . .. . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 Creating Server Instances . . .. . . . . . . . . . . . . . . . .. . . . . . .. . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . 100 Uninstalling Netcool/Impact . . . . . . . 101 Uninstalling on Windows Platforms . . . . . . . . . . . . . . 90 Upgrading Netcool/Impact . . . . . . . . 97 Quorum Licensing. . . . 88 Configuring the Operating System Kernel (UNIX Only). . . . . . . . . . . . . . . . . . . . . . . . . 104 How Do I Set Up a Server Instance? . . . . . . . . . . . . . . 99 Backing Up and Restoring Netcool/Impact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .. .. . . . . . . . . . . . . . . . . . . . . . . 104 What Are the Supported Server Configurations? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . 90 Verifying Port Settings. . . . . . . . . .. . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 How Do I Monitor a Server Instance? . . . . . . . . . . . . . .. . . . . . . 103 About the Netcool/Impact Server . . . . . . .. . . . . 90 Reading the Installation Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .0 . . . . . . . . . . . . .. . . . . . . .. . . . . . . . . 95 Configuring Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .. . . . . . . .. . . . . . . . . . . . . 88 Setting the IMPACT_HOME Environment Variable . . . . . . . . . . . . . . . . . . . 104 What Is the Netcool/Impact Server? . . . . . . . . . . . . . . . . .. . . . . . . . .Contents Installing Netcool/Impact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . 97 Configuring Registry Settings . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Uninstalling on UNIX .. . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . .. . . 98 Configuring Authentication . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .. . . . . 101 Chapter 5: Netcool/Impact Server . . . . . 91 Upgrading from Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Running the Netcool/Impact Installer . . . 91 Upgrading from Netcool/Impact 2. . . . . . . . . 105 How Do I Run a Server Instance? . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Licensing Netcool/Impact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . 95 Licensing Requirements . . . . . . . .. . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 What Is a Server Instance? .. . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .. . . . . . . . 106 Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide vii . . . . . . . . . . . . . . . . . ... . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 How Does Clustering Work? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 115 Setting Up a Server Cluster . . . . . 114 Failover . . . . . . . . . . .. . . . . . . . . . . . . . .. . . . . . . . . 113 Primary Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Startup . . . . . . . 110 Running the Remove CVS Archives Script. . . . . . . . . . . . . . . . . . . . 116 Configuring a Server Cluster . . . . . . . . . . . . . . . . . . 110 Running the Remove Server Script. . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . 109 Deleting Server Instances . . . . . . . . . . . . . . . . . . . 116 Installing a Server Cluster. 108 Stopping Netcool/Impact on Windows . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . .. . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide . . . . . . . . . . . . . . . . .Contents Running Server Instances on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Monitoring Server Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Stopping Netcool/Impact on UNIX . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . 111 About Server Clustering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 Starting Netcool/Impact on Windows . . . . . 107 Running Server Instances on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 What are the Clustering Components?. . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . 116 viii Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . 112 Clustering Components . . .. . . . . . . . . 112 How Do I Set Up Server Cluster? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 What Is Server Clustering? . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Secondary Servers. . . . . .. . . . .. 114 Event Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . 114 Shutdown .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . 107 Starting Netcool/Impact on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Chapter 6: Netcool/Impact Server Clustering . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Event Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 How Server Clustering Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. 121 About Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 How Version Control Works . . . . . . . . . . . .Contents Running a Server Cluster . . . . . . . . . . 129 Stopping the Database on UNIX Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Chapter 7: Netcool/Impact Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Cygwin Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Setting the Database Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 How Do I Set Up the Database? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 How Do I Run the Database? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Check In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Configuring Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 How Do I License the Database? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Starting a Cluster Member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Element Renaming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Chapter 8: Netcool/Impact Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 What is the Database? . . . . . . 128 Setting PostgreSQL Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 About the Database. . . . . . . 127 Configuring the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Element Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Starting the Database on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide ix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Starting the Database on UNIX Platforms . 119 Stopping a Cluster Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Element Deletion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Running the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Check Out. . . . . . . . . . . . 127 How Do I Manage the Database? . . . . . . . . . . . . . . . . . 129 Stopping the Database on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . .. . . . . . . . . . . . .. 134 How Do I Run the JRExec Server?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . 134 What Is the JRExec Server? . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . .. . .. . . . . . 131 Chapter 9: Netcool/Impact JRExec Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide . . 138 How Do I Set Up Self-Monitoring? . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Resetting the Database . . .. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 About Netcool/Impact Self-Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . 134 How Do I Configure the JRExec Server? . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Stopping the JRExec Server on Windows . . . . . . . . . . . . 135 Starting the JRExec Server on UNIX . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Viewing the Database Status . . . . . . . . . 135 Starting the JRExec Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . 139 x Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 How Does Self-Monitoring Work? . 134 Running the JRExec Server . . . . . . .. . . . . . 134 Can I Run the JRExec Server Under Process Control? . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 136 Chapter 10: Netcool/Impact Self-Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Backing Up the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents Managing the Database . . . . . . . . . . . . . . . . . . . 138 How Does Self-Monitoring Work with a Netcool/Impact Cluster? . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . 130 Connecting to the Database with the Command Line Client. . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Restoring the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 About the JRExec Server . . . . . . . . . . . . . . . . . . . . .. . . . . . .. . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 135 Configuring the JRExec Server . . . . . . . . . . . . 134 How Do I Set Up the JRExec Server?. . . . . . . . . . .. . . . . . . . .. . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . 138 What Is Self-Monitoring?. .. . . . . .. . . . . . .. . . . . . . . . . . . . . . . . . . . . 135 Stopping the JRExec Server on UNIX . . . . . . . .. . . . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 How Do I Manage Netcool/Impact Events?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Setting Up Self-Monitoring Using the GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Queue Status Event Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 About Queue Size Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Memory Status Severity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Setting Up Self-Monitoring Using the CLI . 156 Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 Current JVM Heap Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 About Memory Status Monitoring. . . . . 151 Maximum JVM Heap Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 Available System Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 nci_import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Monitoring Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 Queue Status . 153 nci_crypt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents Memory Status Monitoring . . . . . . 151 Maximum Required Memory . . . . . . . 152 ObjectServer Data Source . . . . . . . . . . 151 Available JVM Heap Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 nci_export . . . . . . . . . . . . . . . . 148 Viewing Information About Self-Monitoring . . . . . . . . . . . . . . . 150 Memory Status History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Memory Event Fields. . . . . . . . . . . . . . . . . . . . . . . . 152 Chapter 11: Command Line Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Setting Up Self-Monitoring . . . 150 Queue Status History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Queue Size Monitoring . . . . . . . . . . . . . . . . .1 Administration Guide xi . . . . . . . . . . 144 Queue Status Severity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Deduplication Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . 168 Configuring AIX . . . . . . . . 163 Netcool/Impact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 DB2 DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Data Type Configuration Properties . 157 Runtime Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Flat File DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Netcool License Server . . . 168 Configuring HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 xii Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 Windows Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Netcool GUI Server . . . . . 170 SQL Database DSAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Appendix B: DSA Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Firewall Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Netcool Security Manager . . . . . . . . . . . . . . . . . . . 169 About the Built-In DSAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 Data Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 UNIX Kernel Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Configuring Red Hat Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 Installation Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents nci_trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Netcool/Impact Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Appendix A: Supplementary Information . . . . . . . . . 172 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 File Format . 172 JDBC Driver Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Configuring Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 UNIX Examples.1 Administration Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Data Source Configuration Properties . . . . . . . . . . . . . . . 183 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Netcool/Impact 3. . . . 187 JDBC Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Supported Versions . . . . . . . . . . . . . . . . . . . . . . . . . . 176 JDBC Driver Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Data Types . . . . . . . . . . 182 Oracle DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents Informix DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 MySQL DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 JDBC Version . . . . . . 178 Data Types . . . . . . . . . . . . 181 ODBC DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 JDBC Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Data Source Configuration Properties . . . . . . . . . 179 ObjectServer DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 PostgreSQL DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Administration Guide xiii . . . . . . . . . . . . . . . . . . . . . 183 JDBC Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Data Types . . . . . . 183 Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 SQL Server DSA . . . . . . . . . . . . . . . . . . 180 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 JDBC Driver Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

.1 Administration Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Data Source Configuration Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Data Types. . . . . . . . . . . . .Contents Sybase DSA . . . 190 Contact Information . . . . . . . . . 195 xiv Netcool/Impact 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Supported Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1 Administration Guide on page 3 Associated Publications on page 4 Typographical Notation on page 6 Operating System Considerations on page 9 Netcool/Impact 3. 2004 This preface contains information about this guide and about the Netcool/Impact documentation.fm December 15.Preface 00_Preface. It contains the following sections: • • • • • Audience on page 2 About the Netcool/Impact 3.1 Administration Guide 1 .

configuring and running Netcool/Impact and its related software components.1 Administration Guide . It is intended for Netcool/Impact administrators and for other users who are responsible for setting up and managing this product. 2 Netcool/Impact 3.Preface Audience This guide contains information on installing.

1 Administration Guide About the Netcool/Impact 3.1 Administration Guide 3 .About the Netcool/Impact 3.1 Administration Guide This guide contains the following chapters: • • • • • • • • • • • • • Chapter 1: Getting Started on page 11 Chapter 2: Netcool Common License Server on page 27 Chapter 3: Netcool GUI Server on page 53 Chapter 4: Netcool/Impact on page 79 Chapter 5: Netcool/Impact Server on page 103 Chapter 6: Netcool/Impact Server Clustering on page 111 Chapter 7: Netcool/Impact Version Control on page 121 Chapter 8: Netcool/Impact Database on page 125 Chapter 9: Netcool/Impact JRExec Server on page 133 Chapter 10: Netcool/Impact Self-Monitoring on page 137 Chapter 11: Command Line Tools on page 153 Appendix A: Supplementary Information on page 161 Appendix B: DSA Reference on page 169 Netcool/Impact 3.

This guide is intended for Netcool/Impact administrations and for other users who are responsible for implementing Netcool/Impact.Preface Associated Publications Netcool/Impact 3. Netcool/Impact User Interface Guide This guide provides step-by-step instructions on using the Netcool/Impact user interface. operators and functions. 4 Netcool/Impact 3. This guide is intended for all Netcool/Impact users. Netcool/Impact Policy Reference Guide This guide contains reference information about the Netcool/Impact Policy Language (IPL). data types. It is intended for users who are responsible for writing and running Netcool/Impact policies. It contains information on setting up a data model. It contains complete information about policy language syntax.1 provides the following addtional documentation: • • • • • • Netcool/Impact Solutions Guide Netcool/Impact User Interface Guide Netcool/Impact Policy Reference Guide Netcool/Impact Web Services Guide Netcool/Impact Online Help Netcool/Impact Release Notes Netcool/Impact Solutions Guide This guide contains information on implementing Netcool/Impact solutions in your environment. working with services and developing policies. It also provides a complete policy language reference.1 Administration Guide . It is intended for all Netcool/Impact users. Netcool/Impact Web Services Guide This guide contains information on using the Netcool/Impact Web Services DSA and on using Netcool/Impact as a web service. Netcool/Impact Online Help This online help system provides step-by-step instructions on using the Netcool/Impact user interface.

1 Administration Guide 5 . Netcool/Impact 3.Associated Publications Netcool/Impact Release Notes This guide provides information about new features. system requirements and known issues for this version of Netcool/Impact.

This notation is used throughout this book and other Netcool® publications. SQL syntax. the Login window Information that the user must enter The introduction of a new term or definition Emphasized text 6 Netcool/Impact 3. Table 1: Typographical Notation and Conventions (1 of 2) Example Monospace Description 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. For example. and directory names Italicized monospace text indicates a variable that the user must populate. -password password. For example.Preface Typographical Notation Table 1 shows the typographical notation and conventions used to describe commands. and graphical user interface (GUI) features.1 Administration Guide . Italic The following are described in an italic font style: • • • • An application window name. for example. path. File→Save. Bold The following application characteristics are described in a bold font style: • • • • Buttons Frames Text fields Menu entries A bold arrow symbol indicates a menu entry selection.

ellipses indicate that the preceding element can be repeated. Multiple elements or clauses are separated by vertical bars. For example: [1] First command. [3] Third command.. The repetition is unlimited unless otherwise indicated. or BOOLEAN types: • • • A string can contain alphanumeric characters. an underlined element indicates a default option.. . SQL keywords are not case-sensitive. The repetition is unlimited unless otherwise indicated.. ellipses preceded by a comma indicate that the preceding element can be repeated.. If the string has spaces in it... Netcool/Impact 3. Names of ObjectServer objects and identifiers are case-sensitive. { a | b } In SQL syntax notation. and may appear in uppercase.1 Administration Guide 7 .. Command line options can be string. enclose it in quotation (") marks.. [ ] | . An integer must contain a positive whole number or zero (0).. integer. with each repeated element separated from the last by a comma. separated by vertical bars. A BOOLEAN must be set to TRUE or FALSE. In SQL syntax notation.. vertical bars separate two or more alternative syntax elements.. In SQL syntax notation. In SQL syntax notation.Typographical Notation Table 1: Typographical Notation and Conventions (2 of 2) Example [1] Description Code or command examples are occasionally prefixed with a line number in square brackets. lowercase. In SQL syntax notation. parentheses appearing within the statement syntax are part of the syntax and should be typed as shown unless otherwise indicated. or mixed case. In SQL syntax notation. a ( ) Many Netcool commands have one or more command line options that can be specified following a hyphen (-). In SQL syntax notation. [2] Second command. square brackets indicate an optional element or clause. curly brackets enclose two or more required alternative choices.

or critical information. Pay close attention to warnings. For example. 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. or samples of code. Example Example subheadings describe typical or generic scenarios.1 Administration Guide . when describing an installation process. Essentially. this is for extra data that is important but not vital to the user. For example: [1] [2] [3] [4] [5] [6] <body> <img src="ChartView?template=barchart&format=PNG &request=image&chart=quote&width=800&height=400" border="0" height="400" width="800" alt="Events by Severity" > </body> 8 Netcool/Impact 3. Warning: Warning is used for highlighting vital instructions. as they contain information that is vital to the successful use of our products. Tip: Tip is used for additional information that might be useful for the user. cautions. there might be a shortcut that could be used instead of following the standard installation instructions. ! 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.Preface Note. For example: CREATE DATABASE database_name. Tip.

UNIX is case-sensitive. replace $IMPACT_HOME with %IMPACT_HOME% and the forward slash (/) with a backward slash (\).1 Administration Guide 9 . Unless otherwise specified. Netcool/Impact 3. where $IMPACT_HOME is the UNIX environment variable that contains the path to the Netcool/Impact home directory.Operating System Considerations Operating System Considerations All command line formats and examples are for the standard UNIX shell. You must type commands in the case shown in the book. On Microsoft Windows platforms. command files are located in the $IMPACT_HOME/bin directory.

1 Administration Guide .Preface 10 Netcool/Impact 3.

fm December 15. 2004 10:15 am This chapter contains the information you need to get started with a Netcool/Impact installation.Chapter 1: Getting Started 01_Getting_Started. It contains the following sections: • • • • • • • • About Netcool/Impact Installations on page 12 Installation Components on page 14 Installation Architecture on page 15 Installation Types on page 16 Setting Up an Installation on page 18 Running an Installation on page 21 Running an Installation Under Process Control on page 23 Managing an Installation on page 25 Netcool/Impact 3.1 Administration Guide 11 .

For more information. you must first understand your environment and your goals for Netcool/Impact. After you finish planning. see Setting Up an Installation on page 18. see Installation Components on page 14. It contains the following topics: • • • • What Is a Netcool/Impact Installation? What Are the Supported Installation Types? How Do I Set Up an Installation? How Do I Manage an Installation? What Is a Netcool/Impact Installation? A Netcool/Impact installation is an implementation of Netcool/Impact and its related software components. license and configure the installation components on the appropriate target systems. What Are the Supported Installation Types? Netcool/Impact supports both single system and distributed installations. you can install. A distributed installation is one in which Netcool/Impact and its components are installed on multiple systems and then configured to work together across a network.Chapter 1: Getting Started 1.1 About Netcool/Impact Installations This section contains overview information about Netcool/Impact installations. How Do I Set Up an Installation? Before you set up an installation. Single system installations consist of Netcool/Impact and its related software components installed on a single target system. 12 Netcool/Impact 3. The components of an installation are: • • • • Netcool/Impact Netcool Common License Server Netcool Security Manager Netcool GUI Server For more information.1 Administration Guide . You can then plan how you want to install the product based on your requirements. For more information. see Installation Types on page 16.

1 Administration Guide 13 . Netcool/Impact also provides web-based GUIs that you can use to perform administration tasks. Netcool/Impact and its related components provide a variety of log files and other tools that you can also use to monitor their status and troubleshoot problems. In addition. Netcool/Impact 3.About Netcool/Impact Installations How Do I Manage an Installation? You manage an installation of Netcool/Impact using either command line scripts (on UNIX platforms) or Windows-based management tools and applications (on Windows platforms).

In addition. see Chapter 4: Netcool/Impact on page 79. see Chapter 2: Netcool Common License Server on page 27. For more information on the Netcool GUI Server. Netcool Security Manager The Netcool Security Manager provides user authentication for Netcool/Impact and the Netcool GUI Server. see Chapter 3: Netcool GUI Server on page 53. Netcool/Impact allows you to extensively customize and enhance Netcool/OMNIbus and other Netcool products by adding such functionality as advanced event and business data correlation. messaging systems and network inventory applications. see the Netcool Security Manager Administration Guide. For more information on the Netcool Security Manager. Netcool GUI Server The GUI Server is a standalone server application that hosts web-based graphical user interfaces for Netcool/Impact and the Netcool Security Manager. including databases. event enrichment and event notification.Chapter 1: Getting Started 1. Netcool/Impact is the primary component of the installation. For more information on Netcool/Impact.1 Administration Guide . 14 Netcool/Impact 3. you can use Netcool/Impact to integrate Netcool/OMNIbus with a wide variety of third party software. Netcool Common License Server The Netcool Common License Server provides licensing functionality for Netcool/Impact.2 Installation Components A Netcool/Impact installation has the following components: • • • • Netcool/Impact Netcool Common License Server Netcool Security Manager Netcool GUI Server Netcool/Impact Netcool/Impact is the analysis and correlation engine for the Netcool suite of network management products. For more information on the Netcool Common License Server. the Netcool Security Manager and the Netcool GUI Server.

1 Administration Guide 15 .3 Installation Architecture The following figure shows the basic architecture of a Netcool/Impact installation. Netcool/ Impact Netcool Common License Server Netcool Security Manager Netcool GUI Server Figure 1: Netcool/Impact Installation Architecture Netcool/Impact 3.Installation Architecture 1.

1 Administration Guide . This type of installation is the most common and offers the highest degree of flexibility and customization for live production environments. 16 Netcool/Impact 3. The Netcool Common License Server.Chapter 1: Getting Started 1. Netcool Security Manager and the Netcool GUI Server. Single server installations are not recommended for live production environments. which can be shared between multiple Netcool products. This type of installation is suitable for testing and demonstrating Netcool/Impact. Distributed Installation A distributed installation is one in which Netcool/Impact and its components are installed on multiple systems and then configured to work together across a network. One recommended configuration is as follows: • • Each instance of the Netcool/Impact server is located on a separate system. There are a variety of possible configurations for this type of installation. are located on one or more separate systems.4 Installation Types Netcool/Impact supports the following installation types: • • Single System Installation Distributed Installation Single System Installation A single server installation consists of Netcool/Impact and the related software components installed on a single system.

Netcool/ Impact Netcool/ Impact Netcool/ Impact Netcool Common License Server Netcool GUI Server Netcool Security Manager Figure 2: Netcool/Impact Distributed Installation Netcool/Impact 3.Installation Types The following figure shows this type of distributed installation.1 Administration Guide 17 .

Your Micromuse account representative can help you determine what type of hardware you need to run the installation and how to configure it to fit your requirements. You must also have an understanding of your network topology. requirements and available resources before you install the software. you must take into account your goals. 18 Netcool/Impact 3.5 Setting Up an Installation This section contains general information on setting up a Netcool/Impact installation. Specifically. This type of installation requires little planning and is the easiest to create and maintain.1 Administration Guide .Chapter 1: Getting Started 1. For real-life production installations. Micromuse recommends that you install Netcool/Impact and its components on a single system. you must know what type of alerts are collected by Netcool probes and monitors and how the alerts are stored in the Netcool/OMNIbus ObjectServer database. Micromuse recommends that you create a diagram of the installation you want to create before you begin. devices and applications that exist on the network and how they are monitored by Netcool/OMNIbus. For testing or demonstration purposes. you can plan your Netcool/Impact installation. including the types of systems. you must have an understanding of how Netcool/OMNIbus and other Netcool products are installed and used in your environment. Planning an Installation After you understand how Netcool/OMNIbus and other Netcool products are installed and used in your environment. It contains the following topics: • • • • • • Before You Begin Planning an Installation Installing Components Licensing Components Creating a Netcool/Impact Server Instance Configuring Components Before You Begin Before you start setting up Netcool/Impact.

You must obtain the license feature codes for Netcool/Impact and its related components and then install them in the license server before you can run them. Installing Netcool/Impact on page 88 Licensing Components Netcool/Impact. see: • • • • Installing the License Server on page 36 Installing the GUI Server on page 60 Installing the Security Manager in the Netcool Security Manager Administration Guide. or create your own. In GUI mode.Setting Up an Installation Installing Components You must install the components in the following order: • • • • License Server GUI Server Security Manager Netcool/Impact If you have already installed the License Server. you must run the installer in console mode. For more information.3 license server and the Netcool Common License Server. Licensing the GUI Server on page 63 and Upgrading Netcool/Impact on page 91. the installers prompt you for required information from the command line.1 Administration Guide 19 . For more information. the Security Manager and the GUI Server are compatible with the Netcool/Impact 2. Netcool/Impact and its components provide installer programs that you can run in GUI mode or in console mode. the installers present a series of graphical windows that guide you through the installation process. Netcool/Impact 3. the Security Manager or the GUI Server for use with another Netcool product. If you are running the installer remotely using telnet or another command line application. see Licensing the Security Manager in the Security Manager Administration Guide. Micromuse recommends that you prepare a worksheet and record the information that you provide to the installer programs. you do not need to install another instance for use with Netcool/Impact. You can print and use the sample worksheet included in the Appendix A: Supplementary Information on page 161. In console mode.

This program creates the required properties files and other files associated with the server instance and stores them in the $IMPACT_HOME/etc directory. Depending on the component. you must create a new instance of the Netcool/Impact server. Configuring Components The installer programs set the minimum required configuration properties during installation.1 Administration Guide . You can change the configuration of a component at any time by manually editing the properties files. For more information. you might need to stop and restart after making configuration changes. see Creating Server Instances on page 106. Netcool/Impact provides a program named nci_new_server that guides you through the instance creation process. 20 Netcool/Impact 3.Chapter 1: Getting Started Creating a Netcool/Impact Server Instance After you have installed Netcool/Impact and its related software components.

Running an Installation 1. you must use the Windows Services Administration tools. Netcool Security Manager Netcool/Impact 3.1 Administration Guide 21 . The License Server also provides a Windows program called LMTOOLS that you can use to start and stop the server. Table 2: Netcool/Impact Component Commands Component License Server GUI Server Security Manager Netcool/Impact Command $NCLICENSE/bin/nc_start_license $GUI_HOME/bin/ncgui_server $SM_HOME/bin/ncsm_server $IMPACT_HOME/bin/nci_db start (Optional) $IMPACT_HOME/bin/nci_server server where server is the name of the server instance On Windows platforms.6 Running an Installation Micromuse recommends that you start Netcool/Impact and its related components in the following order: • • • • License Server GUI Server Security Manager Netcool/Impact You must start the Netcool/Impact server after you start the other components. Netcool Database (Security). The following table shows the commands for starting the components on UNIX platforms. To start and stop these programs. Table 3: Netcool/Impact Windows Services (1 of 2) Component License Server GUI Server Security Manager Service Name Netcool License Server Netcool GUI Server Netcool Security RMI. Netcool/Impact and its related components run as Windows services. The following table shows the names of the Windows services.

1 Administration Guide . Netcool Database (Impact) 22 Netcool/Impact 3.Chapter 1: Getting Started Table 3: Netcool/Impact Windows Services (2 of 2) Component Netcool/Impact Service Name Netcool Impact server where server is the name of the server instance.

Netcool/Impact 3.Running an Installation Under Process Control 1. After you have installed the process control manager. Use of process control with Netcool/Impact is optional. Netcool/Impact. see the Netcool/OMNIbus Administration Guide.1 Administration Guide 23 .conf file on each system. It contains the following topics: • • • What Is Process Control? How Do I Set Up Process Control? Sample Configuration File What Is Process Control? Process control is a feature of Netcool/OMNIbus that helps maintain uptime for applications in the Netcool suite. For additional information on process control. see the Netcool/OMNIbus Administration Guide. the Netcool Common License Server. You can use this feature to make sure that Netcool/Impact and its related components are automatically restarted in the event that they stop due to software failure.7 Running an Installation Under Process Control This section contains information running Netcool/Impact and its related components under process control. you must edit the nco_pa. the Netcool Security Manager and the Netcool GUI Server run as "non-pa aware" applications. How Do I Set Up Process Control? To set up process control. For instructions on installing the process control manager and setting up process control in your environment. you must install the process control manager on each system in your environment where you are running Netcool/Impact and its related components.

’ RetryCount=3 ProcessType=PaNOT_PA_AWARE } nco_process ’GUIServer’ { Command ’$GUI_HOME/bin/ncgui_server’ run as impact Host=’HOST_01’ Managed=true RestartMsg=’The GUI Server has restarted. nco_process ’LicenseServer’ { Command ’$NCLICENSE/bin/nc_start_license’ run as impact Host=’HOST_01’ Managed=true RestartMsg=’The License Server has restarted.Chapter 1: Getting Started Sample Configuration File The following is a sample nco_pa.1 Administration Guide .’ RetryCount=3 ProcessType=PaNOT_PA_AWARE } 24 Netcool/Impact 3.conf configuration file that shows the process definitions for Netcool/Impact and its related components.’ RetryCount=3 ProcessType=PaNOT_PA_AWARE } nco_process ’Impact_NCI’ { Command ’$IMPACT_HOME/bin/nci_server NCI’ run as impact Host=’HOST_01’ Managed=true RestartMsg=’The Impact Server NCI has restarted.’ AlertMsg=’The License Server has gone down. Real-world configuration files will differ depending on how you have installed and configured your installation.’ RetryCount=3 ProcessType=PaNOT_PA_AWARE } nco_process ’SecurityManager { Command ’$SM_HOME/bin/ncsm_server’ run as impact Host=’HOST_01’ Managed=true RestartMsg=’The Security Manager has restarted.’ AlertMsg=’The Impact Server NCI has gone down.’ AlertMsg=’The GUI Server has gone down.’ AlertMsg=’The Security Manager has gone down.

Managing an Installation 1. In addition. Netcool/Impact and its related components provide a variety of log files and other tools that you can also use to monitor their status and troubleshoot problems.8 Managing an Installation You manage an installation of Netcool/Impact using either command line scripts (on UNIX platforms) or Windows-based management tools and applications (on Windows platforms). Netcool/Impact and the Netcool Security Manager also provide web-based GUIs that you can use to perform administration tasks. Netcool/Impact 3.1 Administration Guide 25 .

Chapter 1: Getting Started 26 Netcool/Impact 3.1 Administration Guide .

fm December 15. 2004 10:29 am This chapter contains information on the Netcool Common License Server 1.1 Administration Guide 27 .Chapter 2: Netcool Common License Server 02_License_Server.0b21. It contains the following sections: • • • • • • • • • • • About the License Server on page 28 System Requirements on page 31 Licensing Architecture on page 32 License Server Components on page 33 Installing the License Server on page 36 Installing Licenses on page 39 Managing the License Server on UNIX on page 43 Managing the License Server on Windows on page 45 Using the FLEXlm Command Line Tools on page 47 Quorum Licensing on page 48 Uninstalling the License Server on page 51 Netcool/Impact 3.

2 support both single-server and quorum configurations of the License Server. The License Server is supported on all the platforms that are supported for Netcool/Impact and the Netcool Security Manager. Netcool GUI Server 2.0 and Netcool Security Manager 1.0b21 of the License Server incorporates FLEXlm version 9. Previous versions of these components supported only single-server configurations. 28 Netcool/Impact 3. You must install and configure a License Server before you run Netcool/Impact or the Netcool GUI Server. see the FLEXlm End User’s Guide.1 Administration Guide . This guide is available from the Macrovision website at http://www. It contains the following topics: • • • • • • • • What Is the License Server? What Are the Supported Configurations? What Are the License Server Components? How Do I Set Up the License Server? How Do I Install Licenses? How Do I Run the License Server? Can I Run the License Server Under Process Control? How Do I Manage the License Server? What Is the License Server? The Netcool Common License Server is a standalone server component that provides licensing functionality for Netcool/Impact and other products in the Netcool suite. see Quorum Licensing on page 48.1. For more information. For more information on quorum licensing. What Are the Supported Configurations? Netcool/Impact 3. you do not need to install a new one for use with Netcool/Impact.com. For more information on FLEXlm. see System Requirements on page 31.Chapter 2: Netcool Common License Server 2.1 About the License Server This section contains overview information about the License Server. The License Server is based on FLEXlm licensing technology. You must also install licenses for Netcool/Impact and for the Security Manager before you run these components. Version 1.macrovision. FLEXlm is a product of Macrovision Corporation.2. If you are already running a License Server in your environment.

The License Server runs by default as a foreground process. see Managing the License Server on UNIX on page 43 and Managing the License Server on Windows on page 45. Netcool/Impact 3. see Installing Licenses on page 39. You can view the installation log to see if the process has completed successfully. see License Server Components on page 33. To install the License Server. you must first generate the license host ID for the system where the License Server is running. you must first obtain the installation files from the Micromuse Product CD-ROM or as a download from the Micromuse Technical Support website. How Do I Install Licenses? Before you install licenses in the License Server. To install the licenses. For more information. For more information. On Windows platforms. The installation files include the License Server installer and a README file. There is no need to pass the -z command line argument to the startup script as in previous versions. On UNIX platforms. How Do I Run the License Server? On UNIX platforms. The License Server runs as a “non-pa aware” application. The URL for the Micromuse Technical Support website is http://support. How Do I Set Up the License Server? Before you set up the License Server. you start and stop the License Server using the server administration scripts. you run the installer and follow the on-screen prompts. For more information. you can use the Windows services administration tools or the LMTOOLS program.micromuse.com.About the License Server What Are the License Server Components? The License Server software consists of the licensing daemons (on UNIX platforms) or service (on Windows platforms). see Installing the License Server on page 36. you must set the required environment variables after installation. Can I Run the License Server Under Process Control? You can run the License Server under process control with no special considerations. license files and a collection of license tools that you can use to manage licensing in your environment. For more information. The installer sets all of the required configuration properties.1 Administration Guide 29 . Then. you request a license file from Micromuse Technical Support. you copy the license file to the target system and request a license file refresh from the License Server.

30 Netcool/Impact 3.Chapter 2: Netcool Common License Server How Do I Manage the License Server? The License Server provides a set of command line tools that allow you to manage licensing in your environment. see Managing the License Server on UNIX on page 43 and Managing the License Server on Windows on page 45. On Windows platforms. you can also use the LMTOOLS program. refresh licenses and perform other related tasks. This program allows you to perform all of the management functionality provided by the command line tools. You can use these tools to view the License Server status.1 Administration Guide . view license usage. For more information.

For recommendations on hardware sizing for the License Server. Platform Support The License Server is supported on the following platforms: • • • • • Sun Microsystems Solaris 7. License files are not backward compatible between versions. Micromuse recommends that you use the most recent FLEXlm-enabled license server available. You must read the full text of the license agreement and accept the terms of the agreement before installing this software. Netcool/Impact 3.1 and 5. the Netcool/Impact 2.5 and later.3 license server and the license server distributed with Netcool/OMNIbus 3.00 Hardware Support Hardware requirements for the License Server vary depending on your environment and license usage.1 Administration Guide 31 .0 Microsoft Windows 2000 Server. Limitations You can run only one FLEXlm-enabled Netcool license server per machine. contact your Micromuse account manager or Micromuse Technical Support. Windows XP and Windows 2003 Server IBM AIX 5L (5.2 System Requirements Make sure that the target system fulfills the requirements in this section before installing the License Server.0 and Enterprise Server 3. Under some conditions.System Requirements 2. This includes the Netcool Common License Server. the license agreement text displayed by the installer program is not legible when viewed inside Exceed. 8 and 9 Red Hat Linux 9. Exceed Issues Micromuse does not recommend the use of Hummingbird Exceed with the License Server installer program.2) Hewlett-Packard HP-UX 11.

Chapter 2: Netcool Common License Server 2.3 Licensing Architecture The following figure shows the relationship between Netcool/Impact. other Netcool applications and the License Server.1 Administration Guide . Netcool/RAD Netcool/OMNIbus Netcool Common License Server Other Netcool Applications Netcool/Impact Figure 3: Netcool Licensing Architecture 32 Netcool/Impact 3.

the FLEXlm daemon and the vendor daemon. It provides the primary interface to client applications (such as Netcool/Impact and the Netcool Security Manager) and passes requests to check in and check out licenses to the vendor daemon. This daemon is responsible for the core operations of the License Server. These daemons provide the licensing functionality for the server. The default name for license files is license.lic. License Server Service (Windows Platforms) On Windows platforms. following instructions provided in the FLEXlm documentation.exe. the License Server has two daemons. Netcool/Impact 3. You run the lmgrd. This service provides the primary interface to client applications (such as Netcool/Impact and the Netcool Security Manager) and handles requests to check in and check out licenses.exe daemon using the Services Administration tools provided by Windows. The License Server supports an unlimited number of license files. You run the lmgrd and netcool daemons using the License Server script.1 Administration Guide 33 . By default.4 License Server Components The License Server has the following components: • • • • • License server daemons (UNIX only) License server service (Windows only) License files Command line tools LMTOOLS (Windows only) License Server Daemons (UNIX Platforms) On UNIX platforms. You can also run the service using the LMTOOLS program.License Server Components 2. The FLEXlm daemon is named lmgrd. The vendor daemon is named netcool. License Files License files are text files that contain licenses for the License Server. You can also launch the daemons manually from the command line.lic as a license file. the License Server runs as a service named lmgrd. license files are located in the $NCLICENSE/etc directory. The License Server recognizes any file with a name that ends in .

The vendor line appears in the license file in the following format: VENDOR netcool Feature Lines Feature lines are lines that contain information about each licensed component. The ck and SIGN attributes are used by the License Server for license validation. exp_date is the expiration date for the licenses and number is the number of licenses available.1 Administration Guide . hostID is the license host ID for the server and port is the port where you are running the License Server.1 exp_date number ck SIGN where feature is a Netcool license feature code. Vendor Line The vendor line identifies the vendor providing the licenses.Chapter 2: Netcool Common License Server License files contain the following elements: • • • Server line Vendor line Feature lines Server Line 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 host hostID port where host is the hostname of the system. Feature lines appear in the license file in the following format: FEATURE feature netcool 3. 34 Netcool/Impact 3. including number of licenses and the license expiration date. The license file contains one feature line for each licenseable Netcool component or feature.

You can use these tools to view the server status. These tools are located in the $NCLICENSE/bin directory.0 31-Dec-2005 2 ck=200 \ SIGN=9C877EF420E2 Command Line Tools (UNIX Platforms) The License Server provides a set of command line tools that allow you to manage licensing on UNIX platforms. LMTOOLS (Windows Platforms) On Windows platforms. see Managing the License Server on Windows on page 45. For more information.0 31-Dec-2005 4 ck=199 \ SIGN=939730F86748 FEATURE cro_nci_eventbroker netcool 4.0 31-Dec-2005 2 ck=174 \ SIGN=30DC95B86230 FEATURE cro_nci_objserv_dsa netcool 4. view license usage.0 31-Dec-2005 2 ck=185 \ SIGN=C39E61ACFE2D FEATURE cro_nci_mysql_dsa netcool 4.0 31-Dec-2005 2 ck=221 \ SIGN=A2D69708434E FEATURE cro_nci_client netcool 4. refresh licenses and perform other related tasks.License Server Components Example License File The following is an example of the contents of a license file: SERVER localhost 80f34eb5 27000 VENDOR netcool USE_SERVER FEATURE cro_nci_server netcool 4.1 Administration Guide 35 . Netcool/Impact 3. see Managing the License Server on UNIX on page 43. the License Server provides a program called LMTOOLS that you can use to manage licensing. You can use LMTOOLS to perform all of the management functionality provided by the command line tools. For more information. You can also use LMTOOLS to start and stop the License Server.

This script is located in the root level of the tar file. you do the following: • • • Run the License Server installer Set the License Server environment variables (UNIX only) Verify firewall port settings After you have finished installing the License Server.d directory. Micromuse recommends that you do not install the License Server as user root. The installer is a script named license_install. where ver is the version and build number of the package.Chapter 2: Netcool Common License Server 2. This script automatically restarts the License Server at system startup. UNIX only. the default is /opt/netcool/common/license. On Solaris. Running the License Server Installer The License Server installer copies the program files to the target system and sets the minimum required configuration properties. On Windows platforms.tar. On AIX.1 Administration Guide . You can choose whetherto copy a startup script into the init. or to troubleshoot installation errors. write and execute permissions to the target directory. the License Server is distibuted as a zipped tar file named license_ver. Red Hat Linux. the default is /usr/netcool/common/license. On Windows 2000. Copy startup script 36 Netcool/Impact 3. You can run the installer as any other user that has read. If you are already running the License Server in your environment. the installer is a setup program named licensemgr. and HP-UX.gz. you can read the installation log to verify that the software has been installed correctly. On UNIX platforms.5 Installing the License Server To install the License Server.msi. The License Server installer prompts you for the following information: Table 4: Netcool Common License Server Installer Prompts Prompt Installation directory Description The directory where you want to install the License Server. you do not need to create a separate installation for use with Netcool/Impact. You can run the installer by double-clicking the program icon in Windows Explorer. the default is C:\Program Files\Netcool\Common\License.

2. export NCLICENSE The following example shows how to set NCLICENSE using csh: setenv NCLICENSE /opt/netcool/common/license Netcool/Impact 3. At a command line prompt.msi by double-clicking the file in Windows Explorer. Setting the License Server Environment Variables If you are installing the License Server on a UNIX platform. Follow the on-screen prompts. Enter the following: tar -xvzf license_ver. Enter the following: . you must set the NCLICENSE and NETCOOL_LICENSE_FILE environment variables. Launch licensemgr. 3. the default location is /usr/netcool/common/license. change the current directory to the directory where the install package is located.tar. To run the License Server installer on Windows platforms: 1. NCLICENSE The NCLICENSE variable specifies the location where you installed the License Server./license_install 4.gz where ver is the version and build number of the License Server. 2.1 Administration Guide 37 .Installing the License Server To run the License Server installer on UNIX platforms: 1. The following example shows how to set NCLICENSE using sh or bash: NCLICENSE=/opt/netcool/common/license. On AIX systems. HP-UX and Red Hat Linux systems. Follow the on-screen prompts. the default location is /opt/netcool/common/license. On Solaris.

38 Netcool/Impact 3. You can use this log to verify that you have installed the License Server successfully. You can also use it to troubleshoot installation problems. By default.Chapter 2: Netcool Common License Server NETCOOL_LICENSE_FILE The NETCOOL_LICENSE_FILE specifies the location of Netcool license files on your system. The installation log contains runtime messages generated during the installation process. the GUI Server or the Security Manager by a firewall.1 Administration Guide . you should check the port usage information in Firewall Considerations on page 166 to make sure that the configuration allows access to the required ports. Reading the Installation Log The License Server installation log is named License_Manager_InstallLog. or you are running the License Server on a Windows machine with a built-in firewall. this location is $NCLICENSE/etc.log and is located in the $NCLICENSE directory. The following example shows how to set NETCOOL_LICENSE_FILE using bash or sh: NETCOOL_LICENSE_FILE=$NCLICENSE/etc The following example shows how to set NETCOOL_LICENSE_FILE using csh: setenv NETCOOL_LICENSE_PATH $NCLICENSE/etc Verifying Port Settings If the License Server is seperated from Netcool/Impact.

This file is located in the $NCLICENSE/log directory. The License Server installer automatically generates a host ID and stores it in a file named hostid.1 Administration Guide 39 . you must provide the license host ID for the system where the License Server is running. The lmhostid command is located by default in the C:\Program Files\netcool\common\license\bin directory.04 Time: 1046691321 cksum: 0024dcf3 3b25306b35266925050112110401056820544f55783721100d0e1b07043c 5054575746504c50426b2b0616055d1b6d2a505d534c4357594c41554844 535363240b0c14160407166b2517194f02101545040704110e091411174f 020d1f6b362636253e42320f1516004f44516b2a4a52564452580d596d26 090904524851515241030745525a5a0a504f505d534c4357594c41554844 5353455c52564f5654575c53555a5c516c360d51594234595551514e015b 0e0c5f0d0f1b06471d541413001602144b4d075801110707001d5064240d 5b564d31485554525e125c1a0d46050709064d105b110200130104584a13 5918190f1500175d6b2944556b243b2f6c Netcool/Impact 3.04 (15-OCT-2002 11:20:01) ---OUTPUT-BEGIN--Version: v1.Installing Licenses 2. Sample UNIX License Host ID The following example shows sample output from the nc_hostid script: nco_hostcode v1. The nc_hostid script is located in the $NCLICENSE/bin directory.6 Installing Licenses To install Netcool licenses. you do the following: • • • • Generate the license host ID Obtain the license feature codes Request the license file Copy the license file to the system Generating the License Host ID When you request a license file from Micromuse Technical Support.out. You can generate the host ID at any other time by running the nc_hostid script (UNIX platforms) or the lmhostid command (Windows platforms).

Copyright (C) 1989-2002 Macrovision Corporation The FLEXlm host ID of this machine is "0001025191c4" Obtaining License Feature Codes When you request a license file from Micromuse Technical Support. you must provide the code for each feature that you want to license. Table 5: Netcool/Impact License Feature Codes (1 of 2) Component Netcool/Impact server Netcool/Impact client Event reader Operator view ObjectServer DSA LDAP DSA Oracle DSA MySQL DSA Microsoft SQL Server DSA Flat File DSA Informix DSA DB2 DSA PostgreSQL DSA Sybase DSA Code cro_nci_server cro_nci_client cro_nci_eventreader cro_nci_opview cro_nci_objserv_dsa cro_nci_ldap_dsa cro_nci_oracle_dsa cro_nci_mysql_dsa cro_nci_freetds_dsa cro_nci_flatfile_dsa cro_nci_informix_dsa cro_nci_db2_dsa cro_nci_postgres_dsa cro_nci_sybase_dsa 40 Netcool/Impact 3.1 Administration Guide .Chapter 2: Netcool Common License Server Sample Windows Host ID The following example shows sample output from the lmhostid command: lmhostid . Netcool/Impact License Feature Codes The following table shows the license feature codes for Netcool/Impact.

Netcool/Impact 3.1 Administration Guide 41 . see Upgrading Netcool/Impact on page 91.Installing Licenses Table 5: Netcool/Impact License Feature Codes (2 of 2) Component JMS DSA Cramer Dimension DSA Vitria BusinessWare DSA XML DSA XML DSA (XML Files) Portal Infranet DSA Granite Xpercom DSA Metasolv DSA SNMP DSA Telcordia DSA Tibco TIB/Rendezvous DSA Web Services DSA Code cro_nci_dsamediator_jmssda cro_nci_dsamediator_cramer cro_nci_dsamediator_vitria cro_nci_dsamediator_xml cro_nci_dsamediator_xmlfile cro_nci_dsamediator_infranet cro_nci_dsamediator_granite cro_nci_dsamediator_metasolv cro_nci_dsamediator_snmp cro_nci_dsamediator_telcordia cro_nci_dsamediator_tibco cro_nci_webservice_dsa For more information on licensing requirements for Netcool/Impact. see the Netcool Security Manager Administration Guide. Netcool Security Manager License Feature Codes The following table shows the license feature codes for the Netcool Security Manager. Table 6: Netcool Security Manager License Feature Codes Component Netcool Security Manager Code cro_ncsm_server For more information on licensing requirements for the Netcool Security Manager.

After verifying your license request. send an e-mail to Micromuse Technical Support at support@micromuse.Chapter 2: Netcool Common License Server Requesting the License File To request a license file. If a file named license.com.lic extension before copying. You must attach the license host ID and the license feature codes to the e-mail. The License Server reads all files in the $NCLICENSE/etc directory that have the . Installing the License File Copy the license file to the $NCLICENSE/etc directory.lic. Micromuse will reply with an e-mail that contains a license file named license. 42 Netcool/Impact 3. give the license file a unique name with the .lic extension.1 Administration Guide .lic already exists.

Starting the License Server To start the License Server on UNIX platforms. see the Netcool/Impact Reference Guide. The scripts allow you to do the following: • • • • • Start the License Server View License Server status Refresh the License Server Stop the License Server View the license host ID For complete syntax and sample output from the command line scripts. you run the nc_print_license script. This script launches the License Server and causes it to read all of the license files located in the $NCLICENSE/etc directory. This script prints the server status and information on license usage to the standard output. you run the nc_read_license script. To run the nc_read_license script. This script causes the server to re-read all of the license files located in the $NCLICENSE/etc directory.Managing the License Server on UNIX 2. To run the nc_start_license script.7 Managing the License Server on UNIX The License Server provides a set of command line scripts that you can use to manage licensing on UNIX platforms. enter the following at a command line prompt: $NCLICENSE/bin/nc_start_license Viewing License Server Status To view the status of the License Server. enter the following at a command line prompt: $NCLICENSE/bin/nc_print_license Refreshing the License Server To refresh the License Server. you run the nc_start_license script.1 Administration Guide 43 . These scripts are located in the $NCLICENSE/bin directory. To run the nc_print_license script. enter the following at a command line prompt: $NCLICENSE/bin/nc_read_license Netcool/Impact 3.

To view the license host ID. you run the nc_stop_license script.1 Administration Guide . To run the nc_hostid script.Chapter 2: Netcool Common License Server Stopping the License Server To stop the License Server. To run the nc_stop_license script. You use the host ID when you request licenses from Micromuse Technical Support. enter the following at a command line prompt: $NCLICENSE/bin/nc_hostid 44 Netcool/Impact 3. enter the following at a command line prompt: $NCLICENSE/bin/nc_stop_license Viewing the License Host ID The license host ID is a unique identifier used by the License Server to identify the system where it has been installed. you run the nc_hostid script.

1 Administration Guide 45 . Click the Perform Status Enquiry button. Launch LMTOOLS from the Windows Start Menu. Click the Start Service button. 3. Viewing License Server Status on Windows To view the status of the License Server and to view information on license usage: 1. 3.8 Managing the License Server on Windows The License Server provides a program called LMTOOLS that you can use to manage licensing on Windows platforms. Launch LMTOOLS from the Windows Start Menu. 2. 2. LMTOOLS allows you to do the following: • • • • • Start the License Server View License Server status Refresh the License Server Stop the License Server View the license host ID Starting the License Server on Windows To start the License Server: 1. 3.Managing the License Server on Windows 2. Launch LMTOOLS from the Windows Start Menu. Click the ReRead License File button. Click the Server Status tab in the LMTOOLS window. 2. Refreshing the License Server on Windows To cause the License Server to re-read the license files in the license path: 1. Click the Start → Stop → Reread tab in the LMTOOLS window. Netcool/Impact 3. Click the Start → Stop → Reread tab.

3.1 Administration Guide . 2. By default. Launch LMTOOLS from the Windows Start Menu.Chapter 2: Netcool Common License Server Stopping the License Server on Windows To start the License Server: 1. 46 Netcool/Impact 3. this command is located in the C:\Program Files\netcool\common\license\bin directory. Viewing the License Host ID on Windows To view the license host ID. Click the Stop Service button. Click the Start → Stop → Reread tab in the LMTOOLS window. you run the lmhostid command from any command prompt. You can use this license host ID when you request licenses from Micromuse Technical Support.

Using the FLEXlm Command Line Tools 2. where arch is the name of the operating system where the License Server is installed. Switches to a new report log file.macrovision. Stops the FLEXlm license daemon. This guide is available from the Macrovision website at http://www. Refreshes the License Server. Switches to a new debug log file. Netcool/Impact 3. Equivalent to nc_print_license. For complete instructions on running the command line tools. FLEXlm provides the following command line tools: Table 7: Netcool Common License Server Command Line Tools Name lmdiag lmdown lmnewlog lmpath lmreread lmstat lmswitch lmswitchr lmver Description Helps you diagnose problems with checking out licenses. Equivalent to nc_stop_license.9 Using the FLEXlm Command Line Tools FLEXlm provides a set of command line tools that allow you to perform advanced administration tasks. Prints the version number of FLEXlm components. Equivalent to nc_read_license. Changes the license file path. Starts a new log file.1 Administration Guide 47 . see the FLEXlm End User’s Guide.com. The command line tools are located in the $NCLICENSE/platform/arch/bin directory. Shows the License Server status and license usage.

you must specify that the licenses are for use with a quorum configuration. Typically. you install these instances on separate systems in your environment.Chapter 2: Netcool Common License Server 2. This configuration provides failover functionality between server instances.10 Quorum Licensing This section contains information on quorum licensing.1 Administration Guide . You must also provide host IDs for each of the systems where you plan to install the License Server. You must install all instances of the License Server on systems running the same operating system. secondary and tertiary instances. you do the following: • • • Install the License Server instances Request and install quorum license files Run the License Server instances Installing License Server Instances You can install the quorum License Server instances in the same way you install a standalone License Server. it produces a single license file that you must install on all instances of the License Server in the quorum. 48 Netcool/Impact 3. The second and third instances are called secondary and tertiary instances. Requesting and Installing Quorum License Files When you request licenses from Micromuse Technical Support. There are no additional steps or special considerations. How Do I Set Up a Quorum? To set up a licensing quorum. When Micromuse processes your license request. The first instance of the License Server is called the primary instance. This license file specifies the hostnames of each of the license servers and their status as primary. Quorum licensing requires exactly three instances of the License Server. It contains the following topics: • • • What Is Quorum Licensing? How Do I Set Up a Quorum? How Do I Configure Netcool/Impact Components to Use a Quorum? What Is Quorum Licensing? Quorum licensing is a configuration in which you install multiple License Servers and configure them to act as a single server.

all other instances in the quorum are also stopped automatically. You must configure Netcool/Impact.1 Administration Guide 49 . Netcool/Impact 3.0 permanent 3 SIGN="0004 1209 \ DCFF 45AD 6F8E 8725 B9C9 AB00 270A 95E9 13D7 EB6C 1705 FBA1 \ AF0B" SIGN2="0082 BF9C FE8E CF88 48F7 EE54 1B7A 4400 437B 4665 \ 30E5 9365 CEC0 FBDB 72AE" In this license file. the Netcool GUI Server and the Netcool Security Manager.0 permanent 3 SIGN="0002 0A4A 0B3E \ C2D8 E512 0A21 619A DD00 DFC8 F26F 27EC AF6D D97C 8BA6 455B" \ SIGN2="00A7 6CE8 57FB 192D FC5B 52E2 B9DC 0800 F872 B9F6 E367 \ 06E2 0C7F 2A17 BFC6" FEATURE cro_nci_server netcool 4. When you shut down a single instance of the License Server using the nc_stop_license script or LMTOOLS. Running the License Server Instances You must start each of the License Server instances in the order specified in the license file.Quorum Licensing The following example shows a typical quorum license file. you manually edit the contents of each license properties file so that they contain the hostnames and port numbers of the License Server instances. lic_host_01 is the primary License Server instance. SERVER lic_host_01 80fda0b1 27000 SERVER lic_host_02 80fd3629 27000 SERVER lic_host_03 80fd4557 27000 VENDOR netcool USE_SERVER FEATURE cro_nci_client netcool 4.0 permanent 3 SIGN="0003 DBEB \ 5BCD D55D 82A7 DC98 8D53 FD00 3B01 2D4D F9E9 7C08 EB54 BB06 \ 5BB0" SIGN2="00A5 C4BC 1664 4D0F 58DE 323B 0997 6600 25D7 D2FF \ 8445 8C8B EF6B 03BB D490" FEATURE cro_nci_eventreader netcool 4. Note: You must explicitly specify the port used by each License Server instance in the license file. lic_host_02 is the secondary instance and lic_host_03 is the tertiary instance. regardless of whether you are using the default port (27000) or another port.0 permanent 3 SIGN="0016 7453 25FC \ DE2C 205E 6321 A77E 3700 8637 A47F 08E3 B3D5 E736 D5FD B94E" \ SIGN2="009A EBAB DA22 B1E7 2D92 DEB9 55A8 B500 6C3F EB88 26B1 \ F11D C16C 24E9 FA99" FEATURE cro_nci_eventbroker netcool 4. How Do I Configure Netcool/Impact Components to Use a Quorum? To configure Netcool/Impact components to use the quorum.

license.props and is located in the etc directory of each component installation. To edit the license properties file: 1.port@host_03 2.port@host_02.port properties.host and impact.server=port@host_01. This includes the impact. add the following property to the file: license.1 Administration Guide . the Netcool/Impact license properties file is $IMPACT_HOME/etc/license. For the Netcool GUI Server. 27000).port@host_02.props.port@host_03 where host_01. For example. 50 Netcool/Impact 3. secondary and tertiary instances of the License Server and port is the port number used by the servers (by default. For the Netcool/Impact.Chapter 2: Netcool Common License Server The license properties file is named license. add the following property to the file: impact. Remove all properties currently defined in the file.host and license. host_02 and host_03 are the primary.port or license. You must specify the License Servers in the order that they appear in the license file.license.server=port@host_01.license.

The Add/Remove Programs tool uninstalls the License Server. select Control Panel → Add/Remove Programs. 2. all of the program files are copied to the $NCLICENSE directory. you should copy any license files to a safe location before uninstalling.Uninstalling the License Server 2. If you plan to reinstall the License Server.11 Uninstalling the License Server This section contains information on uninstalling the License Server on UNIX and Windows platforms. You can safely uninstall the License Server by deleting this directory and all its contents. In the Start Menu. which deletes the program files from the file system and removes License Server information from the Windows registry file. Select Netcool License Server from the list of installed applications and click Remove. This tool launches the License Server uninstaller. Netcool/Impact 3. enter the following at a command line prompt: rm -rf $NCLICENSE Uninstalling on Windows You can uninstall the License Server on Windows platforms by using the Add/Remove Programs tool in the Windows Control Panel.1 Administration Guide 51 . To uninstall the License Server: 1. Uninstalling on UNIX When you install the License Server on UNIX platforms. To uninstall the License Server. You must shut down the License Server before you attempt to uninstall.

Chapter 2: Netcool Common License Server 52 Netcool/Impact 3.1 Administration Guide .

2004 10:15 am This chapter contains information about the Netcool GUI Server 2.1 Administration Guide 53 . It contains the following sections: • • • • • • • • • • • About the GUI Server on page 54 System Requirements on page 56 GUI Server Components on page 58 GUI Server Architecture on page 59 Installing the GUI Server on page 60 Licensing the GUI Server on page 63 Running the GUI Server on page 65 Configuring the GUI Server on page 66 Registry Clustering on page 68 GUI Server Logging on page 77 Uninstalling the GUI Server on page 78 Netcool/Impact 3.0.fm December 15.Chapter 3: Netcool GUI Server 03_GUI_Server.

On UNIX platforms. For more information. The GUI Server consists of the Servlet Engine and the Netcool Application Registry.1 About the GUI Server This section contains overview information about the Netcool GUI Server. you can change its configuration at any time by manually editing its properties files. you must set the required environment variables after installation. see GUI Server Components on page 58. For more information. you must first obtain the installation files from the Micromuse Product CD-ROM or as a download from the Micromuse Support Site. To install the GUI Server. The installer sets all of the required configuration properties. 54 Netcool/Impact 3. How Do I Set Up the GUI Server? Before you set up the GUI Server. The installer creates an installation log that you can view to see if the process completed successfully. It contains the following topics: • • • • • What Is the GUI Server? How Do I Set Up the GUI Server? How Do I Run the GUI Server? Can I Run the GUI Server Under Process Control? How Do I Administer the GUI Server? What Is the GUI Server? The GUI Server is a standalone server application that hosts web-based graphical user interfaces for Netcool/Impact and other products in the Netcool suite. The installation files include the Netcool GUI Server installer and a README file.1 Administration Guide . you run the installer program and follow the on-screen prompts. You must install and configure the GUI Server before you install Netcool/Impact. see Installing the GUI Server on page 60.Chapter 3: Netcool GUI Server 3. After you have installed the GUI Server.

you can read the GUI Server log. How Do I Run the GUI Server? On UNIX platforms. you specify the hostname and port for this license server. Netcool/Impact 3.1 Administration Guide 55 . When you install the GUI Server. The GUI Server runs as a “non-pa aware” application. see Running the GUI Server on page 65. Can I Run the GUI Server Under Process Control? You can run the GUI Server under process control with no special considerations. To check the status of the GUI Server. How Do I Administer the GUI Server? After you have started the GUI Server.About the GUI Server How Do I License the GUI Server? The GUI Server requires a Netcool/Impact client license for each user account that is used to access Netcool/Impact via the web-based interface. see GUI Server Logging on page 77. For more information. For more information. For more information. you start and stop the GUI Server using the Windows Services administration tools. You must obtain the required licenses and install them in your license server before running Netcool/Impact as an application instance in the GUI Server. it requires no additional real-time administration. see Licensing the GUI Server on page 63. you start and stop the GUI Server using the administration scripts. On Windows platforms.

Red Hat Linux and Microsoft Windows platforms.2) Hewlett-Packard HP-UX 11.2 System Requirements Make sure that the target system fulfills the following requirements before installing the Netcool GUI Server.0 Microsoft Windows 2000 Server.com/products1/unix/java. Installing the Java Runtime Environment (JRE) alone is not sufficient.0. License Server Compatibility The GUI Server is compatible with the Netcool Common License Server 1. Note: On AIX and HP-UX platforms.0b21 or later.ibm. Windows XP and Windows 2003 Server IBM AIX 5L (5. Red Hat no longer officially supports version 9. the J2SDK is installed automatically when you install the GUI Server.11 Note: If you intend to install the GUI Server on a Linux platform. Micromuse recommends that you use Red Hat Enterprise Server 3.Chapter 3: Netcool GUI Server 3.com/java. Platform Support The GUI Server is supported on the following platforms: • • • • • Sun Microsystems Solaris 7. On Solaris.1 Administration Guide .4. you must download and install the entire J2SDK. You can obtain the J2SDK for HP-UX from the Hewlett-Packward website at http://www.x of the Java 2 Software Development Kit (J2SDK). On AIX and HP-UX platforms.0 and Enterprise Server 3.hp. you must download and install a compatible version separately from the GUI Server. You do not have to install the J2SDK independently of the software. 8 and 9 Red Hat Linux 9. Java Support The GUI Server requires version 1. 56 Netcool/Impact 3. You can obtain the J2SDK for AIX from the IBM website at http://www.0.1 and 5.

2 for user authentication.1 or 1. You must read the full text of the license agreement and accept the terms of the agreement before installing this software. Netcool/Impact 3. Web Browser Support The Netcool/Impact GUI runs on the following web browsers: • • • Microsoft Internet Explorer 5. contact your Micromuse account manager or Micromuse Technical Support. For recommendations on hardware sizing for the GUI Server.5 and later Netscape 6 and later Mozilla 1. the license agreement text displayed by the installer program is not legible when viewed inside Exceed. Exceed Limitations Micromuse does not recommend the use of Hummingbird Exceed with the GUI Server installer program.1 Administration Guide 57 . Under some conditions.7 and later Hardware Requirements Hardware requirements for the GUI Server vary depending on your environment.System Requirements Security Manager Requirements The GUI Server requires Netcool Security Manager 1.

1. the registry is configured at installation to run in the servlet engine. The Servlet Engine incorporates Apache Tomcat servlet technology. The GUI Server uses the information stored in the registry when brokering HTTP requests between end users’ web browsers and the applications. By default.Chapter 3: Netcool GUI Server 3.apache. Netcool applications that use the GUI Server register with the Application Registry at startup. Note: The registry is a set of Java servlets that can be run in any J2EE servlet container. see the Tomcat website at http://jakarta.org/tomcat. The version of Tomcat used in the Servlet Engine is 4. The registry is also used by Netcool/Impact and the Netcool Security Manager to store information used in server clustering.3 GUI Server Components The GUI Server has the following components: • • Servlet Engine Application Registry Servlet Engine The Servlet Engine is a runnable HTTP server application that hosts web-based Netcool user interfaces and brokers requests between end users’ web browsers and Netcool applications. 58 Netcool/Impact 3. For more information. Application Registry The Netcool Application Registry is a component that provides application registration functionality to the GUI Server.1 Administration Guide . You do not need to start and stop the registry separately from the servlet container.

4 GUI Server Architecture The following figure shows the Netcool GUI Server architecture.1 Administration Guide 59 .GUI Server Architecture 3. Web Browser Internet o r Intranet Netcool/ Impact Netcool GUI Server Other Netcool Products Netcool Security Manager Figure 4: Netcool GUI Server Architecture Netcool/Impact 3.

4. You can run the installer as any other user that has read. the installer prompts you for required information from the command line. where build is the build number of the software and arch is the name of the operating system. You can run the installer in GUI mode or in console mode. you must download and install a compatible version of the Java 2 Development Kit (J2SDK) before you install the GUI Server. write and execute permissions to the target directory. You must download and install the entire J2SDK. The GUI Server is compatible with versions 1. 60 Netcool/Impact 3.com/products1/unix/java. The installer is named guiserverbuildarch. If you are installing the GUI Server remotely using telnet or another command line application. In GUI mode.ibm. you must run the installer in console mode. In console mode. The JRE alone is not sufficient.bin. you do the following: • • • • Install the Java Development Kit (AIX and HP-UX only) Run the GUI Server installer Set the GUI Server environment variables (UNIX platforms only) Verify firewall port settings After you have finished installing the GUI Server. Installing the Java Development Kit (AIX and HP-UX Only) If you are installing the GUI Server on AIX or HP-UX. the installer presents a series of graphical dialog boxes that guide you through the installation process.5 Installing the GUI Server To install the GUI Server. You can download the J2SDK for HP-UX from the Hewlett-Packard website at http://www.x of the J2SDK. you can read the installation log to verify that the software has been installed correctly. You can download the J2SDK for AIX from the IBM website at http://www. Micromuse recommends that you do not install the GUI Server as the root user.com/java. or to troubleshoot installation errors. Running the GUI Server Installer The GUI Server installer copies the program files to the target system and sets the minimum required configuration properties.1 Administration Guide .Chapter 3: Netcool GUI Server 3.hp.

Default is 27000. Default is 8080. Netcool/Impact 3./guiserver.bin -i console 2. Default is localhost. Application Registry directory Shutdown port HTTP port Shutdown port used internally by the Servlet Engine. Follow the on-screen prompts. Directory where you want to install the Netcool Application Registry./guiserver.bin To run the installer in console mode. Home directory of the J2SDK installed on the file system. Default is /opt/netcool/guiserver on UNIX platforms and C:\Program Files\Netcool\Guiserver on Windows. To run the installer in GUI mode. Port used by the Security Manager.1 Administration Guide 61 . Default is localhost. To run the GUI Server installer: 1. you use this HTTP port. AIX and HP-UX installs only. If you want to set up a registry cluster. enter the following: . change the current directory to the directory where the installer is located. enter the following: . Security Manager host Security Manager port License Server host License Server port Java home directory Note: By default. Default is 8077. 3. Hostname or IP address of the system where the Netcool Security Manager is located. Hostname or IP address of the system where the License Server is running. HTTP port used by the Servlet Engine.Installing the GUI Server The GUI Server installer prompts you for the following information: Table 8: Netcool GUI Server Installer Prompts Prompt Installation directory Description Directory where you want to install the GUI Server. Port used by the License Server. When you log into Netcool/Impact or the Security Manager via a web browser. Default is 8005. you must perform the additional steps described in Registry Clustering on page 68. At a command line prompt. the installer configures the GUI Server to install and use a single instance of the Netcool Application Registry.

0_Install_Log. You can also use it to troubleshoot installation problems. or you are running the GUI Server on a Windows machine with a built-in firewall. this directory is opt/netcoool/guiserver. Reading the Installation Log The GUI Server installation log is named Netcool_GUI_Server_2. the Security Manager or the License Server by a firewall. you must set the GUI_HOME environment variable to the directory where you installed the application. 62 Netcool/Impact 3.1 Administration Guide . You can use this log to verify that you have installed the GUI Server successfully. export GUI_HOME The following example shows how to set GUI_HOME using csh: setenv GUI_HOME /opt/netcool/guiserver Verifying Port Settings If the GUI Server is seperated from Netcool/Impact.Chapter 3: Netcool GUI Server Setting the GUI Server Environment Variables If you are installing the GUI Server on a UNIX platform. By default. The following example shows how to set GUI_HOME using sh or bash: GUI_HOME=/opt/netcool/guiserver. The installation log contains runtime messages generated during the installation process.log and is located in the $GUI_HOME directory. you should check the port usage information in Firewall Considerations on page 166 to make sure that the configuration allows access to the required ports.

Default is 27000.server. you must stop and restart the GUI Server before the change takes effect. you muse manually edit the contents of the license properties file so that it contains the hostnames and port numbers of the License Server instances. The license feature code for client licenses is nci_client.props and is located in the $GUI_HOME/etc directory. It contains information on: • • • Licensing requirements Configuring licensing Quorum licensing Licensing Requirements The GUI Server requires a Netcool/Impact client license for each user account that is used to access Netcool/Impact via the web-based interface.Licensing the GUI Server 3. However. The licensing properties are set automatically when you install the GUI Server.host Description Hostname or IP address of the license server to be used by the GUI Server. Netcool/Impact 3.server.port Quorum Licensing To use the GUI Server with a quorum licensing configuration. If you manually edit the properties file.1 Administration Guide 63 . Configuring Licensing Licensing properties are located in the license properties file. This file is named license. Port of the license server to be used by the GUI Server. license. The following table shows the license properties for the GUI Server: Table 9: Netcool GUI Server License Properties Property license. Default is localhost.6 Licensing the GUI Server This section contains information on licensing the GUI Server. you can manually edit the license properties file at any time to change the configuration. You must obtain the required licenses and install them in your license server before running Netcool/Impact as an application instance in the GUI Server.

host and license. You must specify the License Servers in the order that they appear in the license file. For more information on quorum licensing. where host_01. see Quorum Licensing on page 48.port properties. Add the following property to the file: license. 27000).1 Administration Guide .port@host_03 2. host_02 and host_03 are the primary. 64 Netcool/Impact 3. secondary and tertiary instances of the License Server and port is the port number used by the servers (by default. This includes the license. Remove all properties currently defined in the file.Chapter 3: Netcool GUI Server To edit the license properties file: 1.port@host_02.server=port@host_01.

This script is named ncgui_shutdown and is located in the $GUI_HOME/bin directory. In the Start Menu. In the Services window that opens. In the Services window that opens. Starting the GUI Server on UNIX You start the GUI Server by running the startup script. Stopping the GUI Server on Windows To stop the GUI Server: 1. select Control Panel / Administrative Tools / Services. enter the following at a command prompt: $GUI_HOME/bin/ncgui_server Stopping the GUI Server on UNIX You stop the GUI Server by running the shutdown script. In the Start Menu. Netcool/Impact 3. This script is named ncgui_server and is located in the $GUI_HOME/bin directory. 2. To stop the GUI Server. 2.1 Administration Guide 65 . right-click on Netcool GUI Server and select Stop.7 Running the GUI Server This section contains information on starting and stopping the GUI Server on UNIX and Windows platforms. select Control Panel / Administrative Tools / Services.Running the GUI Server 3. right-click on Netcool GUI Server and select Start. enter the following at a command prompt: $GUI_HOME/bin/ncgui_shutdown Starting the GUI Server on Windows To start the GUI Server: 1. To start the GUI Server.

This properties file contains information in XML format for the Tomcat servlet technology incorporated into the GUI Server. The following table shows the authentication properties for the GUI Server.org/tomcat.host security.apache. Port used by the Security Manager.xml and is located in the $GUI_HOME/etc directory. You must stop and restart the GUI Server in order for configuration changes to take effect. Maintained for backward compatibility only. Configuring Authentication Authentication properties for the GUI Server are located in the server properties file. Configuring the Servlet Engine Configuration properties for the Servlet Engine are located in the servlet properties file.Chapter 3: Netcool GUI Server 3. Table 11 shows the registry properties for Netcool/Impact: Table 11: Netcool/Impact Registry Properties (1 of 2) Propery impact. This file is named server.props and is located in the $GUI_HOME/etc directory. Table 10: Netcool GUI Server Authentication Properties Property security.userid Description Registry login username. This file is named server.registry. see the Apache Tomcat documentation at http://jakarta. Configuring the Registry The configuration properties for the Netcool Application Registry are located in the registry properties file. 66 Netcool/Impact 3. This file is named registry.port Description Hostname or IP address of the system where the Security Manager is located. You should only modify this file under the supervision of Micromuse Technical Support.props and is located in the $GUI_HOME/etc directory. For more information on the servlet properties file.8 Configuring the GUI Server You can configure GUI Server components at any time after installation by manually editing their properties files.1 Administration Guide . Default is admin.

registry. Port used.1 Administration Guide 67 . where # is an index value that identifies the registry instance.registry.location For more information on registry properties.host impact. This is the HTTP port used by the GUI Server or Tomcat. Hostname of the registry instance.port impact.registry. Netcool/Impact 3.count impact. Default is /registry/services.password Description Registry login password. see Registry Clustering on page 68. impact. where # is an index value that identifies the registry instance.Configuring the GUI Server Table 11: Netcool/Impact Registry Properties (2 of 2) Propery impact.#. Number of registry instances in the cluster.registry. which have 8080 as defaults.#. Default is netcool. Maintained for backward compatibility only. URL location on servlet container where registry is installed.registry.#. where # is an index value that identifies the registry instance.

9 Registry Clustering This section contains information on registry clustering. The secondary registries are responsible for providing failover functionality for the primary registry. Clustering prevents the registry from acting as a single point of failure in a Netcool/Impact installation. It stores information about which instances of these components are running and where they are located on the network.Chapter 3: Netcool GUI Server 3. The primary registry is the component responsible for communicating in real time with Netcool components like Netcool/Impact. 68 Netcool/Impact 3.1 Administration Guide . It contains the following topics: • • • • • • What Is Registry Clustering? What Are the Clustering Components? How Do I Set Up Registry Clustering? How Do I Run the Registry Cluster? How Does Registry Clustering Work? How Do I View Registry Status? What Is Registry Clustering? Clustering is a feature that allows you to install multiple instances of the Netcool Application Registry and configure them to provide failover capability. the Netcool GUI Server and the Netcool Security Manager. except in the case that the primary registry fails and a secondary registry assumes the role of the primary. They do not communicate with the Netcool applications in real time. What Are the Clustering Components? A registry cluster consists of a primary registry and one or more secondary registries.

For Tomcat. To configure the registry instances. Installing the Registries The next step in setting up clustering is to install the registry in each J2EE servlet container.1 Administration Guide 69 .xml file.apache. you must edit the web. easily-configurable platform for the registry. If you are installing for use with Tomcat. The installer prompts you whether to install the GUI Server. Netcool/Impact. You can run the registry with any J2EE servlet container. you do the following: • • • • Install two or more instances of a J2EE servlet container on systems in your environment Install the registry in the J2EE container applications Configure the registry Configure the Netcool applications that use the registry (for example.org/tomcat.xml file so that it contains a set of property settings for each registry in the cluster. you must specify the directory where you want the registry to reside. If you are installing the registries for use with the GUI Server. where $CATALINA_HOME is the directory where Tomcat is installed. see http://jakarta. choose to install the registry as a standalone component. this path must be $GUI_HOME/app3p/tomcat/webapps. Netcool/Impact 3. the Netcool GUI Server and the Netcool Security Manager) Installing J2EE Servlet Containers The first step in setting up clustering is to install two or more instances of a J2EE servlet container on systems in your environment. Each registry must be configured in the exact same way. For the GUI Server this file is in the $GUI_HOME/app3p/tomcat/webapps/registry/WEB-INF directory. For more information on Tomcat. During installation. Micromuse recommends that you use Tomcat for scenarios in which you require a lightweight.Registry Clustering How Do I Set Up Registry Clustering? To set up registry clustering. If you are installing for use with Tomcat. Supported containers include the Netcool GUI Server and the standalone Tomcat server. You install the registry using the standard GUI Server installer. Configuring the Registries Clustering configuration properties for the registry instances are located in the web. this file is in the $CATALINA_HOME/webapps/registry/WEB-INF directory. the registry or both. this path must be $CATALINA_HOME/webapps.

1 Administration Guide . REPLICANT. starting with zero.#. which have 8080 as defaults. which is the default. Index value that identifies this registry cluster. URL location on servlet container where registry is installed. You must specify index values as a series. Default is /regsitry/services. Specifies whether the registry should cache its state information to disk at shutdown and read cached information at startup. This is the directory you specified when you installed the registry. Hostname of the registry instance. This is the HTTP port used by the GUI Server or Tomcat.HOST Description Number of registries in the cluster. where # is an index value that identifies the registry instance. Port used. where # is an index value that identifies the registry instance.Chapter 3: Netcool GUI Server Table 12 shows the clustering properties: Table 12: Registry Clustering Properties Property REPLICANT.COUNT REPLICANT.LOCATION SELFINDEX PERSIST_ENABLED PERSIST_PATH 70 Netcool/Impact 3.#. Default is $GUI_HOME/webapps/registry.PORT REPLICANT. Specifies the directory where state information is cached.#. Micromuse recommends settings this property to true. Can be true or false. where # is an index value that identifies the registry instance.

LOCATION</param-name> <param-value>/registry/services</param-value> </context-param> <context-param> <param-name>SELFINDEX</param-name> <param-value>0</param-value> </context-param> Netcool/Impact 3.COUNT</param-name> <param-value>3</param-value> </context-param> <context-param> <param-name>REPLICANT.HOST</param-name> <param-value>registry_host_02</param-value> </context-param> <context-param> <param-name>REPLICANT.Registry Clustering The following example shows typically settings for these properties in a clustering scenario with three registry instances: <context-param> <param-name>REPLICANT.PORT</param-name> <param-value>8080</param-value> </context-param> <context-param> <param-name>REPLICANT.PORT</param-name> <param-value>8080</param-value> </context-param> <context-param> <param-name>REPLICANT.HOST</param-name> <param-value>registry_host_03</param-value> </context-param> <context-param> <param-name>REPLICANT.PORT</param-name> <param-value>8080</param-value> </context-param> <context-param> <param-name>REPLICANT.HOST</param-name> <param-value>registry_host_01</param-value> </context-param> <context-param> <param-name>REPLICANT.LOCATION</param-name> <param-value>/registry/services</param-value> </context-param> <context-param> <param-name>REPLICANT.1 Administration Guide 71 .LOCATION</param-name> <param-value>/registry/services</param-value> </context-param> <context-param> <param-name>REPLICANT.

where # is an index value that identifies the registry instance. This file is located in the etc directory of the component installation.registry prefix. Port used. Maintained for backward compatibility only.1 Administration Guide .props file for each component to view property names in the correct format.xml file.registry. where # is an index value that identifies the registry instance. Note: Property names differ depending on whether you are configuring Netcool/Impact or you are configuring another component. the Netcool Security Manager and any other Netcool components that use the registry cluster.userid Description Registry login username. As with the clustering properties in the web. Registry properties for other components begin with the registry prefix.password impact.#.registry.registry.registry. See the default values in the registry. Registry configuration properties for Netcool components are located in the registry. impact. Registry properties for Netcool/Impact begin with the impact. the Netcool GUI Server. Default is netcool. Maintained for backward compatibility only. Table 13 shows the registry properties for Netcool/Impact: Table 13: Netcool/Impact Registry Clustering Properties Propery impact. Default is /registry/services.#. you must configure Netcool/Impact.host impact. Registry login password. URL location on servlet container where registry is installed. Default is admin. where # is an index value that identifies the registry instance.port impact. This directory is $IMPACT_HOME/etc for Netcool/Impact.#. $GUI_HOME/etc for the GUI Server and $NCSM_HOME/etc for the Netcool Security Manager. Hostname of the registry instance.location 72 Netcool/Impact 3.props file. This is the HTTP port used by the GUI Server or Tomcat. Number of registry instances in the cluster.Chapter 3: Netcool GUI Server Configuring the Netcool Applications After you have configured the registry instances.registry. which have 8080 as defaults. you must specify a set for each registry in the cluster.count impact.registry.

Default is netcool. Default is admin.userid Description Registry login username.#. where # is an index value that identifies the registry instance. Maintained for backward compatibility only.Registry Clustering Table 14 shows the registry properties for the GUI Server and the Security Manager: Table 14: Netcool GUI Server and Netcool Security Manager Clustering Properties Propery registry.1 Administration Guide 73 .count registry.location Netcool/Impact 3. Default is /registry/services. URL location on servlet container where registry is installed.#. Registry login password.host registry. Hostname of the registry instance. registry.password registry. This is the HTTP port used by the GUI Server or Tomcat. Number of registry instances in the cluster. where # is an index value that identifies the registry instance.port registry. Maintained for backward compatibility only. Port used. where # is an index value that identifies the registry instance.#. which have 8080 as defaults.

0.1 Administration Guide .1. If registry instances are part of a GUI Server installation.1.1.168.registry.host=192.1.registry.count=3 impact.0.props file for Netcool/Impact: impact.168.2.props file for the GUI Server or Security Manager: impact.Chapter 3: Netcool GUI Server The following example shows a typical registry.registry.registry.registry.2.1.host=192.registry.registry.location=/registry/services impact.password=netcool impact.registry.registry.registry.1.121 impact.1.registry.registry.registry. The command to start Tomcat is $CATALINA_HOME/bin/startup.168.122 impact.121 impact.registry.port=8890 impact.port=8888 impact.port=8889 impact.registry. You can start the servlet container applications in any order.2.2.0.168.registry.port=8888 impact.1.0.location=/registry/services impact.2.registry.1.userid=admin impact.registry.registry.count=3 impact.port=8889 impact.120 impact.password=netcool impact.host=192.1. you can start the instances using the standard GUI Server startup script.location=/registry/services How Do I Run a Registry Cluster? To run a registry cluster.0.registry. 74 Netcool/Impact 3.host=192.0.1.registry.port=8890 impact.registry. This script is called ncgui_server and is located in the $GUI_HOME/bin directory.location=/registry/services impact.location=/registry/services impact.userid=admin impact.registry.168.120 impact.host=192.registry.122 impact.location=/registry/services The following example shows a typical registry.sh.2.1. start each J2EE servlet container where the registry is installed.168.host=192.

it does one of the following: • If the member is the primary registry instance. it forwards the command to the primary without executing it. Runtime During runtime. Netcool/Impact 3.xml file. The other registries then execute the command and update their registration information. it will execute the command and then publish the command to every other registry in the cluster.1 Administration Guide 75 . • Failure and Recovery When a cluster member fails. When a cluster member recovers. the cluster member queries the other cluster members at intervals to determine their status and to synchronize registry data between them. each registry cluster member reads the ordered cluster member list and its position on that list from its web.Registry Clustering How Does Registry Clustering Work? The clustering process has the following phases: • • • • • Startup Runtime Command Replication Failure and Recovery Shutdown Startup At startup. the other members detect the recovery and notify it that it needs to re-synchronize its registry data. When a cluster member receives such a command. Once a failure has been detected. the other members detect the failure during normal runtime operation. the other members update their clustering information and do not attempt to synchronize data with the failed member. The primary then executes the command as described above. Command Replication When you start and stop Netcool/Impact and the Netcool Security Manager. If the member is not the primary registry instance. The registry stores this information internally and uses it to determine its behavior during runtime. they issue registration and un-registration commands to the registry cluster members.

If PERSIST_ENABLED is set to true.xml file.1 Administration Guide . This tool displays the currently-defined registry instances and whether they are running or stopped. 76 Netcool/Impact 3. The URL of this tool is http://host:port/registry/services. This information is then read by the cluster member at startup. it saves its registry information in the directory specified by the PERSIST_PATH property. How Do I View Registry Status? The GUI Server provides a web-based tool that you can use to view the status of registry instances. it determines whether to save its registry information to disk by reading the PERSIST_ENABLED property in the web. where host is the hostname of the system where the GUI Server is installed and port is the GUI Server port.Chapter 3: Netcool GUI Server Shutdown When you shut down a cluster member.

xml file to provide additional logging information for the Netcool Application Registry.log Description Used by programs that run as application instances in the GUI Server (for example.timestamp. Enalbes logging of ping messages sent to other registry instances at intervals. The GUI Server provides the following log files: Table 15: GUI Server Log Files Log File netcoolguiserver. GUI Server log files are located in the $GUI_HOME/log directory. the files are located in the %GUI_HOME%\app3p\tomcat\logs directory.10 GUI Server Logging On UNIX platforms.GUI Server Logging 3. ENABLE_PING_LOGGING Netcool/Impact 3. Used by the Application Registry. where timestamp reflects the time the GUI Server was started. localhost_registry_timestamp.1 Administration Guide 77 . Enables logging of requests and responses sent and received by the registry.txt You can set properties in the web. Table 16 shows the logging properties in web.log localhost_log. Used to record messages generated by the default GUI context. On Windows platforms.xml. Table 16: Application Registry Logging Properties Property ENABLE_GENERAL_LOGGING ENABLE_REQUEST_LOGGING Description Enables general logging output from the registry. Netcool/Impact and the Netcool Security Manager).

bat 78 Netcool/Impact 3. all of the program files are copied to the $GUI_HOME directory. You must shut down the GUI Server before you attempt to uninstall. To uninstall the GUI Server. You can safely uninstall the GUI Server by deleting this directory and all its contents.11 Uninstalling the GUI Server This section contains information on uninstalling the GUI Server on UNIX and Windows platforms. This batch file is named uninstall. To uninstall the GUI Server.1 Administration Guide .Chapter 3: Netcool GUI Server 3.bat and is located by default in the C:\Program Files\netcool\guiserver\UninstallerData directory. enter the following at a command line prompt: rm -rf $GUI_HOME Uninstalling on Windows You uninstall the GUI Server on Windows platforms by running the uninstaller batch file. Uninstalling on UNIX When you install the GUI Server on UNIX platforms. enter the following at a command prompt: cd C:\Program Files\netcool\guiserver\UninstallerData uninstall.

fm December 15.Chapter 4: Netcool/Impact 04_Impact. 2004 10:15 am This chapter contains information on Netcool/Impact.1 Administration Guide 79 . It contains the following sections: • • • • • • • • • • • About Netcool/Impact on page 80 System Requirements on page 83 Netcool/Impact Components on page 85 Netcool/Impact Architecture on page 87 Installing Netcool/Impact on page 88 Upgrading Netcool/Impact on page 91 Licensing Netcool/Impact on page 95 Configuring Registry Settings on page 98 Configuring Authentication on page 99 Backing Up and Restoring Netcool/Impact on page 100 Uninstalling Netcool/Impact on page 101 Netcool/Impact 3.

Netcool/Impact allows you to extensively customize and enhance Netcool/OMNIbus and other Netcool products by adding such functionality as advanced event and business data correlation. It contains the following topics: • • • • • • What Is Netcool/Impact? What Are the Netcool/Impact Components? How Do I Set Up Netcool/Impact? How Do I License Netcool/Impact? How Do I Configure Netcool/Impact? How Do I Manage Netcool/Impact? What Is Netcool/Impact? Netcool/Impact is the analysis and correlation engine for the Netcool suite of network management products.Chapter 4: Netcool/Impact 4. What Are the Netcool/Impact Components? Netcool/Impact has the following components: • • • • • • • Netcool/Impact server Netcool/Impact database Netcool/Impact DSAs Netcool/Impact CVS Netcool/Impact JRExec server Netcool/Impact Operator View Netcool/Impact GUI For more information. In addition.1 About Netcool/Impact This section contains overview information about Netcool/Impact.1 Administration Guide . see Netcool/Impact Components on page 85 80 Netcool/Impact 3. event enrichment and event notification. you can use Netcool/Impact to integrate Netcool/OMNIbus with a wide variety of third party software. messaging systems and network inventory applications. including databases.

1 Administration Guide 81 . For more information. see Installing Netcool/Impact on page 88. After you have installed Netcool/Impact. How Do I Configure Netcool/Impact? Netcool/Impact provides two sets of properties files. The URL for the Micromuse Technical Support website is http://support. The installation files include the Netcool/Impact installer and a README file. you specify the host and port for this license server.com. On UNIX platforms. To install Netcool/Impact. Netcool/Impact 3. you run the installer and follow the on-screen prompts. When you install Netcool/Impact. The server properties files control configuration settings for each instance of the Netcool/Impact server.micromuse. For more information. see Upgrading Netcool/Impact on page 91. The global properties files control configuration settings for all instances of the Netcool/Impact server in a configuration. you must first obtain the installation files from the Micromuse Product CD-ROM or as a download from the Micromuse Technical Support website. you must set the required environment variables after installation.About Netcool/Impact How Do I Set Up Netcool/Impact? Before you set up Netcool/Impact. The installer sets all of the required configuration properties. How Do I License Netcool/Impact? Netcool/Impact requires the following licenses: • • • • • Netcool/Impact server license Netcool/Impact client licenses Netcool/Impact Operator View licenses Netcool/Impact event reader license Netcool/Impact DSA licenses You must obtain the required licenses and install them in your license server before running Netcool/Impact. The installer creates an installation log that you can view to see if the process completed succesfully. you can change its configuration at any time by manually editing its properties files.

policies and services. 82 Netcool/Impact 3. You can also use these tools to manage other aspects of Netcool/Impact.Chapter 4: Netcool/Impact How Do I Manage Netcool/Impact? Netcool/Impact provides a web-based GUI and a telnet-enabled CLI that you can use to perform all of the required administration tasks.1 Administration Guide . such as data types. Netcool/Impact also provides a set of logs that you can read to view the status of components or to troubleshoot problems.

1 or 1.0. Security Manager Requirements Netcool/Impact 3.1 is supported on the following platforms: • • • • • Sun Microsystems Solaris 7.0b21 or later.1 is compatible with the Netcool Common License Server 1.1 requires version 1.1 and 5. The JRE is installed automatically when you install Netcool/Impact. 8 and 9 Red Hat Linux 9. GUI Server Requirements Netcool/Impact 3.1 requires version 2. You do not need to install the JRE independently.1 Administration Guide 83 .0 of the Netcool GUI Server.System Requirements 4.1 requires Netcool Security Manager 1. Red Hat no longer officially supports version 9.4.2) Hewlett-Packard HP-UX 11.11 Note: If you intend to install Netcool/Impact on a Linux platform. Netcool/Impact 3. Micromuse recommends that you use Red Hat Enterprise Server 3. Windows XP and Windows 2003 Server IBM AIX 5L (5. Java Support Netcool/Impact 3.2 for user authentication.2 System Requirements Make sure that the target system fulfills the following requirements before installing Netcool/Impact. Platform Support Netcool/Impact 3.0 and Enterprise Server 3. License Server Compatibility Netcool/Impact 3.0 Microsoft Windows 2000 Server.0.x of the Java 2 Runtime Environment (JRE).

Chapter 4: Netcool/Impact

Web Browser Support
The Netcool/Impact GUI runs on the following web browsers: • • • Microsoft Internet Explorer 5.5 and later Netscape 6 and later Mozilla 1.7 and later

Netcool/OMNIbus Support
Netcool/Impact 3.1 supports Netcool/OMNIbus versions 3.5, 3.6, and v7.

Hardware Requirements
Hardware requirements for Netcool/Impact vary depending on your environment. For recommendations on hardware sizing for Netcool/Impact, contact your Micromuse account manager or Micromuse Technical Support.

Exceed Limitations
Micromuse does not recommend the use of Hummingbird Exceed with the Netcool/Impact installer program. Under some conditions, the license agreement text displayed by the installer program is not legible when viewed inside Exceed. You must read the full text of the license agreement and accept the terms of the agreement before installing this software.

84

Netcool/Impact 3.1 Administration Guide

Netcool/Impact Components

4.3

Netcool/Impact Components
Netcool/Impact has the following components: • • • • • • • Netcool/Impact server Netcool/Impact database Netcool/Impact DSAs Netcool/Impact CVS Netcool/Impact JRExec server Netcool/Impact Operator View Netcool/Impact GUI

Netcool/Impact Server
The Netcool/Impact server is the primary component of Netcool/Impact. It consists of a collection of sub-components, called services, that perform the core functionality of the product. It also provides the mechanisms for creating and managing a Netcool/Impact data model and for creating and managing Netcool/Impact policies. In addition, the Netcool/Impact server hosts the web-based GUI. On UNIX platforms, the Netcool/Impact server is a runnable application that you can start and stop using the server administration scripts. On Windows platforms, the Netcool/Impact server runs as a Windows service that you can start and stop using the Windows Services Administration tools.

Netcool/Impact Database
The Netcool/Impact database is a customized and pre-configured version of PostgreSQL. Netcool/Impact uses this database to store information related to its internal reporting features. You can also use this database as a built-in SQL database data source. On UNIX platforms, the Netcool/Impact database is started and stopped automatically when you start and stop Netcool/Impact. You do not have to run the database independently of the Netcool/Impact server. On Windows platforms, the database runs as a Windows service that you can start and stop using the Windows Services Administration tools. For more information, see Chapter 8: Netcool/Impact Database on page 125.

Netcool/Impact 3.1 Administration Guide

85

Chapter 4: Netcool/Impact

Netcool/Impact DSAs
Netcool/Impact Data Source Adaptors (DSAs) provide the interface between Netcool/Impact and external data sources. Netcool/Impact has a wide variety of DSAs that allow you to integrate SQL databases, LDAP directory services and many third party applications with your Netcool installation.

Netcool/Impact CVS
Netcool/Impact CVS is a customized version of the Concurrent Versions System (CVS). Netcool/Impact CVS is installed automatically when you install Netcool/Impact. You can use this version of CVS to provide version control functionality to Netcool/Impact, or you can use an alternate system.

Netcool/Impact JRExec Server
The Netcool/Impact JRExec server is a server component that allows Netcool/Impact to run external commands, scripts and applications from within a policy. You must start and stop the JRExec server independently of the Netcool/Impact Server. On UNIX platforms, the JRExec server is a runnable server application that you start using the JRExec server script. On Windows platforms, the JRExec server runs as a Windows service that you can start and stop using the Windows Services Administration tools.

Netcool/Impact Operator View
The Netcool/Impact Operator View is a web-based tool that you can use to launch policies and view their results from within Netcool/OMNIbus and other applications. You create and manage the Operator View using the Netcool/Impact GUI.

Netcool/Impact GUI
The Netcool/Impact GUI is a web-based graphical user interface that you can use to manage Netcool/Impact data sources, data types, policies and services. You can also use the GUI to view performance data about Netcool/Impact and to design Netcool/Impact Operator Views. The Netcool/Impact User Interface Guide contains complete instructions using the Netcool/Impact GUI.

86

Netcool/Impact 3.1 Administration Guide

Netcool/Impact Architecture

4.4

Netcool/Impact Architecture
The following figure shows the architecture of Netcool/Impact and its components.

Netcool/ Impact GUI

Netcool/ Impact DSAs

Netcool/ Impact

Netcool/ Impact Database Netcool/ Impact JRExec Server

Netcool/ Impact CVS

Figure 5: Netcool/Impact Architecture

Netcool/Impact 3.1 Administration Guide

87

If you are installing Netcool/Impact remotely using telnet or another command line application. you must also increase the shared memory setting to accomodate the Security Manager database.5 Installing Netcool/Impact To install Netcool/Impact. or to troubleshoot installation errors. 88 Netcool/Impact 3. The installer is named impactbuildarch. you must run the installer in console mode. In GUI mode. the installer prompts you for required information from the command line.1 Administration Guide . Running the Netcool/Impact Installer The Netcool/Impact installer copies the program files to the target system and sets the minimum required configuration properties. You can run the installer as any other user that has read.bin. you must first configure the operating system kernel so that the shared memory settings fulfill the requirements of the Netcool/Impact database. you do the following: • • • • Configure the operating system kernel (UNIX only) Run the Netcool/Impact installer Set the Netcool/Impact environment variables (UNIX only) Verify firewall port settings After you have finished installing Netcool/Impact. You cannot run the installer as user root. see UNIX Kernel Configuration on page 167. Configuring the Operating System Kernel (UNIX Only) If you plan to use the Netcool/Impact reporting features on a UNIX platform. write and execute permissions to the target directory. If you are running Netcool/Impact on the same machine as the Security Manager. In console mode. For more information..Chapter 4: Netcool/Impact 4. You can run the installer in GUI mode or in console mode. where build is the build number and arch is the name of the operating system. the installer presents a series of graphical dialog boxes that guide you through the installation process. The Netcool/Impact database requires a maximum shared memory setting of at least 32 MB. Micromuse recommends 64 MB. you can read the installation log to verify that the software has been installed correctly.

Hostname or IP address of the license server to be used by the Security Manager. the installer asks you if you want to create a new instance of the Netcool/Impact server. see Creating Server Instances on page 106.1 Administration Guide 89 . By default. If you answer yes. If you want to set up a registry cluster. which is installed automatically with the product. 3. The installer always launches nci_new_server in GUI mode. Default is localhost. Port of the license server to be used by the Security Manager. For more information . Default is /opt/netcool/impact on UNIX platforms and C:\Program Files\Netcool\Impact on Windows. the Application Registry is installed on the same system as the GUI Server. If you want to create the server instance in console mode. the installer configures Netcool/Impact to use a single instance of the Netcool Application Registry. Specifies which version control system to use with Netcool/Impact. To run the Netcool/Impact installer: 1. change the current directory to the directory where the installer is located. Port to be used by the Netcool/Impact Database. During installation. Hostname or IP address of the system where the Netcool Application Registry is running./impactbuildarch. enter the following: . Default is Netcool/Impact CVS. Follow the on-screen prompts. enter the following: . Version control system License server host License server port Registry host Registry port PostgreSQL port Note: By default.bin -i console 2. To run the installer in GUI mode.Installing Netcool/Impact The Netcool/Impact installer prompts you for the following information: Table 17: Netcool/Impact Installer Prompts Prompt Installation directory Description Directory where you want to install the Security Manager. Netcool/Impact 3. Port used to communicate with the Application Registry. Default is 8080. This port is the same as the HTTP port used by the Netcool GUI Server. At a command line prompt./impactbuildarch. the installer launches the nci_new_server program.bin To run the installer in console mode. you must launch nci_new_server separately. Default is 27000. you must perform the additional steps described in Registry Clustering on page 68.

Reading the Installation Log The Netcool/Impact installation log is named Netcool_Impact_3. this directory is /opt/netcool/impact. You can use this log to verify that you have installed Netcool/Impact successfully.1 Administration Guide .log and is located in the $IMPACT_HOME directory. By default.Chapter 4: Netcool/Impact Setting the IMPACT_HOME Environment Variable If you are installing Netcool/Impact on a UNIX platform. or you are running Netcool/Impact on a Windows machine with a built-in firewall.1_InstallLog. export IMPACT_HOME The following example shows how to set IMPACT_HOME using csh: setenv IMPACT_HOME /opt/netcool/impact Verifying Port Settings If Netcool/Impact is seperated from the GUI Server. The following example shows how to set IMPACT_HOME using sh or bash: IMPACT_HOME=/opt/netcool/impact. The installation log contains runtime messages generated during the installation process. the Security Manager or the License Server by a firewall. you should check the port usage information in Firewall Considerations on page 166 to make sure that the configuration allows access to the required ports. you must set the IMPACT_HOME environment variable to the directory where you installed the application. 90 Netcool/Impact 3. You can also use it to troubleshoot installation problems.

You can install the application to upgrade with no special considerations. For instructions on installing Netcool/Impact 3.0 Manually export project data from Netcool/Impact 3. Upgrading from Netcool/Impact 3. make sure that you install into a separate directory.0 is installed.Upgrading Netcool/Impact 4.0 installation.1. You can create this server instance following the instructions in Creating Server Instances on page 106. see Installing Netcool/Impact on page 88. If the target is the same system as the one where Netcool/Impact 3.0 is to install Netcool/Impact 3.1 Create a new instance of the Netcool/Impact server Start the new instance of the Netcool/Impact server Export data from Netcool/Impact 3. It contains the following topics: • • Upgrading from Netcool/Impact 3.1 on the target system. you must create a new server instance with the same name and same cluster name as the instance you are upgrading from version 3.1 Installing Netcool/Impact 3.3 are not supported. you perform the following steps: • • • • • • Install Netcool/Impact 3.3 Upgrades from versions previous to Netcool/Impact 2.0.1 Administration Guide 91 .6 Upgrading Netcool/Impact This section contains information on upgrading Netcool/Impact from previous versions.0 To upgrade from Netcool/Impact 3. Creating a New Server Instance After installing Netcool/Impact 3. Netcool/Impact 3.1 The first step in upgrading from version 3.0 Upgrading from Netcool/Impact 2.1 (optional) Import data into Netcool/Impact 3.0. Note: Do not attempt to install in the same directory as an existing Netcool/Impact 3.1.

service and policy information from the Netcool/Impact server and stores it in a directory you specify. Manually copy the project list file from the version 3. The Netcool/Impact 3. omitting the servername prefix. 2. see Running Server Instances on UNIX on page 107 or Running Server Instances on Windows on page 108. 92 Netcool/Impact 3.0 projects in the new installation. Importing Data into Netcool/Impact 3. Create a subdirectory of the directory where you exported data in the previous step. rename the file to projectlist.0 installation into the directory you created. Copy each project file into the directory you created and rename the file to omit the servername prefix. you can start it using the server startup script.1 Administration Guide . If you want to re-use version 3. data type.1 installation. where servername is the name of the Netcool/Impact server instance.0 project has an associated project definition file named servername_projname.1 After you have exported the data from Netcool/Impact 3.0.0 The next step in upgrading is to run the export command from the Netcool/Impact 3. 3.1 installation.Chapter 4: Netcool/Impact Starting the New Server Instance Once you have created the new server instance. you must manually export them. This directory must be named Projects. Exporting Data from Netcool/Impact 3. This script is named nci_server and is located in the $IMPACT_HOME/bin directory.0 installation: 1. The project files are imported automatically when you run the import script. Each version 3. The export command is named nci_export and is located in $IMPACT_HOME/bin directory. You do not need to manually import the project data into the version 3. where servername is the name of the Netcool/Impact server instance and projname is the name of the project.0 server must be running when you run this command.0 projects are not automatically exported by the nci_export script. This file is named servername_projectlist. For more information on starting server instances. Then. The export script extracts data source.proj. Manually Exporting Project Data from Netcool/Impact 3. you can then import it into the version 3.0 installation directory.0 Netcool/Impact 3. To export projects from the version 3.

3. you run the import script and specify the location of this directory.1 server instance. Stopping the Netcool/Impact 2.Upgrading Netcool/Impact To import the data.0 installation. enter the following at a command prompt: $IMPACT_HOME/bin/nci_shutdown server_name where server_name is the name of the Netcool/Impact server instance.1 components Start the Netcool GUI Server Run the Netcool/Impact 3. Then.3 server. If you want to use another version control system.1 Note: Netcool/Impact 3. data type.1 installation. The import script inserts the extracted data source. you do the following: • • • • • Stop the Netcool/Impact 2. you must stop the version 2.1.3 server. Installing the Netcool/Impact 3.1 only supports CVS for version control after upgrading from version 2. Netcool/Impact 3. Note: Do not attempt to install in the same directory as an existing Netcool/Impact 3.1 components. At minimum. You can stop the server by running the shutdown script.1 Components After you have stopped the version 2. GUI Server and Netcool/Impact at this time.1 upgrade script Start Netcool/Impact 3. Upgrading from Netcool/Impact 2.1 server instance. you must stop and restart the Netcool/Impact 3.3 Server Before you upgrade to Netcool/Impact 3. After you have imported the the data. service and policy information into the specified version 3. To stop the server.3 To upgrade from Netcool/Impact 2. you must install the Security Manager.1 Administration Guide 93 . The import command is named nci_import and is located in the $IMPACT_HOME/bin directory. you can install the Netcool/Impact 3. you must copy the directory created by the export script to a location on the file system accessible to the Netcool/Impact 3. This script is named nci_shutdown and is located in the $IMPACT_HOME/bin directory. you must use a completely new installation of Netcool/Impact.3.3 server Install Netcool/Impact 3.

1 $IMPACT_HOME/upgrade directory.1 server instance.1 server instance using the configuration properties from the specified Netcool/Impact 2.3 installation directory Version 2. This script is named ncgui_server and is located in the $GUI_HOME/bin directory. you must start the GUI Server. The upgrade script prompts you for the following information: Table 18: Netcool/Impact Upgrade Script Prompts Prompt Version 2. Version control system to be used by version 3. The upgrade script requires the Netcool Application Registry to be running.1 Upgrade Script The upgrade script creates a new Netcool/Impact 3. You can start the GUI Server using the server startup script. The Application Registry is installed and run by default with the GUI Server. Security Manager host.3. Port where the Security Manager is running.3 server. Running the Netcool/Impact 3. 94 Netcool/Impact 3. Security Manager port Version control system. Name of the version 2.1 of Netcool/Impact. Description Directory on the system where version 2. you can start the new Netcool/Impact 3. This instance has the same name as in version 2.3 of Netcool/Impact is installed.1 server instance.1 components. Starting Netcool/Impact 3.1 Administration Guide . Hostname or IP address where the Netcool Security Manager is located.1 After you have run the upgrade script.3 server name.Chapter 4: Netcool/Impact Starting the Netcool GUI Server After you have installed the Netcool/Impact 3. To start the server instance.3 server instance that you want to upgrade. enter the following at a command prompt: $IMPACT_HOME/bin/nci_server server_name where server_name is the name of the Netcool/Impact 3. The upgrade script is named nci_upgrade and is located in the version 3.

The license feature code for the clients is cro_nci_client. Netcool/Impact 3. The license feature code for the Operator View is cro_nci_opview.7 Licensing Netcool/Impact This section contains information on licensing Netcool/Impact.1 Administration Guide 95 . Netcool/Impact Operator View Licenses Netcool/Impact requires an Operator View license for each concurrent instance of the Operator view. It contains information on: • • • Licensing requirements Configuring licensing Quorum licensing Licensing Requirements Netcool/Impact requires the following licenses: • • • • • Netcool/Impact server license Netcool/Impact client licenses Netcool/Impact event reader licenses Netcool/Impact operator view licenses Netcool/Impact DSA licenses Netcool/Impact Server License Netcool/Impact requires a license for each instance of the Netcool/Impact server.Licensing Netcool/Impact 4. Netcool/Impact Event Reader Licenses Netcool/Impact requires an event reader license for each event reader used in the Netcool/Impact server. The license feature code for the event reader is cro_nci_eventreader. The license feature code for the server is cro_nci_server. Netcool/Impact Client Licenses Netcool/Impact requires a client license for each user concurrently logged into Netcool/Impact using the web-based GUI or the CLI.

Chapter 4: Netcool/Impact Netcool/Impact DSA licenses Netcool/Impact requires a DSA license for each DSA used per instance of the Netcool/Impact Server.1 Administration Guide . The following table shows the license feature codes for Netcool/Impact DSAs: Table 19: Netcool/Impact DSA License Feature Codes (1 of 2) Component ObjectServer DSA LDAP DSA Oracle DSA MySQL DSA Microsoft SQL Server DSA Flat File DSA Informix DSA DB2 DSA PostgreSQL DSA Sybase DSA JMS DSA Cramer Dimension DSA Vitria BusinessWare DSA XML DSA XML DSA (XML Files) Portal Infranet DSA Granite Xpercom DSA Metasolv DSA SNMP DSA Telcordia DSA Code cro_nci_objserv_dsa cro_nci_ldap_dsa cro_nci_oracle_dsa cro_nci_mysql_dsa cro_nci_freetds_dsa cro_nci_flatfile_dsa cro_nci_informix_dsa cro_nci_db2_dsa cro_nci_postgres_dsa cro_nci_sybase_dsa cro_nci_dsamediator_jmssda cro_nci_dsamediator_cramer cro_nci_dsamediator_vitria cro_nci_dsamediator_xml cro_nci_dsamediator_xmlfile cro_nci_dsamediator_infranet cro_nci_dsamediator_granite cro_nci_dsamediator_metasolv cro_nci_dsamediator_snmp cro_nci_dsamediator_telcordia 96 Netcool/Impact 3.

Port of the license server to be used by the Netcool/Impact. This includes the license.server.port properties. Netcool/Impact 3.host and license.props and is located in the $IMPACT_HOME/etc directory.port@host_03 2. The licensing properties are set automatically when you install Netcool/Impact. 27000). you must stop and restart the Netcool/Impact server before the change takes effect.port@host_02.host Description Hostname or IP address of the license server to be used by the Netcool/Impact.license. If you manually edit the properties file. However. This file is named license. For more information on quorum licensing. license. you must manually edit the contents of the license properties file so that it contains the hostnames and port numbers of the License Server instances. To edit the license properties file: 1. you can manually edit the license properties file at any time to change the configuration. The following table shows the license properties for Netcool/Impact: Table 20: Netcool Security Manager License Properties Property license. Default is 27000.server=port@host_01. Default is localhost. Add the following property to the file: impact.1 Administration Guide 97 . see Quorum Licensing on page 48.port Quorum Licensing To use Netcool/Impact with a quorum licensing configuration. Remove all properties currently defined in the file.server.Licensing Netcool/Impact Table 19: Netcool/Impact DSA License Feature Codes (2 of 2) Component Tibco TIB/Rendezvous DSA Web Services DSA Code cro_nci_dsamediator_tibco cro_nci_webservice_dsa Configuring Licensing Licensing properties are located in the license properties file. host_02 and host_03 are the primary. where host_01. secondary and tertiary instances of the License Server and port is the port number used by the servers (by default.

Registry login password.props and is located in the $IMPACT_HOME/etc directory. Table 21 shows the registry properties for Netcool/Impact: Table 21: Netcool/Impact Registry Clustering Properties Propery impact.registry.location For more information on working with the Netcool Application Registry. Maintained for backward compatibility only.Chapter 4: Netcool/Impact 4.password impact. Number of registry instances in the cluster.port impact. You must stop and restart the Netcool/Impact server for the changes to take effect.registry. impact. The required registry properties are set automatically when you install Netcool/Impact.count impact. This file is named registry.8 Configuring Registry Settings Netcool/Impact uses the Netcool Application Registry to store information used in server clustering. where # is an index value that identifies the registry instance. This is the HTTP port used by the GUI Server or Tomcat. Registry settings are located in the registry properties file. Maintained for backward compatibility only.registry. Hostname of the registry instance.#.1 Administration Guide .host impact. Default is admin. Default is /registry/services. Default is netcool. The Application Registry is a component of the Netcool GUI Server.registry.registry.registry. You can change the registry configuration at any other time by modifying the properties in this file. see Chapter 3: Netcool GUI Server on page 53. 98 Netcool/Impact 3. where # is an index value that identifies the registry instance. Port used. which have 8080 as defaults.#.#. where # is an index value that identifies the registry instance.userid Description Registry login username. URL location on servlet container where registry is installed.

Netcool/Impact 3. see the Netcool Security Manager Administration Guide.1 Administration Guide 99 .9 Configuring Authentication Netcool/Impact uses the Netcool Security Manager for authentication. You must assign this role to each Security Manager user who requires access to the Netcool/Impact GUI. For more information on working with users and roles.Configuring Authentication 4. it inserts a role named ImpactUser into the Security Manager database. When you install Netcool/Impact.

including properties files and all other configuration data. you can tar or zip the entire $IMPACT_HOME directory and archive it for future access. this command does not export all of the properties files and other configuration data used by Netcool/Impact. tar or zip the $IMPACT_HOME directory as a cron job.10 Backing Up and Restoring Netcool/Impact To completely back up a Netcool/Impact installation.1 Administration Guide . This ensures that all parts of the installation. 100 Netcool/Impact 3. untar or unzip the archive and move the contents to the $IMPACT_HOME directory. However. are preserved. To restore the installation. Note that you can partially back up Netcool/Impact using the nci_export command. For timed backups of Netcool/Impact.Chapter 4: Netcool/Impact 4.

11 Uninstalling Netcool/Impact This section contains information on uninstalling the Netcool/Impact on UNIX and Windows platforms. Uninstalling on UNIX When you install Netcool/Impact on UNIX platforms. To uninstall the Netcool/Impact. This batch file is named uninstall. To uninstall the Netcool/Impact. enter the following at a command line prompt: rm -rf $IMPACT_HOME Uninstalling on Windows Platforms You uninstall Netcool/Impact on Windows platforms by running the uninstaller batch file. You must shut down Netcool/Impact before you attempt to uninstall.Uninstalling Netcool/Impact 4.1 Administration Guide 101 . You can safely uninstall the Netcool/Impact by deleting this directory and all its contents. all of the program files are copied to the $IMPACT_HOME directory. enter the following at a command prompt: cd C:\Program Files\netcool\impact\UninstallerData uninstall.bat Netcool/Impact 3.bat and is located by default in the C:\Program Files\netcool\impact\UninstallerData directory.

Chapter 4: Netcool/Impact 102 Netcool/Impact 3.1 Administration Guide .

Chapter 5: Netcool/Impact Server 05_Impact_Server.1 Administration Guide 103 . 2004 10:15 am This chapter contains information about the Netcool/Impact server. It contains the following sections: • • • • • • About the Netcool/Impact Server on page 104 Creating Server Instances on page 106 Running Server Instances on UNIX on page 107 Running Server Instances on Windows on page 108 Monitoring Server Instances on page 109 Deleting Server Instances on page 110 Netcool/Impact 3.fm December 15.

Chapter 5: Netcool/Impact Server

5.1

About the Netcool/Impact Server
This section contains overview information about the Netcool/Impact server. It contains the following topics: • • • • • • What Is the Netcool/Impact Server? What Are the Supported Server Configurations? What Is a Server Instance? How Do I Set Up a Server Instance? How Do I Run a Server Instance? How Do I Monitor a Server Instance?

What Is the Netcool/Impact Server?
The Netcool/Impact Server is the primary component of Netcool/Impact. It consists of a collection of sub-components, called services, that perform the core functionality of the product. It also provides the mechanisms for creating and managing a Netcool/Impact data model and for creating and managing Netcool/Impact policies. In addition, the Netcool/Impact server hosts the web-based GUI. On UNIX platforms, the Netcool/Impact Server is a runnable application that you can start and stop using the server administration scripts. On Windows platforms, the Netcool/Impact Server runs as a Windows service that you can start and stop using the Windows Services Administration tools.

What Are the Supported Server Configurations?
Netcool/Impact supports both single server and clustered server configurations. Single server configurations consist of a single instance of the Netcool/Impact Server installed on a single system in your environment. Clustered server configurations consist of multiple instances of the Netcool/Impact Server installed on different systems and configured to act as a single server. Clustered server configurations provide backup, replication and load balancing functionality to Netcool/Impact. For more information, see Chapter 6: Netcool/Impact Server Clustering on page 111.

What Is a Server Instance?
A server instance is a runnable instance of the Netcool/Impact server. You can run a single or multiple server instances from a single Netcool/Impact directory. You must create a new instance of the server before you can run Netcool/Impact in your environment.

104

Netcool/Impact 3.1 Administration Guide

About the Netcool/Impact Server

Micromuse recommends that you run a single server instance per system. However, it is possible to run multiple instances for testing and validation purposes. There is typically no benefit to running multiple instances of the Netcool/Impact server on a single system in a production environment.

How Do I Set Up a Server Instance?
You can create an instance of the Netcool/Impact server using the nci_new_server program. This program prompts you for the minimum required configuration properties. You can change the configuration at any time by manually editing the server properties file. For more information, see Creating Server Instances on page 106.

How Do I Run a Server Instance?
On UNIX platforms, you start and stop server instances from the command line using the server administration scripts. On Windows platforms, you run server instances as Windows services. For more information, see Running Server Instances on UNIX on page 107 and Running Server Instances on Windows on page 108.

How Do I Monitor a Server Instance?
You can monitor a server instance by viewing the server log. For more information, see Monitoring Server Instances on page 109.

Netcool/Impact 3.1 Administration Guide

105

Chapter 5: Netcool/Impact Server

5.2

Creating Server Instances
To create a new server instance, you run the new server script. This script is named nci_new_server and is located in the $IMPACT_HOME/install directory. The new server script creates the set of properties files and other supporting files that define the instance. These files are created in the $IMPACT_HOME/etc directory. The new server script prompts you for the following information:
Table 22: Netcool/Impact New Server Script Prompts Prompt Instance name Cluster name Description Name of the new instance. Default is NCI. Name of the server cluster for the new instance. If you are not using server clustering, enter the instance name. Otherwise, enter the name of the cluster that the instance will participate in. Port used by the command line service for the new instance. Hostname or IP address for the primary ObjectServer in your environment. Port used by the ObjectServer. Port used by the HTTP service for Netcol/Impact. Default is 5104. Host to be used by the e-mail sender service. Name of the user associated with the e-mail sender service. Specifies which version control system to use with Netcool/Impact. Default is Netcool/Impact CVS, which is installed automatically with the product.

Command line port ObjectServer host ObjectServer port Impact HTTP port SMTP host E-Mail sender name Version control system

To create a server instance:
1.

Enter the following at a command line prompt: $IMPACT_HOME/install/nci_new_server

2.

Follow the on-screen prompts.

106

Netcool/Impact 3.1 Administration Guide

Running Server Instances on UNIX

5.3

Running Server Instances on UNIX
This section contains information on starting and stopping Netcool/Impact on UNIX platforms.

Starting Netcool/Impact on UNIX
You start a server instance by running the Netcool/Impact server startup script. This script is named nci_server and is located in the $IMPACT_HOME/bin directory. To start a server instance, enter the following at a command prompt: $IMPACT_HOME/bin/nci_server server where server is the name of the Netcool/Impact server instance.

Stopping Netcool/Impact on UNIX
You stop a server instance by running the Netcool/Impact server shutdown script. This script is named nci_shutdown and is located in the $IMPACT_HOME/bin directory. You can only stop server instances that are running from the $IMPACT_HOME directory. You cannot use nci_shutdown to stop remote members of a server cluster. To stop a server instance, enter the following at a command prompt: $IMPACT_HOME/bin/nci_shutdown server where server is the name of the Netcool/Impact server instance.

Netcool/Impact 3.1 Administration Guide

107

Chapter 5: Netcool/Impact Server

5.4

Running Server Instances on Windows
This section contains information on starting and stopping Netcool/Impact on UNIX platforms.

Starting Netcool/Impact on Windows
To start Netcool/Impact:
1. 2.

In the Start Menu, select Control Panel→Administrative Tools→Services. In the Services window that opens, right-click on Netcool Impact Server and select Properties. In the Properties dialog box, click Start and then click OK.

Stopping Netcool/Impact on Windows
To stop Netcool/Impact:
1. 2.

In the Start Menu, select Control Panel→Administrative Tools→Services. In the Services window that opens, right-click on Netcool Impact Server and select Properties. In the Properties dialog box, click Stop and then click OK.

108

Netcool/Impact 3.1 Administration Guide

Server log files are named servername_server.1 Administration Guide 109 . The server log files are located in the $IMPACT_HOME/log directory. where servername is the name of the server instance and n is a number that identifies the log file. Netcool/Impact 3.5 Monitoring Server Instances You can monitor instances of the Netcool/Impact server by reading the server log files.n. The server log files contain messages and other information that can help you track the status of the server and troubleshoot any problems that might arise.Monitoring Server Instances 5.log.

enter the following at a command prompt: $IMPACT_HOME/bin/nci_removeserver server_name where server_name is the instance of the server you want to remove. If the instance is running. enter the following at a command prompt: $IMPACT_HOME/install/nci_cvs_remove server_name where server_name is the name of the deleted server instance. the script automatically shuts it down before continuing with operations.Chapter 5: Netcool/Impact Server 5. 110 Netcool/Impact 3. If you are using CVS as your version control system. you can run the remove CVS archives script to completely remove all archives related to a server instance. the remove server script does not delete information on policies. To run the remove server script.1 Administration Guide .6 Deleting Server Instances To delete a server instance. This script is named nci_removeserver and is located in the $IMPACT_HOME/bin directory. The script checks to see if the server instance is running before removing it from the installation. Running the Remove CVS Archives Script By default. data types and services from the version control system. data sources. To run the remove CVS archives script. The remove CVS archives script is named nci_cvs_remove and is located in the $IMPACT_HOME/bin directory. you do the following: • • Run the remove server script Run the remove CVS archives script (optional) Running the Remove Server Script The remove server script removes the server instance from the Netcool/Impact installation.

2004 10:15 am This chapter contains information about Netcool/Impact server clustering.1 Administration Guide 111 . It contains the following sections: • • • • • About Server Clustering on page 112 Clustering Components on page 113 How Server Clustering Works on page 114 Setting Up a Server Cluster on page 116 Running a Server Cluster on page 119 Netcool/Impact 3.Chapter 6: Netcool/Impact Server Clustering 06_Server_Clustering.fm December 15.

What are the Clustering Components? A Netcool/Impact server cluster consists of the primary server. Server clustering replaces the failover functionality provided in versions 2. see Clustering Components on page 113. The previous functionality is no longer supported in Netcool/Impact 3. When you run the installer program. you install a separate instance of Netcool/Impact on each target system. 112 Netcool/Impact 3. How Does Clustering Work? For information on the server clustering process. For more information.Chapter 6: Netcool/Impact Server Clustering 6. Manual changes made to the server properties files are not automatically propagated. see Setting Up a Server Cluster on page 116.1. and secondary servers. You use this feature to add failover and load-balancing functionality to a Netcool/Impact installation. which is responsible for monitoring the Netcool/OMNIbus ObjectServer and making events available to secondary cluster members. How Do I Set Up Server Cluster? To set up a server cluster. see How Server Clustering Works on page 114.3 and earlier of Netcool/Impact. you specify the same cluster name for each server in the cluster.1 Administration Guide . Changes made to the server configuration using the Netcool/Impact GUI are propagated automatically to other cluster members. You can configure cluster members in the same way you configure single server configurations of Netcool/Impact. It contains the following topics: • • • • What Is Server Clustering? What Are the Clustering Components? How Does Clustering Work? How Do I Set Up a Server Cluster? What Is Server Clustering? Server clustering is a feature of Netcool/Impact that allows you to install a group of related Netcool/Impact servers and configure them to operate as a single server instance. For more information. Secondary servers do not connect directly to the ObjectServer.1 About Server Clustering This section contains overview information about Netcool/Impact server clustering. Both primary and secondary servers are responsible for processing the events.

Clustering Components 6. If the primary server fails or is shut down.1 Administration Guide 113 . Most services are disabled in the secondary servers. one of the secondary servers automatically becomes the primary. The following services are not disabled: • • • • Event processor Basic servlet service Policy logger Self-monitoring service Netcool/Impact 3. Secondary servers function solely as event-processing services in the cluster. as well as processing events on its own. Secondary Servers Secondary servers are cluster members that are responsible for retrieving events from the primary server and for executing policies in response to the incoming events. The first cluster member that is started automatically becomes the primary server.2 Clustering Components A server cluster consists of the following: • • Primary server Secondary servers Primary Server The primary server is the cluster member that is reponsible for monitoring the Netcool/OMNIbus ObjectServer and for making events available to the secondary servers for processing.

3 How Server Clustering Works Server clustering has the following phases: • • • • • Startup Event Monitoring Event Processing Failover Shutdown Startup At startup. Event Processing During the event processing phase. The minimum interval and maximum number of events to retrieve per query are specified in the event processor properties file. Similarly. By default. the server runs the corresponding policy. After all the events have been processed. the secondary server queries the primary server again for new events. Failover The secondary servers ping the primary at intervals during runtime. Secondary servers do not query the ObjectServer at any time. it registers itself as the primary server. and (optionally) receives notification from the ObjectServer when an event is deleted. each secondary server synchronizes its services. Event Monitoring During the event monitoring phase. The primary server places the incoming events in an event queue and waits for requests from the secondary servers for event processing. data sources. each secondary server queries the primary server for events to process. the primary server queries the ObjectServer at intervals for new and updated events. This assures the secondary servers that the primary is active and functioning. each server communicates with the Netcool Application Registry.Chapter 6: Netcool/Impact Server Clustering 6. data types. it declares itself a secondary server. If no other cluster member is currently registered. 114 Netcool/Impact 3. policies and configuration settings with the primary server before becoming active. For each retrieved event.1 Administration Guide . If a primary server is already registered. the primary server requests events from its own event queue. dependent on the filter conditions specified in the event broker.

Shutdown If the primary server is manually shut down.1 Administration Guide 115 . When the original primary server is restarted. Netcool/Impact 3. the first secondary server to become aware of the failure contacts the Netcool Application Registry and registers itself as the new primary.How Server Clustering Works If the primary server fails. the first secondary server to become aware of the failure contacts the Netcool Application Registry and registers itself as the new primary. If a secondary server is shut down. it becomes another secondary server. If a secondary server fails. there is no impact on the other servers in the cluster. as in the failover phase above. there is no impact on the other servers in the cluster.

count impact. Hostname of the registry instance. you do the following: • • Install the cluster Configure the cluster Installing a Server Cluster To install a server cluster.registry. Default is netcool. impact.registry.registry.password impact. Configuring a Server Cluster The Netcool/Impact installer prompts you for the name of the server cluster during installation. where # is an index value that identifies the registry instance. Maintained for backward compatibility only. The Netcool/Impact installer prompts you for the cluster name. You must stop and restart the Netcool/Impact server instance in order for any changes to take effect. This file is named registry. Table 23 shows the registry properties for Netcool/Impact Table 23: Netcool/Impact Registry Properties (1 of 2) Propery impact.#.Chapter 6: Netcool/Impact Server Clustering 6.host 116 Netcool/Impact 3. All servers in a cluster must have the same cluster name. which is used to identify the members of the server cluster at startup in the Netcool Application Registry. You can set other configuration options manually at any time. Number of registry instances in the cluster. Changes made to secondary server instances are not propagated back to the primary. Registry login password. Maintained for backward compatibility only. This name can be any unique identifying string. you install a separate instance of the Netcool/Impact server on each target system.1 Administration Guide .userid Description Registry login username. Default is admin.registry. Note that configuration changes are propagated from the primary server to the secondary servers.props and is located in the $IMPACT_HOME/etc directory. Setting Registry Properties Properties related to the Netcool Application Registry are located in the registry properties file.4 Setting Up a Server Cluster To set up a server cluster.

cluster.receiveupdates.cluster.registry. where # is an index value that identifies the registry instance.registry.for.receiveupdates.repingcount 3 impact. see Configuring the Registry on page 66.replication. Setting Server Properties Properties related to server clustering are located in the server properties file.for. URL location on servlet container where registry is installed. The following table shows the server clustering properties: Table 24: Server Clustering Properties (1 of 2) Name impact.name impact.receiveupdates.cluster.replication.cluster. Specifies whether to synchronize the OrgNode cache. Default is /registry/services. Hibernations impact.Setting Up a Server Cluster Table 23: Netcool/Impact Registry Properties (2 of 2) Propery impact. Interval in milliseconds at which to ping other cluster members.pingtimeout 6000 impact. impact. Specifies whether to synchronize hibernations. Number of times to retry ping if the first fails. Default NCICLUSTER 6000 impact.cluster. which have 8080 as defaults. ServiceStates true true true Netcool/Impact 3.props. OrgNodes impact.location For more information on registry properties. Specifies whether to synchronize service states.1 Administration Guide 117 . Specifies whether the server synchronizes data with the primary at startup before becoming active.#. where servername is the name of the server instance The server properties file is located in the $IMPACT_HOME/etc directory.resyncbeforestandby true impact. This is the HTTP port used by the GUI Server or Tomcat. Time in milliseconds to wait before retrying ping.port Description Port used.replication.pinginterval Description Name of the server cluster.#. This file is named servername_server. where # is an index value that identifies the registry instance.for.

receiveupdates.for. 0 118 Netcool/Impact 3.replication. ActionTrees impact.receiveupdates.1 Administration Guide .for. Specifies whether to synchronize policies.Chapter 6: Netcool/Impact Server Clustering Table 24: Server Clustering Properties(Continued) (2 of 2) Name impact.replication. Default true true Interval at which servers synchronize data.replication. Types impact.statusinterval Description Specifies whether to synchronize data types.

5 Running a Server Cluster You start and stop cluster members in the same way you start and stop another other instances of the Netcool/Impact server. enter the following at a command prompt: $IMPACT_HOME/bin/nci_shutdown name where name is the name of the server instance. The default is NCI. Stopping a Cluster Member You stop the Netcool/Impact server using the server shutdown script. The default is NCI.Running a Server Cluster 6.1 Administration Guide 119 . This script is named nci_server and is located in the $IMPACT_HOME/bin directory. To start the Netcool/Impact server. This script is named nci_shutdown and is located in the $IMPACT_HOME/bin directory. Starting a Cluster Member You start a cluster member using the server startup script. enter the following at a command prompt: $IMPACT_HOME/bin/nci_server name where name is the name of the server instance. To stop the Netcool/Impact server. Netcool/Impact 3.

1 Administration Guide .Chapter 6: Netcool/Impact Server Clustering 120 Netcool/Impact 3.

Chapter 7: Netcool/Impact Version Control 07_Version_Control. 2004 10:15 am This chapter contains information about Netcool/Impact version control. • • • About Version Control on page 122 How Version Control Works on page 123 Configuring Version Control on page 124 Netcool/Impact 3.1 Administration Guide 121 .fm December 15.

data sources. 122 Netcool/Impact 3.Chapter 7: Netcool/Impact Version Control 7. RCS or another version of CVS. data types and configuration properties as revisions in a source control archive.1 Administration Guide . you must install and configure it before installing Netcool/Impact.1 About Version Control Netcool/Impact provides a version control interface that allows you to save Netcool/Impact policies. If you want to use ClearCase. Version control is enabled for Netcool/Impact by default and cannot be disabled. This interface supports the following version control systems: • • • • Netcool/Impact CVS External CVS RCS ClearCase Netcool/Impact CVS is a customized version of the Concurrent Revision System that has been prepared for use with Netcool/Impact. This version of CVS is installed automatically when you install Netcool/Impact and is used as the default version control system.

Netcool/Impact creates a new element in the revision database. data source or data type using the Netcool/Impact GUI or CLI. When you rename an element. data source or data type using the Netcool/Impact GUI or CLI. Check Out Check out occurs when you open an existing policy. In ClearCase. where filename is the name of the policy script file. Netcool/Impact completely removes the entire element or archive from the version control system. Only the user who has currently checked out the element can modify it. In CVS and RCS. Check In Check in occurs when you save a policy.1 Administration Guide 123 . the locked icon appears in the Netcool/Impact GUI. data source or data type using the Netcool/Impact GUI or CLI. Netcool/Impact creates a new archive file named filename. Netcool/Impact checks out and locks the most recent revision in the version control system.How Version Control Works 7.2 How Version Control Works The version control process has the following phases: • • • • • Element creation Check out Check in Element deletion Element renaming Element Creation Element creation occurs when you create a new policy. Element Renaming Element renaming occurs when you rename a policy. Netcool/Impact 3. Netcool/Impact creates a new element using the new name in the version control system. data source. including all revisions. When an element is locked. At check out. At check in. Element Deletion Element deletion occurs when you delete a policy. At element deletion.v. Netcool/Impact checks the corresponding file in as a new revision and removes the lock. data type or properties file. The old element with the previous name is not deleted.

This file is named server_versioncontrol.versioncontrol.3 Configuring Version Control You can change the version control configuration at any time after you have installed Netcool/Impact by manually editing the version control properties file. where server is the name of the instance of the Netcool/Impact server.path impact.props. Reserved for internal use.cvsroot Description Integer that represents the type of version control system.1 Administration Guide .versioncontrol. The following table shows the version control configuration properties: Table 25: Version Control Configuration Properties Property impact.versioncontrol.cvs. Path to the version control executable (CVS and RCS only) Location of the version control archive (CVS only) 124 Netcool/Impact 3.debug impact.systemid impact. This file is located in $IMPACT_HOME/etc directory.versioncontrol.Chapter 7: Netcool/Impact Version Control 7.

fm December 15.1 Administration Guide 125 .Chapter 8: Netcool/Impact Database 08_Database. 2004 10:15 am This chapter contains information about the Netcool/Impact database. It contains the following sections: • • • • About the Database on page 126 Configuring the Database on page 128 Running the Database on page 129 Managing the Database on page 130 Netcool/Impact 3.

The home directory for the database is $IMPACT_HOME/platform/arch/pgsql.Chapter 8: Netcool/Impact Database 8.1 About the Database This section contains general information about the Netcool/Impact database. Micromuse recommends that you run the Netcool/Impact database only if you are using the GUI reporting tools or require a local SQL database data source for use with Netcool/Impact. You can also use the database as a local SQL database data source. Netcool/Impact uses one instance of the database for each installation. where arch is the name of the local operating system. If you are running multiple instances of the Netcool/Impact server from one directory on a system. see the official PostgreSQL documentation.1 Administration Guide . If you are running them from multiple directories. all of the instances will use the same Netcool/Impact database. For more information on PostgreSQL. 126 Netcool/Impact 3. where arch is the name of the operating system platform. The HTML version of the documentation is distributed with Netcool/Impact and is located in the $IMPACT_HOME/platform/arch/pgsql/doc/html directory. If you do not plan to use the database for this functionality. you do not need to run the database. each instance will use the Netcool/Impact database installed in $IMPACT_HOME. It contains the following topics: • • • • • • What is the Database? How Do I Set Up the Database? How Do I License the Database? How Do I Run the Database? How Do I Manage the Database? Cygwin Limitations What is the Database? The Netcool/Impact database is a specially configured version of PostgreSQL that has been prepared for use with Netcool/Impact. How Do I Set Up the Database? The database is installed automatically when you install Netcool/Impact. Netcool/Impact uses the database to store the underlying data used by the GUI reporting tools.

Netcool/Impact 3. The database uses version 1.1 Administration Guide 127 . Cygwin Limitations Micromuse recommends that you do not use Cygwin on Windows systems where you are running the Netcool/Impact database. These tasks include viewing the database status. and backing up and restoring the database. see Managing the Database on page 130. This version may conflict with other versions on the machine. see Running the Database on page 129. Generally.5.About the Database How Do I License the Database? Netcool/Impact requires a PostgreSQL DSA license in order to access the database. How Do I Manage the Database? You can also perform administrative tasks with the Netcool/Impact database using the database administration script. you request this license when you request other Netcool/Impact licenses from Micromuse Technical Support. For more information. How Do I Run the Database? You can start and stop the Netcool/Impact database using the database administration script.3 of the Cygwin runtime. For more information. For information on licensing Netcool/Impact. connecting to the database using the PostgreSQL command line client. The database is not automatically started when you start Netcool/Impact. The license feature code for the PostgreSQL DSA is nci_postgresql_dsa. see Licensing Netcool/Impact on page 95.

To change the database port. modify the following line in the . Setting the Database Port By default. which is called by nci_db. The . 128 Netcool/Impact 3.nci_dbwrapper script.1 Administration Guide .nci_dbwrapper script: PGPORT=5700 Setting PostgreSQL Configuration Properties You can configure additional aspects of the database functionality by modifying the PostgreSQL properties files located in the $IMPACT_HOME/platform/arch/pgsql/data directory.2 Configuring the Database This section contains information on setting the port used by the Netcool/Impact database and on setting the PostgreSQL configuration properties. This port number is specified in the .Chapter 8: Netcool/Impact Database 8. You should only modify these files under the supervision of Micromuse Technical Support. the Netcool/Impact database uses port 5700. The PostgreSQL properties files are described in the official PostgreSQL documentation. where arch is the platform where Netcool/Impact is installed.nci_dbwrapper script is located in the $IMPACT_HOME/bin directory.

select Control Panel→Administrative Tools→Services. enter the following at a command line prompt: $IMPACT_HOME/bin/nci_db start You do not need to start the database unless you plan to use the GUI reporting tools or use it as a local SQL database data source. right-click on Netcool Database (Impact) and select Start. In the Start Menu.Running the Database 8. The database does not start and stop automatically when you start and stop Netcool/Impact. Stopping the Database on Windows To stop the Netcool/Impact database: 1. To start and stop the database on Windows platforms. In the Start Menu. The database is started automatically when you run the Netcool/Impact installer and may still be running. enter the following at a command line prompt: $IMPACT_HOME/bin/nci_db stop Starting the Database on Windows To start the Netcool/Impact database: 1. Stopping the Database on UNIX Platforms To stop the Netcool/Impact database. Before you run the database for the first time. This script is named nci_db and is located in the $IMPACT_HOME/bin directory. Starting the Database on UNIX Platforms To start the Netcool/Impact database. check to see if it is already running. select Control Panel→Administrative Tools→Services. In the Services window that opens. Netcool/Impact 3. 2. 2. you use the database administration script. you use the Windows Services Administration tools.3 Running the Database To start and stop the Netcool/Impact database on UNIX platforms. In the Services window that opens. right-click on Netcool Database (Impact) and select Stop.1 Administration Guide 129 .

enter the following at a command line prompt: $IMPACT_HOME/bin/nci_db setupinit This command may print multiple error messages to the standard output.log Viewing the Database Status To view the database status.1 Administration Guide .4 Managing the Database You can perform the following tasks using the database administration script: • • • • • Reset the database View the database status Connect to the database with the command line client Back up the database Restore the database The administration script is named nci_db and is located in the $IMPACT_HOME/bin directory. Resetting the Database Resetting the database removes all of the historical data stored by the GUI reporting tools. enter the following at a command line prompt: $IMPACT_HOME/bin/nci_db connect 130 Netcool/Impact 3.Chapter 8: Netcool/Impact Database 8. these error messages do not indicate a problem with resetting the database. enter the following at a command line prompt: $IMPACT_HOME/bin/nci_db status The following example shows typical output from the status script: Database on port 5700 Database running. To reset the database. In most cases. You can redirect the error messages to a log file by entering the following at a command line prompt: $IMPACT_HOME/bin/nci_db setupinit 2> error. Connecting to the Database with the Command Line Client The command line client is a SQL tool that is distributed with the PostgreSQL database. To connect to the database with the client.

Backing Up the Database To back up the database. enter the following at a command line prompt: $IMPACT_HOME/bin/nc_db restore -backupfile filename where filename is the name of the backup file. Netcool/Impact 3. For more information. see the official PostgreSQL documentation. enter the following at a command line prompt: $IMPACT_HOME/bin/nci_db backup -backupfile filename where filename is the name of the backup file.1 Administration Guide 131 . Restoring the Database To restore the database from a backup file.Managing the Database You can use the client to run SQL statements against the database in real time.

1 Administration Guide .Chapter 8: Netcool/Impact Database 132 Netcool/Impact 3.

It contains the following sections: • • • About the JRExec Server on page 134 Running the JRExec Server on page 135 Configuring the JRExec Server on page 136 Netcool/Impact 3.1 Administration Guide 133 .Chapter 9: Netcool/Impact JRExec Server 09_JRExec. 2004 10:15 am This chapter contains information about the Netcool/Impact JRExec server.fm December 15.

you can start and stop the server using the Windows Service Administration tools. The section contains the following topics: • • • • • What Is the JRExec Server? How Do I Set Up the JRExec Server? How Do I Run the JRExec Server? Can I Run the JRExec Server Under Process Control? How Do I Configure the JRExec Server? What Is the JRExec Server? The JRExec server is a runnable server component that Netcool/Impact uses to execute external commands. see the Netcool/Impact Policy Reference Guide.1 About the JRExec Server This section contain overview information about the Netcool/Impact JRExec server. This file is located in the $IMPACT_HOME/etc directory and contains the port number used by the JRExec server. On Windows platforms. 134 Netcool/Impact 3. see the following sections in this chapter. How Do I Run the JRExec Server? On UNIX platforms.Chapter 9: Netcool/Impact JRExec Server 9. you run the JRExec server using the JRExec server script. You use the JRExec server with the JRExecAction function. How Do I Configure the JRExec Server? The JRExec server provides a properties file named jrexecserver. scripts and applications from within a policy. For detailed information. How Do I Set Up the JRExec Server? The JRExec server is automatically installed when you install Netcool/Impact. The Windows service is called Netcool/Impact JRExec Server. For more information on JRExecAction.props. Can I Run the JRExec Server Under Process Control? You can run the JRExec server under process control with no special considerations.1 Administration Guide . The JRExec server runs as a “non-pa aware” application.

This script is named nci_jrexec and is located in the $IMPACT_HOME/bin directory. In the Start Menu.1 Administration Guide 135 . enter the following at a command prompt: $IMPACT_HOME/bin/nci_jrexec Stopping the JRExec Server on UNIX You stop the JRExec server by manually terminating the server process. Starting the JRExec Server on UNIX You start JRExec Server by running the JRExec Server startup script. In the Services window that opens. enter the following at a command line prompt: kill -15 pid where pid is the process ID of the JRExec Server. Starting the JRExec Server on Windows To start Netcool/Impact: 1. 2. select Control Panel→Administrative Tools→Services.Running the JRExec Server 9.2 Running the JRExec Server This section contains information on starting and stopping the JRExec server on UNIX and Windows platforms. right-click on Netcool JRExec Server and select Start. To start Netcool/Impact. To manually terminate the process. 2. right-click on Netcool JRExec Server and select Stop. In the Services window that opens. In the Start Menu. select Control Panel→Administrative Tools→Services. Netcool/Impact 3. Stopping the JRExec Server on Windows To stop Netcool/Impact: 1.

3 Configuring the JRExec Server The JRExec server provides a properties file named jrexecserver. you must also change the value of the impact.props file. If you change this property.jrexec. open the properties file in any text editor and change the value of the impact.jrexecserver.Chapter 9: Netcool/Impact JRExec Server 9.props. This file is located in the $IMPACT_HOME/etc directory and contains the port number used by the JRExec server. 136 Netcool/Impact 3. To change the port number used by the JRExec server.1 Administration Guide . where server is the name of the Netcool/Impact server instance.port property.port property in the server_server.

2004 This chapter contains information about Netcool/Impact self-monitoring.fm December 15. It contains the following sections: • • • • • About Netcool/Impact Self-Monitoring on page 138 Memory Status Monitoring on page 140 Queue Size Monitoring on page 144 Setting Up Self-Monitoring on page 147 Viewing Information About Self-Monitoring on page 150 Netcool/Impact 3.Chapter 10: Netcool/Impact Self-Monitoring 11_Self-Monitoring.1 Administration Guide 137 .

Chapter 10: Netcool/Impact Self-Monitoring 10. The severity of events sent to the ObjectServer varies depending on the severity of the memory or event queue status. and event queue size and sends events to the Netcool/OMNIbus ObjectServer regarding memory and queue status. If you are running one or more event readers. How Does Self-Monitoring Work with a Netcool/Impact Cluster? If you are running multiple Netcool/Impact servers in a cluster. the Netcool/Impact self-monitoring service checks the available memory and sends events to the ObjectServer that contain information on the status of memory usage. the self-monitoring service also checks the size of the event queues and sends events to the ObjectServer related to the event queue status. This means that you must configure each server instance seperately and that each server runs the self-monitoring feature independent of other cluster members. It contains the following topics: • • • • • What Is Self-Monitoring? How Does Self-Monitoring Work? How Does Self-Monitoring Work with a Netcool/Impact Cluster? How Do I Set Up Self-Monitoring? How Do I Manage Netcool/Impact Events? What Is Self-Monitoring? Self-monitoring is a feature of Netcool/Impact that monitors Java and system memory usage. How Does Self-Monitoring Work? At intervals. self-monitoring operates on a per-server basis. 138 Netcool/Impact 3. You can configure the service to deduplicate the Netcool/Impact events or to send a new event to the ObjectServer at each interval.1 About Netcool/Impact Self-Monitoring This section provides overview information about the self-monitoring feature. This allows you to customize self-monitoring to accomodate each system where you are running Netcool/Impact. Service configuration information is not propagated between members of the cluster.1 Administration Guide . Self-monitoring allows Netcool operators to monitor the status of Netcool/Impact using an event list in the same way they monitor the status of other devices and applications.

you must set up self-monitoring using the properties file or the CLI. You can also configure the event reader in Netcool/Impact to launch custom policies that are designed to respond to these events. For single-server configurations of Netcool/Impact. Netcool/Impact 3.1 Administration Guide 139 . These events can be viewed by Netcool operators in an event list and managed according to the normal event handling procedures in your environment. For a clustered server configuration. using the GUI is recommended.About Netcool/Impact Self-Monitoring How Do I Set Up Self-Monitoring? You can set up self-monitoring using the Netcool/Impact GUI or the Netcool/Impact command line interface (CLI). How Do I Manage Netcool/Impact Events? Events sent by Netcool/Impact to the ObjectServer as part of self-monitoring are the same as any other Netcool/OMNIbus events.

1 Administration Guide . In order to effectively report on the memory status for the system. the values for these flags are specified using the XMS and XMX variables in the runtime definition file. the memory monitoring feature also monitors available system memory as a whole.Chapter 10: Netcool/Impact Self-Monitoring 10. System Memory Status In addition to Java heap memory. Netcool/Impact must also take into consideration the total amount of system memory available at a given time compared to the amount of memory currently in use by the application. The minimum and maximum values are passed to the JVM by the Netcool/Impact startup script. Netcool/Impact checks the current heap size at intervals and compares it to the maximum size specified by the XMX variable. Java Memory Status When you start an instance of the JVM. you can specify a minimum and maximum heap size using the -Xms and -Xmx flags. The -Xms flag specifies the minimum size of the memory heap and -Xmx specifies the maximum size. The default value of XMS is 64M and the default value of XMX is 1000M. Netcool/Impact then calculates the severity of the JVM memory status using the rules in Table 26. With Netcool/Impact. When you enable the self-monitoring feature. 140 Netcool/Impact 3. The memory status is significant because Netcool/Impact will fail and report an out-of-memory error if the maximum available memory is exceeded. Netcool/Impact uses the amount of Java heap memory specified in the XMX variable as well as an additional 100 to 120 megabytes of system memory. This file is named runtime_def_14 and is located in the $IMPACT_HOME/platform/arch directory. Netcool/Impact monitors available memory in both the Java heap and in the system as a whole.2 Memory Status Monitoring This section contains information on monitoring the Netcool/Impact memory status. It contains the following topics: • • • About Memory Status Monitoring Memory Status Severity Memory Event Fields About Memory Status Monitoring Memory monitoring is a process in which the self-monitoring service checks the Java and system memory and sends events to the Netcool/OMNIbus ObjectServer regarding the memory status at intervals. where arch is the name of the operating system where Netcool/Impact is installed. At maximum.

For example. Netcool/Impact 3.6 times the current heap size. Table 26: Severity Criteria for JVM Memory Events Severity 1 2 3 4 5 Criteria Maximum heap limit is greater than twice the current help size. Netcool/Impact then calculates the severity of the system memory status using the rules in Table 26. if the XMX variable is set to 1000M. Maximum heap limit is less than 1. Maximum heap limit is between 1.2 times the current heap size.6 and 2 times the current heap size. Netcool/Impact checks the current available system memory at intervals and compares it to the maximum memory that it requires. Netcool/Impact sends the event to the ObjectServer. Netcool/Impact determines its maximum allocated memory to be 1150 megabytes. Combined Memory Status After calculating the severity of the JVM and system memory status.4 and 1. Maximum heap limit is between 1.4 times the current heap size.2 and 1. The total severity of the event is the highest severity between the JVM and system memory status.1 Administration Guide 141 . This event contains the fields described in Table 28.Memory Status Monitoring When you enable the self-monitoring feature. Netcool/Impact determines the maximum memory by adding 150 megabytes to the maximum amount allocated to the Java heap. Maximum heap limit is between 1. Memory Status Severity Table 26 shows the criteria used by Netcool/Impact to determine the severity of the JVM memory status.

Available system memory is between 1. Available system memory is between 1. Table 27: Severity Criteria for System Memory Events Severity 1 2 3 4 5 Criteria Available system memory is greater than twice the maximum required memory. 10500 13 ImpactStatus Timestamp for the first occurrence of this event. Memory Event Fields Table 28 shows the fields in memory events sent to the ObjectServer. Available system memory is less than 1.5 times the maximum required memory. IP address of the system where the Netcool/Impact server is running. Hostname of the system where the Netcool/Impact server is running.1 Administration Guide . where server is the name of the Netcool/Impact server instance.8 and 1.65 and 1. Node NodeAlias Severity Summary Class Type AlertGroup FirstOccurrence 142 Netcool/Impact 3. including information about JVM heap usage and system memory usage. Severity calculated according to the rules in Table 26 and Table 27.Chapter 10: Netcool/Impact Self-Monitoring Table 27 shows the criteria used by Netcool/Impact to determine the severity of the systen memory status. Detailed information about the memory status.5 the maximum required memory. Available system memory is between 2 and 1.8 times the maximum required memory. Note: The total severity of any memory event sent to the ObjectServer is the highest severity between the JVM and the system memory status.65 times the maximum required memory. Table 28: Memory Event Fields (1 of 2) Field Identifier Description Impact Memory Status for server.

Memory Status Monitoring Table 28: Memory Event Fields (2 of 2) Field LastOccurrence Description Timestamp for the most recent occurrence of this event. Netcool/Impact 3.1 Administration Guide 143 .

It contains the following topics: • • • About Queue Size Monitoring Queue Status Severity Queue Status Event Fields About Queue Size Monitoring Queue size monitoring is the process in which the self-monitoring service checks the size of event reader event queues at intervals and sends events to the ObjectServer regarding the event queue status. Queue size monitoring only works when one or more event readers is running in Netcool/Impact.times the number of events at previous interval. For each event. Number of events in queue is more than 5 times the number of events at previous interval. Table 29 shows the rules used to determine the severity.3 Queue Size Monitoring This section contains information on monitoring the status of Netcool/Impact event reader event queues. Number of events in queue is between 2 and 3 times the number of events at previous interval. Queue Status Severity Table 29 shows the criteria used by Netcool/Impact to determine the severity of the event queue status.5 times the number of events at previous interval.Chapter 10: Netcool/Impact Self-Monitoring 10. Number of events in queue is between 1. 144 Netcool/Impact 3. the self-monitoring service calculates the severity by determining the rate at which the queue size is increasing or decreasing since the last interval point. Number of events in queue is between 3 and 5 times the number of events at previous interval.1 Administration Guide .5 and 2. Table 30 shows the value of fields in the events sent to the ObjectServer. Table 29: Severity Criteria for Queue Status Events Severity 1 2 3 4 5 Criteria Number of events in queue is less than or equal to 1.

This value is generated if DeltaQueue is less than zero. the queue size has increased. Table 30: Queue Status Fields Field Identifier Description Impact Queue Status for server. Current number of events in queue. Rate at which the queue is increasing. as described in Table 31. where server is the name of the Netcool/Impact server instance. If the value is less than zero. IP address of the system where the Netcool/Impact server is running. If this value is greater than zero. the queue size has decreased.1 Administration Guide 145 . Rate at which the queue is decreasing. Timestamp for the most recent occurrence of this event. Table 31: Queue Status Summary Field (1 of 2) Value Event reader name QueueSize DeltaQueue Description Name of the event reader associated with the queue.Queue Size Monitoring Queue Status Event Fields Table 28 shows the fields in memory events sent to the ObjectServer. Hostname of the system where the Netcool/Impact server is running. Node NodeAlias Severity Summary Class Type AlertGroup FirstOccurrence LastOccurrence Table 31 shows the queue status information sent as the contents of the Summary field. QueueIncreaseRate QueueDecreaseRate Netcool/Impact 3. Detailed information about the queue status. Severity calculated according to the rules in Table 26 and Table 27. 10500 13 ImpactStatus Timestamp for the first occurrence of this event. Change in queue size since the last interval. This value is generated if DeltaQueue is greater than zero.

Chapter 10: Netcool/Impact Self-Monitoring Table 31: Queue Status Summary Field (2 of 2) Value Gap Description Time difference between the StateChange of the earliest event in queue and the current time.1 Administration Guide . 146 Netcool/Impact 3.

Netcool/Impact 3.Setting Up Self-Monitoring 10. The Self-Monitoring Configuration window opens. Setting Up Self-Monitoring Using the GUI To set up self-monitoring using the Netcool/Impact GUI: 1. Figure 6: Self-Monitoring Configuration Window 3. select SelfMonitoring. Open the GUI in a web browser. This is the ObjectServer where any new events will be sent. Select a data source from the ObjectServer Data Source list. you must set up self-monitoring using the CLI or the service properties file.1 Administration Guide 147 . 2.4 Setting Up Self-Monitoring You can set up event monitoring using the following: • • • Netcool/Impact GUI Netcool/Impact CLI Netcool/Impact self-monitoring service properties file If you are running Netcool/Impact in a clustered server configuration. In the Service Status panel.

Enable or disable the Service Log option. 5. Start the command line interface by opening the following address in any telnet application: telnet hostname port where hostname is the name of the system where the Netcool/Impact server is running and port is the command line port. 4. The default port is 2000. 9. To set up self-monitoring using the CLI: 1. 3. Enter an interval in seconds in the Interval field. Setting Up Self-Monitoring Using the CLI You can use the Netcool/Impact CLI to set up self-monitoring if you running Netcool/Impact in both single server and clustered server configurations. This option specifies whether this service starts automatically when you start the Netcool/Impact server. you must stop and restart it before the change takes effect. click the Start button for the SelfMonitoring service. Specify the ObjectServer to which you want Netcool/Impact to send self-monitoring events by entering the following: UPDATE Service SET DataSource = data_source WHERE Name = ’SelfMonitoring’. 7. If you change the deduplication option while the service is running.Chapter 10: Netcool/Impact Self-Monitoring 4. This options specifies whether Netcool/Impact should deduplicate events it sends to the ObjectServer. 148 Netcool/Impact 3. 6. Specify the interval at which you want Netcool/Impact to check memory status and the event queue size by entering the following: UPDATE Service SET Interval = seconds WHERE Name = ’SelfMonitoring’. This option specifies whether to print the service log to file. In the Service Status panel. Click OK. Enable or disable the Depulication option. Enable or disable the Startup option. where dedup_option is true or false. Specify whether you want Netcool/Impact to deduplicate self-monitoring events that it sends to the ObjectServer by entering the following: UPDATE Service SET Deduplication = dedup_option WHERE Name = ’SelfMonitoring’. where data_source is the name of an ObjectServer data source. where seconds is the number of seconds in the interval. This is the number of seconds at which you want Netcool/Impact to check memory status and the event queue size.1 Administration Guide . 8. 2.

Start the self-monitoring service by entering the following: UPDATE Service SET Running = True WHERE Name = ’Self-Monitoring’. Netcool/Impact 3.Setting Up Self-Monitoring If you change the deduplication option while the service is running. 5. you must stop and restart it before the change takes effect.1 Administration Guide 149 .

You can use this information to analyze trends in Netcool/Impact memory usage. the change in queue size since the previous interval.Chapter 10: Netcool/Impact Self-Monitoring 10.5 Viewing Information About Self-Monitoring You can use the Netcool/Impact CLI to view the following information about self-monitoring: • • • • • • • • • • • Memory status history Queue status Queue status history Current JVM heap size Free JVM heap size Maximum JVM heap size Maximum required memory Available system memory Deduplication status Monitoring interval ObjectServer data source Memory Status History The memory status history is a list containing memory status information for the last 100 self-monitoring intervals. To view the memory status history enter the following at a Netcool/Impact CLI prompt: SELECT MemoryStatusHistory from Service WHERE Name = ’SelfMonitoring". including the queue size. and the rate of queue size change. 150 Netcool/Impact 3. Queue Status The status of an event queue.1 Administration Guide . To view the queue status enter the following at a Netcool/Impact CLI prompt: SELECT QueueStatus from Service WHERE Name = ’SelfMonitoring".

Netcool/Impact 3. To view the maximum required memory. enter the following at a Netcool/Impact CLI prompt: SELECT MaxVMHeapSize from Service WHERE Name = ’SelfMonitoring". To view the available JVM heap size enter the following at a Netcool/Impact CLI prompt: SELECT FreeVMHeapSize from Service WHERE Name = ’SelfMonitoring". You can use this information to analyze trends in the queue status. To view the maximum JVM heap size. Maximum Required Memory The maximum required memory is the maximum JVM heap size plus the 120 megabyte system memory overhead used by Netcool/Impact. Maximum JVM Heap Size The maximum JVM heap size is the maximum size specified by the XMX variable in the runtime definition file for Netcool/Impact. Available JVM Heap Size The available JVM heap size is the amount of memory in the Java heap that is unused by Netcool/Impact. Current JVM Heap Size The current JVM heap size is the amount of memory in the Java heap that is currently used by Netcool/Impact.1 Administration Guide 151 . enter the following at a Netcool/Impact CLI prompt: SELECT MaxVMSize from Service WHERE Name = ’SelfMonitoring". enter the following at a Netcool/Impact CLI prompt: SELECT TotalVMHeapSize from Service WHERE Name = ’SelfMonitoring". To view the queue status history enter the following at a Netcool/Impact CLI prompt: SELECT QueueStatusHistory from Service WHERE Name = ’SelfMonitoring". To view the current JVM heap size.Viewing Information About Self-Monitoring Queue Status History The queue status history is a list containing queue status history information for the last 100 self-monitoring intervals.

enter the following at a Netcool/Impact CLI prompt: SELECT DataSource from Service WHERE Name = ’SelfMonitoring". enter the following at a Netcool/Impact CLI prompt: SELECT FreeSystemMemory from Service WHERE Name = ’SelfMonitoring". enter the following at a Netcool/Impact CLI prompt: SELECT Deduplication from Service WHERE Name = ’SelfMonitoring". To view the deduplication status. Deduplication Status The deduplication status indicates whether Netcool/Impact is currently deduplicating self-monitoring events it sends to the ObjectServer. ObjectServer Data Source This is the ObjectServer where Netcool/Impact is sending self-monitoring events. 152 Netcool/Impact 3.Chapter 10: Netcool/Impact Self-Monitoring Available System Memory The available system memory is the total free memory on the system unused by Netcool/Impact and other applications.1 Administration Guide . enter the following at a Netcool/Impact CLI prompt: SELECT Interval from Service WHERE Name = ’SelfMonitoring". Monitoring Interval The monitoring interval specifies the number of seconds at which Netcool/Impact is checking the memory status and event queue size. To view the monitoring interval. To view the name of the ObjectServer data source. To view the available system memory.

fm December 15. 2004 10:15 am This chapter contains information about the Netcool/Impact command line tools. • • • • nci_crypt on page 154 nci_export on page 155 nci_import on page 156 nci_trigger on page 157 Netcool/Impact 3.Chapter 11: Command Line Tools 10_Command_Line_Tools.1 Administration Guide 153 .

1 nci_crypt The nci_crypt tool encrypts a string using the Netcool/Impact encryption algorithm. This tool is located in the $IMPACT_HOME/bin directory. To run this tool. 154 Netcool/Impact 3.Chapter 11: Command Line Tools 11. enter the following at a command prompt: $IMPACT_HOME/bin/nci_crypt string where string is the string you want to encrypt.1 Administration Guide . You can use this tool to encrypt passwords passed to Netcool/Impact from the command line with nci_trigger.

This tool is located in the $IMPACT_HOME/bin directory. Note: Make sure that the instance of the Netcool/Impact server that contains the data you are exporting is running before you use nci_export. service and policy information from an instance of the Netcool/Impact server to a specified directory. enter the following at a command prompt: $IMPACT_HOME/bin/nci_export server_name directory where server_name is the name of the server instance whose data you want to export and directory is the directory where you want to store the exported data. Netcool/Impact 3. data type. To run this tool.nci_export 11.2 nci_export The nci_export tool exports data source.1 Administration Guide 155 .

3 nci_import The nci_import tool imports data that was previously exported from an instance of the Netcool/Impact server. To run this tool. policies and services currently defined in the server instance. 156 Netcool/Impact 3.1 Administration Guide . data types. This data includes all data sources.Chapter 11: Command Line Tools 11. enter the following at a command prompt: $IMPACT_HOME/bin/nci_import server_name directory where server_name is the name of the server instance where you want to import the data and directory is the location that contains data exported using nci_export. Note: Make sure that the target instance of the Netcool/Impact server is running before you use nci_import. This tool is located in the $IMPACT_HOME/bin directory.

You can encrypt passwords using the nci_crypt tool. Optional. platform and command syntax to standard output and then exit. Value of a field in the event container passed to the policy. Instance of the Netcool/Impact server where you want the policy to run. UNIX only. Windows only.nci_trigger 11.. Note: If no password is defined for the user. Optional. Windows only. Username and encrypted password of a valid Netcool Security Manager user who has access to Netcool/Impact. Name of the policy to run. You can encrypt passwords using the nci_crypt tool. Username and password of a valid Netcool Security Manager user who has access to Netcool/Impact. you must specify the password as NULL when you execute the command. server_name user_id/password user_id password -e/user_id/encrypted_password -e user_id encrypted_password policy_name field value Netcool/Impact 3.. Name of a field in the event container passed to the policy.4 nci_trigger The nci_trigger tool allows you to start a policy from the command line. UNIX only. To run this tool. Username and encrypted password of a valid Netcool Security Manager user who has access to Netcool/Impact. Username and password of a valid Netcool Security Manager user who has access to Netcool/Impact. enter the following at a command prompt: $IMPACT_HOME/bin/nci_trigger [-version] | server_name [ user_id | user_id/password | -e/user_id/encrypted_password | NULL ] policy_name field value field value . This tool is located in the $IMPACT_HOME/bin directory. Table 32: nci_trigger Command Line Arguements Arguments -version Description Causes nci_trigger to print the Netcool/Impact version number.1 Administration Guide 157 . Table 32 shows the command line arguments for nci_trigger.

In this example. the password is netcool and the server instance is NCI. the policy is named POLICY_01. nci_trigger NCI admin/netcool POLICY_03 Node host_01 Summary Node_down AlertKey host_01Node_down 158 Netcool/Impact 3. nci_trigger NCI admin/netcool POLICY_01 This example shows how to run a policy using an encrypted password. The following example shows how to use this notation in a policy. you can enter the following at a command prompt: nci_trigger admin/netcool POLICY_01 Value1 Testing1 Value2 Testing2 This prints the following to the policy log: Testing1 Testing2 UNIX Examples This example shows how to run a simple policy from the command line that does not process an in-coming event. Runtime Parameters If you are using nci_trigger to pass runtime parameters to a policy. you must include Identifier and Serial fields in the event container passed to policy. the policy is named POLICY_01 Log(@Value1). In this example.Chapter 11: Command Line Tools Note: If you want to run a policy that contains a call to the ReturnEvent function. you must make sure that you specify the parameters as variables in the policy using the @ notation.1 Administration Guide . the user is admin. To run this policy using nci_trigger. In this example. Log(@Value2). nci_trigger NCI_02 -e/admin/7E6C7364EFD7CD69 POLICY_02 This example shows how to to run a policy and pass event field values to the policy as the contents of an incoming event container. the password was previously encrypted using the nci_crypt tool.

the password is netcool and the server instance is NCI. the policy is named POLICY_01. In this example. the password was previously encrypted using the nci_crypt tool. nci_trigger NCI admin netcool POLICY_01 This example shows how to run a policy using an encrypted password. In this example.1 Administration Guide 159 . nci_trigger NCI_02 -e admin 7E6C7364EFD7CD69 POLICY_02 This example shows how to to run a policy and pass event field values to the policy as the contents of an incoming event container.nci_trigger Windows Examples This example shows how to run a simple policy from the command line that does not process an in-coming event. nci_trigger NCI admin netcool POLICY_03 Node host_01 Summary Node_down AlertKey host_01Node_down Netcool/Impact 3. the user is admin.

1 Administration Guide .Chapter 11: Command Line Tools 160 Netcool/Impact 3.

fm December 15.1 Administration Guide 161 . It contains the following sections: • • • Installation Worksheet on page 162 Firewall Considerations on page 166 UNIX Kernel Configuration on page 167 Netcool/Impact 3.Appendix A: Supplementary Information 98_Appendix. 2004 10:15 am This appendix contains supplementary information for Netcool/Impact administrators.

Each table contains an empty Answer column that you can fill with the information that you supply to the installer programs. You should record this information during the course of installation for later reference.1 Administration Guide . you can also record the information electronically using the UNIX script command. You can use the tables in this section to record installation information. Netcool License Server The Netcool License Server installer prompts you for the following information: Table A1: Netcool Common License Server Installer Prompts Prompt Installation directory Answer Netcool GUI Server The Netcool GUI Server installer prompts you for the following information: Table A2: Netcool GUI Server Installer Prompts (1 of 2) Prompt Installation directory Answer Application Registry directory Shutdown port HTTP port 162 Netcool/Impact 3.Appendix A: Supplementary Information A. If you install the components in console mode.1 Installation Worksheet The installer programs for Netcool/Impact and its related software components prompt you for system information during the installation process.

Installation Worksheet Table A2: Netcool GUI Server Installer Prompts (2 of 2) Prompt Security Manager host Answer Security Manager port License Server host License Server port Netcool Security Manager The Netcool Security Manager installer prompts you for the following information: Table A3: Netcool Security Manager Installation Prompts Prompt Installation directory Answer HTTP listener port Server port Database port License server host License server port Netcool/Impact 3.1 Administration Guide 163 .

1 Administration Guide .Appendix A: Supplementary Information Netcool/Impact The Netcool/Impact installer prompts you for the following information: Table A4: Netcool/Impact Installer Prompts Prompt Installation directory Answer Version control system License server host License server port Registry host Registry port PostgreSQL port Netcool/Impact Server The nci_new_server script prompts you for the following information: Table A5: Netcool/Impact New Server Script Prompts (1 of 2) Prompt Instance name Answer Cluster name 164 Netcool/Impact 3.

1 Administration Guide 165 .Installation Worksheet Table A5: Netcool/Impact New Server Script Prompts(Continued) (2 of 2) Prompt Command line port Answer ObjectServer host ObjectServer port Impact HTTP port SMTP host E-Mail sender name Version control system Netcool/Impact 3.

or if you are installing them on Windows systems with built-in firewall software. This port is used by the GUI Server to serve the Netcool/Impact GUI and the Security Manager GUI. This port is also used to serve the Security Manager GUI in standalone configurations. Table A6: Netcool/Impact Component Ports Default Port 5104 Description Netcool/Impact HTTP port. 2000 8080 8077 27000 4100 If you are using Netcool/Impact to access data sources that are located on a separate system (for example.2 Firewall Considerations If you are running Netcool/Impact and its related components in a networked environment where components are separated by a firewall.1 Administration Guide . This port is used by the License Server for communication with other Netcool components. you can use information in Table A6 to make sure that access is permitted between components at the designated ports. This port is also used by the Netcool Application Registry to communicate with Netcool components. Security Manager port. GUI Server HTTP port.Appendix A: Supplementary Information A. This port is also used in a clustered server configuration for communication between cluster members. an SQL database). 166 Netcool/Impact 3. you must make sure that the data source port is accessible to Netcool/Impact through any firewall configuration. Netcool/Impact command line port. Netcool/OMNIbus ObjectServer port. This port is used for communication between Netcool/Impact and the Netcool GUI Server. License Server port. This port is used by the Security Manager to communicate with Netcool/Impact and other Netcool components. This port is used by the Netcool Security Manager for ObjectServer authentication and for the default ObjectServer data source.

where arch is the name of the operating system. If you are running both Netcool/Impact and the Netcool Security Manager on a single system. you should set the maximum shared memory to 128 MB. In addition. Micromuse recommends a settting of 64 MB.1 Administration Guide 167 . if you are installing on HP-UX.UNIX Kernel Configuration A. Note: You must reboot the system in order for the new settings to take effect. kernel configuration settings are located in the /etc/system file.html.3 UNIX Kernel Configuration The Netcool/Impact database is a customized version of PostgreSQL that has been prepared for use with this application. PostgreSQL requires a maximum shared memory setting of at least 32 MB for each instance running on a system. Configuring Solaris On Solaris platforms. This documentation is distributed with Netcool/Impact and is located in the $IMPACT_HOME/platform/arch/pgsql/doc/html directory. Netcool/Impact 3. see the official PostgreSQL documentation. you must configure the operating system kernel so that it fulfills the memory requirements for the PostgreSQL database. Before you install Netcool/Impact on UNIX platforms. you must modify the file so that it contains the following lines: set set set set set set set set shmsys:shminfo_shmmax=max_memory shmsys:shminfo_shmmin=1 shmsys:shminfo_shmmni=256 shmsys:shminfo_shmseg=256 semsys:seminfo_semmap=256 semsys:seminfo_semmni=512 semsys:seminfo_semmns=512 semsys:seminfo_semmsl=32 where max_memory is at least 0x4000000 on systems where you are installing either Netcool/Impact and the Security Manager or 0x8000000 on systems where you are installing both. The HTML file that contains instructions on configuring the operating system kernel is named kernel-resources. For more information. you must also configure the kernel to accomodate the threading requirements of Netcool/Impact. To configure shared memory settings on Solaris.

Note that changes to the proc file system are not persistent after reboot.shmmax=max_memory where max_memory is at least 6710864 on systems where you are installing either Netcool/Impact or the Security Manager and at least 13421728 on systems where you are installing both. To make the change without rebooting. You can specify the max_thread_proc setting using the HP-UX Kernel Configuration tool. To configure the kernel you must modify the file so that it contains the following line: kernel. enter the following at a comment line prompt: echo max_memory >/proc/sys/kernel/shmmax where max_memory is the new maximum memory setting. you can also configure the proc file system. Settings of less than 500 can cause the Netcool/Impact server to fail at startup. Configuring HP-UX Netcool/Impact requires a max_thread_proc setting of at least 500 on HP-UX. Note: You must reboot the system in order for the new settings to take effect. kernel configuration settings are located in the /etc/sysctl. To change the shared memory. 168 Netcool/Impact 3.conf file. Configuring AIX The default kernel configuration for AIX is adequate for running Netcool/Impact and the Netcool Security Manager.Appendix A: Supplementary Information Configuring Red Hat Linux On Red Hat Linux platforms.1 Administration Guide . You do not need to configure kernel settings on AIX platforms.

fm December 15. It contains the following sections: • • • • • • • • • • • About the Built-In DSAs on page 170 DB2 DSA on page 172 Flat File DSA on page 174 Informix DSA on page 176 MySQL DSA on page 178 ObjectServer DSA on page 180 ODBC DSA on page 182 Oracle DSA on page 183 PostgreSQL DSA on page 185 SQL Server DSA on page 187 Sybase DSA on page 189 Netcool/Impact 3. 2004 This appendix contains reference information related to built-in Netcool/Impact DSAs.1 Administration Guide 169 .Appendix B: DSA Reference 99_Appendix.

Data Source Configuration Properties When you create a new data source for use with an SQL database DSA.1 About the Built-In DSAs Netcool/Impact provides a standard set of built-in data source adaptors (DSAs) that you can use to access common SQL database data sources.Appendix B: DSA Reference B. Some DSAs require additional information. as well as field names that correspond to each column in the table. you must specify a set of configuration properties. These properties typically include the data source name and connectivity information for the underlying database (for example. you are required to specify the name of the table (or similar structure) in the underlying data source. field names can be specified using the auto-discovery tools. These DSAs are installed automatically when you install Netcool/Impact and are only visible in the Netcool/Impact GUI after you have installed licenses for them in the Netcool Common License Server. You can use the information provided on driver versions to debug and troubleshoot DSA performance and to better understand the scope and scale of functionality provided. 170 Netcool/Impact 3. In most cases.1 Administration Guide . the hostname and port). Data Type Configuration Properties When you create a new data type for use with an SQL database data source. SQL Database DSAs This chapter provides the following information about SQL database DSAs: • • • • • JDBC driver versions Data source configuration properties Data type configuration properties Supported data types Special considerations JDBC Driver Versions SQL database DSAs use Java Database Connectivity (JDBC) drivers to connect to underlying data sources.

Special Considerations Some SQL database DSAs require you to perform additional steps or prevent you from accessing functionality specific to the underlying database. However. In most cases. whole number data types are treated as Netcool/Impact integers and decimal data types are treated as Netcool/Impact floats. some DSAs exclude rarely-used data types. Netcool/Impact 3. data types representing string or character values are treated as Netcool/Impact strings.1 Administration Guide 171 .About the Built-In DSAs Supported Data Types SQL database DSAs allow you to access information stored in most of the data types in the underlying database.

Default is 6789. Data Source Configuration Properties Table B1 shows the configuration properties that you set when you create a DB2 data source. Table B1: DB2 Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the DB2 data source. Maximum number of simultaneous SQL connections to the DB2 database. Hostname of the system where the primary DB2 database is running. see the DB2 website at http://www.Appendix B: DSA Reference B. Name of the backup DB2 database. Hostname of the system where the backup DB2 database is running. Name of the primary DB2 database. Default is 6789. Connection port used by the primary DB2 database. For more information on this driver. Connection port used by the backup DB2 database. JDBC Driver Version This DSA uses version 7. Default is 5. Username to use when accessing the DB2 database.1 Administration Guide . Primary Hostname Primary Port Primary Database Backup Hostname Backup Port Backup Database Disable Data Source Failover 172 Netcool/Impact 3. Specifies that you do not want to use DSA failover with this data source. Password to use when accessing the DB2 database.2 DB2 DSA The DB2 DSA is a built-in component of Netcool/Impact that allows you to access information in an IBM DB2 database.2 of the DB2 JDBC driver.com/software/data/db2/.ibm.

Table B2: DB2 DSA Supported Data Types DB2 Data Type smallint. decimal.1 Administration Guide 173 . dbclob. timestamp blob.DB2 DSA Data Types Table B2 shows the supported DB2 data types and their Netcool/Impact equivalents. clob date. real. double. integer. long varchar. numeric char. bigint float. vargraphic Netcool/Impact Data Type Integer Float String Date Not supported Netcool/Impact 3. varchar. graphic. time.

email. name. You must enclose the delimiter character in single quotation marks when you define it in the Netcool/Impact GUI. This text file must be a multi-line file.mgonzalez@example.+ /. Field names can contain any character except the double quotation mark (") and the space character ( ).com. File Format The Flat File DSA is capable of reading a character-delimited text file stored on the file system where Netcool/Impact is running. The following is an example of a character-delimited text file. Path of the text file that contains the data you want to access using this DSA. Delimiters 174 Netcool/Impact 3.Appendix B: DSA Reference B. You specify the filename when you create a flat file data type.San Francisco Data Source Configuration Properties Table B3 shows the configuration properties for Flat File data sources. . You cannot use the Flat File DSA to write information to a text file.com. The DSA supports the following delimiters: .3 Flat File DSA The Flat File DSA is a built-in component of Netcool/Impact that allows you to read information in a character-delimited text file. . Table B3: Flat File Data Source Configuration Properties Property Data Source Name Directory Description Name of the data source. where the first line specifies the names of the fields and each subsequent line represents a row of data.New York Anna Singh.asingh@example. Use of text files and the Flat File DSA is not an effective substitute for the use of a conventional relational database and an SQL database DSA.1 Administration Guide . In this example.location Mark Gonzalez. The Flat File DSA offers slow performance when compared to other DSAs.London James Chen.jchen@example.com. Delimiter character that separates fields in the text file. email and location are the field names. name. Note: The Flat File DSA is intended for use in demonstrating and testing Netcool/Impact and for infrequently accessing small amounts of data stored in a text file.

greater than (>) and LIKE. Other operators. Netcool/Impact 3. Special Considerations The Flat File DSA only supports the use of the equal operatory (=) in SQL filter statements. are not supported. with the exception that.Flat File DSA Data Type Configuration Properties You configure a Flat File data type in the same way that you configure other SQL database data types. instead of a table name in the Base Table field. like less than (<). You use SQL filters when you call the GetByFilter function in the policy language and when you use filters while browsing data type contents in the Netcool/Impact GUI. you specify the name of the text file that contains the information you want to access.1 Administration Guide 175 .

4 Informix DSA The Informix DSA is a built-in component of Netcool/Impact that allows you to access information in an IBM Informix database. Hostname of the system where the backup Informix database is running. Primary Hostname Primary Port Primary Server Primary Database Backup Hostname Backup Port Backup Server Backup Database Disable Data Source Failover 176 Netcool/Impact 3. For more information.1 Administration Guide . Data Source Configuration Properties Table B1 shows the configuration properties that you set when you create an Informix data source. Connection port used by the backup Informix database. JDBC Driver Version This DSA uses version 1. Default is 5.JC2 of the Informix JDBC driver. Server name where the backup Informix database resides.Appendix B: DSA Reference B. Connection port used by the primary Informix database. Name of the backup Informix database. Maximum number of simultaneous SQL connections to the Informix database. see the Informix JDBC website at http://www-306. Hostname of the system where the primary Informix database is running. Default is 1526.ibm.40. Table B4: Informix Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the Informix data source. Name of the primary Informix database. Default is 1526. Username to use when accessing the Informix database.com/software/data/informix/tools/jdbc/. Specifies that you do not want to use Informix failover with this data source. Server name where the primary Informix database resides. Password to use when accessing the Informix database.

insert or update interval fields may cause runtime errors.Informix DSA Data Types Table B5 shows the supported Informix data types and their Netcool/Impact equivalents. Attempts to retrieve. SMALLFLOAT. BYTE Netcool/Impact Data Type Integer Float String Date String Not supported Special Considerations Netcool/Impact supports the Informix DATETIME data type in YEAR to FRACTIONs format only. 2004-07-01 08:45:01. Netcool/Impact does not support inserts or updates on DATE fields in Informix tables. Informix fields of INTERVAL data type are not supported by Netcool/Impact.1 Administration Guide 177 . INTERVAL. Netcool/Impact 3.nn (for example. If an Informix table contains datetime columns that use another format.10). This means that you cannot add or update data items in the associated Netcool/Impact data types unless you specify that you want to exclude the fields from inserts. To ensure that Netcool/Impact functions correctly with this data type. SMALLINT FLOAT. DATETIME MONEY BLOB. you must convert the column type before you can access the table using Netcool/Impact. You can set the exclude from insert option in the Netcool/Impact GUI when you edit data type fields. Table B5: Informix DSA Supported Data Types Informix Data Type INT. DEC CHAR. make sure that datetime fields use the format yyyy-mm-dd hh:mm:ss. VARCHAR DATE.

JDBC Driver Version This DSA uses version 2.5 MySQL DSA The MySQL DSA is a built-in component of Netcool/Impact that allows you to access information in a MySQL database. Primary Hostname Primary Port Primary Database Backup Hostname Backup Port Backup Database Disable Data Source Failover 178 Netcool/Impact 3.org. Default is 5.Appendix B: DSA Reference B.mysql. Default is 3306. Specifies that you do not want to use MySQL failover with this data source. Name of the primary MySQL database. Connection port used by the primary MySQL database. see the MySQL website at http://www. Username to use when accessing the MySQL database. Hostname of the system where the primary MySQL database is running. Maximum number of simultaneous SQL connections to the MySQL database. Hostname of the system where the backup MySQL database is running. Data Source Configuration Properties Table B6 shows the configuration properties that you set when you create a MySQL data source. Name of the backup MySQL database.0 of the MySQL Connector/J JDBC driver. Connection port used by the backup MySQL database. For more information.1 Administration Guide . Table B6: MySQL Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the MySQL data source. Password to use when accessing the MySQL database. Default is 3306.

DECIMAL. FIXED CHAR. DATETIME. INT FLOAT.MySQL DSA Data Types Table B7 shows the supported MySQL data types and their Netcool/Impact equivalents.1 Administration Guide 179 . MEDIUMBLOB. BLOB. SMALLINT. MEDIUMINT. BIGINT. TEXT DATE. YEAR TINYBLOB. ENUM Netcool/Impact Data Type Integer Float String Date String Not supported Netcool/Impact 3. DOUBLE. TIMESTAMP TIME. Table B7: MySQL DSA Supported Data Types MySQL Data Type TINYINT. LONGBLOG. SET. VARCHAR.

Appendix B: DSA Reference

B.6

ObjectServer DSA
The ObjectServer DSA is a built-in component of Netcool/Impact that allows you to access information in a Netcool/OMNIbus ObjectServer. Note: Use of the ObjectServer DSA is not required for Netcool/Impact to retrieve events from the ObjectServer using the event reader server or to add, update, or delete events from within a policy using the ReturnEvent function.

Supported Versions
This DSA supports versions 3.5, 3.6, and v7 of the ObjectServer.

Data Source Configuration Properties
Table B8 shows the configuration properties that you set when you create an ObjectServer data source.
Table B8: ObjectServer Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the ObjectServer data source. Username to use when accessing the ObjectServer database. Password to use when accessing the ObjectServer database. Maximum number of simultaneous SQL connections to the ObjectServer database. Default is 5. Hostname of the system where the primary ObjectServer database is running. Connection port used by the primary ObjectServer database. Default is 1521. Hostname of the system where the backup ObjectServer database is running. Connection port used by the backup ObjectServer database. Default is 1521. Specifies that you do not want to use ObjectServer failover with this data source.

Primary Hostname Primary Port Backup Hostname Backup Port Disable Data Source Failover

180

Netcool/Impact 3.1 Administration Guide

ObjectServer DSA

Data Types
Table B9 shows the supported ObjectServer data types and their Netcool/Impact equivalents.
Table B9: ObjectServer DSA Supported Data Types ObjectServer Data Type INTEGER, UNSIGNED, INCR REAL CHAR, VARCHAR TIME BOOLEAN Netcool/Impact Data Type Integer Float String Integer String

Netcool/Impact 3.1 Administration Guide

181

Appendix B: DSA Reference

B.7

ODBC DSA
The ODBC DSA is a built-in component of Netcool/Impact that allows you to access information in an ODBC data source.

JDBC Version
This DSA uses JDBC/ODBC bridge technology provided by version 1.4 of the Java 2 Software Development Kit.

Data Types
Generally, ODBC data types are treated as their closest equivalent by Netcool/Impact. For example, all whole number data types are treated as integers by Netcool/Impact and all decimal data types are treated as Floats. Similarly, all data types that store text are treated as strings.

182

Netcool/Impact 3.1 Administration Guide

Oracle DSA

B.8

Oracle DSA
The Oracle DSA is a built-in component of Netcool/Impact that allows you to access information in an Oracle database.

JDBC Version
This DSA uses version 9i of the Oracle JDBC driver.

Data Source Configuration Properties
Table B10 shows the configuration properties that you set when you create an Oracle data source.
Table B10: Oracle Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the Oracle data source. Username to use when accessing the Oracle database. Password to use when accessing the Oracle database. Maximum number of simultaneous SQL connections to the Oracle database. Default is 5. Hostname of the system where the primary Oracle database is running. Connection port used by the primary Oracle database. Default is 4100. Server ID of the server where the primary Oracle database resides. Default is ORCL. Hostname of the system where the backup Oracle database is running. Connection port used by the backup Oracle database. Default is 4100. Server ID of the server where the backup Oracle database resides. Default is ORCL. Specifies that you do not want to use Oracle failover with this data source.

Primary Hostname Primary Port Primary SID Backup Hostname Backup Port Backup SID Disable Data Source Failover

Netcool/Impact 3.1 Administration Guide

183

NVARCHAR2 CLOB BLOB. LONG RAW. NCHAR. Table B11: Oracle DSA Supported Data Types Oracle Data Type NUMBER FLOAT CHAR. INTERVAL_YEAR Netcool/Impact Data Type Integer Float String Clob Not supported 184 Netcool/Impact 3.1 Administration Guide . BFILE. RAW.Appendix B: DSA Reference Data Types Table B11 shows the supported Oracle data types and their Netcool/Impact equivalents.

org. Connection port used by the backup PostgreSQL database.0 driver. Table B12: PostgreSQL Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the PostgreSQL data source. Username to use when accessing the PostgreSQL database. JDBC Version This DSA uses version 7.3 of the PostgreSQL JDBC 3. visit the PostregSQL JDBC website at http://jdbc. Default is 5432.PostgreSQL DSA B. Hostname of the system where the backup PostgreSQL database is running.postgresql. Maximum number of simultaneous SQL connections to the PostgreSQL database. Password to use when accessing the PostgreSQL database. Primary Hostname Primary Port Backup Hostname Backup Port Disable Data Source Failover Netcool/Impact 3. For more information on this driver. Default is 5. Data Source Configuration Properties Table B12 shows the configuration properties that you set when you create a PostgreSQL data source. Hostname of the system where the primary PostgreSQL database is running. Default is 5432.9 PostgreSQL DSA The PostgreSQL DSA is a built-in component of Netcool/Impact that allows you to access information in an PostgreSQL database.1 Administration Guide 185 . Connection port used by the primary PostgreSQL database. Specifies that you do not want to use PostgreSQL failover with this data source.

1 Administration Guide . double precision char. real. bigint.Appendix B: DSA Reference Data Types Table B13 shows the supported PostgreSQL data types and their Netcool/Impact equivalents. text boolean Inet. numeric. character varying. integer. Table B13: PostgreSQL DSA Supported Data Types PostgreSQL Data Type smallint. 186 Netcool/Impact 3. Micromuse recommends that you use the numeric or decimal data type in PostgreSQL as a substitute. varchar.3 and later of PostgreSQL. bigserial decimal. serial. cidr Netcool/Impact Data Type Integer Float String Boolean String Special Considerations The money data type is deprecated in versions 7. This data type is not supported by Netcool/Impact. macaddr. character.

Connection port used by the backup SQL Server database. Default is 5. visit the jTDS website at http://jtds. Hostname of the system where the primary SQL Server database is running. JDBC Version The SQL Server DSA uses version 0.SQL Server DSA B.sourceforge. Primary Hostname Primary Port Backup Hostname Backup Port Disable Data Source Failover Netcool/Impact 3. Maximum number of simultaneous SQL connections to the SQL Server database. Specifies that you do not want to use SQL Server failover with this data source. Default is 5432.1 Administration Guide 187 . Data Source Configuration Properties Table B14 shows the configuration properties that you set when you create an SQL Server data source. Default is 5432.net/.10 SQL Server DSA The SQL Server DSA is a built-in component of Netcool/Impact that allows you to access information in a Microsoft SQL Server database. Password to use when accessing the SQL Server database. Table B14: SQL Server Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the SQL Server data source. Username to use when accessing the SQL Server database.8rc1of the jTDS JDBC driver. Hostname of the system where the backup SQL Server database is running. For more information on this driver. Connection port used by the primary SQL Server database.

smalldatetime smallmoney. nvarchar. float. varchar. uniqueidentifier binary. varbinary. real char.Appendix B: DSA Reference Data Types Table B15 shows the supported SQL Server data types and their Netcool/Impact equivalents. Table B15: SQL Server DSA Supported Data Types SQL Server Data Type tinyint. nchar.1 Administration Guide . ntext datetime. text. numeric. int. bigint decimal. smallint. money. cursor Netcool/Impact Data Type Integer Float String Date String Not supported 188 Netcool/Impact 3. image.

Default is 5000. Supported Versions This DSA uses version 5.Sybase DSA B. Default is 5000. Password to use when accessing the Sybase database. Hostname of the system where the primary Sybase database is running. Connection port used by the primary Sybase database. Connection port used by the backup Sybase database. Default is 5. Primary Hostname Primary Port Backup Hostname Backup Port Disable Data Source Failover Netcool/Impact 3.11 Sybase DSA The Sybase DSA is a built-in component of Netcool/Impact that allows you to access information in a Sybase database.1 Administration Guide 189 . Hostname of the system where the backup Sybase database is running. Specifies that you do not want to use Sybase failover with this data source.5 of the Sybase jConnect JDBC driver. Table B16: Sybase Data Source Configuration Properties Property Data Source Name Username Password Maximum SQL Connections Description Name of the Sybase data source. Username to use when accessing the Sybase database. Data Source Configuration Properties Table B16 shows the configuration properties that you set when you create a Sybase data source. Maximum number of simultaneous SQL connections to the Sybase database.

VARCHAR. UNIVARCHAR. FLOAT CHAR. INT NUMERIC. SMALLINT. TEST. Table B17: Sybase DSA Supported Data Types Sybase Data Type TINYINT. IMAGE Netcool/Impact Data Type Integer Float String Date Float Not supported 190 Netcool/Impact 3. DATETIME SMALLMONEY. VARBINARY. NCHAR. UNICHAR.1 Administration Guide .Appendix B: DSA Reference Data Types Table B17 shows the supported Sybase data types and their Netcool/Impact equivalents. REAL. DECIMAL. MONEY BINARY. NVARCHAR SMALLDATETIME.

2004 10:15 am Index A authentication 99 H host ID (License Server) 39 C cygwin Netcool/Impact database limitations 127 I IMPACT_HOME 90 ImpactUser role 99 importing Netcool/Impact data 156 D DB2 DSA 172 Informix DSA 176 installing GUI Server 60 License Server 36 Netcool/Impact 88 E event queue monitoring 144 exporting Netcool/Impact data 155 J JRExec server 134 configuring 136 running 135 F Flat File DSA 174 G GUI Server 54 Application Registry 58 architecture 59 components 58 configuring 66 environment variables 62 installing 60 Java Development Kit (AIX and HP-UX) 60 licensing 63 logging 77 running 65 Servlet Engine 58 uninstalling 78 GUI_HOME 62 L license files 33 License Server 28 architecture 32 command line tools (UNIX) 43 components 33 daemons (UNIX) 33 environment variables 37 host ID 39 installing 36 LMTOOLS (Windows) 45 running (UNIX) 43 running (Windows) 45 service (Windows) 33 system requirements 31 uninstalling 51 Netcool/Impact 3.Index MMGuideIX.fm December 15.1 Administration Guide 191 .

using with nci_trigger 158 S self-monitoring 138 setting up 147 viewing information 150 server clustering 112 192 Netcool/Impact 3.1 Administration Guide . 83 uninstalling 101 upgrading 91 O ObjectServer DSA 180 ODBC DSA 182 Oracle DSA 183 P PostgreSQL DSA 185 Q queue size monitoring 144 quorum licensing 48 GUI Server 63 License Server 48 Netcool/Impact 97 R runtime parameters.Index licenses feature codes 40 host ID 39 installing 39 licensing. quorum 48 LMTOOLS 45 Netcool/Impact database 126 configuring 128 managing 130 running 129 Netcool/Impact Server 104 creating instances 106 deleting instances 110 monitoring instances 109 running instances (UNIX) 107 running instances (Windows) 108 Netcool/Impact server clustering 112 NETCOOL_LICENSE_PATH 38 M memory status monitoring 140 MySQL DSA 178 N ncgui_server 65 ncgui_shutdown 65 nci_db 129 nci_export 155 nci_import 156 nci_jrexec 135 nci_server 107 nci_shutdown 107 NCLICENSE 37 Netcool/Impact 80 architecture 87 backing up and restoring 100 components 85 configuring registry settings 98 CVS 86 DSAs 86 environment variables 90 installing 88 JRExec server 86 license feature codes 95 licensing 91 Operator View 86 server clustering 112 shared memory requirements 88 system requirements 56.

1 Administration Guide 193 .Index components 113 shared memory requirements Netcool/Impact 88 Netcool/Impact database 88 SQL Server DSA 187 Sybase DSA 189 U uninstalling GUI Server 78 License Server 51 Netcool/Impact 101 upgrading Netcool/Impact 91 V version control 122 configuring 124 process 123 Netcool/Impact 3.

1 Administration Guide .Index 194 Netcool/Impact 3.

UK) +61 (0) 8 9213 3470 (Perth.1 Administration Guide 195 .micromuse. 2004 Corporate Region USA Address Micromuse Inc. Level 2 26 Colin Street West Perth Perth WA 6005 Australia Telephone 1-800-Netcool (638 2665) +1 415 538 9090 Fax +1 415 538 9091 World Wide Web http://www.com.micromuse.micromuse.uk ASIA-PACIFIC +61 (0) 8 9213 3400 +61 (0) 8 9486 1116 http://www.au Technical Support Region USA Telephone 1-800-Netcool (800 638 2665) +1 415 538 9090 (San Francisco) EUROPE ASIA-PACIFIC +44 (0) 20 8877 0073 (London.micromuse.com +44 (0) 20 8875 0991 +61 (0) 8 9486 1116 World Wide Web http://support.com/helpdesk/licenses Netcool/Impact 3. (HQ) 139 Townsend Street San Francisco CA 94107 USA Micromuse Ltd.co.com Fax +1 415 538 9091 License Generation Team E-Mail licensing@micromuse. Disraeli House 90 Putney Bridge Road London SW18 1DA United Kingdom Micromuse Ltd.fm December 15.micromuse.com EUROPE +44 (0) 20 8875 9500 +44 (0) 20 8875 9995 http://www. Australia) E-mail GLOBAL support@micromuse.com World Wide Web http://support.Contact Information backmatter.

Contact Information 196 Netcool/Impact 3.1 Administration Guide .

Sign up to vote on this title
UsefulNot useful