Netcool Configuration Manager Version 6.4.1 Installation and Configuration Guide R2E6 IBM
Netcool Configuration Manager Version 6.4.1 Installation and Configuration Guide R2E6 IBM
Note Before using this information and the product it supports, read the information in Notices on page 133. This edition applies to ersion 6, release 4 of IBM Tioli Netcool Configuration Manager (5725-F56) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2010, 2016. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents About this publication........ Intended audience............ What this publication contains........ Publications.............. Accessibility.............. ix Tioli technical training.......... ix Support information........... ix Conentions used in this publication...... x Chapter 1. Planning.......... 1 Architecture.............. 1 Hardware requirements........... 3 Software requirements........... 5 FIPS 140-2 requirements.......... 8 Chapter 2. Installing......... 9 Preparing to install............ 9 Creating OS user accounts........ 11 Creating installation directories....... 12 Preparing the Oracle database....... 12 Preparing the DB2 database........ 14 Preparing the operating system....... 17 Preparing an AIX installation....... 19 Preparing a Linux installation....... 20 Preparing a Solaris installation....... 21 Configuring the firewall......... 21 Installing the product........... 22 Installation information checklist...... 22 Installing a GUI and worker serer..... 26 Installing a worker serer only....... 32 Installing the product in silent mode..... 37 Installing ITNCM-Reports........ 42 Installing ITNCM-Reports in silent mode... 44 Installing driers............ 46 Driers oeriew........... 47 Drier installation prerequisites....... 50 Installing standard driers........ 51 Installing SmartModel driers....... 53 Installing auto-discoery.......... 61 Installing auto-discoery ia CLI (all platforms) 62 Installing auto-discoery ia GUI (all platforms) 63 Installing auto-discoery in silent mode.... 64 Installing OOBC............. 65 Extracting OOBC software........ 65 Installing a daemon.......... 66 Installing OOBC software......... 67 Configuring a daemon.......... 69 Troubleshooting the OOBC software installation 69 Chapter 3. Configuring........ 71 Loading the databases........... 71 Configuring DB2 HADR.......... 72 Configuring immediate execution (Natie Command Set workflow)............. 74 Configuring high priority queue....... 75 Configuring a pre-emptie high-priority queue.. 76 Deploying the keystore and user files...... 78 Increasing the Jaa Heap size........ 78 Configuring the Jaa Heap size for immediate execution (Natie Command Set workflow).. 79 Internal housekeeping........... 80 HTTPS connection setup.......... 80 Configuration of eentpollers.xml file..... 81 Creating a Worker serer general resource.... 81 Importing sample compliance policies..... 81 Enabling auto-restart of Netcool Configuration Manager after reboot........... 82 Changing platform configuration....... 82 Configuring mail serers.......... 83 Enabling and disabling FIPS 140-2 mode.... 84 Enabling FIPS............ 85 Disabling FIPS............ 88 Configuring reporting on a stand-alone installation 89 Configuring OOBC............ 90 OOBC system prerequisites........ 90 OOBC default configuration file...... 91 Configure out-of-band change....... 94 Configure monitor........... 94 Configure Netcool Configuration Manager serer 96 Configure syslog users......... 97 Configure syslog match......... 98 Configure actions........... 100 Configure notifiers.......... 102 Chapter 4. Upgrading........ 105 Upgrade from Netcool Configuration Manager 6.3.0.x to 6.4.1............. 105 Pre-upgrade procedures......... 105 Upgrade procedures.......... 106 Post-upgrade procedures........ 113 Upgrade from Netcool Configuration Manager 6.4.0.x to 6.4.1............. 115 Pre-upgrade procedures......... 115 Upgrade procedures.......... 116 Post-upgrade procedures........ 123 Upgrading Netcool Configuration Manager Reporting.............. 125 Chapter 5. Uninstalling....... 129 Uninstalling Netcool Configuration Manager... 129 Uninstalling ITNCM-Reports........ 130 Uninstalling OOBC Software........ 130 Uninstalling an OOBC daemon...... 131 Uninstalling OOBC software....... 131 Notices.............. 133 Trademarks.............. 135 Index............... 137 Copyright IBM Corp. 2010, 2016 iii
i IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
About this publication Intended audience Netcool Configuration Manager proides configuration management capabilities for network deices, as well as extensie configuration policy thresholding capabilities. The IBM Tioli Netcool Configuration Manager Installation and Configuration Guide describes how to install Netcool Configuration Manager. The guide also describes post-installation configuration tasks. This publication is for administrators who need to install and set up Netcool Configuration Manager. This publication is intended for administrators who need to install Netcool Configuration Manager and perform post-installation configuration. Readers must be familiar with network management and operating system configuration tasks. What this publication contains Publications This publication contains the following sections: Chapter 1, Planning, on page 1 Chapter 2, Installing, on page 9 Chapter 3, Configuring, on page 71 Chapter 4, Upgrading, on page 105 Chapter 5, Uninstalling, on page 129 This section lists publications in the Netcool Configuration Manager PDF document set. The prerequisite publications in the IBM Tioli Network Manager IP Edition and IBM Tioli Netcool/OMNIbus library are also listed here. The section also describes how to access Tioli publications online and how to order Tioli publications. Netcool Configuration Manager PDF document set The following documents are aailable in the Netcool Configuration Manager library: IBM Tioli Netcool Configuration Manager Installation and Configuration Guide Describes how to install IBM Tioli Netcool Configuration Manager. It also describes necessary and optional post-installation configuration tasks. This publication is for administrators who need to install and set up IBM Tioli Netcool Configuration Manager. IBM Tioli Netcool Configuration Manager User Guide Describes user tasks for IBM Tioli Netcool Configuration Manager, such as how to access reports, use deices, and execute the different utilities to maintain and support Auto-Discoery. This publication is for users working with IBM Tioli Netcool Configuration Manager. IBM Tioli Netcool Configuration Manager Administration Guide Copyright IBM Corp. 2010, 2016
Describes administration tasks for IBM Tioli Netcool Configuration Manager, such as how to set up user accounts, create and manage the OS registry, administer database and policy exports and imports, and perform housekeeping and security tasks. This publication is for administrators who are responsible for the maintenance and aailability of IBM Tioli Netcool Configuration Manager. IBM Tioli Netcool Configuration Manager Reference Guide Contains reference information about IBM Tioli Netcool Configuration Manager. IBM Tioli Netcool Configuration Manager API Guide Proides information about how to use the Jaa API to programmatically access IBM Tioli Netcool Configuration Manager. IBM Tioli Netcool Configuration Manager NSM REST API Guide Describes the Serice Management Interface API. IBM Tioli Netcool Configuration Manager Integration Guide Describes how to integrate Netcool Configuration Manager with Tioli Netcool/OMNIbus and Network Manager. IBM Tioli Netcool Configuration Manager Quick Start Guide Gets you started with a typical installation for IBM Tioli Netcool Configuration Manager. IBM Tioli Netcool Configuration Manager Release Notes Gies important and late-breaking information about IBM Tioli Netcool Configuration Manager. This publication is for deployers and administrators, and should be read first. Prerequisite publications: IBM Tioli Network Manager IP Edition To use the information in this publication effectiely when dealing with an integrated installation of Netcool Configuration Manager, Network Manager, and Tioli Netcool/OMNIbus, you must hae some prerequisite knowledge, which you can obtain from the Network Manager documentation, especially the following publications: IBM Tioli Network Manager IP Edition Release Notes Gies important and late-breaking information about IBM Tioli Network Manager IP Edition. This publication is for deployers and administrators, and should be read first. IBM Tioli Network Manager Getting Started Guide Describes how to set up IBM Tioli Network Manager IP Edition after you hae installed the product. This guide describes how to start the product, make sure it is running correctly, and discoer the network. Getting a good network discoery is central to using Network Manager IP Edition successfully. This guide describes how to configure and monitor a first discoery, erify the results of the discoery, configure a production discoery, and how to keep the network topology up to date. Once you hae an up-to-date network topology, this guide describes how to make the network topology aailable to Network Operators, and how to monitor the network. The essential tasks are coered in this short guide, with references to the more detailed, optional, or adanced tasks and reference material in the rest of the documentation set. IBM Tioli Network Manager IP Edition Product Oeriew Gies an oeriew of IBM Tioli Network Manager IP Edition. It describes the product architecture, components and functionality. This publication is for anyone interested in IBM Tioli Network Manager IP Edition. i IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
IBM Tioli Network Manager IP Edition Installation and Configuration Guide Describes how to install IBM Tioli Network Manager IP Edition. It also describes necessary and optional post-installation configuration tasks. This publication is for administrators who need to install and set up IBM Tioli Network Manager IP Edition. IBM Tioli Network Manager IP Edition Administration Guide Describes administration tasks for IBM Tioli Network Manager IP Edition, such as how to administer processes, query databases and start and stop the product. This publication is for administrators who are responsible for the maintenance and aailability of IBM Tioli Network Manager IP Edition. IBM Tioli Network Manager IP Edition Discoery Guide Describes how to use IBM Tioli Network Manager IP Edition to discoer your network. This publication is for administrators who are responsible for configuring and running network discoery. IBM Tioli Network Manager IP Edition Eent Management Guide Describes how to use IBM Tioli Network Manager IP Edition to poll network deices, to configure the enrichment of eents from network deices, and to manage plug-ins to the Tioli Netcool/OMNIbus Eent Gateway, including configuration of the RCA plug-in for root-cause analysis purposes. This publication is for administrators who are responsible for configuring and running network polling, eent enrichment, root-cause analysis, and Eent Gateway plug-ins. IBM Tioli Network Manager IP Edition Network Troubleshooting Guide Describes how to use IBM Tioli Network Manager IP Edition to troubleshoot network problems identified by the product. This publication is for network operators who are responsible for identifying or resoling network problems. IBM Tioli Network Manager IP Edition Network Visualization Setup Guide Describes how to configure the IBM Tioli Network Manager IP Edition network isualization tools to gie your network operators a customized working enironment. This publication is for product administrators or team leaders who are responsible for facilitating the work of network operators. IBM Tioli Network Manager IP Edition Management Database Reference Describes the schemas of the component databases in IBM Tioli Network Manager IP Edition. This publication is for adanced users who need to query the component databases directly. IBM Tioli Network Manager IP Edition Topology Database Reference Describes the schemas of the database used for storing topology data in IBM Tioli Network Manager IP Edition. This publication is for adanced users who need to query the topology database directly. IBM Tioli Network Manager IP Edition Language Reference Describes the system languages used by IBM Tioli Network Manager IP Edition, such as the Stitcher language, and the Object Query Language. This publication is for adanced users who need to customize the operation of IBM Tioli Network Manager IP Edition. IBM Tioli Network Manager IP Edition Perl API Guide Describes the Perl modules that allow deelopers to write custom applications that interact with the IBM Tioli Network Manager IP Edition. Examples of custom applications that deelopers can write include Polling and Discoery Agents. This publication is for adanced Perl deelopers who need to write such custom applications. IBM Tioli Monitoring for Tioli Network Manager IP User's Guide About this publication ii
Proides information about installing and using IBM Tioli Monitoring for IBM Tioli Network Manager IP Edition. This publication is for system administrators who install and use IBM Tioli Monitoring for IBM Tioli Network Manager IP Edition to monitor and manage IBM Tioli Network Manager IP Edition resources. Prerequisite publications: IBM Tioli Netcool/OMNIbus To use the information in this publication effectiely when dealing with an integrated installation of Netcool Configuration Manager, Network Manager, and Tioli Netcool/OMNIbus, you must hae some prerequisite knowledge, which you can obtain from the Tioli Netcool/OMNIbus documentation, especially the following publications: IBM Tioli Netcool/OMNIbus Installation and Deployment Guide Includes installation and upgrade procedures for Tioli Netcool/OMNIbus, and describes how to configure security and component communications. The publication also includes examples of Tioli Netcool/OMNIbus architectures and describes how to implement them. IBM Tioli Netcool/OMNIbus User's Guide Proides an oeriew of the desktop tools and describes the operator tasks related to eent management using these tools. IBM Tioli Netcool/OMNIbus Administration Guide Describes how to perform administratie tasks using the Tioli Netcool/OMNIbus Administrator GUI, command-line tools, and process control. The publication also contains descriptions and examples of ObjectSerer SQL syntax and automations. IBM Tioli Netcool/OMNIbus Probe and Gateway Guide Contains introductory and reference information about probes and gateways, including probe rules file syntax and gateway commands. IBM Tioli Netcool/OMNIbus Web GUI Administration and User's Guide Describes how to perform administratie and eent isualization tasks using the Tioli Netcool/OMNIbus Web GUI. Accessing terminology online The IBM Terminology website consolidates the terminology from IBM product libraries in one conenient location. You can access the Terminology website at the following Web address: http://www.ibm.com/software/globalization/terminology Accessing publications online IBM posts publications for this and all other Tioli products, as they become aailable and wheneer they are updated, to the Tioli Information Center website at: http://publib.boulder.ibm.com/infocenter/tiihelp/3r1/index.jsp Note: If you print PDF documents on other than letter-sized paper, set the option in the File > Print window that allows Adobe Reader to print letter-sized pages on your local paper. iii IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Ordering publications You can order many Tioli publications online at the following website: http://www.elink.ibmlink.ibm.com/publications/serlet/pbi.wss You can also order by telephone by calling one of these numbers: In the United States: 800-879-2755 In Canada: 800-426-4968 In other countries, contact your software account representatie to order Tioli publications. To locate the telephone number of your local representatie, perform the following steps: 1. Go to the following website: http://www.elink.ibmlink.ibm.com/publications/serlet/pbi.wss 2. Select your country from the list and click Go. The Welcome to the IBM Publications Center page is displayed for your country. 3. On the left side of the page, click About this site to see an information page that includes the telephone number of your local representatie. Accessibility Tioli technical training Support information Accessibility features help users with a physical disability, such as restricted mobility or limited ision, to use software products successfully. With this product, you can use assistie technologies to hear and naigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. For Tioli technical training information, refer to the following IBM Tioli Education website: http://www.ibm.com/software/tioli/education If you hae a problem with your IBM software, you want to resole it quickly. IBM proides the following ways for you to obtain the support you need: Online Go to the IBM Software Support site at http://www.ibm.com/software/ support/probsub.html and follow the instructions. IBM Support Assistant The IBM Support Assistant (ISA) is a free local software sericeability workbench that helps you resole questions and problems with IBM software products. The ISA proides quick access to support-related information and sericeability tools for problem determination. To install the ISA software, go to http://www.ibm.com/software/support/isa About this publication ix
Conentions used in this publication This publication uses seeral conentions for special terms and actions and operating system-dependent commands and paths. Typeface conentions This publication uses the following typeface conentions: Bold Italic Monospace Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip: and Operating system considerations:) Keywords and parameters in text Citations (examples: titles of publications, diskettes, and CDs) Words defined in text (example: a nonswitched line is called a point-to-point line) Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictie clause."; letters as letters example: "The LUN address must start with the letter L.") New terms in text (except in a definition list): a iew is a frame in a workspace that contains data Variables and alues you must proide:... where myname represents... Examples and code examples File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options Operating system-dependent ariables and paths This publication uses the UNIX conention for specifying enironment ariables and for directory notation. When using the Windows command line, replace $ariable with %ariable% for enironment ariables, and replace each forward slash (/) with a backslash (\) in directory paths. For example, on UNIX systems, the $NCHOME enironment ariable specifies the directory where the Network Manager core components are installed. On Windows systems, the same enironment ariable is %NCHOME%. The names of enironment ariables are not always the same in the Windows and UNIX enironments. For example, %TEMP% in Windows enironments is equialent to $TMPDIR in UNIX enironments. If you are using the bash shell on a Windows system, you can use the UNIX conentions. x IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Chapter 1. Planning Architecture Use this information to plan a new installation of Netcool Configuration Manager. For upgrading and migrating from existing installations, see the Migration and Upgrading sections instead. Related information: Installing auto-discoery on page 61 Use this information to install the Netcool Configuration Manager auto-discoery drier. You must install the most current driers before installing auto-discoery. Netcool Configuration Manager can be deployed as either a stand-alone product on one or more serers, or with IBM Tioli Network Manager IP Edition and IBM Tioli Netcool/OMNIbus as part of an integrated solution. All components of Netcool Configuration Manager are installed on each deployed serer. Howeer, the compliance serer component is switched on or off at install time. You can also switch worker serer modes afterwards by running a script. Note: A database must be present before Netcool Configuration Manager is installed. Stand-alone product You can install Netcool Configuration Manager on a single serer or distributed on a number of serers. Optionally, you can install Tioli Common Reporting as part of the same installation procedure. TCR is installed with, and accessed through, the Tioli Integrated Portal. Installation dependency Installation order 1 2* Tioli Integrated Portal Optional components 1 2* 2 2* Tioli Common Reporting including the Netcool Configuration Manager reports (and the Tioli Integrated Portal) Database Netcool Configuration Manager Figure 1. Stand-alone installation with component dependencies and installation sequence 1 2 Install the database first. Install Netcool Configuration Manager. Install the Netcool Configuration Manager driers and the OOBC software. Copyright IBM Corp. 2010, 2016 1
Optionally, you can install Tioli Common Reporting, including the Netcool Configuration Manager reports and the Tioli Integrated Portal. Integrated product You can install Netcool Configuration Manager together with Network Manager and Tioli Netcool/OMNIbus, either on a single serer or on a number of serers. In such an integrated scenario you, install first Network Manager and Tioli Netcool/OMNIbus, before installing Netcool Configuration Manager without Tioli Common Reporting. After this, you install TCR separately into the Network Manager TIP enironment. Note: You can use an existing installation of Network Manager and Tioli Netcool/OMNIbus to create such an integrated solution. Tioli Netcool/OMNIbus 4 Netcool/ OMNIbus Web GUI Network Manager web applications 3 ObjectSerer Network Manager IP Edition 1 2 5 6 Tioli Integrated Portal Tioli Common Reporting including the Netcool Configuration Manager Installation dependency Database Netcool Configuration Manager Installation order 1 Figure 2. Integrated installation with component dependencies and installation sequence 1 Install the database first. 2, 3, 4 Install Network Manager, including Tioli Netcool/OMNIbus. 5 6 This installs, in order, the Tioli Netcool/OMNIbus ObjectSerer, the Network Manager software components, and the Tioli Integrated Portal components including the Tioli Netcool/OMNIbus Web GUI, and the Network Manager web applications. Install Netcool Configuration Manager. Install the Netcool Configuration Manager driers and the OOBC software. Install the Netcool Configuration Manager Actiity Viewer and wizards into the Network Manager Tioli Integrated Portal enironment, and the reports into the existing Network Manager Tioli Common Reporting deployment. 2 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Hardware requirements Hardware requirements ary according to the size and composition of your network and the features of Netcool Configuration Manager that you want to use. They are also influenced by your database and operating system configuration, and by whether you install a 32 bit or 64 bit ersion of Netcool Configuration Manager. Ensure that your serers meet at least the minimum hardware requirements before you proceed to an installation. Table 1. Netcool Configuration Manager serer hardware requirements Item CPU Memory (32 bit operating systems) Requirement 2 GHz Note: Fix Pack 1 32-bit operating systems are not supported bynetcool Configuration Manager from ersion 6.4.1 Fix Pack 1 onwards. Consequently, it is ery strongly recommended that a 64-bit ersion of Netcool Configuration Manager is installed so that the security updates and APAR fixes deliered in Fix Pack 1, and any subsequent 6.4.1 fix packs, can be applied. Netcool Configuration Manager components require the following amount of memory: Presentation JVM: 2GB Compliance JVM: 2GB Reporting JVM: 2GB Worker Base JVM: 2GB Worker Compliance engine JVM: 2GB The following examples illustrate the memory requirements for a number of typical deployments: Presentation serer + Compliance core + Worker Base + Reporting: 8GB Presentation serer + Compliance core + Worker Base: 6GB Presentation serer + Compliance core + Reporting: 6GB Presentation serer + Worker Base + Reporting: 6GB Presentation serer + Compliance core: 4GB Worker Base: 2GB Compliance ealuation engine only: 2GB Worker Base + Compliance ealuation engine: 4GB Note: These requirements are for Netcool Configuration Manager components only, that is, they do not include the database or operating system memory requirements. Consult the database and OS documentation for more information specific to your OS and database memory needs. Chapter 1. Planning 3
Table 1. Netcool Configuration Manager serer hardware requirements (continued) Item Memory (64 bit operating systems) Requirement Netcool Configuration Manager components require the following amount of memory: Presentation JVM: 2GB Compliance core JVM: 2GB Reporting JVM: 2GB Worker Base JVM: 3GB Worker Compliance engine JVM: 2GB Disk space Network interface card Database disk space Swap/paging space The following examples illustrate the memory requirements for a number of typical deployments: Presentation serer + Compliance core + Worker Base + Reporting: 9GB Presentation serer + Compliance core + Worker Base: 7GB Presentation serer + Compliance core + Reporting: 6GB Presentation serer + Worker Base + Reporting: 7GB Presentation serer + Compliance core: 5GB Worker Base: 2GB Compliance ealuation engine only: 2GB Worker Base + Compliance ealuation engine: 4GB Note: These requirements are for Netcool Configuration Manager components only, that is, they do not include the database or operating system memory requirements. Consult the database and OS documentation for more information specific to your OS and database memory needs. 10 GB of space is recommended as a base for initial installation. Requirements may change based on indiidual company needs. The Installer by default uses 5 GB of space in /tmp. If /tmp isn't large enough, IATEMPDIR can be used to specify another directory instead. The IATEMPDIR enironment ariable specifies an alternatie directory into which the Netcool Configuration Manager installer may extract files before actual installation. Howeer, a small amount of data (about 1MB) will be written to /tmp een if IATEMPDIR is being used. Important: When installing Tioli Common Reporting: The IATEMPDIR directory is required when installing Tioli Common Reporting and you must specify a minimum of 10 GB. Important: Fix Pack 3 When using the Prerequisite Scanner tool: The Prerequisite Scanner tool (and Netcool Configuration Manager) will not work if /tmp is mounted with noexec. Gigabit Ethernet 500 GB Your system should hae swap/paging space equialent to half of the RAM allocated. For example, for 10 GB RAM, you should hae 5 GB of paging space. Refer to your database documentation for more detailed database swap/paging space guidelines. 4 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Software requirements Software requirements ary according to the operating system and features of Netcool Configuration Manager that you want to use. Note: When gien a choice, a 64-bit operating system is preferred to a 32-bit operating system. If Juniper deices are to be managed, then a 64-bit operating system should be used. Note: Fix Pack 1 32-bit operating systems are not supported bynetcool Configuration Manager from ersion 6.4.1 Fix Pack 1 onwards. Consequently, it is ery strongly recommended that a 64-bit ersion of Netcool Configuration Manager is installed so that the security updates and APAR fixes deliered in Fix Pack 1, and any subsequent 6.4.1 fix packs, can be applied. Table 2. Netcool Configuration Manager supported operating systems Item Requirement AIX 6.1 and 7.1 Note: AIX 6.1 and 7.1 are no longer aailable as 32 Bit architecture. Howeer, Netcool Configuration Manager remains aailable for both 32 and 64 Bit ersions of AIX, and both are compatible with AIX 6.1 and 7.1. Linux Package tar-1.14-2.aix5.1.ppc.rpm (GNU tar) or later should be installed for Netcool Configuration Manager Tioli Common Reporting, or else the installation will fail. SUSE Linux 10 and 11 (32 and 64 Bit ersions) Solaris 10 and 11 Red Hat Enterprise Linux 5 and 6 (32 and 64 Bit ersions) Restriction: For Red Hat Enterprise Linux 6, Netcool Configuration Manager Tioli Common Reporting is not supported. If you require Tioli Common Reporting on a Red Hat Enterprise Linux platform, use Version 5 (32 or 64 Bit ersions). The following system libraries must be installed on Red Hat Enterprise Linux 6 (32 and 64 Bit ersions), or the installation will fail: glibc-2.12-1.25.el6_1.3.i686 libgcc-4.4.5-6.el6.i686 Table 3. Netcool Configuration Manager database requirements Database Version supported Note: For all database types and ersions, use the latest fix pack, unless otherwise specified. DB2 9.5 9.7 10.1 10.5 Fix Pack 3 Chapter 1. Planning 5
Table 3. Netcool Configuration Manager database requirements (continued) Database Version supported Oracle 10g R2 (10.2.0.1) 11g R2 (11.2.0.1.0) Tip: Netcool Configuration Manager supports Oracle Real Application Clusters (Oracle RAC), but if a switchoer occurs, you must restart Netcool Configuration Manager on all serers. Note: The database must be installed before Netcool Configuration Manager. Ensure a minimum 8kb block size per instance. Table 4. Netcool Configuration Manager client software requirements Item Web Browser support Jaa Runtime Enironment Requirement Internet Explorer 8.0, 9.0, and 10.0 Mozilla Firefox 10,17,24 Extended Support Release (ESR) Restriction: When using TCR Reporting, only IE 8.0/9.0 and Mozilla Firefox 10,17 ESR are currently supported. Note: This should be installed on the client before any other software is installed. Not integrated with Network Manager JRE 1.6 or 1.7 installed on the client Integrated with Network Manager JRE 1.6 installed on the client Table 5. Other Netcool Configuration Manager requirements Item FTP, TFTP, Tar, Unzip, gunzip Network time protocol (NTP) DB2 Runtime Client Notes This should be installed on all serers before any other software is installed. This should be installed and configured on all serers before any other software is installed. Note: Required only for the following scenarios: Installations of Netcool Configuration Manager that are not integrated with Network Manager, exercise the option to install Tioli Common Reporting, and utilize a DB2 database. Installations of Netcool Configuration Manager that use a DB2 database and are integrated with Network Manager using a different database. For more information, see Installing and configuring the DB2 Run Time Client on page 15. 6 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Table 5. Other Netcool Configuration Manager requirements (continued) Item Tioli Common Reporting Notes Important: Tioli Common Reporting prerequisites should be installed on all serers before any other software is installed.reiew the requirements for Tioli Common Reporting to make sure you meet your performance requirements. For detailed information on software and hardware requirements, see the Tioli Common Reporting information center at the following URL: http://www-01.ibm.com/support/ knowledgecenter/ssh2df/welcome Restriction: Tioli Common Reporting must be installed in the Tioli Integrated Portal in a single serer deployment. A distributed installation of Tioli Common Reporting is not supported when integrated with Netcool Configuration Manager. Tip: The Tioli Common Reporting prerequisites listed in the Tioli Common Reporting documentation apply to all ersions of Red Hat Enterprise Linux 5, and not just to 5.1 and 5.2. Netcool Configuration Manager can be installed on ersions 5.1 to 5.5. Restriction: For Red Hat Enterprise Linux, Tioli Common Reporting can only be installed on Red Hat Enterprise Linux 5 (32 and 64 Bit ersions 5.1 to 5.5). Red Hat Enterprise Linux 6 is not compatible with Tioli Common Reporting. Remember: When deploying Tioli Common Reporting onto a existing integrated Linux platform, ensure unixodbc-2.2.x.x or higher RPM is present. Note: When deploying a stand-alone ersion of Tioli Common Reporting onto a Solaris platform, ensure that the Solaris serer timezone is one that is supported by Tioli Common Reporting. If Solaris uses a time zone Tioli Common Reporting does not recognize, a time zone error will occur when you access Tioli Common Reporting. See the Tioli Common Reporting information center for more time zone information. Related tasks: Installing and configuring the DB2 Run Time Client on page 15 When not integrating with Network Manager, and installing the Netcool Configuration Manager Tioli Common Reporting component with a DB2 database, you must obtain and install the DB2 runtime client, catalogue the TCP/IP node (that is, the platform running the DB2 database), and also catalogue the DB2 database instance. You also perform these actions when integrating Netcool Configuration Manager using a DB2 database with a ersion of Network Manager that does not use a DB2 database. Installing a GUI and worker serer on page 26 You install Netcool Configuration Manager either on a single serer, or on seeral serers in a distributed architecture. The installation of a GUI and worker serer can be part of a stand-alone installation on a single serer, or it can be the first step in the installation of a distributed architecture on seeral serers. Installing a worker serer only on page 32 You install a Netcool Configuration Manager worker serer as part of a distributed architecture deployed on one or more serers. You install one or more worker serers after haing completed the installation of one or more GUI and worker serers. Chapter 1. Planning 7
FIPS 140-2 requirements Enabling FIPS 140-2 on Netcool Configuration Manager requires that you run the correct ersion of Driers and that you configure the HTTPS connection setup. Specifically, the following list elaborates on the requirements for enabling FIPS 140-2 compliance on Netcool Configuration Manager: Driers 14, or aboe Netcool Configuration Manager can operate with a ariety of Drier releases. Howeer, in order to enable FIPS 140-2 compliance, you must be running with Driers 14, or aboe. Users running an earlier Driers ersion and who want to enable FIPS 140-2 compliance must upgrade to at least Driers 14. Tip: Always ensure you are running the latest Driers release. Configure the HTTPS connection setup Certificate export/import is required for HTTPS. When Netcool Configuration Manager uses encryption oer HTTPS, FIPS-certified ciphers are used. Therefore, configuring the HTTPS connection setup is a prerequisite for enabling FIPS 140-2 mode on Netcool Configuration Manager. For more information, see HTTPS connection setup on page 80. Related information: Enabling and disabling FIPS 140-2 mode on page 84 Use this information to either enable or disable FIPS 140-2 mode. 8 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Chapter 2. Installing Preparing to install Use this information to install Netcool Configuration Manager. After installation, you perform configuration tasks. For supplementary information on integrating with Network Manager IP Edition and Tioli Netcool/OMNIbus, see the IBM Tioli Netcool Configuration Manager Integration Guide. Before you install a new ersion of Netcool Configuration Manager, you must perform a number of preparatory tasks. Before you begin Important: To install a non-integrated, stand-alone ersion of Netcool Configuration Manager, follow the instructions contained in the following sections. Howeer, for an installation of Netcool Configuration Manager that is to be integrated with Network Manager IP Edition and Tioli Netcool/OMNIbus, see the IBM Tioli Netcool Configuration Manager Integration Guide before you attempt any installation tasks. Ensure you hae downloaded the correct installation files for your operating system. You need three separate installation files to install the three Netcool Configuration Manager installation components, as well as the driers and OOBC installation files. Note: Fix Pack 1 32-bit operating systems are not supported bynetcool Configuration Manager from ersion 6.4.1 Fix Pack 1 onwards. Consequently, it is ery strongly recommended that a 64-bit ersion of Netcool Configuration Manager is installed so that the security updates and APAR fixes deliered in Fix Pack 1, and any subsequent 6.4.1 fix packs, can be applied. Main installation image These platform-specific images contain the main installation files and are required for all installation scenarios. The platform-specific files are as follows: AIX Linux ITNCM_aix_ppc32.bin, or ITNCM_aix_ppc64.bin ITNCM_linux_ia32.bin, or ITNCM_linux_x86_64.bin Solaris ITNCM_solaris_sparc.bin, or ITNCM_solaris_sparc64.bin Tioli Common Reporting component These platform-specific images contain a separate installer that contains the installation files for the Tioli Common Reporting component. Note: Ensure you reiew the software and hardware requirements for Tioli Common Reporting to make sure you meet your performance requirements. For detailed information on requirements, see the Tioli Common Reporting Knowledge Center at the following URL: http://www-01.ibm.com/support/knowledgecenter/ssh2df/welcome Copyright IBM Corp. 2010, 2016 9
Remember: These files also contain Tioli Integrated Portal, into which Tioli Common Reporting will be installed. These files are required only for non-integrated, stand-alone installations of Netcool Configuration Manager that require access to Tioli Common Reporting. The platform-specific files are as follows: Linux (32bit) ITNCM_Reports_linux_ia32.tar Linux (64bit) ITNCM_Reports_linux_x86_64.tar Solaris (32bit) ITNCM_Reports_solaris_sparc32.tar Solaris (64bit) ITNCM_Reports_solaris_sparc64.tar AIX (32bit) ITNCM_Reports_aix_ppc32.tar AIX (64bit) ITNCM_Reports_aix_ppc64.tar Tioli Integrated Portal component Remember: These files are required only for integrated installation scenarios. For more information on installing these integrated components, see the IBM Tioli Netcool Configuration Manager Integration Guide. These platform-specific images contain the installation files for the Netcool Configuration Manager Actiity Viewer, the wizards and the thick-client launch portal, as well as the default Tioli Common Reporting reports. You install these components into the existing Network Manager ersion of Tioli Integrated Portal. The platform-specific files are as follows: AIX Linux ITNCM_TIP_aix.bin ITNCM_TIP_linux.bin Solaris ITNCM_TIP_solaris.bin Driers installation files The multi-platform ITNCMDriers.bin drier files are contained within the installation folders and are required for all installation scenarios. For more information on installing driers, see the related links. OOBC installation files The multi-platform oobc.zip OOBC files are contained within the installation folders and are required for all installation scenarios. For more information on installing OOBC, see the related topics. About this task Note: Netcool Configuration Manager installation examples use the default directory path of /opt/ibm/tioli/netcool/ncm. You can oerride this with a path appropriate to your own requirements. Related tasks: 10 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
Installing a GUI and worker serer on page 26 You install Netcool Configuration Manager either on a single serer, or on seeral serers in a distributed architecture. The installation of a GUI and worker serer can be part of a stand-alone installation on a single serer, or it can be the first step in the installation of a distributed architecture on seeral serers. Installing a worker serer only on page 32 You install a Netcool Configuration Manager worker serer as part of a distributed architecture deployed on one or more serers. You install one or more worker serers after haing completed the installation of one or more GUI and worker serers. Related information: Installing driers on page 46 Use this information to install Netcool Configuration Manager driers. Installing OOBC on page 65 Use this information about Netcool Configuration Manager to install the OOBC daemon, install the OOBC software, configure an OOBC daemon, and troubleshoot OOBC installation issues. Creating OS user accounts Netcool Configuration Manager requires a system user and an FTP user that belong to the same user group. Before you begin For commands specific to your operating system, refer to your OS documentation. About this task Netcool Configuration Manager operates under the default system user account 'icosuser' and group 'icosgrp'. Additionally, FTP serers that communicate with deices (GUI and Worker), or that process UOWs (Worker), use the default 'icosftp' user account. Icosgrp, icosuser and icosftp can be changed if your administration circumstances require this. Howeer, the two users must belong to the same group. About the FTP user account You must create an FTP user account only on a serer that is to be the FTP serer communicating with deices (GUI & Worker), or that is going to process UOWs (Worker). The FTP user account must be set up and used to create the network deice configuration files, and it must exist on all workers. The FTP user account is also used for FTP communications. Note: Netcool Configuration Manager requires a designated space as a repository for all network deice configuration files. This space will be used regardless of network configuration transfer mode (that is, FTP, TFTP, or streaming). Note: This procedure assumes that the default system user, FTP user, and user group are used. Procedure 1. Log into the machine as root. 2. Create the icosgrp group. Chapter 2. Installing 11
3. Add the icosuser user to icosgrp. 4. Set the password for icosuser. Remember: Make a note of the password, as this will be required to complete the installation and administer the product. 5. Add the icosftp user to icosgrp. 6. Set the password for the icosftp user. Remember: Make a note of the password. 7. To allow general access to the icosftp directory, set the folder permissions at 774. What to do next Now, create the installation directories. Creating installation directories You use the mkdir command to create the installation directories on each serer that Netcool Configuration Manager is to be installed. Before you begin About this task You must create the installation directories on each serer Netcool Configuration Manager will be installed. Procedure 1. Log on to the serer as root 2. Execute the following command: mkdir -p /opt/ibm/tioli/netcool/ncm Note: This is the default directory path. 3. Set the permissions on the install directory by typing: chown icosuser:icosgrp /opt/ibm/tioli/netcool/ncm What to do next Now, install the installation directories on the other serers as required. When done, you prepare the database for installation. Preparing the Oracle database Prior to installing or upgrading Netcool Configuration Manager, Oracle database parameters must be set. Before you begin To prepare the Oracle database, you update the database, and then create the Oracle user account, before ensuring that all Netcool Configuration Manager Oracle database users hae the appropriate system permissions. Note: The default user is icosuser, which you can change. 12 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
About this task Depending on the platform configuration, calculate your connection pool sizes based on the following default alues: Note: These are the minimum Netcool Configuration Manager requirements only. Presentation Serer with Compliance enabled Worker Serer Core = 55 Presentation = 65 Compliance Core = 55 Total = 175 ( + 55 if IDT is changed to run standalone) Presentation Serer with Compliance disabled Worker Serer Core = 55 Presentation = 65 Total = 120 ( + 55 if IDT is changed to run standalone) Worker Serer (Base + Compliance Eal Engine) Worker Serer Core = 55 Compliance EE = 55 Total = 110 Worker Serer (Base only) Worker Serer Core = 55 Total = 55 Worker Serer (Ealuation Engine Only) Ealuation Engine = 55 Total = 55 + 15 for command-line tools Note: This procedure assumes that the default icosuser is used. Procedure 1. Calculate Oracle processes using the formula specified. 2. Specify the following SQL*Plus command to specify the number of processes for the Oracle database: ALTER SYSTEM SET PROCESSES=alue from formula SCOPE=SPFILE Oracle must be restarted for these settings to take effect. Before modifying the Oracle processes of an existing Netcool Configuration Manager deployment, it is necessary to stop all serers accessing the database prior to executing any modifications. In addition it is recommended when the application serers are to be started, that each serer is shut down and allowed to restart one at a time before restarting the next one. This will result in a reduced impact on the Oracle database. Chapter 2. Installing 13
3. If using Oracle Version 10, set the Cursor Sharing to EXACT using the following SQL *Plus command carried on the Oracle serer: ALTER SYSTEM SET CURSOR_SHARING= EXACT SCOPE=BOTH 4. As the SYSDBA user, create the Oracle user account by executing the following SQL command: CREATE USER icosuser IDENTIFIED BY <password> 5. Using SQL, assign the CONNECT and RESOURCE roles to the user as follows: GRANT connect, resource TO icosuser 6. Assign the CREATE VIEW priilege to the user as follows: GRANT CREATE VIEW TO icosuser 7. Assign the CREATE SESSION priilege to the user as follows: GRANT CREATE SESSION TO icosuser 8. Issue the following SQL statement to allocate LOB chunks more efficiently: ALTER SYSTEM SET EVENT= 44951 TRACE NAME CONTEXT FOREVER, LEVEL 1024 scope=spfile; 9. Restart the database. What to do next Now, prepare the operating system for installation. Preparing the DB2 database The following steps to prepare the DB2 database assume that you hae already installed your DB2 database instance. Before you begin These steps assume that your DB2 instance owner is 'db2inst1'. If your instance owner is not 'db2inst1' then change 'db2inst1' references to your user. The following steps also assume that the Netcool Configuration Manager database user is different from the instance owner and called 'ncmdbuser'. If you are using db2inst1 as the NCM database user, replace all 'ncmdbuser' references in commands with 'db2inst1'. Procedure 1. Login into DB2 Serer as the instance owner 'db2inst1'. 2. Create the Netcool Configuration Manager database with a pagesize of 32768: db2 create database ITNCM automatic storage yes pagesize 32768 dft_extent_sz 32 3. Configure database user priileges. db2 connect to itncm Note: The Grant command may fail if your user already has priileges assigned. db2 "GRANT BINDADD,CONNECT,CREATE_NOT_FENCED_ROUTINE,CREATE_EXTERNAL_ROUTINE, QUIESCE_CONNECT ON DATABASE TO USER ncmdbuser" 4. Update the transaction log size: db2 update db cfg using logfilsiz 5000 db2 update db cfg for itncm using logprimary 200 db2 update db cfg for itncm using logsecond 50 5. Increase database storage used for locking: db2 update db cfg for itncm using LOCKLIST 8192 14 IBM Tioli Netcool Configuration Manager: Installation and Configuration Guide
6. Commit Changes: db2 commit 7. Reset the database connection: db2 connect reset Installing and configuring the DB2 Run Time Client When not integrating with Network Manager, and installing the Netcool Configuration Manager Tioli Common Reporting component with a DB2 database, you must obtain and install the DB2 runtime client, catalogue the TCP/IP node (that is, the platform running the DB2 database), and also catalogue the DB2 database instance. You also perform these actions when integrating Netcool Configuration Manager using a DB2 database with a ersion of Network Manager that does not use a DB2 database. Before you begin Installation of the DB2 database is a prerequisite, which is described in the DB2 Knowledge Center. You can access the DB2 Knowledge Center at the following link: http://www-01.ibm.com/support/knowledgecenter/ssepgg_9.5.0/ com.ibm.db2.luw.doc/welcome.html About this task Restriction: This procedure applies only to the following two scenarios: Installations of Netcool Configuration Manager that are not integrated with Network Manager, exercise the option to install Tioli Common Reporting, and utilize a DB2 database. Installations of Netcool Configuration Manager that use a DB2 database and are integrated with Network Manager using a different database. For all other scenarios, ignore this procedure and moe on to the topic describing how to add regular expression support to the DB2 database. For information on configuring the DB2 Run Time Client, see the 'Configuring client-to-serer connections using the command line processor' topic at the following link: http://www-01.ibm.com/support/knowledgecenter/ SSEPGG_9.5.0/com.ibm.db2.luw.qb.client.doc/doc/t0007243.html You can install the DB2 runtime client after installing Netcool Configuration Manager. If you do, ensure you then catalog the Netcool Configuration Manager database using the same alias that you supplied when installing the Tioli Common Reporting components. Procedure 1. Download the DB2 Run Time Client. The runtime client can be obtained at the IBM Support Portal. a. On the IBM Support Portal, naigate to the Downloads tab and search for the ersion of the DB2 Run Time Client that you want to download. b. Select the appropriate link to display a table that lists the DB2 download packages. c. To download the DB2 Run Time Client, select the appropriate package from the table. For more information on the supported ersions of DB2, see Software requirements on page 5. Chapter 2. Installing 15