IBM Tivoli Netcool Performance Manager Wireline Component June 2018 Document Revision R2E1. Installing Technology Packs IBM

Transcription

1 IBM Tivoli Netcool Performance Manager Wireline Component June 2018 Document Revision R2E1 Installing Technology Packs IBM

2 Note Before using this information and the product it supports, read the information in Notices on page 15. Copyright IBM Corporation 1997, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents About this information v Intended audience v Tivoli Netcool Performance Manager - Wireline Component v What this information contains vi Service Management Connect vi Tivoli Netcool Performance Manager technical training vii Support information vii Conventions used in this publication vii Typeface conventions vii Installing packs Installing technology packs Types of technology packs Backing up inventory files Prerequisite software Preinstallation setup tasks Preparing to install technology pack patches... 4 Preparing the pack installation directory Installing a technology pack Installing technology packs by using the launchpad Populating the family dictionary table UBA collectors Log files Appendix. Installing technology packs by using the command line Notices Terms and conditions for product documentation.. 17 Trademarks Additional copyright notices Copyright IBM Corp. 1997, 2018 iii

4 iv IBM Tivoli Netcool Performance Manager: Installing Technology Packs

5 About this information Intended audience Describes how to install and configure Tivoli Netcool Performance Manager technology packs. Tivoli Netcool Performance Manager 1.4 supports both Oracle and DB2 databases. Attention: DB2 is supported on Linux only. Whereas, Oracle is supported on Solaris, AIX, and Linux systems. The audience for this guide. v Network administrators or operations specialists responsible for installing and configuring Technology Packs on an IBM Tivoli Netcool Performance Manager system on an enterprise network. Readers must be familiar with the following topics: v Basic principles of TCP/IP networks and network management v SNMP concepts v Administration of the Oracle database management system v Tivoli Netcool Performance Manager v Tivoli Netcool Performance Manager technology pack concepts v Tivoli Netcool Performance Manager reporting concepts v Jazz for Service Management Tivoli Netcool Performance Manager - Wireline Component IBM 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 the following subcomponents: v DataMart is a set of management, configuration, and troubleshooting GUIs. The Tivoli Netcool Performance Manager System Administrator uses the GUIs to define policies and configuration, and to verify and troubleshoot operations. v DataLoad provides flexible, distributed data collection and data import of SNMP and non-snmp data to a centralized database. v DataChannel aggregates the data that is collected through Tivoli Netcool Performance Manager DataLoad for use by the Tivoli Netcool Performance Manager DataView reporting functions. It also processes online calculations and detects real-time threshold violations. v DataView is a reliable application server for on-demand, web-based network reports. v Technology Packs extend the Tivoli Netcool Performance Manager system with service-ready reports for network operations, business development, and customer viewing. Copyright IBM Corp. 1997, 2018 v

6 The following figure shows the different Tivoli Netcool Performance Manager modules. Tivoli Netcool Performance Manager documentation consists of the following items: v Release notes v Configuration recommendations v Installation and upgrade information v User guides v Technical notes v Online help The documentation is available for viewing and downloading on the IBM Knowledge Center at SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/tnpm_1.4_kc_welcome.html. What this information contains This publication contains the following sections: v Installing technology packs on page 1 Service Management Connect Describes how to install and manage technology packs. v Installing technology packs by using the launchpad on page 6 Describes how to install technology packs by using command line. Connect, learn, and share with Service Management professionals: product support technical experts who provide their perspectives and expertise. Access the Tivoli Netcool Performance Manager 1.4 community on developerworks community. Use developerworks community in the following ways: v Become involved with transparent development, an ongoing, open engagement between other users and IBM developers of Tivoli products. You can access early designs, sprint demonstrations, product roadmaps, and pre-release code. vi IBM Tivoli Netcool Performance Manager: Installing Technology Packs

7 v Connect one-on-one with the experts to collaborate and network about Tivoli and the Network and Service Assurance community. v Read blogs to benefit from the expertise and experience of others. v Use wikis and forums to collaborate with the broader user community. Tivoli Netcool Performance Manager technical training Support information For Tivoli Netcool Performance Manager technical training information, see the following Tivoli Netcool Performance Manager Training website at: If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain the support you need: Online Access the IBM Software Support site at support/probsub.html. IBM Support Assistant The IBM Support Assistant is a free local software serviceability workbench that helps you resolve questions and problems with IBM software products. The Support Assistant provides quick access to support-related information and serviceability tools for problem determination. To install the Support Assistant software, go to support/isa. Troubleshooting Guide For more information about resolving problems, see the problem determination information for this product. Conventions used in this publication Several conventions are used in this publication for special terms, actions, commands, and paths that are dependent on your operating system. Typeface conventions This publication uses the following typeface conventions: Bold Italic v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text v 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:) v Keywords and parameters in text v Citations (examples: titles of publications, diskettes, and CDs) v Words defined in text (example: a nonswitched line is called a point-to-point line) v Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictive clause."; letters as letters example: "The LUN address must start with the letter L.") About this information vii

8 Monospace v New terms in text (except in a definition list): a view is a frame in a workspace that contains data. Bold monospace v Variables and values you must provide:... where myname represents... v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text v Message text and prompts addressed to the user v Text that the user must type v Values for arguments or command options v Command names, and names of macros and utilities that you can type as commands v Environment variable names in text v Keywords v Parameter names in text: API structure parameters, command parameters and arguments, and configuration parameters v Process names v Registry variable names in text v Script names viii IBM Tivoli Netcool Performance Manager: Installing Technology Packs

9 Installing packs Installing technology packs Provides details about the types of technology pack, prerequisites software, preinstallation, installation, and post installation tasks. All UBA technology pack installations require the Topology Editor to configure the technology pack. Configuration details are described here. Tivoli Netcool Performance Manager supports the Version or higher technology pack installation procedures. All technology packs, both legacy bundle and stand-alone packs, require the Technology Pack Installer. Always use the latest Technology Pack Installer, regardless of the version of the technology pack. Note: The latest Technology Pack Installer (ProvisoPackInstaller.jar file) version is It works on both Oracle and IBM DB2. Types of technology packs Tivoli Netcool Performance Manager supports these types of technology packs. Bundled Multiple technology packs that are contained in a single, bundled JAR file. Stand-alone Individual technology packs that are contained in separate JAR files, one for each stand-alone technology pack. Both bundled and stand-alone packs are installed with a common installer with slightly different screens that depends on the type of pack you are installing. Typically, you might install a combination of bundled and stand-alone packs. The installation instructions cover the following installation scenarios: v Bundled only v Stand-alone only v Bundled and stand-alone Backing up inventory files These backup steps are not required for an SNMP stand-alone technology pack. About this task For specific information about managing the inventory control files for an SNMP technology pack, see Configuring Technology Packs. Before you install a new technology pack from the technology pack bundle, or from a stand-alone pack, you must perform the following actions: Procedure 1. Change your working directory to the conf directory by using the following command: cd $PVMHOME/conf Copyright IBM Corp. 1997,

10 2. Make backup copies of the inventory control files by entering the following commands: cp inventory_elements.txt inventory_elements.txt.orig cp inventory_subelements.txt inventory_subelements.txt.orig 3. After the installation of the technology pack is complete, you must follow the configuration steps see Configuring Technology Packs. 4. After the configuration of the technology pack is complete, you must perform a diff between the inventory control files and the.orig versions of the files, and merge back any differences. Prerequisite software Ensure that you fulfill these prerequisites before you install and configure a technology pack. Prerequisite software for technology pack installation You must have all the prerequisite software and required information before you install and configure a technology pack. v IBM Tivoli Netcool Performance Manager. v An SNMP collector. You can add an SNMP collector as described in Adding a collector in the Installing Tivoli Netcool Performance Manager - Wireline Component. Note: For UBA technology packs, you add a UBA collector and associate it with a UBA pack as part of this technology pack installation. v Ensure that you have access to the Tivoli Netcool Performance Manager DataMart server that is running an X Window System server. Note: If no graphics card is installed on the DataMart server, the Xvfb virtual frame buffer package that provides X Window System services is automatically installed. For more information, see Setting up a remote X Window display in the Installing Tivoli Netcool Performance Manager - Wireline Component. v Ensure that you have access to Dashboard Application Services Hub (Tivoli Netcool Performance Manager v1.4). v Ensure that you have access to the DataChannel server. v Ensure that you have access to the technology pack installation files on one of the following locations: Product distribution site: softwareandservices. On the product distribution sites are the ProvisoPackInstaller.jar file, and technology pack JAR files. IBM Tivoli Netcool Performance Manager Wireline Technology Packs CD Assembly, which contains the ProvisoPackInstaller.jar file, technology pack JAR files, and the JAR files for the Starter Kit components. For more information about the Starter Kit, see Preinstallation setup tasks on page 3. For more information about obtaining software, see your IBM customer representative. v The correct version of Java. For more information, see Configuration Recommendations. Additional information An SNMP technology pack is MIB-based and its configuration is relatively straightforward. UBA Technology Packs collect data against non-snmp devices, and rely on the UBA of the Tivoli Netcool Performance Manager DataChannel to process the data. 2 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

11 Before you configure a technology pack, ensure that you: v Have the following documentation for your version of Tivoli Netcool Performance Manager: Release Summary for Tivoli Netcool Performance Manager for the current technology pack release Installing Tivoli Netcool Performance Manager - Wireline Component Upgrading Tivoli Netcool Performance Manager - Wireline Component (if you are upgrading the core software) Upgrading Technology Packs (if you are upgrading the technology-pack software) Configuring and Operating DataMart Note: Refer to this guide to create an inventory profile and initiate a discovery. v Have access to the following site to check for interim fixes or fix packs that might apply to your technology pack: NetcoolProviso.html v Have the Tivoli Netcool Performance Manager documentation and the Pack Release Summary, which are available on the following website: Always check the Pack Release summary before you install a technology pack to determine: If the pack is bundled or stand-alone pack. If the pack has any dependencies. For example, some packs require that the MIB-II Technology Pack to be installed. If the pack is an SNMP or a UBA pack. UBA packs must be associated with a UBA collector as part of the pack installation. If the pack is upgradeable. v The Oracle TNS name of the server on which you installed Oracle server with the Tivoli Netcool Performance Manager database configuration. For more information, see Specifying a Basename for DB_USER_ROOT topic in the Installing Tivoli Netcool Performance Manager - Wireline Component. v The DB2 name of the server on which you installed DB2 server with the Tivoli Netcool Performance Manager database configuration. For more information, see Installing Tivoli Netcool Performance Manager - Wireline Component. Preinstallation setup tasks Ensure that all necessary configuration steps are completed on the prerequisite software. v Determine the technology packs you want to install, and then see the release notes to determine whether the pack is bundled or stand-alone pack. Note: If you are installing multiple packs, plan to download all the JAR files and install all the packs at the same time. v Completed the following tasks: Reviewed the release summary for the current technology pack. Installing packs 3

12 Note: Release summary contain important information that you must consider before you install a technology pack. They also contain information about specific patches that must be installed before you configure a technology pack Installed the current version of the Tivoli Netcool Performance Manager components, as described in the Installing Tivoli Netcool Performance Manager - Wireline Component Installed the MIB-II Technology Pack. Note: The MIB-II Technology Pack is a stand-alone technology pack that is contained in its own JAR file. The MIB-II Technology Pack must be installed for those technology packs that have a dependency on this pack. Configured at least one DataChannel. Configured an SNMP collector subchannel for an SNMP pack. Configured a UBA bulk collector subchannel for a UBA pack. Created a user on the server with permission to FTP and delete files. v Open a terminal emulator and log on to the DataMart server as pvuser. v Change your working directory to the DataMart home directory (/opt/datamart, by default). v Load the shell with the DataMart environment by sourcing the datamart.env file, as follows:. /opt/datamart/datamart.env Note: After you load the DataMart environment into the shell, the PVMHOME variable is set to the DataMart home directory, /opt/datamart, by default. These instructions assume that this variable is set. v Set and export the DISPLAY environment variable (see Installing Tivoli Netcool Performance Manager - Wireline Component) so that the Technology Pack Installer GUI displays back on your system. v Installed the Technology Pack. Note: Localization is done automatically during installation of the technology pack. Preparing to install technology pack patches Describes how to install technology pack patches. Before you begin v For the latest patch information for Tivoli Netcool Performance Manager, see Installing an interim fix. v For the latest patch information for technology packs, download the Release Summary for Tivoli Netcool Performance Manager of the required technology pack release from the information center. Review the appendix that deals with interim fixes and fix packs in the release notes. Note the patches that are required for the technology packs you intend to install. Procedure 1. Download the required patches for each technology pack that you intend to install. 2. Install the required patches for each technology pack that you intend to install. 4 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

13 Preparing the pack installation directory You can obtain technology pack installation files from the IBM product distribution website, or from the Tivoli Netcool Performance Manager technology pack CD. Before you begin If you are installing the packs by using an instance of the Tivoli Netcool Performance Manager launchpad on the local file system, you can install directly from the CD. Otherwise, you must create a temporary directory and copy the technology pack files to the local system before you begin the installation. You cannot run the launchpad from the Tivoli Netcool Performance Manager DVD, and then install technology packs directly from the CD distribution. Note: If you are using a local instance of the launchpad and you want to install directly from the technology pack CD, you can skip this step and proceed to Installing technology packs by using the launchpad. Procedure 1. On the system where DataMart is located, use the mkdir command to create tech-packs directory to hold the technology pack JAR files and the ProvisoPackInstaller.jar file. For example: mkdir -p $PVMHOME/version/tech-packs 2. If you want to use technology packs from the IBM product distribution website, download the JAR files by following these steps: a. Use the cd command to change your working directory to the tech-packs directory that you created in Step 1. For example: cd $PVMHOME/version/app-packs b. Download the following from this website: v ProvisoPackInstaller.jar file v JAR files for technology packs you want to install (the bundled JAR file for bundled packs or individual JAR files for stand-alone packs) 3. If you want to use technology packs from the Tivoli Netcool Performance Manager technology pack CD, browse to the /Proviso/AP/jar location on the CD and copy the following files to the temporary directory: v v ProvisoPackInstaller.jar file JAR files for technology packs you want to install (the bundled JAR file for bundled packs or individual JAR files for stand-alone packs) 4. Unmount the CD. Installing a technology pack You can install a Tivoli Netcool Performance Manager technology pack either from a launchpad or by using the command line. Installing packs 5

14 Installing technology packs by using the launchpad Use this information to install a technology pack by using the launchpad. Before you begin Check the version of Java running on your system by entering the following command: java -version You must upgrade your version of Java depending on the technology pack release. Important: For all technology packs, the launchpad requires you to enter the path to supported Java runtime binary files. Only version 1.6.0_b(14+) is supported. The Tivoli Netcool Performance Manager topology editor provides a supported version of the Java binary files. Using the older Java version might result in an error that says it is not possible to proceed with the installation. About this task To install a Tivoli Netcool Performance Manager technology pack, follow these steps: Procedure 1. Start the installer: a. If it is not already open, open the launchpad (see Starting the Launchpad in the Installing Tivoli Netcool Performance Manager - Wireline Component). Note: Open a terminal emulator and log on to the DataMart server as pvuser. You must su to root. Otherwise, the launchpad fails to start. b. On the launchpad, click Install Technology Pack. c. On the Install Technology Pack window, enter the following information: v The DataMart home directory (for example,/opt/datamart, by default). v The Java run time environment home directory (for example, /opt/ibm/proviso/topologyeditor/jre/bin). Note: For more information about supported JRE versions, see the Configuration Recommendations. v The Tivoli Netcool Performance Manager user (for example, pvuser). d. Click the Install Technology Pack link. A window prompts you to select the technology pack installation setup directory. e. Click Browse to locate the temporary directory ($PVMHOME/version/apppacks) that you created in Preparing the pack installation directory on page 5, or the directory on the Tivoli Netcool Performance Manager CD where the pack JAR files are located (by default, /Proviso/AP/jar). The technology pack can be loaded to the server where the Tivoli Netcool Performance Manager database is installed. f. Click the directory, and then click Select to display the specified directory in the window. g. Click OK. When the Technology Pack Installer starts, it displays a Tivoli Netcool Performance Manager Technology Packs Welcome window. 6 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

15 2. Click Next. 3. Accept the license agreement, and then click Next. The Technology Pack Installer displays the Database Access Parameters window with the parameter values that you specified when you are installing and configuring Oracle, the Tivoli Netcool Performance Manager database, and Tivoli Netcool Performance Manager DataMart. For more information, see Installing and configuring the prerequisite software and Installing in a distributed environment in the Installing Tivoli Netcool Performance Manager - Wireline Component. 4. Reenter the password of the database user, which is PV by default. 5. Click Next to continue. The Technology Pack Installer displays the Dashboard Application Services Hub access parameter values that you specified when installing and configuring Tivoli Netcool Performance Manager DataView as described in Installing in a distributed environment in the Installing Tivoli Netcool Performance Manager - Wireline Component. Note: The Technology Pack Installer GUI always displays as the default port number for Dashboard Application Services Hub. If you want to use a different port number, you must give the port number at the time of Tivoli Netcool Performance Manager installation. Otherwise, the Technology Pack Installer displays an error message and you cannot proceed with the installation. 6. Reenter the password of the Dashboard Application Services Hub user, which is smadmin by default. The Technology Pack Installer displays a Feature Selection window, which lists all the packs you downloaded to the directory created in Preparing the pack installation directory on page 5 in the left pane. All the packs are automatically selected for installation. 7. Clear any technology packs in the list that you do not want to install, and then click Next. Note: The prerequisites for technology packs item in the Feature Selection window is always installed. You cannot clear this item. The Starter Kit is not included in this item. Depending on the type of packs you install, you might be presented with slightly different windows. Stand-alone packs only: a. Click Next to start the installation. As the stand-alone packs are installed, the Technology Pack Installer displays the name of each pack and indicates the progress. When the installation completes, the Technology Pack Install Complete window is displayed. b. Click Finish to exit the Technology Pack Installer. c. Perform post-installation tasks. Bundled and stand-alone packs: The Technology Pack Installer installs all of the stand-alone technology packs and displays the name of each pack and indicates progress. When the installation of the stand-alone packs completes, the Tivoli Netcool Performance Manager Technology Packs screen opens, and the installation of bundled packs begins. Installing packs 7

16 Bundled packs: To install the bundle packs, follow these steps: CAUTION: Before you install bundled packs, the Installer looks for an environment variable named PROVISO_JAVA. This variable points to the directory that contains the approved V1.5 (or higher) IBM Java virtual machine. If PROVISO_JAVA environment variable is not set, the installer attempts to use the default system Java and causes an issue when you install bundled packs. a. An Update Proviso Database message box is displayed briefly, followed by a Tivoli Netcool Performance Manager Technology Packs screen. Click Next to continue. The Technology Pack Installer displays the Database Details screen with the parameter values that you specified when installing and configuring Oracle, the Tivoli Netcool Performance Manager database, and Tivoli Netcool Performance Manager DataMart as described in previous chapters of this installation guide. For more information, see Installing and configuring the prerequisite software and Installing in a distributed environment in the Installing Tivoli Netcool Performance Manager - Wireline Component. b. Reenter the password of the database user, which is PV by default. c. Click Next to continue. The Select Packages screen opens. d. On the Select Packages screen, do the following steps: v v If not previously installed, select the Pack Bundle Prerequisites. Select individual bundled technology packs that you want to install. e. Click Next to continue. f. Confirm your bundled pack selections on the Install Options Selected screen or click Back to return to the Select Packages screen to remove or add technology packs to the list. g. When you are satisfied with your selections, click Next. The Technology Pack Installer begins copying files that are associated with the bundled packs, displaying several status windows. Note: If it detects existing files, the Technology Pack Installer might display Replace File window, for example, inventory_elements.txt and inventory_subelements.txt. For more information about backing up these files, see Backing up inventory files on page 1. When the Technology Pack Installer finishes copying all the necessary files for the bundled packs and updates the database, it displays the ReadMe File screen. By default, the check box for reviewing the README file is selected. The README file tells you to download from the IBM Knowledge Center. h. Click Finish. The Technology Pack Installer displays a series of messages in the terminal emulator as it uploads style sheets and other pack-related files to the database. Upon completion, the Technology Pack Installer displays a Technology Pack Install Complete screen. i. Click Finish to exit the Technology Pack Installer. 8 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

17 What to do next After the installation completes, do the following, depending upon the types of packs (bundled or stand-alone packs, SNMP, or UBA packs) you installed: Note: See Configuring Technology Packs to determine the pack type (SNMP or UBA). Important: A technology pack does not work until it is configured. After you configure the technology pack, data is collected and reports are populated. SNMP packs Configure the technology pack, as described in Configuring Technology Packs. UBA packs Add a UBA collector, as follows: v Configure the technology pack, as described in Configuring Technology Packs. Populating the family dictionary table Use this information to populate the family dictionary table for any new Alcatel-Lucent 5620 SAM LogToFile installation. Procedure 1. Change your working directory to the standard directory by using the following command: cd $PVMHOME/APFiles/alcatel_5620_sam_log2file/datamart/standard/ 2. Provide the run permission to the importlogtofilefamilydictionary.rmg script file by using the following command: chmod +x importlogtofilefamilydictionary.rmg 3. Source the DataMart environment by using the following command:.$pvmhome/datamart.env 4. Run the importlogtofilefamilydictionary.rmg script file by using the following command:./importlogtofilefamilydictionary.rmg Initially, you receive the $Import has started message. When the import is completed, you see the $Completed import message. UBA collectors The UBA collector is associated with two DataChannel components: Complex Metric Engine (CME)x.x Performs calculations on the collected data. File Transfer Engine (FTE)x.x Transfers files from the collector output directories and places them in the input directory of the CME. Note: Topology Editor includes the channel and collector numbers in the component names. For example, Data Channel 1 might have Collector UBA 1.1, with Complex Metric Engine 1.1 and File Transfer Engine 1.1. The FTE writes data to the file /var/adm/wtmpx on each system that hosts a collector. As part of routine maintenance, check the size of this file to Installing packs 9

18 prevent it from growing too large. For more information about Disk Quota Management, see Installing Tivoli Netcool Performance Manager - Wireline Component. Note: The Solaris version can be configured with strict access default settings for secure environments. Strict FTP access settings might interfere with automatic transfers between a DataChannel subchannel and the DataLoad server. Check for FTP lockouts in /etc/ftpd/ftpusers, and check for strict FTP rules in /etc/ftpd/ftpaccess. Adding a UBA collector for a UBA pack Use this information to add a UBA collector for a UBA Pack. Procedure 1. Load the pack XSD file into an existing topology, as follows: a. If it is not already open, open the Topology Editor (see Starting the Topology Editor in the Installing Tivoli Netcool Performance Manager - Wireline Component). b. Open a deployed topology (a topology.xml file) (see Opening an Existing Topology File in the Installing Tivoli Netcool Performance Manager - Wireline Component). c. In the Technology Pack view, right-click the Technology Packs folder and select Load Technology Pack from the menu. The Load the technology pack configuration metadata window displays. There are two radio buttons: XSD file and JAR file. d. Click the JAR file radio button and select Browse. There is a known issue and a workaround for opening an XSD file from a UBA pack. For more information, see UBA pack XSD file inside a JAR file cannot be loaded into the Topology Editor section in Pack Release Summary. e. Using the Directory: field, the up and down arrows, and the Folders pane on the configuration metadata window, go to the directory where the technology pack JAR files exist. For example, $PVMHOME/APFiles or a directory on the Tivoli Netcool Performance Manager CD. f. For bundled UBA packs: v v v v Select the bundled JAR file, then click OK. The bundled JAR file displays in the Load the technology pack configuration metadata window. Click Next. The Topology Editor displays the list of XSD files for the Bundled packs you installed. Select one or more XSD files to import into the topology. Click Select all to select all of the XSD files. Note: You can also click a single XSD file and press the CTRL key to select any number of other XSD files. Click Finish. The Topology Editor adds the selected Bundled Technology Pack or packs to the list of technology packs displayed in the Technology Packs view. g. For stand-alone UBA packs: v Select a technology pack JAR file, and then click OK. The pack JAR file is displayed in the configuration metadata window. v Click Finish. The Topology Editor adds the selected stand-alone technology pack to the list of technology packs displayed in the Technology Packs view. 10 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

19 2. After you load a UBA pack XSD file, you must add a UBA collector and associate it with a UBA technology pack as follows: a. In the Logical view, right-click the DataChannel x folder and select from the Add collector UBA menu. The Configure Collector window opens. b. Select the appropriate technology pack (for example, Alcatel Lucent 5529 SDC) from the list of technology packs, and then click Next. c. Using the list of available hosts on the Configure Collector window, select the workstation that hosts the collector. For example, corinth). d. Accept the default collector number. For example, 2. e. Click Finish. The Topology Editor displays the new collector under the DataChannelx folder in the Logical view. f. Highlight the collector to view its properties. The Topology Editor displays both the UBA collector core parameters and the UBA technology pack-specific parameters. The core parameters are configured with all UBA technology packs. Review the values for the parameters to make sure that they are valid. For information about the core parameters, see the Properties Reference. For information about the pack-specific parameters, see the Topology Editor Help. g. To add extra UBA collectors for a UBA technology pack, repeat Step 2-a through Step 2-f. h. Redeploy the updated topology (see Starting the Deployer in the Installing Tivoli Netcool Performance Manager - Wireline Component). 3. Configure the UBA technology packs. Log files The Technology Pack Installer writes log files to the /usr/tmp directory. Log files in this directory contain a detailed history of the tasks the Technology Pack Installer performs as it installs technology packs. You can check this log file to help solve any issues that might occur during technology pack installation. For example, a log file might contain a message that indicates that the Technology Pack Installer GUI cannot display back on your system because the DISPLAY environment variable was not set. For more information, see Setting up a remote X Window display in the Installing Tivoli Netcool Performance Manager - Wireline Component. Log files for bulk technology packs are named installer<timestamp>.log, where timestamp is the time that the file was created in seconds since the UNIX epoch. Log files for stand-alone packs are named APInstall<timestamp>.log. For technology packs, log file names have the format APInstall<number>.log. For example: APInstall log. Installing packs 11

20 12 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

21 Appendix. Installing technology packs by using the command line You can install a Tivoli Netcool Performance Manager Technology Pack by using the command line. The preferred method for installing a technology packs is from the launchpad. About this task To install a Tivoli Netcool Performance Manager technology pack from the command line, follow these steps: Procedure 1. Use the cd command to change your working directory to the temporary directory ($PVMHOME/version/app-packs) that you created in Preparing the pack installation directory on page 5, or to the directory on the Tivoli Netcool Performance Manager CD where the pack JAR files are located (by default,/proviso/ap/jar). Note: The Technology Pack Installer and pack JAR files need to be owned by pvuser. Else, change the file ownership before you start the installation. 2. To start the Technology Pack Installer, enter the following command: java -Xmx256M -jar ProvisoPackInstaller.jar Note: The -Xmx256M option is required to allocate sufficient memory for the Technology Pack Installer to successfully install multiple bundled and stand-alone technology packs. Attention: The following command is only applicable for V1.4.0 and higher Technology Packs. 3. To start the Technology Pack Installer for Alcatel Lucent 5620 SAM technology pack, enter the following command: java -Xmx512M -jar ProvisoPackInstaller.jar When the Technology Pack Installer starts, it displays a Tivoli Netcool Performance Manager Technology Packs Welcome window. 4. Click Next. 5. Click Accept the terms to accept the license agreement. 6. Click Next. 7. Use Step 4 through Step 7 in Installing technology packs by using the launchpad on page 6. Copyright IBM Corp. 1997,

22 14 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

23 Notices This information was developed for products and services that are offered in the USA. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY United States of America For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm websites are provided for convenience only and do not in any manner serve as an endorsement of those Copyright IBM Corp. 1997,

24 websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Department number/building number Site mailing address_ City, State; Zip Code_ USA (or appropriate country) Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: 16 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

25 This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights reserved. Terms and conditions for product documentation Permissions for the use of these publications are granted subject to the following terms and conditions. Applicability These terms and conditions are in addition to any terms of use for the IBM website. Personal use You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM. Commercial use You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM. Rights Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein. IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed. You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations. Notices 17

26 IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at copytrade.shtml. Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both. IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. ITIL is a registered trademark, and a registered community trademark of The Minister for the Cabinet Office, and is registered in the U.S. Patent and Trademark Office. UNIX is a registered trademark of The Open Group in the United States and other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom. Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries. 18 IBM Tivoli Netcool Performance Manager: Installing Technology Packs

27 Additional copyright notices The following copyright information is for software used by Tivoli Netcool Performance Manager Wireline Component. Tcl 8.3.3, Combat/TCL 0.7.3, Combat/TCL 0.7.5, TclX 8.3, TK This software is copyrighted by the Regents of the University of California, Sun Microsystems, Inc., Scriptics Corporation, and other parties. The following terms apply to all files associated with the software unless explicitly disclaimed in individual files. The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation for any purpose, provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions. No written agreement, license, or royalty fee is required for any of the authorized uses. Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here, provided that the new terms are clearly indicated on the first page of each file where they apply. IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. GOVERNMENT USE: If you are acquiring this software on behalf of the U.S. government, the Government shall have only "Restricted Rights" in the software and related documentation as defined in the Federal Acquisition Regulations (FARs) in Clause (c) (2). If you are acquiring the software on behalf of the Department of Defense, the software shall be classified as "Commercial Computer Software" and the Government shall have only "Restricted Rights" as defined in Clause (c) (1) of DFARs. Notwithstanding the foregoing, the authors grant the U.S. Government and others acting in its behalf permission to use and distribute the software in accordance with the terms specified in this license. SCOTTY Stack This software is copyrighted by Juergen Schoenwaelder, the Technical University of Braunschweig, the University of Twente, and other parties. The following terms apply to all files associated with the software unless explicitly disclaimed in individual files. The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation for any purpose, provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions. No written agreement, license, or royalty fee is required for any of the authorized uses. Modifications to this software may be copyrighted by Notices 19