net cool administration guide

Tivoli Netcool/ImpactVersion 5.1.1

Administration Guide

SC23-8829-02

NoteBefore using this information and the product it supports, read the information in Appendix D, Notices, on page 115.

Edition notice

This edition applies to version 5.1.1 of IBM Tivoli Netcool/Impact and to all subsequent releases and modificationsuntil otherwise indicated in new editions.

Copyright International Business Machines Corporation 2006, 2009.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

ContentsAbout this publication . . . . . . . . viiIntended audience . . . . . . . . . . . . viiPublications . . . . . . . . . . . . . . vii

Tivoli Netcool/Impact library . . . . . . . viiAccessing terminology online . . . . . . . viiAccessing publications online . . . . . . . viiiOrdering publications . . . . . . . . . viii

Accessibility . . . . . . . . . . . . . . viiiTivoli technical training . . . . . . . . . . viiiSupport for problem solving . . . . . . . . . ix

Using IBM Support Assistant . . . . . . . ixObtaining fixes . . . . . . . . . . . . xReceiving weekly support updates . . . . . . xContacting IBM Software Support . . . . . . xi

Conventions used in this publication . . . . . xiiiTypeface conventions . . . . . . . . . . xiiiOperating system-dependent variables andpaths . . . . . . . . . . . . . . . xiii

Chapter 1. Introduction . . . . . . . . 1Overview of deployments . . . . . . . . . . 1Deployment components . . . . . . . . . . 1

Impact Server . . . . . . . . . . . . . 1GUI Server . . . . . . . . . . . . . . 2Netcool Database Server . . . . . . . . . 2

Deployment types . . . . . . . . . . . . 2Setting up a deployment . . . . . . . . . . 3

Planning an installation. . . . . . . . . . 3Installing components . . . . . . . . . . 3Configuring components . . . . . . . . . 3

Running a deployment . . . . . . . . . . . 4

Chapter 2. Installing TivoliNetcool/Impact . . . . . . . . . . . . 5System requirements. . . . . . . . . . . . 5Running the installer in GUI mode . . . . . . . 6Running the installer in console mode . . . . . 17Running the installer in silent mode . . . . . . 23Silent installation response file . . . . . . . . 25Verifying the deployment. . . . . . . . . . 27Installation logs . . . . . . . . . . . . . 28Installing the JRExec server (Windows platforms). . 28Setting up JDBC for GenericSQL DSA . . . . . 28Running a deployment . . . . . . . . . . 29Uninstalling Tivoli Netcool/Impact . . . . . . 29

Uninstalling Tivoli Netcool/Impact componentson Windows platforms . . . . . . . . . 29Uninstalling Tivoli Netcool/Impact componentson UNIX platforms . . . . . . . . . . . 29

Post installation utility. . . . . . . . . . . 30

Chapter 3. Managing the Impact Server 33Overview of the Impact Server . . . . . . . . 33Creating Impact Server instances . . . . . . . 33Running Impact Server instances . . . . . . . 34

Using Impact Server administration scripts . . . 34Configuring RMI ports . . . . . . . . . . 34Monitoring deployment components . . . . . . 35

Monitoring server instances . . . . . . . . 35Log4j properties file . . . . . . . . . . 35Monitoring services. . . . . . . . . . . 36

Deleting Impact Server instances . . . . . . . 36Enabling read-only mode . . . . . . . . . . 37Stopping the embedded version of WebSphereApplication Server . . . . . . . . . . . . 37Starting the embedded version of WebSphereApplication Server . . . . . . . . . . . . 38

Chapter 4. Managing the GUI Server . . 39Overview of the GUI Server . . . . . . . . . 39GUI Server components . . . . . . . . . . 39

GUI engine . . . . . . . . . . . . . 39Name Server . . . . . . . . . . . . . 39

Running the GUI Server . . . . . . . . . . 40Redeploying the GUI Server . . . . . . . . . 40Enabling HTTPS on the GUI Server . . . . . . 40

Chapter 5. Server clustering . . . . . 41Server clustering overview . . . . . . . . . 41Server cluster components . . . . . . . . . 41Name Server cluster components . . . . . . . 42Impact Server clustering process . . . . . . . 42Name Server clustering process. . . . . . . . 43Setting up the server cluster . . . . . . . . . 44Runtime analysis . . . . . . . . . . . . 47Checking the cluster status in the Name Server . . 47Configuring Event Processor service . . . . . . 48Connection properties between the Name Serverand the Impact Server . . . . . . . . . . . 49Connection properties between the Name Serverand the GUI Server . . . . . . . . . . . . 49Name Server configuration properties . . . . . 50Impact Server cluster configuration properties . . . 52

Chapter 6. Version control . . . . . . 55Version control overview . . . . . . . . . . 55Version control process . . . . . . . . . . 55Configuring version control . . . . . . . . . 56Version control script . . . . . . . . . . . 56

Checking out files . . . . . . . . . . . 57Checking in files. . . . . . . . . . . . 57Adding files . . . . . . . . . . . . . 57Unchecking out files . . . . . . . . . . 58Creating a checkpoint . . . . . . . . . . 58Updating the sandbox . . . . . . . . . . 58

Migrating to Subversion . . . . . . . . . . 59

Chapter 7. Netcool Database Server . . 61Overview of the Netcool Database Server . . . . 61Setting the database port . . . . . . . . . . 61

Copyright IBM Corp. 2006, 2009 iii

|||||||||||||||||||||||||||||||||

||||||||||||||||||||||||||||||||||||||||||||||||||||||

Running the Netcool Database Server . . . . . 61Starting the database server . . . . . . . . 62Stopping the database server . . . . . . . 62

Managing the Netcool Database Server . . . . . 62Viewing the database status . . . . . . . . 62Resetting the database . . . . . . . . . . 62Connecting to the database with the commandline client . . . . . . . . . . . . . . 62Backing up the database . . . . . . . . . 62Restoring the database. . . . . . . . . . 63

Chapter 8. JRExec server. . . . . . . 65Overview of the JRExec server . . . . . . . . 65Running the JRExec server on UNIX platforms . . 65Running the JRExec server on Windows platforms 65Configuring the JRExec server . . . . . . . . 65

Chapter 9. Self-monitoring . . . . . . 67Self-monitoring overview . . . . . . . . . . 67Self-monitoring in server cluster . . . . . . . 67Setting up self-monitoring using the GUI . . . . 68Running self-monitoring using the GUI . . . . . 68Running self-monitoring using the command lineinterface . . . . . . . . . . . . . . . 68Setting the Object Server Data Source for monitoringevents . . . . . . . . . . . . . . . . 69Memory status monitoring . . . . . . . . . 69

Java memory status. . . . . . . . . . . 69System memory status. . . . . . . . . . 70Combined memory status . . . . . . . . 70Memory status severity . . . . . . . . . 70Memory event fields . . . . . . . . . . 71Checking if memory status monitoring is enabled 71Enabling memory status monitoring . . . . . 71Disabling memory status monitoring . . . . . 72Viewing current memory status. . . . . . . 72Viewing memory status history. . . . . . . 72Viewing the total JVM heap size . . . . . . 72Viewing the maximum JVM heap size . . . . 72Viewing the free system memory . . . . . . 72Checking if memory status events arededuplicated . . . . . . . . . . . . . 72Disabling memory status event deduplication . . 72Viewing memory status event intervals . . . . 73Changing memory status event intervals . . . 73

Queue status monitoring . . . . . . . . . . 73Queue status severity . . . . . . . . . . 73Queue status event fields . . . . . . . . . 74Checking if queue status monitoring is enabled 74Enabling queue status monitoring . . . . . . 75Disabling queue status monitoring. . . . . . 75Viewing the current queue status . . . . . . 75Viewing the queue status history . . . . . . 75Checking if queue status event deduplication isenabled. . . . . . . . . . . . . . . 75Enabling queue status event deduplication . . . 75Disabling queue status event deduplication. . . 75Viewing queue status event intervals . . . . . 75Changing queue status event intervals . . . . 76

Data source status monitoring . . . . . . . . 76

Data source status events . . . . . . . . . 76Data source status event fields . . . . . . . 77Checking if data source status monitoring isenabled. . . . . . . . . . . . . . . 78Enabling data source status monitoring . . . . 78Disabling data source status monitoring . . . . 78Viewing the current data source status . . . . 78Viewing the data source status history . . . . 78

Cluster Status Monitoring . . . . . . . . . 78Starting self-monitoring on a secondary clustermember . . . . . . . . . . . . . . 79Cluster status events . . . . . . . . . . 79Cluster status event fields . . . . . . . . 79Checking if cluster status monitoring is enabled 80Enabling cluster status monitoring. . . . . . 80Disabling cluster status monitoring . . . . . 81Viewing the current cluster status . . . . . . 81Viewing the cluster status history . . . . . . 81

Chapter 10. Secure communication inTivoli Netcool/Impact . . . . . . . . 83Setting up SSL communication in TivoliNetcool/Impact . . . . . . . . . . . . . 83

Generating the SSL keystore, server certificateand truststore. . . . . . . . . . . . . 83Copying the SSL keystore, server certificate andtruststore . . . . . . . . . . . . . . 84Configuring the embedded version of WebSphereApplication Server for SSL certificate and keymanagement . . . . . . . . . . . . . 84Configuring the Name Server for SSL . . . . 85Configuring Impact Server for SSL . . . . . 85Configuring the GUI Server for SSL . . . . . 85

Deploying Virtual Member Manager adapter . . . 85Installing Virtual Member Manager adapter onembedded version of WebSphere ApplicationServer . . . . . . . . . . . . . . . 86Validating the installation script . . . . . . 86Mapping roles to users . . . . . . . . . 86Configuring LDAP or Active Directory . . . . 87Mapping roles to groups and users managed inLDAP . . . . . . . . . . . . . . . 88Setting up SSL communication with the ObjectServer . . . . . . . . . . . . . . . 89

Chapter 11. Command-line tools . . . . 91nci_crypt . . . . . . . . . . . . . . . 91nci_export . . . . . . . . . . . . . . . 91nci_import. . . . . . . . . . . . . . . 92nci_trigger. . . . . . . . . . . . . . . 92nci_policy . . . . . . . . . . . . . . . 94Using command line manager . . . . . . . . 94Event Processor commands . . . . . . . . . 96Email Reader commands . . . . . . . . . . 97Email Sender commands . . . . . . . . . . 98Policy Activator commands . . . . . . . . . 98Hibernating Policy Activator commands . . . . . 98Corba Name commands . . . . . . . . . . 99Policy Logger commands . . . . . . . . . . 99OMNIbus Event Reader commands . . . . . . 100

iv Netcool/Impact: Administration Guide

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

||||||||||||||||||||||||||||||||||

|||

||||||||||||||||||||

Database Event Reader commands . . . . . . 103Database Event Listener commands . . . . . . 105JMS Message Listener commands. . . . . . . 105

Appendix A. Migrating from SecurityManager to Virtual Member Manager . 109

Appendix B. Migrating TivoliNetcool/Impact from releases before5.1 to 5.1.1. . . . . . . . . . . . . 111Importing the existing configuration into 5.1installation . . . . . . . . . . . . . . 111

Performing the security transition . . . . . . 112Migrating the reporting data . . . . . . . . 112

Appendix C. Accessibility . . . . . . 113

Appendix D. Notices . . . . . . . . 115Trademarks . . . . . . . . . . . . . . 117

Glossary of terms . . . . . . . . . 119

Index . . . . . . . . . . . . . . . 125

Contents v

|||||||||

|||||||

||||

vi Netcool/Impact: Administration Guide

About this publicationThe Tivoli

Netcool/Impact Administration Guide contains instructions oninstalling, configuring, running and monitoring Netcool/Impact.

Note: Changes for the 5.1.1 version are marked with vertical change bars in theleft margin.

Intended audienceThis publication is for users who are responsible for installing, configuring,running and monitoring Netcool/Impact.

PublicationsThis section lists publications in the Netcool/Impact library and relateddocuments. The section also describes how to access Tivoli publications onlineand how to order Tivoli publications.

Tivoli Netcool/Impact libraryv Quick Start Guide, CZ7USMLProvides concise information about installing and running Tivoli Netcool/Impactfor the first time.

v Administration Guide, SC23882902Provides information about installing, running and monitoring the product.

v User Interface Guide, SC23883002Provides instructions for using the Graphical User Interface (GUI).

v Policy Reference Guide, SC23883102Contains complete description and reference information for the Impact PolicyLanguage (IPL).

v DSA Reference Guide, SC23883202Provides information about data source adaptors (DSAs).

v Operator View Guide, SC23885102Provides information about creating operator views.

v Solutions Guide, SC23883402Provides end-to-end information about using features of Tivoli Netcool/Impact.

v Integrations Guide, SC27283400Contains instructions for integrating Tivoli Netcool/Impact with other IBM

software and other vendor software.v Troubleshooting Guide, GC27283300Provides information about troubleshooting the installation, customization,starting, and maintaining Tivoli Netcool/Impact.

Accessing terminology onlineThe Tivoli Software Glossary includes definitions for many of the technical termsrelated to Tivoli software. The Tivoli Software Glossary is available at the followingTivoli software library Web site:

Copyright IBM Corp. 2006, 2009 vii

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm

The IBM Terminology Web site consolidates the terminology from IBM productlibraries in one convenient location. You can access the Terminology Web site at thefollowing Web address:

http://www.ibm.com/software/globalization/terminology

Accessing publications onlineThe Quick Start DVD contains the publications that are in the product library. Theformat of the publications is PDF, HTML, or both. Refer to the readme file on theDVD for instructions on how to access the documentation.

IBM posts publications for this and all other Tivoli products, as they becomeavailable and whenever they are updated, to the Tivoli Information Center Website at http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp.

Note: If you print PDF documents on other than letter-sized paper, set the optionin the File Print window that allows Adobe Reader to print letter-sized pages onyour local paper.

Ordering publicationsYou can order many Tivoli publications online at http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss.

You can also order by telephone by calling one of these numbers:v In the United States: 800-879-2755v In Canada: 800-426-4968

In other countries, contact your software account representative to order Tivolipublications. To locate the telephone number of your local representative, performthe following steps:1. Go to http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss.2. Select your country from the list and click Go.3. Click About this site in the main panel to see an information page that

includes the telephone number of your local representative.

AccessibilityAccessibility features help users with a physical disability, such as restrictedmobility or limited vision, to use software products successfully. With this product,you can use assistive technologies to hear and navigate the interface. You can alsouse the keyboard instead of the mouse to operate all features of the graphical userinterface.

For additional information, see Appendix C, Accessibility, on page 113.

Tivoli technical trainingFor Tivoli technical training information, refer to the following IBM TivoliEducation Web site at http://www.ibm.com/software/tivoli/education.

viii Netcool/Impact: Administration Guide

Support for problem solvingIf you have a problem with your IBM software, you want to resolve it quickly. Thissection describes the following options for obtaining support for IBM softwareproducts:v Using IBM Support Assistantv Obtaining fixes on page xv Receiving weekly support updates on page xv Contacting IBM Software Support on page xi

Using IBM Support AssistantThe IBM Support Assistant is a free, stand-alone application that you can install onmost workstations and also use to perform remote troubleshooting of otherworkstations. You can enhance the application by installing product-specificadd-ons for the IBM products you use.

The IBM Support Assistant saves you the time it takes to search the product,support, and educational resources. Several troubleshooting features are provided,including the ability to perform guided troubleshooting to aid in problemresolution, and also the ability to collect diagnostic information. The collecteddiagnostic information can then be used to self-diagnose the problem, or it can beincluded in an Electronic Service Request (ESR) submitted to IBM Support engineers.The ESR tool is used to open, update, and report on PMRs (Problem ManagementRecords) online. See http://www.ibm.com/software/support/help.html forassistance in using the ESR tool.

For more information, and to download the IBM Support Assistant, seehttp://www.ibm.com/software/support/isa. Currently, the add-on is supportedby IBM Support Assistant V4.1 or later. After you download and install the IBMSupport Assistant, follow these steps to install the IBM Support Assistant add-onfor your product:1. Start the IBM Support Assistant application.2. From the File > Preferences > Updater preferences menu, provide the URL to

update the site under Specify an Update Site > Location.3. Select http from the list.4. Validate the site and click OK to confirm changes.5. Run Update > Find new > Product Add-ons.6. Select the appropriate plug-in7. Read the license and description, and if you comply, select I accept the terms

in the license agreements and click Next.8. Click Finish to proceed with the installation, and when prompted, restart the

IBM Support Assistant to complete the installation.

To collect the diagnostic files and include them in an ESR that can be sent to IBMSupport engineers, view the Help files from the Help menu bar. To perform thecollection of diagnostic files for self-diagnosis only, complete the following steps:1. Start the IBM Support Assistant application.2. From the Home screen, select Analyze Problem.3. In the Select A Collector dialog box, expand the appropriate product name, and

select the agent for which you want to collect diagnostic information. ChooseAdd.

About this publication ix

4. After the agent or agents are added to the Collector Queue, choose Collect Allto begin the collection.

5. Enter the information requested in the dialog boxes.6. The final dialog box requests whether or not you want to upload the collection

file to IBM Support or another FTP location. If you only want to view thecollected files on your computer, choose Do Not FTP the Logs.

7. The collection has finished. You can view the collected files by clicking thecompressed file in the Collector Status dialog box.

Obtaining fixesA product fix might be available to resolve your problem. To determine whichfixes are available for your Tivoli software product, follow these steps:1. Go to the IBM Software Support Web site at http://www.ibm.com/software/

support.2. Under Select a brand and/or product, select Tivoli.3. Click the right arrow to view the Tivoli support page.4. Use the Select a category field to select the product.5. Select your product and click the right arrow that shows the Go hover text.6. Under Download, click the name of a fix to read its description and, optionally,

to download it.If there is no Download heading for your product, supply a search term, errorcode, or APAR number in the field provided under Search Support (thisproduct), and click the right arrow that shows the Go hover text.

For more information about the types of fixes that are available, see the IBMSoftware Support Handbook at http://techsupport.services.ibm.com/guides/handbook.html.

Receiving weekly support updatesTo receive weekly e-mail notifications about fixes and other software support news,follow these steps:1. Go to the IBM Software Support Web site at http://www.ibm.com/software/

support.2. Click My support in the far upper-right corner of the page under

Personalized support.3. If you have already registered for My support, sign in and skip to the next

step. If you have not registered, click register now. Complete the registrationform using your e-mail address as your IBM ID and click Submit.

4. The Edit profile tab is displayed.5. In the first list under Products, select Software. In the second list, select a

product category (for example, Systems and Asset Management). In the thirdlist, select a product sub-category (for example, Application Performance &Availability or Systems Performance). A list of applicable products isdisplayed.

6. Select the products for which you want to receive updates.7. Click Add products.8. After selecting all products that are of interest to you, click Subscribe to email

on the Edit profile tab.9. In the Documents list, select Software.

10. Select Please send these documents by weekly email.

x Netcool/Impact: Administration Guide

11. Update your e-mail address as needed.12. Select the types of documents you want to receive.13. Click Update.

If you experience problems with the My support feature, you can obtain help inone of the following ways:

OnlineSend an e-mail message to [email protected], describing your problem.

By phoneCall 1-800-IBM-4You (1-800-426-4968).

Contacting IBM Software SupportIBM Software Support provides assistance with product defects. The easiest way toobtain that assistance is to open a PMR or Electronic Service Request (ESR) directlyfrom the IBM Support Assistant (see Using IBM Support Assistant on page ix).

Before contacting IBM Software Support, your company must have an active IBMsoftware maintenance contract, and you must be authorized to submit problems toIBM. The type of software maintenance contract that you need depends on thetype of product you have:v For IBM distributed software products (including, but not limited to, Tivoli,Lotus, and Rational products, and DB2 and WebSphere products that run onWindows or UNIX operating systems), enroll in Passport Advantage in oneof the following ways:

OnlineGo to the Passport Advantage Web site at http://www-306.ibm.com/software/howtobuy/passportadvantage/pao_customers.htm .

By phoneFor the phone number to call in your country, go to the IBM SoftwareSupport Web site at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region.

v For customers with Subscription and Support (S & S) contracts, go to theSoftware Service Request Web site at https://techsupport.services.ibm.com/ssr/login.

v For customers with IBMLink, CATIA, Linux, OS/390, iSeries, pSeries,zSeries, and other support agreements, go to the IBM Support Line Web site athttp://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006.

v For IBM eServer software products (including, but not limited to, DB2 andWebSphere products that run in zSeries, pSeries, and iSeries environments), youcan purchase a software maintenance agreement by working directly with anIBM sales representative or an IBM Business Partner. For more informationabout support for eServer software products, go to the IBM Technical SupportAdvantage Web site at http://www.ibm.com/servers/eserver/techsupport.html.

If you are not sure what type of software maintenance contract you need, call1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go tothe contacts page of the IBM Software Support Handbook on the Web athttp://techsupport.services.ibm.com/guides/contacts.html and click the name ofyour geographic region for phone numbers of people who provide support foryour location.

To contact IBM Software support, follow these steps:

About this publication xi

1. Determining the business impact2. Describing problems and gathering information3. Submitting problems

Determining the business impactWhen you report a problem to IBM, you are asked to supply a severity level. Usethe following criteria to understand and assess the business impact of the problemthat you are reporting:

Severity 1The problem has a critical business impact. You are unable to use theprogram, resulting in a critical impact on operations. This conditionrequires an immediate solution.

Severity 2The problem has a significant business impact. The program is usable, butit is severely limited.

Severity 3The problem has some business impact. The program is usable, but lesssignificant features (not critical to operations) are unavailable.

Severity 4The problem has minimal business impact. The problem causes little impacton operations, or a reasonable circumvention to the problem wasimplemented.

Describing problems and gathering informationWhen describing a problem to IBM, be as specific as possible. Include all relevantbackground information so that IBM Software Support specialists can help yousolve the problem efficiently. To save time, know the answers to these questions:v Which software versions were you running when the problem occurred?v Do you have logs, traces, and messages that are related to the problemsymptoms? IBM Software Support is likely to ask for this information.

v Can you re-create the problem? If so, what steps were performed to re-create theproblem?

v Did you make any changes to the system? For example, did you make changesto the hardware, operating system, networking software, and so on.

v Are you currently using a workaround for the problem? If so, be prepared toexplain the workaround when you report the problem.

Submitting problemsYou can submit your problem to IBM Software Support in one of two ways:

OnlineClick Submit and track problems on the IBM Software Support site athttp://www.ibm.com/software/support/probsub.html. Type yourinformation into the appropriate problem submission form.

By phoneFor the phone number to call in your country, go to the contacts page ofthe IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region.

If the problem you submit is for a software defect or for missing or inaccuratedocumentation, IBM Software Support creates an Authorized Program AnalysisReport (APAR). The APAR describes the problem in detail. Whenever possible,

xii Netcool/Impact: Administration Guide

IBM Software Support provides a workaround that you can implement until theAPAR is resolved and a fix is delivered. IBM publishes resolved APARs on theSoftware Support Web site daily, so that other users who experience the sameproblem can benefit from the same resolution.

Conventions used in this publicationThis publication uses several conventions for special terms and actions, operatingsystem-dependent commands and paths, and margin graphics.

Typeface conventionsThis publication uses the following typeface conventions:

Bold

v Lowercase commands and mixed case commands that are otherwisedifficult to distinguish from surrounding text

v Interface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), labels (such as Tip:, and Operating system considerations:)

v Keywords and parameters in textItalic

v Citations (examples: titles of publications, diskettes, and CDsv Words defined in text (example: a nonswitched line is called a

point-to-point line)v Emphasis of words and letters (words as words example: Use the word

that to introduce a restrictive clause.; letters as letters example: TheLUN address must start with the letter L.)

v New terms in text (except in a definition list): a view is a frame in aworkspace that contains data.

v Variables and values you must provide: ... where myname represents....Monospace

v Examples and code examplesv File names, programming keywords, and other elements that are difficultto distinguish from surrounding text

v Message text and prompts addressed to the userv Text that the user must typev Values for arguments or command options

Operating system-dependent variables and pathsThis publication uses the UNIX convention for specifying environment variablesand for directory notation.

When using the Windows command line, replace $variable with % variable% forenvironment variables and replace each forward slash (/) with a backslash (\) indirectory paths. The names of environment variables are not always the same inthe Windows and UNIX environments. For example, %TEMP% in Windowsenvironments is equivalent to $TMPDIR in UNIX environments.

Note: If you are using the bash shell on a Windows system, you can use the UNIXconventions.

About this publication xiii

xiv Netcool/Impact: Administration Guide

Chapter 1. IntroductionA Tivoli Netcool/Impact deployment is an installation of Tivoli Netcool/Impactcomponents in your environment.

Overview of deploymentsTivoli Netcool/Impact can be deployed as a single system installation and adistributed installation. For more information about deployment types, seeDeployment types on page 2.

To set up the deployment, you run the installer programs on systems in yourenvironment. The installer copies program files to the systems and set the minimalrequired configuration options. After a successful installation of all thecomponents, you can then customize the configuration according to your needs.For more information about customizing your deployment, see Setting up adeployment on page 3.

To run the deployment, you use a set of administration scripts, or servicesadministration tools, depending on your operating system. For more informationabout running the deployment, see Running a deployment on page 4.

A centralized logging feature is provided that is used by both the Impact Serverand the GUI Server, to monitor application events and status during applicationruntime. In addition, you can use application subcomponents, like for exampleservices, to configure them to log their activity to files. For more information aboutmonitoring a deployment, see Monitoring deployment components on page 35.

You can use the Object Server as an external authentication and authorizationsource for your deployment. For more information about authentication andauthorization, see Deploying Virtual Member Manager adapter on page 85.

Deployment componentsA deployment has the following components:

Impact ServerThe Impact Server is the primary component of a deployment. Thiscomponent manages the data model, services, and policies that make upyour Tivoli Netcool/Impact implementation and runs the policies in realtime in response to events that occur in your environment.

GUI ServerThe GUI Server is the component that is responsible for managing theGUI. The GUI Server brokers HTTP requests from users Web browsersand returns the graphical user interface views that you use to work withdata model services, and policies.

Impact ServerThe Impact Server is the primary component of a deployment. This componentmanages the data model, services, and policies that make up your TivoliNetcool/Impact implementation and runs the policies in real time in response toevents that occur in your environment.

Copyright IBM Corp. 2006, 2009 1

The Impact Server has a runnable subcomponent called the JRExec server that youcan use to run external commands, scripts, and applications from within a policy.

The Impact Server runs as an application instance inside a Java application server.By default, the Impact Server runs inside the embedded version of WebSphereApplication Server, the application server that is installed automatically as part ofthe Tivoli Netcool/Impact installation.

For information about managing the Impact Server, see Chapter 3, Managing theImpact Server, on page 33.

GUI ServerThe GUI Server is the component that is responsible for managing the GUI. TheGUI Server brokers HTTP requests from users Web browsers and returns thegraphical user interface views that you use to work with data model services, andpolicies.

The GUI Server has a subcomponent called the Name Server that providesapplication registry functionality for the Tivoli Netcool/Impact components. Thecomponents use the Name Server to locate and establish connections to each other.The Impact Server also uses the Name Server for server clustering.

Like the Impact Server, the GUI Server runs as a hosted application inside a Javaapplication server. By default, the GUI Server runs inside the embedded version ofWebSphere Application Server that is installed automatically as part of the TivoliNetcool/Impact installation.

For more information about the GUI Server, see Chapter 4, Managing the GUIServer, on page 39.

Netcool Database ServerThe Netcool Database Server is a specially configured version of an embeddedHSQL that has been prepared for use with Tivoli Netcool/Impact and otherNetcool products. The database is used to store the underlying data used by theGUI reporting tools.

For more information about the Netcool Database Server, see Chapter 7, NetcoolDatabase Server, on page 61.

Deployment typesThe following deployment types are supported:

Single-system deployment

A single-system deployment consists of the Impact Server and the GUIServer installed on a single system in your environment. A single-systemdeployment is suitable for testing and demonstration purposes.

Distributed deployment

A distributed deployment consists of one or more instances of the ImpactServer and the GUI Server installed across different systems in yourenvironment. A distributed deployment is suitable for most real-worldimplementations of Tivoli Netcool/Impact.

2 Netcool/Impact: Administration Guide

A typical distributed deployment can consist of two or more instances ofthe Impact Server installed on separate systems and configured as part of aserver cluster, and an instance of the GUI Server installed on a system thatis configured to allow users Web browsers to access the GUI. Serverclustering provides failover and load-balancing functionality for the ImpactServer instances.

For more information about server clustering, see Chapter 5, Serverclustering, on page 41.

Setting up a deploymentBefore you start setting up Tivoli Netcool/Impact, you must have anunderstanding of how Netcool/OMNIbus and other Netcool products are installedand used in your environment. Specifically, you must know what type of alerts arecollected by Netcool probes and monitors, and how the alerts are stored in theNetcool/OMNIbus ObjectServer database. You must also have an understanding ofyour network topology, including the types of systems, devices, and applicationsthat exist on the network and how they are monitored by Netcool/OMNIbus.

Planning an installationAfter you understand how Netcool/OMNIbus and other Netcool products areinstalled and used in your environment, you can plan your deployment.

For testing or demonstration purposes, a good practice is to install TivoliNetcool/Impact and its components on a single system. This type of deploymentrequires little planning and is the easiest to create and maintain.

For real life production deployments, you must take into account your goals,requirements, and available resources before you install the software. One bestpractice is to create a diagram of the installation you want to create before youbegin. IBM technical support can help you determine what type of hardware youneed to run the deployment and how to configure it to fit your requirements.

Installing componentsYou use the Tivoli Netcool/Impact installer to install the Impact Server and theGUI Server. The installer is a program that can be run in GUI mode, console mode,and silent mode. In GUI mode a series of windows guide you through theinstallation process. In console mode, the installer prompts you to enter therequired information from the command line. If you are running the installersremotely using telnet or another command line application, you must run theinstaller in console mode.

For more information about running the installer, see Chapter 2, Installing TivoliNetcool/Impact, on page 5

Configuring componentsThe installer program sets the minimum required configuration properties duringinstallation. You can change the configuration of a component at any time bymanually editing the properties files. Depending on the component, you mightneed to stop and restart after making configuration changes.

Chapter 1. Introduction 3

Running a deploymentYou start and stop the Impact Server and the GUI Server by starting and stoppingthe Java application server where they reside, by default, the embedded version ofWebSphere Application Server. Both servers are automatically loaded and startedwith the application server.

You can also start and stop the Tivoli Netcool/Impact components separately fromthe application server using the management console tools provided by thatapplication. You must start them in the following order:v Impact Server and GUI Server.For more information about starting these components, see Starting theembedded version of WebSphere Application Server on page 38.

v JRExec server (optional).For more information about starting JRExec server, see Chapter 8, JRExecserver, on page 65.


Chapter 2. Installing Tivoli Netcool/ImpactThe Tivoli Netcool/Impact installer is an application that copies the program filesto the target system and sets the minimum required configuration properties. Theinstaller also installs the embedded version of WebSphere Application Server, thedefault Java application server used by Tivoli Netcool/Impact, on the targetsystem.

By default, the installer deploys the Impact Server and the GUI Server EAR filesinto the embedded version of WebSphere Application Server. The next time youstart the application server, it automatically detects the EAR files and starts thecomponents.

Important: Native 31-bit Linux on System z is not supported because theapplication server that is installed by Tivoli Netcool/Impact 5.1.1 does not supportnative 31-bit Linux on System z. For a list of platforms supported on embeddedversion of WebSphere Application Server see:

http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg27007274

Tivoli Netcool/Impact does support the 31-bit Linux on System z jvms in the 64-bitLinux on system z operating system.

System requirementsSoftware requirements

The following operating systems are compatible with IBM Tivoli Netcool/Impactversion 5.1.1:

Operating System Version/Release 32 bit/64 bit

AIX 5.2, 5.3, 6.1 32 bit/64 bit

Solaris 9, 10 (Zones are supported) 32 bit/64 bit

HP/UX 11i v2 32 bit

Windows Server 2003 Std x64, Server2003 Enterprise x64, Server2003 DataCenter x64 (nocluster support)

64 bit

Windows Server 2003 Enterprise,Server 2003 Standard, Server2003 Datacenter (no clustersupport), XP Professional,Server 2008 Enterprise,Server 2008 Standard, Server2008 DataCenter (R2 and nonR2)

32 bit/64 bit

Suse 9.2,10 32 bit/64 bit

RedHat ES 4.0, 5.0 - IA32, x86-64, IA64,PPC64, PPC32, zSeries (31bit, 64 bit)

32 bit/64 bit

Copyright IBM Corp. 2006, 2009 5

|

|

|||||||||||||||||||||||||||||||||||||||

|

|||||||||

|

||||||||

|

Hardware requirements

The following are the minimum hardware requirements for installing and runningIBM Tivoli Netcool/Impact version 5.1.1:

System Minimum requirements

Windows 32 bit 3 GB RAM 2 GB Paging space 5 GB harddisk space free

UNIX 32 bit 3 GB RAM 2 GB Swap space 5 GB hard diskspace free

Windows 64 bit 4 GB RAM 2 GB Paging space 5 GB harddisk space free

UNIX 64 bit 4 GB RAM 2 GB Swap space 5 GB hard diskspace free

Linux for System z 64 bit 4 GB RAM 2 GB Paging space 8 GB harddisk space free (you need to set IATEMPDIRto the location where your 8 GB hard diskdrive space is located before starting yourinstallation)

General Notesv On all UNIX platforms, if the installer indicates that there is not enough harddisk drive space for the temporary directory then you will need to setIATEMPDIR to a location where you have 8 GB hard disk space free beforestarting your installation.

v Impact 5.1.1 runtime needs a minimum of 2 GB of RAM dedicated on anyplatform

Running the installer in GUI modeBefore you begin

Make sure that there is sufficient space on the temp volume. The self extractorchecks for free disk space 3 times the size of the installer on the volume where thetemp directory is located. If there is not enough free space, the installer promptsyou for an alternative location for the extraction. The value of the temp directorypath is resolved based on the system environment variable, IATEMPDIR on UNIXplatforms and TEMP on Windows platforms. Set this environment variable beforerunning the installer to redirect the temporary directories of the installer to thelocation where there is sufficient disk space.

About this task

On UNIX platforms, you do not run the installer as the root user. You can run theinstaller as any other user that has read, write, and execute permissions to thetarget directory.On Windows platforms the userid used for the installation musthave administrator permissions because Tivoli Netcool/Impact creates a WindowsService entry.1. Copy the installation file to your local directory.2. Depending on your operating system use one of the following methods to

launch the installation:


||||||||||||||||||||||||||||||||||||||||||||||||||||

(UNIX platforms) You can start the installation from any place in the filesystem by providing the full path to the installation file or you can navigate tothe directory to which you have copied it. Use the following command syntaxto launch the installation on UNIX:setup.bin

or//setup.bin

where system is the name of the operating system and version is a 32 bit or64 bit version of the operating system. Example of the command on a 32-bitversion of Linux:./setupLinux32.bin

(Windows platforms) Double click the installation file or use the command atthe command prompt to run it.

3. Choose the installation language.

Select the language that will be used during the installation and click OK tocontinue.

4. Read the Introduction and continue with the installation.

Chapter 2. Installing Tivoli Netcool/Impact 7

|||||||||||||||

||||

Click Next to continue.5. Read and accept the license agreement.

Click Next to continue.6. Choose between a new installation and an upgrade.

The installation program checks the file system for previous TivoliNetcool/Impact installations. When version 5.1 is detected you are asked ifyou want to update the instance of 5.1 to version 5.1.1. If you select toupgrade you are taken directly to the Pre-Installation Summary.


|

||||

|||||||

When no 5.1 version is auto detected you are asked if you want to run a newclean installation of version 5.1.1 or, if there is an undetected version 5.1, youcan select to try an update of the undetected version 5.1. If you select toupgrade a current version 5.1 will take you to the Choose Install Folder stageof the installation, similarly to selecting to install a new instance of version5.1.1. In the case of upgrade, however, the path will be validated for pointingto a valid instance of 5.1.

7. Choose the installation directory.


|

|||||||||

||

If you are running a new installation you cannot install into a directory thathas an instance of Tivoli Netcool/Impact nor into any directory left behindfrom an old installation.You can install the server into any directory to which you have writeprivileges (+755 rights on UNIX platforms). The default location on UNIXplatforms is /opt/ibm/netcool but note that even if you have +755(drwxr-xr-x) permissions to /opt the installer will not create ibm/netcool in it.To be able to use the default directory go to the /opt directory, create the ibmdirectory and give it permissions of 777 (drwxrwxrwx). After that the installerwill be able to install into /opt/ibm/netcool directory. An alternative method,is to add the non-root user to run the installer to an appropriate group thatallows them to create the default directory.

Note: On UNIX platforms do not use special characters or spaces in the installpath name.The default directory on Windows platforms is C:\ProgramFiles\IBM\Netcool.Click Next to continue.

8. Choose install type.


|

|||||||||||||||||||

If you select the Default mode the installer proceeds directly to thePre-Installation Summary and performs the installation with a default set ofvalues.If you choose the Advanced mode you have an opportunity to customize theTivoli Netcool/Impact environment and then have to go through a series ofadvanced configuration steps.Click Next to continue.

9. (Advanced) Select the components to be installed.

By default, both the GUI Server and the Impact Server are installed. You canaccept this selection or change it and install the GUI Server or the ImpactServer alone.


|

||||||||||

||||

Click Next to continue.10. (Advanced) Configure the embedded version of WebSphere Application Server

ports.

You can accept the default values of the embedded version of WebSphereApplication Server ports - 9080 for the HTTP port (GUI Server) and 9060 forthe administrator port (administration console) or provide different values iffor some reason you cannot use the default ones. You will use the ports thatyou provide here to access the Tivoli Netcool/Impact administration screenand the GUI Server after the installation. For more information aboutaccessing the administration console and the GUI Server, see Verifying thedeployment on page 27.Click Next to continue.

11. (Advanced) Configure the Name Server.The Name Server is a component that provides registration functionality forthe GUI Server and the Impact Server. Applications that use the GUI Serverregister with the Name Server at startup. The GUI Server uses the informationstored in the Name Server when brokering HTTP requests between users Webbrowsers and the applications. The Name Server is also used to storeinformation used in server clustering. For more information about serverclustering, see Chapter 5, Server clustering, on page 41.You can define multiple Name Server port pairs and then associate yourcurrent installation to multiple Name Servers. Each Name Server port that youprovide will be tested to check if it is active. If the port is active you will betaken to the next step of the installation. If the port is not active you will see amessage indicating that the port is not active but you will still be able tocontinue with the installation. For the installation to be successful, however,make sure that the Name Server, port pair as you have defined is available.

Note: If you are defining a GUI Server then the current host name and portnumber must be in the list of Name Servers, if it is not in the list an error isdisplayed.


||||

||||||||||||||||||||||||||||

To add more than one Name Server select the Select to add more NameServers check box, click the Next button and another Name Server, port pairthat you have provided in the input fields will be verified and added to thelist. When you are done click Next to go on to the next installation screen.If you selecti the Select to clear the list of Name Servers option the entire listis removed (deleted) and you can define a new list of Name Server.

12. (Advanced) Configure the Tivoli Netcool/Impact instance.

Configure the instance of Impact Server that you are installing. If you areinstalling a member of a cluster provide the name of the instance and thecluster group to which you want it to belong.


|

|||||||||

||||

The command-line manager service tool allows you to access the ImpactServer from the command-line interface to start and stop services as well asconfigure their parameters. The default value of the command-line serviceport is 2000. For more information about the command-line service, seeUsing command line manager on page 94. The DB port is the port that youcan use to access the Tivoli Netcool/Impact database and by default it is 5435.Click Next to continue.

13. (Advanced) Configure the Object Server.

By default the installer uses the current host name of the Object Server hostand its default port. You can keep the default values or use a different fullyqualified host name of the host that will be used as the Object Server host.You can choose not to use a password as it is valid for an Object Server not tohave a password.Click Next to continue.

14. (Advanced) Choose Version Control system.


|||||||||

||||||||

The version control manager uses Tivoli Netcool/Impact Subversion (SVN) asthe default version control which is installed automatically with the ImpactServer if you leave the default selection. No additional configuration steps willbe required if you decide to go with the default setting and immediately afterthe installation you will be able to save policies, data sources, data types, andconfiguration properties as revisions in a source control archive.Choose another option if you want to use a different version control system.Be prepared to provide additional configuration information in the steps tofollow.Click Next to continue.

15. (Advanced/Optional) Set the Version Control path.You have to go through this installation step if the Impact Server or both theImpact Server and the GUI Server are selected together from the componentsto be installed and Subversion, or CVS, or RCS or ClearCase is selected inthe version Choose Version Control System step.Click Next to continue.

16. (Advanced/Optional) Set Version Control RepositoryYou have to go through this installation step if the Impact Server or both theImpact Server and the GUI Server are selected together from the componentsto be installed and Subversion or CVS is selected in the Version ControlSystem step.Click Next to continue.

17. Pre-Installation summary.


|

||||||||||||||||||||||||

Make sure that the installation parameters in the pre-installation summaryreflect your choices and proceed with the installation.

18. Finish the installation.

Click Done to leave the installation.

What to do next

Perform the following additional configuration steps that are applicable to yourinstallation profile:


|

|||||

|||||

v Review the installation logs, especially the logs found in the /logdirectory, to verify that the software has been installed correctly, or totroubleshoot installation errors. For more information, see Installation logs onpage 28.

v Log on to Netcool/Impact components to verify if they have been successfullyinstalled. For more information about verifying the deployment, see Verifyingthe deployment on page 27.

v If you were installing an Impact Server to be a part of a server cluster follow thesteps in Chapter 5, Server clustering, on page 41.

v If you want to use SSL for communication with the GUI Server follow the stepsin Setting up SSL communication in Tivoli Netcool/Impact on page 83.

v (Windows platforms) Install the JRExec server. For more information aboutinstalling the JRExec server, see Installing the JRExec server (Windowsplatforms) on page 28.

v If you upgraded from version 5.1 in which you used internal CVS as yourversion control, run the nci_cvs2svn script. For more information about thescript, see Migrating to Subversion on page 59.

Running the installer in console modeBefore you begin


About this task

If you are installing Netcool/Impact remotely using telnet or anothercommand-line application, you must run the installer in console mode.

On UNIX platforms, you do not run the installer as the root user. You can run theinstaller as any other user that has read, write, and execute permissions to thetarget directory.On Windows platforms the userid used for the installation musthave administrator permissions because Tivoli Netcool/Impact creates a WindowsService entry.1. Copy the installation file to your local directory.2. Depending on your operating system use one of the following methods to

launch the installation:(UNIX platforms) You can start the installation from any place in the filesystem by providing the full path to the installation file or you can navigate tothe directory to which you have copied it. Use the following command syntaxto launch the installation on UNIX:setup.bin -i console

or//setup.bin -i console


||||||||||||||||||||||||||||||||||||||||||||||

where system is the name of the operating system and version is a 32 bit or64 bit version of the operating system. Example of the command on a 32-bitversion of Linux:./setupLinux32.bin -i console

(Windows platforms) Use the following syntax to start the installation:/setupwin.exe -i console

where version is a 32 bit or 64 bit version of Windows. Example of thecommand on a 32 bit version of Windows:setupwin32.exe -i console

3. Choose the installation language.===============================================================================Choose Locale...----------------

1- Deutsch->2- English

3- Espaol4- Franais5- Italiano6- Portugus (Brasil)

CHOOSE LOCALE BY NUMBER:

Select the language that to be used during the installation and press Enterto continue.

4. Read the Introduction and continue with the installation.===============================================================================Introduction------------

Welcome to the InstallAnywhere Wizard for Netcool/Impact

The InstallAnywhere wizard wil install Netcool/Impact on your computer.To continue, press ENTER.

Netcool/ImpactIBMhttp://www.ibm.com

PRESS TO CONTINUE:

Press Enter to continue.5. Read and accept the license agreement.

Press Enter to continue viewing the license agreement, or enter "1" toaccept the agreement, "2" to decline it, "3" to print it, or "99" to go backto the previous screen.:

Accept the license agreement by selecting option 1 and press Enter tocontinue.

6. Choose between a new installation and an upgrade.The installation program checks the file system for previous TivoliNetcool/Impact installations. When version 5.1 is detected you are asked ifyou want to update the instance of 5.1 to version 5.1.1. If you select toupgrade you are taken directly to the Pre-Installation Summary.When no 5.1 version is auto detected you are asked if you want to run a newclean installation of version 5.1.1 or, if there is an undetected version 5.1, youcan select to try an update of the undetected version 5.1. If you select toupgrade a current version 5.1 will take you to the Choose Install Folder stage


|||||||||||||||||||||||||||||||||||||||||||||||||||||||

of the installation, similarly to selecting to install a new instance of version5.1.1. In the case of upgrade, however, the path will be validated for pointingto a valid instance of 5.1.

7. Choose the installation directory.===============================================================================Choose Install Folder---------------------

Press ENTER to install "Netcool/Impact" to this directory, or type in anabsolute path of a directory you want to install to a different directory.

ENTER AN ABSOLUTE PATH, OR PRESS TO ACCEPT THE DEFAULT.(DEFAULT: /opt/ibm/netcool):

If you are running a new installation you cannot install into a directory thathas an instance of Tivoli Netcool/Impact nor into any directory left behindfrom an old installation.You can install the server into any directory to which you have writeprivileges (+755 rights on UNIX platforms). The default location on UNIXplatforms is /opt/ibm/netcool but note that even if you have +755(drwxr-xr-x) permissions to /opt the installer will not create ibm/netcool in it.To be able to use the default directory go to the /opt directory, create the ibmdirectory and give it permissions of 777 (drwxrwxrwx). After that the installerwill be able to install into /opt/ibm/netcool directory. An alternative method,is to add the non-root user to run the installer to an appropriate group thatallows them to create the default directory.

Note: On UNIX platforms do not use special characters or spaces in the installpath name.The default directory on Windows platforms is C:\ProgramFiles\IBM\Netcool. Press Enter to use the default installation directory andcontinue or enter another directory where you want to install Netcool/Impactand then hit Enter.

8. Choose install type.===============================================================================Choose the installation type that best suits your needs.--------------------------------------------------------

Default install will install Netcool/Impact and all pre-requisite software ontothis machine using default values. NOT RECOMMENDED FOR PRODUCTION ENVIRONMENTS.Advanced install is recommended for Production environments. Allows choice ofwhat pre-requisite software to install as well as the oprion to change defaultvalues.

->1- Default2- Advanced

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE DEFAULT:

If you select the Default mode the installer proceeds directly to thePre-Installation Summary and performs the installation with a default set ofvalues.If you choose the Advanced mode you have an opportunity to customize theTivoli Netcool/Impact environment and then have to go through a series ofadvanced configuration steps.

9. (Advanced) Select the components to be installed.


||||||||||||||||||||||||||||||||||||||||||||||||||||||

===============================================================================Choose Impact Server Type-------------------------

Select the feature for "Netcool/Impact" you would like to install:

->1- GUI Server->2- Impact Server

ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, ORPRESS TO ACCEPT THE DEFAULT:

By default, both the GUI Server and the Impact Server are installed. You canaccept this selection or change it and install the GUI Server or the ImpactServer alone.

10. (Advanced) Configure the embedded version of WebSphere Application Serverports.===============================================================================Specify Embedded IBM Websphere HTTP/Admin Ports-----------------------------------------------

Netcool/Impact will install a fully functional Embedded version of the IBMWebshpere Application Server.

HTTP Port (DEFAULT: 9080):Admin Port (DEFAULT: 9060):

You can accept the default values of the embedded version of WebSphereApplication Server ports - 9080 for the HTTP port (GUI Server) and 9060 forthe administrator port (administration console) or provide different values iffor some reason you cannot use the default ones. Enter the ports values andpress Enter to continue.

11. (Advanced) Configure the Name Server.The Name Server is a component that provides registration functionality forthe GUI Server and the Impact Server. Applications that use the GUI Serverregister with the Name Server at startup. The GUI Server uses the informationstored in the Name Server when brokering HTTP requests between users Webbrowsers and the applications. The Name Server is also used to storeinformation used in server clustering. For more information about serverclustering, see Chapter 5, Server clustering, on page 41.You can define multiple Name Server port pairs and then associate yourcurrent installation to multiple Name Servers. Each Name Server port that youprovide will be tested to check if it is active. If the port is active you will betaken to the next step of the installation. If the port is not active you will see amessage indicating that the port is not active but you will still be able tocontinue with the installation. For the installation to be successful, however,make sure that the Name Server, port pair as you have defined is available.

Note: If you are defining a GUI Server then the current host name and portnumber must be in the list of Name Servers, if it is not in the list an error isdisplayed.==============================================================================Name Server Configuration-------------------------Impact uses the Netcool Name Server to publish its services. By default theapplication name server is installed as part ot the Netcool ImpactClient. If yomoved the "nameserver.war" file to a different J2EE server, please enter thecorrect http host and port below, otherwise use the host and port of yourNetcool Impact Server.


||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

Name Server Host (DEFAULT: somenameserver):Name Server Port (DEFAULT: 9080):Would you like to define another Name Server and port pair? (Y/N)

To add more than one Name Server select Y(YES) and press Enter andanother Name Server, port pair that you have specified is verified and addedto the list. When you are done type N (NO) for a summary of the NameServer and port pairs. If you are not happy with the list of Name Servers typeback to go back to the Name Server dialog again, if you are happy type Y(YES) to go on to the next installation screen.If you back up to the step before Configure the Name Server and reenter thedialog, the previous list of Name Servers is cleared and you need to define anew list of Name Servers.

12. (Advanced) Configure the Tivoli Netcool/Impact instance.===============================================================================Configure Impact Instance-------------------------

Netcool/Impact allows you to run multiple instances of the server withdifferent configuration characteristics.The instance name is a unique stringthat identifies the server instance.The cluster group is used to identifyserver instances that form a cluster.If you do not want to run in clusteringmode, just assign a unique name to every server instance.

Instance Name (DEFAULT: NCI):

Cluster Group (DEFAULT: NCICLUSTER):

Command Line Port (DEFAULT: 2000):

DB Port (DEFAULT: 5435):

Configure the instance of Impact Server that you are installing. If you areinstalling a member of a cluster provide the name of the instance and thecluster group to which you want it to belong.The command-line manager service tool allows you to access the ImpactServer from the command-line interface to start and stop services as well asconfigure their parameters. The default value of the command-line serviceport is 2000. For more information about the command-line service, seeUsing command line manager on page 94. The DB port is the port that youcan use to access the Tivoli Netcool/Impact database and by default it is 5435.Enter all the required information and press Enter to continue.

13. (Advanced) Configure the Object Server.===============================================================================Configure ObjectServer----------------------

Netcool/Impact will need an event source. By default, it will connect toNetcool/OMNIbus.Other types of event sources require manualconfiguration.Please enter the host and port for your Netcool/OMNIbus server.

ObjectServer Host (DEFAULT: xxxx.ie.ibm.com):

ObjectServer Port (DEFAULT: 4100): 4100

ObjectServer Password:*

By default the installer uses the current host name of the Object Server hostand its default port. You can keep the default values or use a different fullyqualified host name of the host that will be used as the Object Server host.


|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

You can choose not to use a password as it is valid for an Object Server not tohave a password.Enter all the required information and press Enter to continue.

14. (Advanced) Choose Version Control system.===============================================================================Choose Version Control System-----------------------------

Netcool/Impact uses version control for its configuration files (propertyfiles, data types and policies).You can use an existing version control systemor the Subversion (SVN) package bundled with Netcool/Impact.

->1- Impact Subversion2- Subversion3- CVS4- RCS5- Clearcase

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE DEFAULT:

The version control manager uses Tivoli Netcool/Impact Subversion (SVN) asthe default version control which is installed automatically with the ImpactServer if you leave the default selection. No additional configuration steps willbe required if you decide to go with the default setting and immediately afterthe installation you will be able to save policies, data sources, data types, andconfiguration properties as revisions in a source control archive.Choose another option if you want to use a different version control system.Be prepared to provide additional configuration information in the steps tofollow.

15. (Advanced/Optional) Set the Version Control path.You have to go through this installation step if the Impact Server or both theImpact Server and the GUI Server are selected together from the componentsto be installed and Subversion, or CVS, or RCS or ClearCase is selected in theversion Choose Version Control System step.

16. (Advanced/Optional) Set Version Control RepositoryYou have to go through this installation step if the Impact Server or both theImpact Server and the GUI Server are selected together from the componentsto be installed and Subversion or CVS is selected in the Version ControlSystem step.

17. Pre-Installation summary.===============================================================================Pre-Installation Summary------------------------

Please Review the Following Before Continuing:

Product Name:Netcool/Impact

Install Folder:/home/netcool_impact/opt/ibm/netcool

Install Set:Advanced

Disk Space Information (for Installation Target):


||||||||||||||||||||||||||||||||||||||||||||||||||||||||

Required: 682,862,708 bytesAvailable: 60,439,982,080 bytes

PRESS TO CONTINUE:

Make sure that the installation parameters in the pre-installation summaryreflect your choices and proceed with the installation.

18. Finish the installation.===============================================================================Install Complete----------------

Congratulations. The product has been successfully installed. Product name:Netcool/Impact

/home/netcool_impact/opt/ibm/netcool

Press "ENTER" to exit the wizard.

PRESS TO EXIT THE INSTALLER:

Press Enter to leave the installation.

What to do next

Perform the following additional configuration steps that are applicable to yourinstallation profile:v Review the installation logs, especially the logs found in the /logdirectory, to verify that the software has been installed correctly, or totroubleshoot installation errors. For more information, see Installation logs onpage 28.






Running the installer in silent modeBefore you begin

Before running the installer in silent mode you need to edit the response file. Atemplate of the response file, installSilent_Response.txt, is provided with theinstallation file and you can edit it with your favorite text editor.

For a list of installation options that you can customize in the response file seeSilent installation response file on page 25.

The following rules apply to the response file:


|||||||||||||||||||||||||||||||||||||||||||||||||

v The path to the installer properties file can be either absolute, or relative to thedirectory in which the installer resides.

v Use the response file, installSilent_response.txt, shipped with the installer.You can change the name of the file.

v If an installer properties file is specified but does not exist, the default propertiesfile, if present, is used. Otherwise, any supplied command-line options are used,or if no additional options are specified, the installer is run using the defaultsettings.


About this task

On UNIX platforms, you do not run the installer as the root user. You can run theinstaller as any other user that has read, write, and execute permissions to thetarget directory.On Windows platforms the userid used for the installation musthave administrator permissions because Tivoli Netcool/Impact creates a WindowsService entry.1. Copy the installation file to your local directory.

Also copy the response file to a directory on your file system.2. Depending on your operating system use one of the following methods to

launch the installation:(UNIX platforms) You can start the installation from any place in the filesystem by providing the full path to the installation file or you can navigate tothe directory to which you have copied it. Use the following command syntaxto launch the installation on UNIX:setup.bin -i silent -f

or//setup.bin -i silent-f

where system is the name of the operating system and version is a 32 bit or 64bit version of the operating system. Example of the command on a 32-bitversion of Linux:./setupLinux32.bin -i silent -f installer.properties

(Windows platforms) Use the following syntax to start the installation:/setupwin.exe -i silent -f

where version is a 32 bit or 64 bit version of Windows. Example of thecommand on a 32 bit version of Windows:setupwin32.exe -i silent -f installer.properties

3. (Optional) Follow the installation progress by viewing the installation log.While the installation is running you can follow its progress by viewing theIMPACT5.1.1_install-xx.log.lck file (where xx can be 00 or 01 or 02) and islocated in your home directory. When this lock file disappears (is removed atend of the installation) the silent installation is complete.


|||||||||||||||||||||||||||||||||||||||||||||||||

4. Finish the installation.

What to do next

Perform the following additional configuration steps that are applicable to yourinstallation profile:v Review the installation logs, especially the logs found in the /logdirectory, to verify that the software has been installed correctly, or totroubleshoot installation errors. For more information, see Installation logs onpage 28.






Silent installation response fileThe following table contains the installation parameters that you can customize inthe installation response file template, installSilent_Response.txt.

Table 1. Silent installation propertiesParameter Description

USER_INSTALL_DIR Installation directory. Directory on the system whereyou install Netcool products. Default is/opt/ibm/netcool on UNIX platforms andC:\Program Files\IBM\Netcool on Windows.

CHOSEN_INSTALL_SET Installation type. Default value is default,alternative is advanced.

GUI_SERVER_RESULT Install GUI Server. Choose 1 to install, default is 1.

IMPACT_SERVER_RESULT Install Impact Server. Choose 1 to install, default is1.

EWAS_HEAP_SIZE Used to set eWAS server initial jvm heap size. Thedefault value is 1200 (1.2 gig initial heap size). Forthose customers who are installing on machines thatcan not support 1.2 gig jvm heap use this parameterto reduce the amount of eWAS server initial jvmheap size, a good value to use would beEWAS_HEAP_SIZE=512.

EWAS_HTTP_PORT HTTP port used by the application server. Whenyou log in to Tivoli Netcool/Impact using a Webbrowser, you use this HTTP port. Default is 9080.

EWAS_ADMIN_PORT Administration port. The default is 9060.


|||||||||||||||||||||||

|||||||||||||||||||||||||||||||||

Table 1. Silent installation properties (continued)Parameter Description

NAMESERVER_HP Host name or IP address of the system where theName Server is running followed by the port wherethe Name Server is running, separated by a colon.There are no default values for the host name andport, they must be fully qualified.

You must provide this information when:

GUI_SERVER_RESULT=0IMPACT_SERVER_RESULT=1

You can specify multiple Name Servers in whichcase you need to separate them with a comma:

NAMESERVER_HP=:,:

is the Name Server host name that hasno default value, and must be fully qualified and is the port number of the NameServer (no default value either).

NCI_INSTANCE_NAME Name of the new instance. The default is NCI.

NCI_CLUSTER_NAME Cluster group. Name of the server cluster for thenew instance. If you are not using server clustering,accept the default. Otherwise, enter the name of thecluster that the instance will participate in. Thedefault is NCICLUSTER.

NCI_CMD_LINE_PORT Command line port. Port used by the command lineservice for the new instance. The default is 2000.

NCI_DB_PORT Netcool database port. Port used by the NetcoolDatabase Server. The default is 5435.

OBJECTSERV_HOST_NAME Host name or IP address for the primary ObjectServer in your environment. Default, localhost.

OBJECTSERV_PORT Port used by the Object Server. The default is 4100.

OBJECTSERV_USER Name of the user account that is used to connect asan Object Server client. The default is root.

OBJECTSERV_PASSWORD Password for the Object Server user. The default isblank.

NCI_VCS_IMPACTSVN

NCI_VCS_SYSTEMSVN

NCI_VCS_SYSTEMCVS

NCI_VCS_RCS

NCI_VCS_CLEARCASE

Specifies which version control system to use.Default is Tivoli Netcool/Impact Subversion, whichis installed automatically with the product. Choosetrue for your selection, leave false for the rest.


||||||||||||||||||||||||||||||||||||||||||||||||||

||||

Table 1. Silent installation properties (continued)Parameter Description

UPGRADE_IMPACT_51 You set this parameter only if you are running anupgrade. Old Netcool/Impact 5.1 version found -upgrade it to new Impact 5.1.1 version. There is atest that is run at the beginning of the installerstartup to determine if an old Impact 5.1 versionexists on this machine. If an old Impact 5.1 is foundthe customer has the option to upgrade that versionof Impact to the 5.1.1 version. To upgrade thecustomer sets the UPGRADE_IMPACT_51parameter to 1. This will then upgrade the Impact5.1 to Impact 5.1.1. Default is to upgrade Impact 5.1.

v 1 - to upgrade the existing 5.1 installation. It isthe default setting.

v 0 - not to upgrade the existing 5.1 installationNote: If an Impact 5.1 is not found on the currentmachine the parameter UPGRADE_IMPACT_51 isignored.

UPDATE_REGULAR_INSTALL_TYPE You set this parameter only if you are running anupgrade. Old Netcool/Impact 5.1 version notfound. You have an old Netcool/Impact 5.1 but theautodetect did not find it in the ISMP registry. YOucan still upgrade the Netcool/Impact 5.1 installationby codingUPDATE_REGULAR_INSTALL_TYPE=UPDATEand setting the parameter USER_INSTALL_DIR topoint to the old Netcool/Impact 5.1 directory. If theNetcool/Impact 5.1 was autodetected thisparameter is ignored.

You can set one of these values:

v REGULAR - to run a clean new installation. It isthe default setting.

v UPDATE - to run an update from version 5.1 to5.1.1

VERCTLPATH Version control path. Default value /

VERCTL_REPOSITORY Version control repository. Default value /

Verifying the deploymentv Look into the netcool.log file to make sure that the Impact Server startedsuccessfully.

v Log on to the GUI and see if you can use view and manage services, datamodels, and policies.1. Open the following URL in a Web browser:

http://hostname:port/nci

where hostname is the name of the system where the embedded version ofWebSphere Application Server is running and port is the HTTP port. Thedefault port is 9080.

2. Enter the administration user name and password in the login page thatopens. The default administration user name is admin and the defaultpassword is netcool.


|||||||||||||||||||||||||||||||||||||||||||||||||||||||||

If you have deployed the components correctly, you can use the GUI to viewand manage services, data models, and policies as described in the UserInterface Guide.

Installation logsReview the following logs to make sure that the installation was successful:

IMPACT5.1.1_install-xx.log.lck

xx can be 00 or 01 or 02. This log is created while the installation isrunning the. When this lock file disappears (is removed at the end of theinstallation) the installation is complete.

IMPACT5.1.1_install-xx.logxx can be 00 or 01 or 02. The installer puts this log in the user homedirectory. This log file contains messages generated during the installationprocess. You can also use it to troubleshoot installation problems.

$NCHOME/logFor additional debugging information review the logs found in thisdirectory. These logs will help to troubleshoot installation problems.

Installing the JRExec server (Windows platforms)The JRExec server is a component used to run external commands, scripts, andapplications from within a policy. The JRExec server is automatically installed onthe system when you install Tivoli Netcool/Impact. On Windows systems, youmust also manually create the JRExec service after installation.

To create the JRExec service, enter the following command at a command prompt:%NCHOME%/impact/bin/nci_jrexec -i nci_jrexec.conf

Setting up JDBC for GenericSQL DSAThe GenericSQL DSA is a built-in component that enables access to information inany database application through a JDBC driver.

About this task

If you need to use the GenericSQL DSA, install a JDBC driver and specify thedirectories for this driver in the Impact Server properties file.

Note: This is only required for GenericSQL DSA and not for other SQL DSAs. Formore information about GenericSQL and other DSAs, see the DSA ReferenceGuide.1. To install the necessary JDBC driver, follow the instructions supplied with the

driver.2. To specify the directories where the driver was installed, edit the Impact Server

properties file.This file is named servername_server.props, where servername is the name ofthe Impact Server. The file is located in the $NCHOME/impact/etc directory. Youmust set the impact.server.jdbcDriverDirs property.v On Windows systems, use / or \\ as the path separator and a semicolon (;)between directories:impact.server.jdbcDriverDirs=C:\\Program Files\\JDBC;C:\\Program Files\\JDBC\\NewSQL


|||||||||||||||||||||||||||||||||||||||||||||

v On UNIX systems, use as the path separator and a colon (:) betweendirectories:impact.server.jdbcDriverDirs=/opt/ibm/netcool/dir1:/opt/ibm/netcool/dir2

Running a deploymentYou start and stop the Impact Server and the GUI Server by starting and stoppingthe Java application server where they reside, by default, the embedded version ofWebSphere Application Server. Both servers are automatically loaded and startedwith the application server.

You can also start and stop the Tivoli Netcool/Impact components separately fromthe application server using the management console tools provided by thatapplication. You must start them in the following order:v Impact Server and GUI Server.For more information about starting these components, see Starting theembedded version of WebSphere Application Server on page 38.

v JRExec server (optional).For more information about starting JRExec server, see Chapter 8, JRExecserver, on page 65.

Uninstalling Tivoli Netcool/ImpactYou can uninstall both Tivoli Netcool/Impact components, the Impact Server, andthe GUI Server using the same system tools.

On UNIX platforms, you run the uninstaller script, uninstall which is located inthe $NCHOME/_uninst directory.

On Windows platforms, you use the Add/Remove Programs tool.

Uninstalling Tivoli Netcool/Impact components on Windowsplatforms

On Windows platforms, you uninstall Tivoli Netcool/Impact components, theImpact Server or the GUI Server, using the Add/Remove Programs tool.1. In the Start menu, select Control Panel Add/Remove Programs.2. In the dialog box that opens, select Netcool/Impact and then select

Change/Remove.3. Follow the on-screen prompts to remove the software.4. Remove the directories where Tivoli Netcool/Impact components were

installed.Use Windows Explorer or the rmdir command at the command prompt.

Uninstalling Tivoli Netcool/Impact components on UNIXplatforms

On UNIX platforms, you uninstall Tivoli Netcool/Impact components, the ImpactServer or the GUI Server, by running the uninstaller script, uninstall which islocated in the $NCHOME/_uninst directory. You can run the uninstaller in GUI modeor in console mode. In GUI mode, it presents a series of graphical windows thatguide you through the uninstallation process. In console mode, it prompts you for


|||||||||||||||||||||||||

|||||||||||

|||||||

required information from the command line. If you are running the uninstallerremotely, using telnet or another command-line application, you must run it inconsole mode.1. At a command prompt, change the current directory to $NCHOME/_uninst.2. Run the uninstaller script.

v To run the uninstaller in GUI mode:./uninstall

v To run the uninstaller in console mode:./uninstall -console

3. Follow the on-screen prompts to remove the software.4. Remove the directories where Tivoli Netcool/Impact was installed.

Use the rm -r command.

Post installation utilityAbout this task

The post installation utility, nci_new_server (nci_new_server.exe on Windowsplatforms) is located in the $NCHOME/impact/install directory.

You use the post installation utility to:v Create a new instance of Impact Server.v Update the Name Server names for the GUI Server and Impact Servers.v Add a new Impact Server to a GUI Server only installation.v Reconfigure a currently installed Name Server.

The steps to follow after running the post installation utility are similar to those inthe new installation procedure. For more information about the new installation,seeChapter 2, Installing Tivoli Netcool/Impact, on page 5.v Running post install utility in GUI mode.Navigate to the directory that contains the script and run the followingcommand: ./nci_new_server (on UNIX platforms) nci_new_server.exe (on Windows platforms)Select the components that you want to install or configure by following theinstructions that are displayed on the screen.

v Running post installation utility in the command line.Navigate to the directory that contains the script and run the followingcommand: ./nci_new_server -i console (on UNIX platforms) nci_new_server.exe -i console (on Windows platforms)Select the components that you want to install or configure by following theinstructions that are displayed on the screen.

v Running post installation utility in silent mode.Before running the post installation utility in silent mode you need to edit theresponse file. A template of the response file, installSilent_Response.txt, isprovided with the installation file and you can edit it with your favorite texteditor. For a list of installation options that you can customize in the responsefile see Silent installation response file on page 25.


|||||||||||||||||||||||||||||||||||||||||||||

Navigate to the directory tha

net cool administration guide

Documents

server cluster components

server clustering overview

gui mode

gui server39overview

gui server40redeploying

gui server40chapter

ibm tivoli netcoolimpact

tivoli netcoolimpactversion