Click here to load reader

PDF Tnpm Installguide

  • View
    120

  • Download
    0

Embed Size (px)

Text of PDF Tnpm Installguide

  • IBM Tivoli Netcool Performance Manager 1.3.2Wireline ComponentDocument Revision R2E1

    Installation Guide

  • NoteBefore using this information and the product it supports, read the information in Notices on page 251.

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

  • ContentsPreface . . . . . . . . . . . . . . viiAudience . . . . . . . . . . . . . . . viiTivoli Netcool Performance Manager - WirelineComponent . . . . . . . . . . . . . . viiThe Default UNIX Shell . . . . . . . . . . ix

    Chapter 1. Introduction . . . . . . . . 1Tivoli Netcool Performance Manager architecture . . 1

    Co-location rules . . . . . . . . . . . . 2Inheritance . . . . . . . . . . . . . . 4Notable subcomponents and features . . . . . 5

    Typical installation topology . . . . . . . . . 8Basic topology scenario . . . . . . . . . . 8Intermediate topology scenario . . . . . . . 9Advanced topology scenario. . . . . . . . 10

    Tivoli Netcool Performance Manager distribution . . 11

    Chapter 2. Requirements . . . . . . . 13Minimum requirements for installation . . . . . 13

    Solaris hardware requirements . . . . . . . 13AIX hardware requirements . . . . . . . . 14Linux hardware requirements . . . . . . . 14Oracle deployment space requirements . . . . 14Tivoli Integrated Portal deployment spacerequirements . . . . . . . . . . . . . 15Screen resolution . . . . . . . . . . . 15

    Minimum requirements for a proof of conceptinstallation . . . . . . . . . . . . . . 15

    Solaris hardware requirements (POC). . . . . 15AIX hardware requirements (POC) . . . . . 16Linux hardware requirements (POC) . . . . . 16Screen resolution . . . . . . . . . . . 16

    Supported operating systems and modules . . . . 17Solaris 10 for SPARC platforms . . . . . . . 17AIX platforms . . . . . . . . . . . . 20Linux platforms . . . . . . . . . . . . 24

    Required user names . . . . . . . . . . . 27pvuser . . . . . . . . . . . . . . . 27oracle . . . . . . . . . . . . . . . 27

    Ancillary software requirements . . . . . . . 28FTP support . . . . . . . . . . . . . 28OpenSSH and SFTP . . . . . . . . . . 28File compression. . . . . . . . . . . . 29DataView load balancing . . . . . . . . . 29Oracle Database . . . . . . . . . . . . 30Oracle server . . . . . . . . . . . . . 30Tivoli Common Reporting client . . . . . . 30Java Runtime Environment (JRE) . . . . . . 31Web browsers and settings . . . . . . . . 31X Emulation . . . . . . . . . . . . . 32WebGUI integration . . . . . . . . . . 33Microsoft Office Version . . . . . . . . . 33

    Chapter 3. Installing and configuringthe prerequisite software . . . . . . . 35

    Overview . . . . . . . . . . . . . . . 35Supported platforms . . . . . . . . . . 36

    Pre-Installation setup tasks . . . . . . . . . 36Setting up a remote X Window display . . . . 36Changing the ethernet characteristics . . . . . 37Adding the pvuser login name . . . . . . . 40Setting the resource limits (AIX only) . . . . . 42Set the system parameters (Solaris only) . . . . 43Enable FTP on Linux systems (Linux only) . . . 45Disable SELinux (Linux only) . . . . . . . 45Set the kernel parameters (Linux only) . . . . 45Replace the native taring utility with gnu tar(AIX 7.1 only) . . . . . . . . . . . . 46Install a libcrypto.so . . . . . . . . . . 47

    Deployer pre-requisites . . . . . . . . . . 47Operating system check . . . . . . . . . 47Mount points check . . . . . . . . . . 48Authentication between distributed servers . . . 48

    Downloading the Tivoli Netcool PerformanceManager distribution to disk . . . . . . . . 48

    Downloading Tivoli Common Reporting to disk 49General Oracle setup tasks . . . . . . . . . 49

    Specifying a basename for DB_USER_ROOT . . 50Specifying Oracle login passwords. . . . . . 51Assumed values . . . . . . . . . . . . 52

    Install Oracle 11.2.0.2 server (64-bit) . . . . . . 53Download the Oracle distribution to disk . . . 53Verify the required operating system packages. . 54Run the Oracle server configuration script . . . 54Set a password for the Oracle login name . . . 57Run the preinstallation script . . . . . . . 57Run the rootpre.sh script (AIX only) . . . . . 58Verify PATH and Environment for the Oraclelogin name . . . . . . . . . . . . . 58Install Oracle using the menu-based script . . . 59Run the root.sh script . . . . . . . . . . 61Set the ORACLE_SID variable . . . . . . . 62Set automatic startup of the database instance . . 63Configure the Oracle listener . . . . . . . 63Configure the Oracle net client . . . . . . . 65

    Install Oracle 11.2.0.2 client (32-bit) . . . . . . 67Download the Oracle distribution to disk . . . 67Run the Oracle client configuration script . . . 68Set a password for the Oracle login name . . . 70Run the preinstallation script . . . . . . . 70Verify PATH and Environment for the Oraclelogin name . . . . . . . . . . . . . 71Install the Oracle client (32-bit) . . . . . . . 71Run the root.sh script . . . . . . . . . . 73Configure the Oracle Net Client . . . . . . 74Update the oracle user's .profile . . . . . . 74Configure the Oracle Net client . . . . . . . 75

    Next steps . . . . . . . . . . . . . . . 77

    Copyright IBM Corp. 2006, 2012 iii

  • Chapter 4. Installing in a distributedenvironment . . . . . . . . . . . . 79Distributed installation process . . . . . . . . 79Starting the Launchpad . . . . . . . . . . 81Installing the Topology Editor . . . . . . . . 82Starting the Topology Editor. . . . . . . . . 83Creating a new topology . . . . . . . . . . 84Adding and configuring the Tivoli NetcoolPerformance Manager components . . . . . . 84

    Add the hosts . . . . . . . . . . . . 84Add a database configurations component . . . 86Add a DataMart . . . . . . . . . . . . 87Add a Discovery Server . . . . . . . . . 89Add a Tivoli Integrated Portal . . . . . . . 90Add a DataView. . . . . . . . . . . . 91Add the DataChannel administrative components 92Add a DataChannel . . . . . . . . . . 93Add a Collector . . . . . . . . . . . . 95Add a Cross Collector CME . . . . . . . . 98

    Saving the topology . . . . . . . . . . . 99Opening an existing topology file . . . . . 100

    Starting the Deployer. . . . . . . . . . . 100Primary Deployer . . . . . . . . . . . 100Secondary Deployers . . . . . . . . . . 101Pre-deployment check . . . . . . . . . 101

    Deploying the topology . . . . . . . . . . 102Reuse an existing Tivoli Integrated Portal andInstall DataView using a non root user on alocal host . . . . . . . . . . . . . . 104Reuse an existing Tivoli Integrated Portal andInstall DataView using a non root user on aremote host . . . . . . . . . . . . . 106

    Next steps . . . . . . . . . . . . . . 108Resuming a partially successful first-timeinstallation . . . . . . . . . . . . . . 109

    Chapter 5. Installing as a minimaldeployment . . . . . . . . . . . . 111Overview . . . . . . . . . . . . . . . 111Before you begin . . . . . . . . . . . . 111

    Special consideration . . . . . . . . . . 112Overriding default values . . . . . . . . 112

    Installing a minimal deployment . . . . . . . 113Download the MIB-II files . . . . . . . . 113Starting the Launchpad . . . . . . . . . 113Start the installation . . . . . . . . . . 114

    The post-installation script . . . . . . . . . 116Next steps . . . . . . . . . . . . . . 116

    Chapter 6. Modifying the currentdeployment . . . . . . . . . . . . 117Opening a deployed topology . . . . . . . . 117Adding a new component . . . . . . . . . 118Changing configuration parameters of existingTivoli Netcool Performance Manager components . 120Moving components to a different host . . . . . 120Moving a deployed collector to a different host . . 121

    Moving a deployed SNMP collector . . . . . 121Moving a deployed UBA bulk collector. . . . 123

    Changing the port for a collector . . . . . . . 126

    Modifying Tivoli Integrated Portal and TivoliCommon Reporting ports . . . . . . . . . 126

    Changing ports for the Tivoli CommonReporting console . . . . . . . . . . . 127Port assignments . . . . . . . . . . . 128Viewing the application server profile . . . . 128

    Chapter 7. Using the High AvailabilityManager . . . . . . . . . . . . . 131Overview. . . . . . . . . . . . . . . 131HAM basics . . . . . . . . . . . . . . 131

    The parts of a collector . . . . . . . . . 132Clusters . . . . . . . . . . . . . . 133

    HAM cluster configuration . . . . . . . . . 133Types of spare hosts . . . . . . . . . . 133Types of HAM clusters . . . . . . . . . 134Example HAM clusters . . . . . . . . . 134

    Resource pools . . . . . . . . . . . . . 140How the SNMP collector works . . . . . . . 140

    How failover works with the HAM and theSNMP collector . . . . . . . . . . . . 141Obtaining collector status . . . . . . . . 142

    Creating a HAM environment . . . . . . . . 143Topology prerequisites . . . . . . . . . 144Procedures . . . . . . . . . . . . . 144Create the HAM and a HAM cluster . . . . 144Add the designated spare . . . . . . . . 145Add the managed definitions . . . . . . . 146Define the resource pools . . . . . . . . 147Save and start the HAM. . . . . . . . . 149Creating an additional HAM environment. . . 150

    Modifying a HAM environment . . . . . . . 150Removing HAM components . . . . . . . 150Stopping and restarting modified components 151

    Viewing the current configuration . . . . . . 151Show Collector Process... dialog . . . . . . 152Show Managed Definition... dialog . . . . . 152

    Chapter 8. Enabling CommonReporting on Tivoli NetcoolPerformance Manager. . . . . . . . 155Model Maker . . . . . . . . . . . . . 155The Base Common Pack Suite . . . . . . . . 156Installing the BCP package from the distribution 157

    Chapter 9. Uninstalling components 159Removing a component from the topology . . . 159

    Restrictions and behavior . . . . . . . . 159Removing a component . . . . . . . . . 160

    Uninstalling the entire Tivoli Netcool PerformanceManager system . . . . . . . . . . . . 161

    Order of uninstall . . . . . . . . . . . 161Restrictions and behavior . . . . . . . . 162Performing the uninstall. . . . . . . . . 162

    Uninstalling the topology editor . . . . . . . 163Residual files . . . . . . . . . . . . . 164

    Appendix A. Remote installationissues . . . . . . . . . . . . . . 167

    iv IBM Tivoli Netcool Performance Manager: Installation Guide

  • When remote install is not possible . . . . . . 167FTP is possible, but REXEC or RSH are not . . 167Neither FTP nor REXEC/RSH are possible . . 168

    Installing on a remote host using a secondarydeployer . . . . . . . . . . . . . . . 168

    Appendix B. DataChannel architecture 171Data collection . . . . . . . . . . . . . 171

    Data aggregation . . . . . . . . . . . 171Management programs and watchdog scripts 172DataChannel application programs . . . . . 173

    Starting the DataLoad SNMP collector . . . . . 175DataChannel management components in adistributed configuration . . . . . . . . . 176

    Manually starting the Channel Managerprograms . . . . . . . . . . . . . . 176

    Adding DataChannels to an existing system . . . 177DataChannel terminology . . . . . . . . . 178

    Appendix C. Aggregation sets . . . . 181Overview. . . . . . . . . . . . . . . 181Configuring aggregation sets . . . . . . . . 181Installing aggregation sets . . . . . . . . . 185

    Start the Tivoli Netcool Performance Managersetup program . . . . . . . . . . . . 185Set aggregation set installation parameters . . 185Edit aggregation set parameters file . . . . . 188

    Linking DataView groups to timezones. . . . . 189

    Appendix D. Deployer CLI options 191Using the -DTarget option . . . . . . . . . 192

    Appendix E. Secure file transferinstallation . . . . . . . . . . . . 195Overview. . . . . . . . . . . . . . . 195Enabling SFTP . . . . . . . . . . . . . 195Installing OpenSSH . . . . . . . . . . . 196

    AIX systems . . . . . . . . . . . . . 196Solaris systems . . . . . . . . . . . . 198Linux systems . . . . . . . . . . . . 200

    Configuring OpenSSH . . . . . . . . . . 200Configuring the OpenSSH server . . . . . . 200Configuring OpenSSH client . . . . . . . 201Generating public and private keys . . . . . 201

    Testing OpenSSH and SFTP . . . . . . . . 204Troubleshooting . . . . . . . . . . . . 204Netcool/Provisio SFTP errors . . . . . . . . 205

    Appendix F. LDAP integration . . . . 207Supported LDAP servers . . . . . . . . . 207LDAP configuration . . . . . . . . . . . 207

    Enable LDAP configuration . . . . . . . 207Verifying the DataView installation . . . . . 208Assigning Tivoli Netcool Performance Managerroles to LDAP users . . . . . . . . . . 208

    Appendix G. Using silent mode. . . . 211Sample properties files . . . . . . . . . . 211The Deployer . . . . . . . . . . . . . 211

    Running the Deployer in silent mode . . . . 211Confirming the status of a silent install . . . . 212Restrictions . . . . . . . . . . . . . 213

    The Topology Editor . . . . . . . . . . . 213

    Appendix H. Installing an interim fix 215Overview. . . . . . . . . . . . . . . 215

    Installation rules . . . . . . . . . . . 215Behavior and restrictions . . . . . . . . 215

    Before you begin . . . . . . . . . . . . 216Installing a patch . . . . . . . . . . . . 216

    Appendix I. Error codes and log files 219Error codes . . . . . . . . . . . . . . 219

    Deployer messages . . . . . . . . . . 219Topology Editor messages . . . . . . . . 232InstallAnywhere messages . . . . . . . . 236

    Log files . . . . . . . . . . . . . . . 237COI log files. . . . . . . . . . . . . 237Deployer log file . . . . . . . . . . . 238Eclipse log file . . . . . . . . . . . . 238Trace log file . . . . . . . . . . . . 238

    Appendix J. Troubleshooting. . . . . 239Deployment problems . . . . . . . . . . 239

    Saving installation configuration files . . . . 241Tivoli Netcool Performance Manager componentproblems . . . . . . . . . . . . . . . 241Topology Editor problems . . . . . . . . . 242Telnet problems . . . . . . . . . . . . 242Java problems . . . . . . . . . . . . . 243Testing connectivity to the database . . . . . . 243Testing external procedure call access . . . . . 244

    Appendix K. Migrating DataViewcontent and users . . . . . . . . . 245Moving DataView content between TivoliIntegrated Portal servers. . . . . . . . . . 245

    The synchronize command . . . . . . . . 245Migrating SilverStream content to the TivoliIntegrated Portal . . . . . . . . . . . . 246

    SilverStream page conversion . . . . . . . 246The migrate command . . . . . . . . . 248

    Notices . . . . . . . . . . . . . . 251

    Trademarks . . . . . . . . . . . . 255

    Contents v

  • vi IBM Tivoli Netcool Performance Manager: Installation Guide

  • PrefaceThe purpose of this manual

    IBM Tivoli Netcool Performance Manager 1.3.2 is a bundled product consisting ofa wireline component and a wireless component.

    The purpose of this guide is to help you install theTivoli Netcool PerformanceManager product suite and the Oracle database management system.

    This guide provides instructions for installing Tivoli Netcool Performance Managercomponents, but not necessarily for configuring the installed components into afinished system that produces management reports. After going through the stepsin this guide, you will have a set of running Tivoli Netcool Performance Managercomponents ready to configure into a fully functional system.

    The goal of this guide is to get each component installed and running in its barestform. The running component does not necessarily have network statistical dataflowing into and out of it yet. In particular, at the end of this installationprocedure, there are no or few management reports that can be viewed inDataView.

    Configuring installed components into a working system is the subject of othermanuals in the Tivoli Netcool Performance Manager documentation set.

    AudienceThe audience for this manual.

    The audience for this manual is the network administrator or operations specialistresponsible for installing the Tivoli Netcool Performance Manager product suite onan enterprise network. To install Tivoli Netcool Performance Manager successfully,you should have a thorough understanding of the following subjects:v Basic principles of TCP/IP networks and network managementv SNMP conceptsv Administration of the Linux, Solaris or AIX operating environmentv Administration of the Oracle database management systemv Tivoli Netcool Performance Manager

    Tivoli Netcool Performance Manager - Wireline ComponentIBM Tivoli Netcool Performance Manager consists of a wireline component(formerly Netcool/Proviso) and a wireless component (formerly Tivoli Netcool

    Performance Manager for Wireless).

    Tivoli Netcool Performance Manager - Wireline Component consists of thefollowing subcomponents:v DataMart is a set of management, configuration, and troubleshooting GUIs. TheTivoli Netcool Performance Manager System Administrator uses the GUIs todefine policies and configuration, and to verify and troubleshoot operations.

    Copyright IBM Corp. 2006, 2012 vii

  • v DataLoad provides flexible, distributed data collection and data import of SNMPand non-SNMP data to a centralized database.

    v DataChannel aggregates the data collected through Tivoli Netcool PerformanceManager DataLoad for use by the Tivoli Netcool Performance ManagerDataView reporting functions. It also processes online calculations and detectsreal-time threshold violations.

    v DataView is a reliable application server for on-demand, web-based networkreports.

    v Technology Packs extend the Tivoli Netcool Performance Manager system withservice-ready reports for network operations, business development, andcustomer viewing.

    The following figure shows the different Tivoli Netcool Performance Managermodules.

    Tivoli Netcool Performance Manager documentation consists of the following:v Release notesv Configuration recommendationsv User guidesv Technical notesv Online help

    The documentation is available for viewing and downloading on the informationcenter at http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/topic/com.ibm.tnpm.doc/welcome_tnpm.html.

    viii IBM Tivoli Netcool Performance Manager: Installation Guide

  • The Default UNIX ShellAdd short description The installation scripts and procedures in this manualgenerally presume, but do not require, the use of the Korn or Bash shells, and onlyKorn shell syntax is shown in examples.

    If you are a user of the C shell or Tcsh, make the necessary adjustments in thecommands shown as examples throughout this manual.

    This guide uses the following shell prompts in the examples:v # (pound sign) indicates commands you perform when logged in as root.v $ (dollar sign) indicates commands you perform when logged in as oracle or

    pvuser.v SQL> indicates commands you perform at the SQL*Plus prompt.

    Preface ix

  • x IBM Tivoli Netcool Performance Manager: Installation Guide

  • Chapter 1. IntroductionIntroduction to Tivoli Netcool Performance Manager installation.

    This chapter provides an overview of the Tivoli Netcool Performance Managerproduct suite and provides important pre-installation setup information. Inaddition, this chapter provides an overview of the installation interface introducedin version 1.3.2.

    Tivoli Netcool Performance Manager architectureTivoli Netcool Performance Manager system components.

    The Tivoli Netcool Performance Manager components run on:v SPARC-based servers from Sun Microsystems that run the Solaris operatingsystem

    v AIX servers from IBMv Linux servers

    Exact, release-specific requirements, prerequisites, and recommendations forhardware and software are described in detail in the IBM Tivoli NetcoolPerformance Manager: Configuration Recommendations Guide.

    You can work with Professional Services to plan and size the deployment of TivoliNetcool Performance Manager components in your environment.

    The following diagram provides a high-level overview of the Tivoli NetcoolPerformance Manager architecture.

    The Tivoli Netcool Performance Manager system components are as follows:v Tivoli Netcool Performance Manager database - The Tivoli NetcoolPerformance Manager database is hosted on Oracle.

    Copyright IBM Corp. 2006, 2012 1

  • v Tivoli Netcool Performance Manager DataMart - Tivoli Netcool PerformanceManager DataMart is the user and administrative interface to the Tivoli NetcoolPerformance Manager database and to other Tivoli Netcool PerformanceManager components.

    v Tivoli Netcool Performance Manager DataLoad - Tivoli Netcool PerformanceManager DataLoad consists of one or more components that collect networkstatistical raw data from network devices and from network managementsystems.

    v Tivoli Netcool Performance Manager DataChannel - Tivoli NetcoolPerformance Manager DataChannel is a collection of components that collectdata from DataLoad collectors, aggregate and process the data, and load thedata into the Tivoli Netcool Performance Manager database. DataChannelcomponents also serve as the escalation point for collected data that isdetermined to be over threshold limits.

    v Tivoli Netcool Performance Manager DataView - Tivoli Netcool PerformanceManager DataView is the Web server hosting and analysis platform. Thisplatform is used to display Web-based management reports based on networkdata aggregated and placed in the Tivoli Netcool Performance Managerdatabase.

    v Tivoli Netcool Performance Manager Technology Packs - Each technology packis a set of components that describes the format and structure of networkstatistical data generated by network devices. Each technology pack is specificfor a particular device, or class of devices; or for a particular company's devices;or for a protocol (such as standard SNMP values) common to many devices.

    v Tivoli Integrated Portal - The Tivoli Integrated Portal application provides adatabase-aware Web server foundation for the Web-based management reportsdisplayed by Tivoli Netcool Performance Manager DataView. The TivoliIntegrated Portal application server is an essential component of each DataViewinstallation.

    Platform support

    All subcomponents of the Tivoli Netcool Performance Manager - WirelineComponent can be installed on a mix of AIX, Linux, and Solaris operating systems;that is, the operating systems on which the DataChannel, DataView, DataLoad andDataMart subcomponents are installed do not have to be of the same type.

    Co-location rulesAllowed component deployment numbers and co-location rules.

    Table 1 lists how many of each component can be deployed per Tivoli NetcoolPerformance Manager system and whether multiple instances can be installed onthe same server.

    In this table:v N - Depends on how many subchannels there are per channel, and how manychannels there are per system. For example, if there are 40 subchannels perchannel and 8 channels, theoretically N=320. However, the practical limit isprobably much lower.

    v System - The entire Tivoli Netcool Performance Manager system.v Per host - A single physical host can be partitioned using zones, which effectivelygives you multiple hosts.

    2 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Note: All CME, DLDR, FTE, and LDR components within a channel must share thesame filesystem.

    Table 1. Co-location rules

    ComponentNumber of Instances

    AllowedCo-LocationConstraints

    Co-LocationConstraints

    Supported byDeployer?

    AMGR One per host thatsupportsDataChannelcomponents

    Yes

    BCOL v N per systemv One percorrespondingsubchannel

    Yes

    CME One per subchannel Filesystem Yes

    CMGR One per system Yes

    Database One per system Yes

    Database channel One perDataChannel;maximum of 8

    Yes

    DataLoad (SNMPcollector)

    v N per systemv One percorrespondingsubchannel

    v One per host

    Yes

    DataMart v N per systemv One per host

    Yes

    DataView v N per systemv One per host

    One per system.

    Discovery Server v N per systemv One per host

    Co-locate withcorrespondingDataMart

    Yes

    DLDR One per channel Filesystem Yes

    FTE One per subchannel Filesystem Yes

    HAM N+M per system,where N is thenumber of collectorsthat HAM ismonitoring, and M isthe number ofstandby collectors

    Yes

    LDR One per channel Filesystem Yes

    Log One per system Yes

    UBA (simple) v N per systemv One percorrespondingsubchannel

    Yes

    UBA (complex) Pack-dependent Pack-dependent Pack-dependent

    Chapter 1. Introduction 3

  • v In the Logical view of the Topology Editor, the DataChannel component containsthe subchannels, LDR, and DLDR components, with a maximum of 8 channelsper system. The subchannel contains the collector, FTE, and CME, with amaximum of 40 subchannels per channel.

    InheritanceInheritance is the method by which a parent object propagates its property valuesto a child component.

    The following rules should be kept in mind when dealing with these properties.v A Child Property can be read only, but is not always.v If the Child Property is not read only, then it can be changed to a value differentfrom the Parent Property.

    v If the Parent Property changes, and the Child and Parent properties were thesame before the change, then the child property will be changed to reflect thenew Parent Property value

    v If the Child Property changes, the Parent Property value will not be updatedv The Default Value of the Child Property is always the current Parent Propertyvalue

    Note: When performing an installation that uses non-default values, that is,non-default usernames, passwords and locations, it is recommended that youcheck both the Logical view and Physical view to ensure that they both contain thecorrect values before proceeding with the installation.

    Example

    As an example of how a new component inherits property values:

    The Disk Usage Server (DUS) is a child component of the Host object. The DUSRemote User property inherits its value from the Host PV User Property oncreation of the DUS. The DUS property value will be taken from the Host propertyvalue.

    Child properties that have been inherited are marked as inherited.

    As an example of what happens when you change inherited property values:

    If we change the Host PV User Property value, it gets pushed down to the DUSRemote User property value, updating it. The associated Default Value is alsoupdated.

    If we change the DUS Remote User property value, that is the child value, it doesnot propagate up to the host; the parent Host PV User Property value remainsunchanged.

    Now the child and parent properties are out of sync, and if we change the parentproperty value it is not reflected in the child property, though the default valuecontinues to be updated.

    4 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Notable subcomponents and featuresThe following sections describe a subset of the Tivoli Netcool PerformanceManager that should be considered before deciding on your topologyconfiguration.

    CollectorsCollectors description.

    The DataLoad collector takes in the unrefined network data and stores it in a filethat Tivoli Netcool Performance Manager can read. This file is known as a binaryobject format file (BOF).

    The following processes are employed in the DataLoad module:v SNMP Collector - The DataLoad SNMP Collector sends SNMP requests tonetwork objects. Only the data requested by the configuration that was definedfor those network objects is retrieved.

    v Bulk Collector - The Bulk Collector uses a Bulk Adaptor, which is individuallywritten for specific network resources, to format the unrefined data into a file,called a PVline file, which is passed to the Bulk Collector.

    Installation or topology considerations:

    Installation and topology considerations for collectors.

    The DataLoad modules can be loaded on lightweight servers and placed as close tothe network as possible (often inside the network firewall). Because a DataLoadmodule does not contain a database, the hardware can be relatively inexpensiveand can still reliably handle high volumes of data.

    Up to 320 DataLoad modules can be supported per Tivoli Netcool PerformanceManager installation.

    The number of collectors in your system will affect the topology configuration. Youcan have multiple BULK collectors, UBA or BCOL, on a single host, but you canonly have one SNMP based collector per host. The number of collectors is in turndriven by the number of required Technology Packs.

    Technology packsTechnology packs description.

    Tivoli Netcool Performance Manager Technology Packs are custom designedcollections of MIBs, discovery formulas, collection formulas, complex formulas,grouping rules, reporters, and other functions. Technology packs provide all TivoliNetcool Performance Manager needs to gather data for targeted devices.Technology packs make it possible for Tivoli Netcool Performance Manager toreport on technology from multiple vendors.

    Installation or topology considerations:

    Installation and topology considerations for technology packs.

    If you are creating a UBA collector, you must associate it with a specific technologypack.

    Chapter 1. Introduction 5

  • Note: General installation information for technology packs can be found in theIBM Tivoli Netcool Performance Manager: Pack Installation and Configuration Guide,pack-specific installation guides are also provided. Please consult both sets ofdocumentation for important installation or topology information.

    High AvailabilityHigh Availability description.

    High availability can be implemented for Tivoli Netcool Performance Manager intwo forms:v High Availability Manager (HAM): This is a DataChannel component that canbe configured to handle availability of SNMP collectors.

    v Veritas Cluster or Sun Cluster (referred to as HA within the documentation):This method of implementing high availability has a much broader scope andcan cover all or a combination of the database, DataChannel, DataMart andDataView components.

    The following High Availability (HA) documents are available for download fromthe Tivoli Open Process Automation Library (OPAL), http://www-01.ibm.com/software/brandcatalog/opal/.v TNPM High Availability OverviewDescribes high availability solutions for the Tivoli Netcool Performance Managerproduct.

    v Sun Cluster TNPM Agent GuideDescribes how Sun Clusters can be used with TNPM to created a highavailability Tivoli Netcool Performance Manager system.

    v High Availability Operations and DeploymentDescribes an example system that was configured to provide high availability.

    v TNPM High Availability Installation and ConfigurationDescribes the steps necessary to install and configure components of TivoliNetcool Performance Manager in a highly available configuration.

    For information covering the High Availability Manager, see Chapter 7, Using theHigh Availability Manager, on page 131

    Installation or topology considerations:

    Installation and topology considerations for the High Availability Manager.

    The HAM must be put on the same machine as the channel manager.

    Disk Usage ServerThis Disk Usage Server component is responsible for maintaining the propertiesnecessary for quota management (flow control) of DataChannel.

    The DataChannel component requires a Disk Usage Server. This component isresponsible for maintaining the properties necessary for quota management (flowcontrol) of DataChannel. DataChannel components can only be added to hosts thatinclude a Disk Usage Server.

    Multiple Disk Usage Servers can be configured per host; therefore, allowingmultiple DataChannel directories to exist on a single host. There are two majorreasons why a user may want to configure multiple Disk Usage Servers:

    6 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Disk space is running lowDisk space may be impacted by the addition of a new DataChannelcomponent. In which case, the user may want to add a new file systemmanaged by a new Disk Usage Server

    Separate disk quota managementThe user may want to separately manage the quotas assigned to discreteDataChannel components. For more information, see Disk quotamanagement.

    The user can assign the management of a new file system to a Disk Usage Serverby editing the local_root_directory property of that Disk Usage Server using theTopology Editor. The user can then add DataChannel components to the host, andcan assign the component to a Disk Usage Server, either in the creation wizard orby editing the DUS_NUMBER property inside the component.

    Disk quota management:

    Disk Quota Management description.

    The addition of a Disk Usage Server endeavors to make the process of assigningspace to a component much easier than it has been previously. No longer is a userrequired to calculate the requirements of each component and assign that spaceindividually, but components now work together to more effectively utilize thespace they have under the Disk Usage Server. Also, the user is relieved of trying tofigure out which component needs extra space and then changing the quota forthat component. Now, the user can just change the quota of the DUS and allcomponents on that Disk Usage Server will get the update and share the space onan as needed basis.

    Good judgement of space requirements is still needed. However, the estimating ofspace requirements is being made at a higher level; and should an estimate beincorrect, only one number needs to be changed instead of potentially updating thequota for each component separately.

    Flow control:

    Flow Control description.

    Optimized flow control further eliminates problems with component level quotas.Each component holds on to only a five hours of input and output, and once it hasreached this limit, it stops processing until the downstream component picks upsome of the data. This avoids the cascading scenario where one component stopsprocessing and the components feeding it begin to stockpile files, which results inthe quota being filled and causes all components to shut down because they haverun out of file space.

    Installation or topology considerations:

    Installation or Topology considerations for flow control.

    DataChannel components can only be added to hosts that include a Disk UsageServer.

    Chapter 1. Introduction 7

  • Typical installation topologyExample topology scenarios.

    Table 2 provides an example of where to install Tivoli Netcool PerformanceManager components, using four servers. Use this example as a guide to help youdetermine where to install the Tivoli Netcool Performance Manager components inyour environment.

    Basic topology scenarioA basic example topology.

    Table 2. Tivoli Netcool Performance Manager basic topology scenario

    Server Name

    Tivoli Netcool PerformanceManager Components

    Hosted Notes

    delphi v Oracle serverv Tivoli NetcoolPerformance ManagerDatabase

    v Tivoli NetcoolPerformance ManagerDataMart

    v Tivoli NetcoolPerformance ManagerDiscovery Server

    Install the Topology Editorand primary deployer on thissystem.

    corinth v Oracle clientv Tivoli NetcoolPerformance ManagerDataLoad, SNMP collector

    v Tivoli NetcoolPerformance ManagerDataLoad, Bulk Loadcollector

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.

    sparta v Oracle clientv Tivoli NetcoolPerformance ManagerDataChannel

    You could install TivoliNetcool PerformanceManager componentsremotely on this system

    athens v Oracle clientv Tivoli Integrated Portalv Tivoli NetcoolPerformance ManagerDataView

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.Your configuration can use apre-existing Tivoli IntegratedPortal, or install and includea new instance.

    8 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Intermediate topology scenarioAn intermediate example topology scenario.

    Table 3. Tivoli Netcool Performance Manager intermediate topology scenario

    Server Name

    Tivoli Netcool PerformanceManager Components

    Hosted Notes

    delphi v Oracle serverv Tivoli NetcoolPerformance ManagerDatabase

    v Tivoli NetcoolPerformance ManagerDataMart

    v Tivoli NetcoolPerformance ManagerDiscovery Server

    Install the Topology Editorand primary deployer on thissystem.

    corinth v Oracle clientv Tivoli NetcoolPerformance ManagerDataLoad, SNMP collector

    v Tivoli NetcoolPerformance ManagerDataLoad, Bulk Loadcollector

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.

    sparta v Oracle clientv Tivoli NetcoolPerformance ManagerDataChannel

    You could install TivoliNetcool PerformanceManager componentsremotely on this system

    thessaloniki v Oracle clientv Tivoli NetcoolPerformance ManagerDataChannel

    Also running the ChannelManager.

    v Tivoli NetcoolPerformance ManagerDataLoad, SNMP collector

    v Tivoli NetcoolPerformance ManagerDataLoad, Bulk Loadcollector

    v High Availability Manager

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.

    This server contains aduplicate set of collectors toallow for high availability.

    athens v Oracle clientv Tivoli Integrated Portalv Tivoli NetcoolPerformance ManagerDataView

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.Your configuration can use apre-existing Tivoli IntegratedPortal, or install and includea new instance.

    Chapter 1. Introduction 9

  • This scenario has an added copy of both collectors on corinth to a second machine,thessaloniki, for the purposes of failover. HAM only manages SNMP collectors;therefore, the HAM in this scenario will manage availability of the DataLoadSNMP collector and not the Bulk Load collector. The HAM must be put on thesame machine as the channel manager.

    Advanced topology scenarioAn advanced example topology scenario.

    Table 4. Tivoli Netcool Performance Manager advanced topology scenario

    Server Name

    Tivoli Netcool PerformanceManager Components

    Hosted Notes

    delphi v Oracle serverv Tivoli NetcoolPerformance ManagerDatabase

    v Tivoli NetcoolPerformance ManagerDataMart

    v Tivoli NetcoolPerformance ManagerDiscovery Server

    Install the Topology Editorand primary deployer on thissystem.

    corinth v Oracle clientv Tivoli NetcoolPerformance ManagerDataLoad, SNMP collector

    v Tivoli NetcoolPerformance ManagerDataLoad, Bulk Loadcollector

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.

    sparta v Oracle clientv Tivoli NetcoolPerformance ManagerDataChannel

    You could install TivoliNetcool PerformanceManager componentsremotely on this system

    thessaloniki v Oracle clientv Tivoli NetcoolPerformance ManagerDataChannel

    Also running the ChannelManager.

    v Tivoli NetcoolPerformance ManagerDataLoad, SNMP collector

    v Tivoli NetcoolPerformance ManagerDataLoad, Bulk Loadcollector

    v High Availability Manager

    You could install TivoliNetcool PerformanceManager componentsremotely on this system

    10 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Table 4. Tivoli Netcool Performance Manager advanced topology scenario (continued)

    Server Name

    Tivoli Netcool PerformanceManager Components

    Hosted Notes

    athens v Oracle clientv Tivoli Integrated Portalv Tivoli NetcoolPerformance ManagerDataView

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.Your configuration can use apre-existing Tivoli IntegratedPortal, or install and includea new instance.

    rhodes v Oracle clientv Tivoli Integrated Portalv Tivoli NetcoolPerformance ManagerDataView

    You could install TivoliNetcool PerformanceManager componentsremotely on this system.Your configuration can use apre-existing Tivoli IntegratedPortal, or install and includea new instance.

    Tivoli Netcool Performance Manager distributionHow to get your hands on the product distribution.

    The Tivoli Netcool Performance Manager distribution is available as a DVD/CDand as an electronic image. The instructions in this guide assume that you areinstalling from an electronic image.

    If you install the product from an electronic image, be sure to keep a copy of thedistribution image in a well-known directory, because you will need this image inthe future to make any changes to the environment, including uninstalling TivoliNetcool Performance Manager.

    The Tivoli Netcool Performance Manager distribution DVD/CD contains:v Tivoli Netcool Performance Manager 1.3.2v Model Maker IBM Cognos Edition version 1.2.0.v Base Common Pack Suite (1.0.0.3-TIV-TNPM-BCPSUITE.tar.gz).

    Chapter 1. Introduction 11

  • 12 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Chapter 2. RequirementsDetails of all Tivoli Netcool Performance Manager requirements.

    This chapter provides the complete set of requirements for Tivoli NetcoolPerformance Manager 1.3.2.

    IBM Prerequisite Scanner

    IBM Prerequisite Scanner is a stand-alone prerequisite checking tool that analyzessystem environments before the installation or upgrade of a Tivoli product or IBMsolution.

    The IBM Prerequisite Scanner can be used to check for the presence of TivoliNetcool Performance Manager requirements.

    Instructions describing how to use and install the IBM Prerequisite Scanner areavailable at http://www-01.ibm.com/support/docview.wss?uid=swg24029221.

    Minimum requirements for installationThe minimum required host specifications for a Tivoli Netcool PerformanceManager deployment.

    Solaris hardware requirementsTivoli Netcool Performance Manager hardware requirements for the Solarisenvironment.

    Tivoli Netcool Performance Manager has the following minimum hardwarerequirements for the Solaris environment.v 4 x SPARC64 VI (dual-core) 2.4GHz or 3 x SPARC64 VII (quad-core) 2.88GHzprocessor

    Note: DataLoad requires virtualization (Solaris zones). For more information,please see DataLoad SNMP on multiple CPU servers.

    v 16 GB Memoryv 2 x 146GB HDD

    If deploying in a distributed environment, each server/zone requires:

    1 x SPARC64 VI (dual-core) 2.4GHz or 1 x SPARC64 VII, (quad-core) 2.88GHzprocessor; 4 GB RAM; 146GB disk space.

    Note: For information about performing a minimal installation deployment, seethe IBM Tivoli Netcool Performance Manager: Installation Guide.

    Copyright IBM Corp. 2006, 2012 13

  • AIX hardware requirementsTivoli Netcool Performance Manager hardware requirements for the AIXenvironment.

    Tivoli Netcool Performance Manager has the following minimum requirements forthe AIX environment:v 4 x Power6 (Dual Core) 4.2GHz, or 3 x Power7 (Quad Core) 3.0GHz processor.

    Note: DataLoad requires virtualization (LPARs). For more information, pleasesee DataLoad SNMP on multiple CPU servers.

    v 16 GB Memoryv 2 x 146GB HDD

    If deploying in a distributed environment, each server/LPAR requires:v 1 x Power6 (Dual Core) 4.2GHz, orv 1 x Power7 (Quad Core) 3.0GHz processor;v 4 GB RAM; 146 GB disk space.

    Other deployment configurations should be sized by IBM Professional Services.

    Linux hardware requirementsTivoli Netcool Performance Manager has a minimal deployment space requirementon Linux

    Tivoli Netcool Performance Manager has the following minimum requirements forthe Linux environment:v 3 x Intel Xeon 5500/5600 series processors (quad-core), 2.4 GHz or greater.

    Note: DataLoad requires virtualization (Virtual Machine). For more information,please see DataLoad SNMP on multiple CPU servers.

    v 16 GB memoryv 2 x 146 GB HDD

    If deploying in a distributed environment, each server/Virtual Machine requires: 1x Intel Xeon 5500/5600 series processor (quad-core) 2.4 GHz, 4 GB RAM, 146 GBdisk space.

    Other deployment configurations should be sized by IBM Professional Services.

    Oracle deployment space requirementsTivoli Netcool Performance Manager has a minimal deployment space requirementfor the Oracle server.

    When you install Oracle you can following the host must conform to thepreviously stated hardware requirements for AIX, Solaris and Linux. However,Oracle may experience problems if sufficient swap space is not provided.v The same amount of Swap as RAM must be present on the Oracle server host ina distributed Tivoli Netcool Performance Manager system.

    v Twice as much Swap as RAM must be present on the Oracle server host for aTivoli Netcool Performance Manager proof of concept install.

    14 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Tivoli Integrated Portal deployment space requirementsTivoli Netcool Performance Manager has a minimal deployment space requirementfor Tivoli Integrated Portal

    When you install DataView, you also install Tivoli Common Reporting (TCR).When performing a remote install a local /tmp folder is required on the deployerin order to contain the TCR bundle. The space requirements are:

    Local TIP install:v /TIP install location - 2GB

    Remote TIP installv local /tmp - 1.5GBv remote /tmp - 1.5GBv remote /TIP install location - 2GB

    Note: If you deploy many technology packs (especially Alcatel-Lucent 5620 SAM,Alcatel 5620 NM, and Nortel CS2000, which either have multiple UBAs or requiremultiple DataChannel applications), you might require more hardware capacitythan is specified in the minimal configuration. In these situations, before moving toa production environment, IBM strongly recommends that you have IBMProfessional Services size your deployment so that they can recommend additionalhardware, if necessary.

    Screen resolutionRecommended screen resolution details.

    A screen resolution of 1024 x 768 pixels or higher is recommended when runningthe deployer.

    Minimum requirements for a proof of concept installationTivoli Netcool Performance Manager has minimum required host specifications forProof of Concept (POC) deployments.

    Note: The minimum requirements do not account for additional functionality suchas WebGUI, Cognos and MDE, each have additional memory and CPU impacts.

    Solaris hardware requirements (POC)The minimum system requirements for a proof of concept install on Solaris.v 2 x SPARC64 VI (dual-core) 2.4GHz or 2 x SPARC64 VII (quad-core) 2.88GHzprocessor.

    v 8GB Memoryv 1 x 146 GB HDD

    To support:v SNMP data only.v All Tivoli Netcool Performance Manager components deployed on a singleserver.

    v Number of resources supported up to 20,000.v 3 SNMP Technology Packs based on MIB II, Cisco Device and IPSLA.

    Chapter 2. Requirements 15

  • v 15 minute pollingv Number of DataView users limited to
  • Supported operating systems and modulesThe supported operating systems, modules, and third-party applications for IBMTivoli Netcool Performance Manager, Version 1.3.2.

    The following sections list the supported operating systems, modules, andthird-party applications for IBM Tivoli Netcool Performance Manager, Version1.3.2.

    All subcomponents of the Tivoli Netcool Performance Manager - WirelineComponent can be installed on a mix of AIX, Linux, and Solaris operating systems;that is, the operating systems on which the DataChannel, DataView, DataLoad andDataMart subcomponents are installed do not have to be of the same type. Thesupported versions of AIX, Linux and Solaris operating systems are discussed inthis document.

    For more information, see the IBM Tivoli Netcool Performance Manager, Version1.3.2 Release Notes, which contains the version numbers for each Tivoli NetcoolPerformance Manager module in Version 1.3.2.

    Solaris 10 for SPARC platformsSupported Solaris systems.

    Operating systems and kernelSupported operating system and kernel version.

    Solaris 10 Update 6 (released in October, 2008).

    Update level can be checked from /etc/release file.

    Applying a kernel patch or a Solaris patch bundle is not the equivalent toinstalling the specific Solaris 10 "update 6" image. Oracle 11gR2 RDBMS software isonly certified for a base install image of Solaris 10 update 6 or greater. Foradditional detail, please see Document 971464.1, FAQ - 11gR2 requires Solaris 10update 6 +.

    Kernel Parameters

    Solaris 10 uses the resource control facility to implement the System V IPC.However, Oracle recommends that you set both resource control and /etc/system/parameters. Operating system parameters not replaced by resource controlscontinue to affect performance and security on Solaris 10 systems.Parameter Replaced by Resource Control Minimum Valuenoexec_user_stack NA (can be set in /etc/system only) 1semsys:seminfo_semmni project.max-sem-ids 100semsys:seminfo_semmsl process.max-sem-nsems 256shmsys:shminfo_shmmax project.max-shm-memory 4294967295shmsys:shminfo_shmmni project.max-shm-ids 100

    Please note that "project.max-shm-memory" represent the maximum sharedmemory available for a project, so the value for this parameter should be greaterthan sum of all SGA size.

    Please refer following document for checking/setting kernel parameter valuesusing resource control :- Note 429191.1 Kernel setup for Solaris 10 using projectfiles.

    Chapter 2. Requirements 17

  • v The 'umask' setting for the "oracle" user has to be 022.v Hostname command should return the fully qualified hostname as shownbelow:% hostnamehostname.domainname

    For further information refer to the following:v NOTE:429191.1 - Kernel setup for Solaris 10 using project files.v NOTE:971464.1 - FAQ - 11gR2 requires Solaris 10 update 6 or greater

    Refer to "Verifying UDP and TCP Kernel Parameters" in the 11g Solaris InstallGuide. Part Number E17163-01 for other recommended kernel parameters.http://download.oracle.com/docs/cd/E11882_01/install.112/e17163/pre_install.htm#BABEJIGD

    Solaris 10 requirementsRequired Packages and Patches for the Solaris 10 system.

    Tivoli Netcool Performance Manager requires at a minimum the End Userdistribution of Solaris 10.

    Required packages:

    Required Packages for the Solaris 10 system.

    Before installing the Oracle server, make sure the following Solaris packages areinstalled on your system:v SUNWarcv SUNWbtoolv SUNWcslv SUNWheav SUNWi15csv SUNWi1csv SUNWi1ofv SUNWlibCv SUNWlibmv SUNWlibmsv SUNWsprotv SUNWtoov SUNWxwfnt

    To verify that the required Solaris packages are installed:1. Enter the following command at the shell prompt:

    # pkginfo -i SUNWarc SUNWbtool SUNWhea SUNWlibm SUNWlibms SUNWsprot SUNWtoo SUNWuiu8

    The following output confirms that the specified Solaris packages are installedcorrectly:

    18 IBM Tivoli Netcool Performance Manager: Installation Guide

  • system SUNWarc Archive Librariessystem SUNWbtool CCS tools bundled with SunOSsystem SUNWhea SunOS Header Filessystem SUNWlibm Forte Developer Bundled libmsystem SUNWlibms Forte Developer Bundled shared libmsystem SUNWsprot Solaris Bundled toolssystem SUNWtoo Programming Tools...

    2. If these packages are not on your system, see the Solaris Installation Guide forinstructions on installing supplementary package software.

    Required patches:

    Required Patches for the Solaris 10 system.

    To determine the patch level on your system, enter the following command:uname -v

    Note: All Tivoli Netcool Performance Manager modules are tested to run on anEnd User distribution of Solaris 10.

    The following list of minimum Solaris patches is required:v For all Installations : 120753-06: SunOS 5.10: Microtasking libraries (libmtsk) patch 139574-03: SunOS 5.10: file crle ldd stings elfdump patch 141444-09 141414-02

    To determine whether an operating system patch is installed, enter a commandsimilar to the following:1. Enter the command:

    /usr/sbin/patchadd -p | grep patch_number(without version number)

    For example, to determine if any version of the 120753-06 patch is installed, usethe following command:/usr/sbin/patchadd -p | grep 120753

    Solaris 10 virtualized containersIf you are using Solaris 10 virtualized containers, you must create containers with"whole root" partitions.

    If using Solaris 10 virtualized containers, you must create containers with "wholeroot" partitions. Tivoli Netcool Performance Manager will not work in containerswith "sparse root" partitions.

    Note: The Tivoli Netcool Performance Manager Self Monitoring Pack and SSMpacks do not report data correctly in virtualized environments, due tocompatibility issues of the underlying SSM agents in these configurations. The MIBII pack can also have difficulties discovering resources in virtualized serverenvironments.

    DataMartDataMart requirements if you are using Solaris 10.

    Configure the default language of Solaris to English.

    Chapter 2. Requirements 19

  • IBM Java Runtime Environment (JRE) 1.5.

    DataLoadDataLoad requirements if you are using Solaris 10.

    Configure the default language of Solaris to English.

    DataChannelDataChannel requirements if you are using Solaris 10.

    Configure the default language of Solaris to English.

    The DataChannel components require X libraries to be installed. The graphicaltools in DataChannel also require a running X server, which can be on a differenthost.

    Technology packsTechnology pack requirements if you are using Solaris 10.

    Installation of technology packs on Solaris 10 requires JRE 1.6 (32-bit). The correctversion is installed with the Topology Editor in the following default location:

    /opt/IBM/proviso/jvm/jre/bin

    DataView and Tivoli Integrated PortalDataView and Tivoli Integrated Portal requirements if you are using Solaris 10.

    Java Runtime Environment (JRE) 1.6 (32-bit)

    AIX platformsSupported AIX systems.

    Tivoli Netcool Performance Manager can be installed and operated in a virtualizedAIX environment.

    Note: Tivoli Netcool Performance Manager on AIX does not support connection toa Solaris-based Oracle database.

    Note: The Tivoli Netcool Performance Manager Self Monitoring Pack and SSMpacks do not report data correctly in virtualized environments, due tocompatibility issues of the underlying SSM agents in these configurations. The MIBII pack can also have difficulties discovering resources in virtualized serverenvironments.

    Operating systemSupported operating system and kernel version.

    IBM Tivoli Netcool Performance Manager, Version 1.3.2 supports:v AIX 6.1 TL 04 SP1 ("6100-04-01), 64-bit kernelv AIX 7.1 TL 0 SP3 ("7100-00-03"), 64-bit kernel

    To verify your AIX release level:

    As root, enter the following command at the shell prompt:# oslevel -r

    20 IBM Tivoli Netcool Performance Manager: Installation Guide

  • This command returns a string that represents the maintenance level for your AIXsystem.

    For AIX 6.1: If the operating system version is lower than AIX 6.1 TechnologyLevel 4 SP 1, then upgrade your operating system to this or a later level.

    For AIX 7.1: If the operating system version is lower than AIX 7.1 TechnologyLevel 0 plus SP 3, then upgrade your operating system to this or a later level. AIXmaintenance packages are available from the following Web site:http://www-933.ibm.com/support/fixcentral/

    Required files and fixesFiles and fixes required by Oracle and Tivoli Netcool Performance Manager for theAIX system.

    AIX 6.1

    The following operating system filesets are required for AIX 6.1:v bos.adt.basev bos.adt.libv bos.adt.libmv bos.perf.libperfstat 6.1.2.1 or laterv bos.perf.perfstatv bos.perf.proctoolsv xlC.aix61.rte:10.1.0.0 or laterv gpfs.base 3.2.1.8 or later

    If you are using the minimum operating system TL level for AIX 6L listed above,then install all AIX 6L 6.1 Authorized Problem Analysis Reports (APARs) for AIX6.1 TL 02 SP1, and the following AIX fixes:v IZ41855v IZ51456v IZ52319

    These 6.1 fixes are already present in the following TL levels:v AIX 6.1 TL-02 SP-04 and laterv AIX 6.1 TL-03 SP-02 and laterv AIX 6.1 TL-04

    The following AIX fixes are required also:v IZ97457v IZ89165

    Note: See Oracle Metalink Note:1264074.1 and Note:1379753.1 for other AIX 6.1patches that may be required

    AIX 7.1

    The following operating system filesets are required for AIX 7.1:v bos.adt.basev bos.adt.lib

    Chapter 2. Requirements 21

  • v bos.adt.libmv bos.perf.libperfstatv bos.perf.perfstatv bos.perf.proctoolsv xlC.aix61.rte:10.1.0.0 or laterv xlC.rte:10.1.0.0 or later

    If you are using the minimum operating system TL level for AIX 7.1 listed above,then install all AIX 7L 7.1 Authorized Problem Analysis Reports (APARs) for AIX7.1 TL 0 SP1, and the following AIX fixes:v IZ87216v IZ87564v IZ89165v IZ97035

    Note: See Oracle Metalink Note:1264074.1 and Note:1379753.1 for other AIX 7.1patches that may be required.

    Determining installed filesets

    To determine if the required filesets are installed and committed, enter a commandsimilar to the following:# lslpp -l bos.adt.base bos.adt.lib bos.adt.libm bos.perf.perfstat \bos.perf.libperfstat bos.perf.proctools

    To determine the supported kernel mode, enter a command similar to thefollowing:# getconf KERNEL_BITMODE

    Determining installed APAR fixes

    To determine if an APAR is installed, enter a command similar to the following:# /usr/sbin/instfix -i -k "IZ42940 IZ49516 IZ52331 IZ41855 IZ52319"

    If an APAR is not installed, then download it from the following Web site andinstall it: http://www-933.ibm.com/support/fixcentral/

    Set resource limitsThe default user process limits are not adequate and must be reset.

    On AIX systems, the default user process limits are not adequate for Tivoli NetcoolPerformance Manager. For detailed information on setting the correct user processlimits, see Set Resource Limits in the IBM Tivoli Netcool Performance Manager:Installation Guide.

    DataMartDataMart requirements if you are using AIX.

    Java Runtime Environment (JRE) 1.5 or higher (for the Database Informationmodule).

    22 IBM Tivoli Netcool Performance Manager: Installation Guide

  • DataLoadDataLoad requirements if you are using AIX.

    No special requirements.

    DataChannelDataChannel requirements if you are using AIX.

    The following DataChannel components require X libraries to be installed:v Bulk Collectorv CMEv DLDRv FTEv FED (also requires that an X Server is running)v LDRv The showVersion utility.

    Technology packsTechnology Pack requirements if you are using AIX.

    Installation of technology packs on AIX 6.1 requires JRE 1.6 (32-bit). The correctversion is installed with the Topology Editor in the following default location:

    /opt/IBM/proviso/jvm/jre/bin

    Viewing the documentation on AIX systemsViewing the documentation requires that you can run Adobe Acrobat Reader.

    To run on AIX systems, Adobe Acrobat Reader requires GIMP Toolkit (GTK+)Version 2.2.2 or higher. You can download the toolkit from the following URL:

    http://www-03.ibm.com/servers/aix/products/aixos/linux/download.html

    In addition, you must install all the dependent packages for GTK+. You can installGTK+ and its dependent packages either before or after installing Acrobat Reader.

    At the time of publication, the latest version of GTK+ is gtk2-2.8.3-9, and thelatest versions of the dependent packages are as follows:v libpng-1.2.8-5v libtiff-3.6.1-4v libjpeg-6b-6v gettext-0.10.40-6v glib2-2.8.1-3v atk-1.10.3-2v freetype2-2.1.7-5v xrender-0.8.4-7v expat-1.95.7-4v fontconfig-2.2.2-5v xft-2.1.6-5v cairo-1.0.2-6v pango-1.10.0-2v xcursor-1.0.2-3

    Chapter 2. Requirements 23

  • v gtk2-2.8.3-9

    To fulfill dependency requirements, you must install these Red Hat PackageManagers (RPMs) in the order specified.

    Installing an RPM:1. To install an RPM use the following syntax:

    rpm -i rpm_filename

    2. To see a list of the RPMs that have been installed, enter the followingcommand:rpm -qa

    Acrobat Reader and LDAP:

    By default, AIX systems do not have LDAP installed.

    By default, AIX systems do not have LDAP installed. If the AIX system does nothave LDAP installed and you run Acrobat Reader, a warning message is displayed.Click OK to have Acrobat Reader proceed normally.

    To remove the error message, delete or rename /opt/acrobat/Reader/rs6000aix/plug_ins/PPKLite.api, where /opt/acrobat is the installation path.

    Linux platformsSupported Linux Systems

    IBM Tivoli Netcool Performance Manager, Version 1.3.2 can be installed andoperated in an environment utilizing VMware partitions. This section details Linuxenvironment prerequisites for Tivoli Netcool Performance Manager.

    Operating systemSupported operating system and kernel versions.

    Tivoli Netcool Performance Manager supports the following Linux systems:v Linux hosts running 64-bit Red Hat Enterprise Linux Version 5.5 or greater withOracle 11g.

    To check the version of your operating system, enter:# cat /etc/redhat-release

    This command should return output similar to:Red Hat Enterprise Linux Server release 5.5 (Tikanga)

    To verify the processor type, run the following command:uname -p

    To verify the machine type, run the following command:uname -m

    To verify the hardware platform, run the following command:uname -i

    All results should contain the output:x86_64

    24 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Note: See Note 225710.1 for supported kernels and Note 265262.1 for "Things toknow about Linux." https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=265262.1

    DatabaseDatabase requirements if you are using Linux.

    It is recommended that the user consult Metalink Note 880989.1, Requirements ForInstalling Oracle11g On RHEL5, which has a full list of Oracle requirements forRHEL5. Oracle keeps this list up to date.

    Required packagesRequired packages if you are using Linux.

    The following is a list of packages for Oracle Enterprise Linux 5.0 and Red HatEnterprise Linux 5.0:v binutils-2.17.50.0.6-6.el5 (x86_64)v compat-libstdc++-33-3.2.3-61 (x86_64) - both architectures are required. Seenext line.

    v compat-libstdc++-33-3.2.3-61 (i386) - both architectures are required. Seeprevious line.

    v elfutils-libelf-0.125-3.el5 (x86_64)v glibc-2.5-24 (x86_64) - both architectures are required. See next line.v glibc-2.5-24 (i686) - both architectures are required. See previous line.v glibc-common-2.5-24 (x86_64)v ksh-20060214-1.7 (x86_64)v libaio-0.3.106-3.2 (x86_64) - both architectures are required. See next line.v libaio-0.3.106-3.2 (i386) - both architectures are required. See previous line.v libgcc-4.1.2-42.el5 (i386) - both architectures are required. See next line.v libgcc-4.1.2-42.el5 (x86_64) - both architectures are required. See previousline.

    v libstdc++-4.1.2-42.el5 (x86_64) - both architectures are required. See nextline.

    v libstdc++-4.1.2-42.el5 (i386) - both architectures are required. See previousline.

    v make-3.81-3.el5 (x86_64)

    Note: These are minimum required versions. Also, for some architectures both ofthe i386 and x86_64 package versions must be verified. For example, both the i386and the x86_64 architectures for glibc-2.5-24 must be installed.

    Also required are:v elfutils-libelf-devel-0.125-3.el5.x86_64.rpmwhich in turn requires the following: elfutils-libelf-devel and elfutils-libelf-devel-static

    One depends upon the other.Therefore, they must be installed together, in one (1) "rpm -ivh" command asfollows:rpm -ivh elfutils-libelf-devel-0.125-3.el5.x86_64.rpm elfutils-libelf-devel-static-0.125-3.el5.x86_64.rpm

    Chapter 2. Requirements 25

  • v glibc-headers-2.5-24.x86_64.rpmwhich in turn requires the following: kernel-headers-2.6.18-92.el5.x86_64.rpm glibc-devel-2.5-24.x86_64.rpm - both architectures are required. See next

    item. glibc-devel-2.5-24.i386.rpm - both architectures are required. See previous

    item.v gcc-4.1.2-42.el5.x86_64.rpmwhich in turn requires the following: libgomp-4.1.2-42.el5.x86_64.rpm libstdc++-devel-4.1.2-42.el5.x86_64.rpm gcc-c++-4.1.2-42.el5.x86_64.rpm libaio-devel-0.3.106-3.2.x86_64.rpm - both architectures are required. See

    next item libaio-devel-0.3.106-3.2.i386.rpm - both architectures are required. See

    previous item. sysstat-7.0.2-1.el5.x86_64.rpm unixODBC-2.2.11-7.1.x86_64.rpm - both architectures are required. See next

    item unixODBC-2.2.11-7.1.i386.rpm - both architectures are required. See previous

    item. unixODBC-devel-2.2.11-7.1.x86_64.rpm - both architectures are required. See

    next item unix ODBC-devel-2.2.11-7.1.i386.rpm - both architectures are required. See

    previous item.

    The following packages are required and checked for by the check_os.iniapplication:v libXp-1.0.0-i386v libXp-1.0.0-x86_64v libXpm-3.5.5-x86_64v libstdc++-devel-4.1.1-x86_64v glibc-devel-2.5-i386v glibc-devel-2.5-x86_64v gcc-c++-4.1.2-x86_64v openmotif-2.3.1-i386v openmotif-2.3.1-x86_64

    DataMartDataMart requirements if you are using Linux.

    Java Runtime Environment (JRE) 1.5 or higher (for the Database Informationmodule).

    DataLoadDataLoad requirements if you are using Linux.

    No special requirements.

    26 IBM Tivoli Netcool Performance Manager: Installation Guide

  • DataChannelDataChannel requirements if you are using Linux.

    No special requirements.

    Required user namesThere are two user names that must created when installing Tivoli NetcoolPerformance Manager.

    Two specific user names are required on any server hosting Tivoli NetcoolPerformance Manager components, they are:v pvuser: A dedicated Tivoli Netcool Performance Manager Unix user.v oracle: A dedicated Oracle user.

    pvuserThe pvuser user name.

    The Tivoli Netcool Performance Manager Unix user pvuser must be added to eachserver hosting a Tivoli Netcool Performance Manager component. The TivoliNetcool Performance Manager Unix user, which is referred to as pvuserthroughout the documentation, can be named using any string as required by yourorganizations naming standards.

    For more information on how to add the Tivoli Netcool Performance ManagerUnix user pvuser , see the "Pre-Installation Setup Tasks > Adding the pvuser LoginName" section of the IBM Tivoli Netcool Performance Manager: Installation Guide.

    oracleThe oracle user name.

    The Oracle user oracle is added to each server hosting a Tivoli NetcoolPerformance Manager component. This user is added when installing either Oracleclient or server. The default username used is oracle; however, this Oracleusername can be named using any string as required by your organizationsnaming standards.

    Note: Should you choose a non-default Oracle username, you must use the samename across all instances of Oracle Client and Server throughout your TivoliNetcool Performance Manager system.

    For more information on creating the oracle user for the Oracle server, see the"Installing the Oracle Server > Run the Oracle Server Configuration Script" sectionof the IBM Tivoli Netcool Performance Manager: Installation Guide.

    For more information on creating the oracle user for the Oracle client, see the"Installing the Oracle Client > Run the Oracle Client Configuration Script" sectionof the IBM Tivoli Netcool Performance Manager: Installation Guide.

    Chapter 2. Requirements 27

  • Ancillary software requirementsExtra and third-party software requirements.

    The following sections outline the extra software packages required by TivoliNetcool Performance Manager.

    FTP supportTivoli Netcool Performance Manager requires FTP support.

    The FTP (File Transfer Protocol) version used to transfer files between TivoliNetcool Performance Manager components is delivered with Solaris 10. AIX alsouses FTP to transfer files between Tivoli Netcool Performance Managercomponents.

    Tivoli Netcool Performance Manager supports the following file transport protocolsbetween Tivoli Netcool Performance Manager components and third-partyequipment (for example, EMS):v FTP Solaris 10v Microsoft Internet Information Services (IIS) FTP server

    OpenSSH and SFTPTivoli Netcool Performance Manager requires OpenSSH and SFTP support.

    Tivoli Netcool Performance Manager supports using encrypted Secure File Transfer(SFTP) and FTP to move data files from DataLoad to DataChannel, or fromDataChannel Remote to the DataChannel Loader.

    Tivoli Netcool Performance Manager SFTP is compatible only with OpenSSHserver and client version 3.1p1 and above. OpenSSH is freely downloadable anddistributable (http://www.openssh.org). OpenSSH is supported on Solaris, AIX,and Linux. Other SSH versions such as F-Secure, the SSH bundled in Solaris 10,and the SSH bundled with AIX are not compatible.

    If you use the SFTP capability, you must obtain, install, generate keys for, maintain,and support OpenSSH and any packages required by OpenSSH.

    See Tivoli Netcool Performance Manager Technical Note: DataChannel Secure File TransferInstallation for more information about installing and configuring OpenSSH.

    AIX requirementsAIX requirements in order to use OpenSSH and SFTP.

    The following table lists additional prerequisites that must be installed on an AIXsystem, and where these packages can be found:

    Table 2: Additional Prerequisites

    Package Location

    openssl-0.9.7g-1.aix5.1.ppc.rpm https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=aixtbx

    openssh-4.1p1_53.tar.Z https://sourceforge.net/projects/openssh-aix/

    28 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Package Location

    bos.adt.libm AIX installation CD.

    Solaris requirementsSolaris requirements in order to use OpenSSH and SFTP.

    The following are additional prerequisites that must be installed on an Solarissystems:v openssh - SSH client (openssh-4.5p1-sol-sparc-local.gz or higher).v zlib - zlib compression and decompression library (zlib-1.2.3-sol9-sparc-local.gzor higher).

    Linux requirementsLinux requirements in order to use OpenSSH and SFTP.

    OpenSSH is required for VSFTP to work with Tivoli Netcool PerformanceManager.OpenSSH is installed by default on any RHEL system.

    By default, FTP is not enabled on Linux systems. You must enable FTP on yourLinux host to carry out the installation of Tivoli Netcool Performance Manager.

    To enable FTP on your Linux host, run the following command as root:

    /etc/init.d/vsftpd start

    File compressionFile compression support.

    Archives delivered as part of the IBM Tivoli Netcool Performance Managerdistribution were created using GNU Tar. This program must be used for thedecompression of archives.

    DataView load balancingLoad balancing support.

    IBM Tivoli Netcool Performance Manager supports the use of an external loadbalancer to optimize the use of available DataView instances.

    The load balancer must support the following basic features:v Basic IP-based load balancingv Sticky sessions based on incoming IPv Up/down status based on checking for a listening port

    The following is the link to the CSS Basic Configuration Guide:http://www.cisco.com/univercd/cc/td/doc/product/webscale/css/css_401/bsccfggd/index.htm

    Chapter 2. Requirements 29

  • Oracle DatabaseOracle database license recommendations.

    License recommendations

    When purchasing a license from Oracle, IBM recommends a Processor licenserather than a Named User Plus license.

    Oracle defines a Named User in such a way that it includes not only actual humanusers, but also non-human-operated devices. In other words, you would require aNamed User Plus license for every resource that Tivoli Netcool PerformanceManager polls, which would be very expensive.

    http://www.oracle.com .

    Oracle serverOracle server support.

    Oracle 11g Enterprise Edition for Solaris (SPARC), Linux and AIX are 64-bit only.Oracle 11g Enterprise Edition must include the partitioning option. The databaseno longer provides 32-bit libraries, so the Oracle client will need to be installed onthe Tivoli Netcool Performance Manager database server, should there be anotherTivoli Netcool Performance Manager component present.

    Note: Tivoli Netcool Performance Manager should be installed and run as astandalone database. It should not be placed on a server that already has adatabase as the installation program will likely interfere. The co-hosting of TivoliNetcool Performance Manager will also affect performance in unknown ways. If aco-host is required then the Customer should seek out Professional Services forsupport.

    Hidden Oracle parametersHidden parameters that must be set for Oracle.

    This section lists all of the Oracle '_', or hidden parameters, used by Tivoli NetcoolPerformance Manager:v _partition_view_enabled=TRUEv _unnest_subquery=FALSEv _gby_hash_aggregation_enabled=FALSE"

    Tivoli Common Reporting clientTivoli Common Reporting and Cognos client-side requirements.

    Tivoli Netcool Performance Manager supports the use of:v Tivoli Integrated Portal 2.1 andv Tivoli Integrated Portal 2.2

    You should install Tivoli Integrated Portal 2.1 if your system hosts software that isincompatible with Tivoli Integrated Portal 2.2

    To use Cognos, you must download and install a windows version of TivoliCommon Reporting 2.1 from xTreme Leverage.

    30 IBM Tivoli Netcool Performance Manager: Installation Guide

  • There are two prerequisites that must be in place to use TCR/Cognos on aMicrosoft Windows environment:v Framework Managerv Oracle Client

    Java Runtime Environment (JRE)Required Java support.

    Java Runtime Environment (JRE) 1.6 (32-bit) is required for all servers hostingTivoli Netcool Performance Manager components. The exception to this isDataMart which requires is IBM Java 1.5 R6.

    The IBM JDK is not supplied and installed automatically with the DataMart,DataChannel and DataLoad components. When installing those components onservers that are remote from the server hosting the primary deployer (TopologyEditor and Deployer) or TIP, then the required JRE, as stated above, will need to bedeployed to those servers separately.

    Web browsers and settingsSupported browsers.

    The following browsers are required to support the Web client and provide accessto DataView reports:

    Important: If you are using Tivoli Netcool Performance Manager with WebGUI, seeWebGUI integration on page 33 for the browsers supported with both.Important: No other browser types are supported.

    Table 5. Windows ClientsWindows Vista Windows XP

    v Microsoft Internet Explorer 7.0, 8.0v Mozilla Firefox 3.6.

    v Microsoft Internet Explorer 7.0, 8.0v Mozilla Firefox 3.6.

    Note: When using Windows Internet Explorer, IBM recommends that you haveavailable at least 1GB of memory

    Table 6. UNIX ClientsAIX Red Hat 5 Solaris 10

    v Firefox 3.6 v Firefox 3.6 v Firefox 3.6

    The following are required browser settings:v Enable JavaScriptv Enable cookies

    Browser requirements for the LaunchpadWeb browser requirements for the Launchpad.

    The new Launchpad has been tested on the following browsers:

    On Solaris:v Firefox 3.6

    Chapter 2. Requirements 31

  • On AIX:v Firefox 3.6

    On Linux:v Firefox 3.6

    For information about downloading and installing these browsers, see thefollowing web sites:v http://www.mozilla.org/v http://www-03.ibm.com/systems/p/os/aix/browsers/index.html

    Note: You must be a registered user to use this site.

    Screen resolutionRecommended screen resolution details.

    A screen resolution of 1152 x 864 pixels or higher is recommended for the displayof DataView reports. Some reports may experience rendering issues at lowerresolutions.

    Report Studio - CognosReport Studio support.

    Report Studio is only supported by Microsoft Internet Explorer.

    X EmulationRemote desktop support.

    For DataMart GUI access, Tivoli Netcool Performance Manager supports thefollowing:v Native X Terminalsv Exceed V 6.2

    The following libraries are required in order for Exceed to work with Eclipse:v libgtk 2.10.1v libgib 2.12.1v libfreetype 2.1.10v libatk 1.12.1v libcairo 1.2.6v libxft 2.1.6v libpango 1.14.0v Real VNC server 4.0

    32 IBM Tivoli Netcool Performance Manager: Installation Guide

  • WebGUI integrationWebGUI version support.

    The IBM Tivoli Netcool/OMNIbus Web GUI Integration Guide for Wireline describeshow to integrate IBM Tivoli Netcool /OMNIbus Web GUI with the wirelinecomponent of Tivoli Netcool Performance Manager.

    TNPM 1.3.2 will have support for:v TIP 2.1 and WebGui 7.3.1 + Fix pack x (as per TNPM 1.3.1 support) - examplescenario where customer has multiple Tivoli products in TIP

    v TIP 2.2 and WebGui 7.3.1 +FP1+FP2 (new support to 1.3.2).

    The web browsers supported by WebGUI and Tivoli Netcool Performance Managerare listed in the following table.

    Table 7. Web clients browsers supported by WebGUIBrowser Version Operating system

    Internet Explorer 7.0, 8.0 Windows 2003, Windows XP,Windows Vista, Windows2008, and Windows 7

    Mozilla Firefox 3.5, 3.6 Windows 2003, Windows XP,Windows Vista, Windows2008 , and Windows 7

    SuSE Linux Enterprise Server(SLES) 10, and 11

    Red Hat Enterprise Linux(RHEL) 4, 5 and 6

    Solaris 9 and 10

    Note: When using Windows Internet Explorer, IBM recommends that you haveavailable at least 1GB of memory

    Microsoft Office VersionMicrosoft Office support.

    The Tivoli Netcool Performance Manager DataView Scheduled Report optiongenerates files compatible with Microsoft Office Word 2002 or higher.

    Chapter 2. Requirements 33

  • 34 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Chapter 3. Installing and configuring the prerequisite softwareInstalling and configuring the software required by Tivoli Netcool PerformanceManager.

    This chapter describes how to install and configure the prerequisite software forTivoli Netcool Performance Manager.

    OverviewBefore beginning the Tivoli Netcool Performance Manager installation, you mustinstall the prerequisite software listed in the IBM Tivoli Netcool PerformanceManager: Configuration Recommendations Guide.

    The required software includes:v Oracle server: To use Oracle with Tivoli Netcool Performance Manager, youmust install Oracle as described in this chapter - do not use a separate Oracleinstallation method provided by Oracle Corporation.

    v Oracle client: You must install Oracle client software on each system where youplan to install a Tivoli Netcool Performance Manager component, except for thesystem where you installed the Oracle server.When you complete the steps in this chapter, the Oracle server and client will beinstalled and running, with tablespaces sized and ready to accept the installationof a Tivoli Netcool Performance Manager DataMart database. You cancommunicate with Oracle using the SQLPlus command-line utility.The steps in this chapter use IBM-provided installation scripts to install andconfigure the Oracle database from the Oracle distribution. For use with TivoliNetcool Performance Manager, you must install Oracle as described in thischapter. Do not use a separate Oracle installation method provided by OracleCorporation. You should obtain the official Oracle distribution from youredelivery site (after purchase of an Oracle license). See the IBM Tivoli NetcoolPerformance Manager: Configuration Recommendations Guide for recommendationswhen purchasing a license from Oracle.

    Note: The Tivoli Netcool Performance Manager script used to install Oracle isplatform-independent and can be used to install on Solaris, AIX, or Linux,regardless of the operating system distribution media.

    v OpenSSH: You must install and configure OpenSSH before installing TivoliNetcool Performance Manager. For details, see Appendix E, Secure file transferinstallation, on page 195. Linux systems require the installation of VSFTP (VerySecure FTP).

    v Web browser: The launchpad requires a Web browser. IBM recommends usingMozilla with the launchpad. For the complete list of supported browsers, see theIBM Tivoli Netcool Performance Manager: Configuration Recommendations Guidedocument.

    v Java: Java is used by DataMart, DataLoad, and the technology packs. You mustensure you are using the IBM JRE and not the RHEL JRE. The IBM JRE issupplied with the Topology Editor or with TIP. To ensure you are using the rightJRE you can either:

    Copyright IBM Corp. 2006, 2012 35

  • Set the JRE path to conform to that used by the Topology Editor, do thisusing the following commands (using the default location for the primarydeployer):

    PATH=/opt/IBM/proviso/topologyEditor/jre/bin:$PATHexport $PATH

    For a remote server, that is one that does not host the primary deployer, youmust download and install the required JRE, and set the correct JRE path. Seethe IBM Tivoli Netcool Performance Manager: Configuration RecommendationsGuide document for JRE download details.

    Note: See the IBM Tivoli Netcool Performance Manager: ConfigurationRecommendations Guide document for the complete list of prerequisite software andtheir supported versions.

    Supported platformsThe platforms supported by Tivoli Netcool Performance Manager.

    Refer to the following table for platform requirement information.

    Tivoli Netcool Performance ManagerComponent Required Oracle Software

    All Tivoli Netcool Performance ManagerComponents:

    v Databasev DataViewv DataChannelv DataLoadv DataMart

    v Solaris 10 10/08 update 6, 64-bitv AIX 6.1, 64-bitv RHEL 5.5, 64-bit

    Pre-Installation setup tasksBefore installing the prerequisite software, perform the tasks outlined in thissection.

    Setting up a remote X Window displaySetting Up a Remote X Window Display

    About this task

    For most installations, it does not matter whether you use a Telnet, rlogin, Xterm,or Terminal window to get to a shell prompt.

    Some installation steps must be performed from a window that supports the XWindow server protocols. This means that the steps described in later chaptersmust be run from an Xterm window on a remote system or from a terminalwindow on the target system's graphical display.

    Note: See the IBM Tivoli Netcool Performance Manager: ConfigurationRecommendations Guide document for the list of supported X emulators.

    36 IBM Tivoli Netcool Performance Manager: Installation Guide

  • Specifying the DISPLAY environment variableIf you use an X Window System shell window such as Xterm, you must set theDISPLAY environment variable to point to the IP address and screen number ofthe system you are using.

    About this task

    Command sequences in this manual do not remind you at every stage to set thisvariable.

    If you use the su command to become different users, be especially vigilant to setDISPLAY before running X Window System-compliant programs.

    Procedure

    In general, set DISPLAY as follows:$ DISPLAY=Host_IP_Address:0.0 $ export DISPLAY

    To make sure the DISPLAY environment variable is set, use the echo command:$ echo $DISPLAY

    Disabling access control to the displayIf you encounter error messages when trying to run X Window System-basedprograms, you might need to temporarily disable X Window System access controlso an installation step can proceed.

    About this task

    To disable access control:

    Procedure1. Set the DISPLAY environment variable.2. Enter the following command when logged in as root:

    # /usr/openwin/bin/xhost +

    Note: Disabling access control is what enables access to the current machinefrom X clients on other machines.

    Changing the ethernet characteristicsBefore installing Tivoli Netcool Performance Manager, you must force both theethernet adapter and the port on the switch to 100 full duplex mode -autonegotiate settings are not enough.

    AIX systemsChanging ethernet characteristics on AIX.

    About this task

    To change the setting to full duplex:

    Note: If the AIX node is a virtual partition, you must perform these steps on thevirtual I/O server (including the reboot).

    Chapter 3. Installing and configuring the prerequisite software 37

  • Procedure1. Using the System Management Interface Tool (SMIT), navigate to Devices >

    Communication > Ethernet Adapter > Adapter > Change/ShowCharacteristics of an Ethernet Adapter.

    2. Select your ethernet adapter (the default is ent0).3. Change the setting Apply change to DATABASE only to yes.4. Set the port on the switch or router that the AIX node is plugged into to

    100_Full_Duplex.5. Reboot your system.

    Solaris systemsThis section describes how to set a network interface card (NIC) and a BGEnetwork driver to full duplex mode.

    NIC:

    Change the NIC to full duplex mode on Solaris systems

    About this task

    To change the NIC to full duplex mode:

    Procedure

    1. Determine which type of adapter you have by running the following command:ifconfig -a

    2. To determine the current settings of the NIC, run the command ndd -get/dev/hme with one of the following parameters:

    Command Parameter Description

    link_status Determines whether the link is up

    v 1 - Upv 0 - Down

    link_speed Determines the link speed

    v 0 - 10Mb/secv 1 - 100Mb/sec

    link_mode Determines the duplex mode

    v 0 - Half duplexv 1 - Full duplex

    adv_autoneg_cap Determines whether auto negotiation is on

    v 0 - Offv 1 - On

    For example:ndd -get /dev/hme link_status

    In these commands, /dev/hme is your NIC; you might need to substitute yourown /dev/xxx.

    3. To set your NIC to 100Mb/s with full duplex for the current session, run thefollowing commands:

    ndd -set /dev/hme adv_100hdx_cap 0ndd -set /dev/hme adv_100fdx_cap 1ndd -set /dev/hme adv_autoneg_cap 0

    38 IBM Tivoli Netcool Performance Manager: Installation Guide

  • However, these commands change the NIC settings for the current session only.If you reboot, the settings will be lost. To make the settings permanent, edit the/etc/system file and add the following entries:

    set hme:hme_adv_autoneg_cap=0set hme:hme_adv_100hdx_cap=0set hme:hme_adv_100fdx_cap=1

    4. Verify that your NIC is functioning as required by rerunning the commandslisted in Step 2.

    BGE network driver:

    Change a BGE network driver to full duplex mode.

    About this task

    To change a BGE network driver to full duplex mode.

    Procedure

    1. To determine the link speed and current duplex setting, run the followingcommand:

    % kstat bge:0 | egrep speed|duplex

    The output is similar to the following:duplex fullifspeed 100000000link_duplex 2link_speed 100

    The parameters are as follows:

    Parameter Description

    link_duplex Determines the duplex setting

    v 1 - Half-duplexv 2 - Full duplex

    link_speed Determines the link speed

    v 10 - 10 Mb/secv 100 - 100 Mb/secv 1000 - 1 Gb/sec

    2. Create a file namedbge.conf in the /platform/uname -i/kernel/drv directory(for example, /platform/SUNW,Sun-Fire-V210/kernel/drv/bge.conf).

    3. Add the following lines to the file:speed=100;full duplex=1;

    4. Reboot the machine to have your changes take effect.

    Linux systemsEnabling 100 full duplex mode on Linux systems.

    About this task

    Use your primary network interface to enable 100 full duplex mode.

    To check if full duplex is enabled:

    Chapter 3. Installing and configuring the prerequisite software 39

  • Procedure1. Enter the following command:

    # dmesg | grep -i duplex

    This should result in output similar to the following:eth0: link up, 100Mbps, full-duplex, lpa 0x45E1

    2. Confirm the output contains the words:Full Duplex

    If this is not contained within the output, you must enable full duplex mode.The example output resulting from the command executed in step 1:eth0: link up, 100Mbps, full-duplex, lpa 0x45E1indicate that the primary network interface is eth0.The actions specified in the following process presume that your primarynetwork i