IBM Tivoli Netcool Performance Manager Wireline Component July 2014 Document Revision R2E1. Installing Technology Packs

Transcription

1 IBM Tioli Netcool Performance Manager Wireline Component July 2014 Document Reision R2E1 Installing Technology Packs

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

3 Contents About this information Intended audience Tioli Netcool Performance Manager - Wireline Component Serice Management Connect i Tioli technical training ii Support information ii Conentions used in this publication ii Typeface conentions ii Installing packs Installing technology packs Types of technology packs Backing up inentory files Prerequisite software Preinstallation setup tasks Preparing to install technology pack patches... 5 Preparing the pack installation directory Installing a technology pack Appendix. Installing technology packs by using the command line Notices Additional copyright notices Copyright IBM Corp. 1997, 2014 iii

4 i IBM Tioli Netcool Performance Manager: Installing Technology Packs

5 About this information Intended audience Describes how to install Tioli Netcool Performance Manager technology packs. Tioli 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. Tioli Netcool Performance Manager rolled out the ability to report on the performance data by using the Cognos reporting capability of Tioli Common Reporting, included as standard in Tioli Netcool Performance Manager. The audience for this guide. Network administrators or operations specialists responsible for installing and configuring technology packs and common packs on an IBM Tioli Netcool Performance Manager system on an enterprise network. Common pack modelers who want to publish data models for Common Reporting in Tioli Netcool Performance Manager. Readers must be familiar with the following topics: Basic principles of TCP/IP networks and network management SNMP concepts Administration of the Oracle database management system Tioli Netcool Performance Manager Tioli Netcool Performance Manager technology pack and common pack concepts Tioli Netcool Performance Manager reporting concepts Jazz for Serice Management IBM Cognos IBM Cognos Framework Manager Tioli Netcool Performance Manager - Wireline Component IBM Tioli Netcool Performance Manager consists of a wireline component (formerly Netcool/Proiso) and a wireless component (formerly Tioli Netcool Performance Manager for Wireless). Tioli Netcool Performance Manager - Wireline Component consists of the following subcomponents: DataMart is a set of management, configuration, and troubleshooting GUIs. The Tioli Netcool Performance Manager System Administrator uses the GUIs to define policies and configuration, and to erify and troubleshoot operations. DataLoad proides flexible, distributed data collection and data import of SNMP and non-snmp data to a centralized database. Copyright IBM Corp. 1997, 2014

6 DataChannel aggregates the data collected through Tioli Netcool Performance Manager DataLoad for use by the Tioli Netcool Performance Manager DataView reporting functions. It also processes online calculations and detects real-time threshold iolations. DataView is a reliable application serer for on-demand, web-based network reports. Technology Packs extend the Tioli Netcool Performance Manager system with serice-ready reports for network operations, business deelopment, and customer iewing. The following figure shows the different Tioli Netcool Performance Manager modules. Tioli Netcool Performance Manager documentation consists of the following: Release notes Configuration recommendations Installation and upgrade information User guides Technical notes Online help The documentation is aailable for iewing and downloading on the information center at com.ibm.tnpm.doc/welcome_tnpm.html. Serice Management Connect Connect, learn, and share with Serice Management professionals: product support technical experts who proide their perspecties and expertise. Access Network and Serice Assurance community at deeloperworks/sericemanagement/nsa/index.html. Use Serice Management Connect in the following ways: i IBM Tioli Netcool Performance Manager: Installing Technology Packs

7 Tioli technical training Support information Become inoled with transparent deelopment, an ongoing, open engagement between other users and IBM deelopers of Tioli products. You can access early designs, sprint demonstrations, product roadmaps, and prerelease code. Connect one-on-one with the experts to collaborate and network about Tioli and the Network and Serice Assurance community. Read blogs to benefit from the expertise and experience of others. Use wikis and forums to collaborate with the broader user community. Related information: Tioli Netcool Performance Manager 1.4 community on deeloperworks For Tioli technical training information, see the following Tioli Netcool Performance Manager Training website at training. If you hae a problem with your IBM software, you want to resole it quickly. IBM proides the following ways for you to obtain the support you need: Online Access the IBM Software Support site at support/probsub.html. IBM Support Assistant The IBM Support Assistant is a free local software sericeability workbench that helps you resole questions and problems with IBM software products. The Support Assistant proides quick access to support-related information and sericeability tools for problem determination. To install the Support Assistant software, go to support/isa. Troubleshooting Guide For more information about resoling problems, see the problem determination information for this product. Conentions used in this publication Seeral conentions are used in this publication for special terms, actions, commands, and paths that are dependent on your operating system. Typeface conentions This publication uses the following typeface conentions: Bold Italic Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Keywords and parameters in text About this information ii

8 Citations (examples: titles of publications, diskettes, and CDs) Words defined in text (example: a nonswitched line is called a point-to-point line) Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictie clause."; letters as letters example: "The LUN address must start with the letter L.") New terms in text (except in a definition list): a iew is a frame in a workspace that contains data. Variables and alues you must proide:... where myname represents... Monospace Examples and code examples File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options Bold monospace Command names, and names of macros and utilities that you can type as commands Enironment ariable names in text Keywords Parameter names in text: API structure parameters, command parameters and arguments, and configuration parameters Process names Registry ariable names in text Script names iii IBM Tioli Netcool Performance Manager: Installing Technology Packs

9 Installing packs Installing technology packs Proides 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 in this guide. Tioli Netcool Performance Manager supports the 4.3-U 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 ersion of the technology pack. Note: The latest Technology Pack Installer (ProisoPackInstaller.jar file) ersion is It works on both Oracle and IBM DB2. Types of technology packs Tioli Netcool Performance Manager supports these types of technology packs. Bundled Multiple technology packs that are contained in a single, bundled JAR file. Stand-alone Indiidual 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 coer the following installation scenarios: Bundled only Stand-alone only Bundled and stand-alone Backing up inentory files These backup steps are not required for an SNMP stand-alone technology pack. About this task For specific information about managing the inentory 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 inentory control files by entering the following commands: cp inentory_elements.txt inentory_elements.txt.orig cp inentory_subelements.txt inentory_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 inentory control files and the.orig ersions 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 hae all the prerequisite software and required information before you install and configure a technology pack. IBM Tioli/Netcool Proiso or IBM Tioli Netcool Performance Manager. An SNMP collector. You can add an SNMP collector as described in Adding a collector in the Installing Tioli 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. Ensure that you hae access to the Tioli Netcool Performance Manager DataMart serer that is running an X Window System serer. Note: If there is no graphics card on the DataMart serer, the Xfb irtual frame buffer package that proides X Window System serices is automatically installed. For more information, see Setting up a remote X Window display in the Installing Tioli Netcool Performance Manager - Wireline Component. Ensure that you hae access to the SilerStream serer (Tioli Netcool/Proiso 4.4.3) Ensure that you hae access to the Tioli Integrated Portal (Tioli Netcool Performance Manager 1.3.0,1.3.1 and 1.3.2) or Dashboard Application Serices Hub (DASH and 1.4) Ensure that you hae access to the DataChannel serer Ensure that you hae access to the technology pack installation files on one of the following locations: Product distribution site: softwareandserices. On the product distribution sites are the ProisoPackInstaller.jar file, and technology pack JAR files. IBM Tioli Netcool Performance Manager Wireline Technology Packs CD Assembly, which contains the ProisoPackInstaller.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 4. For more information about obtaining software, see your IBM customer representatie. The correct ersion of Jaa. For more information, see Configuration Recommendations. 2 IBM Tioli Netcool Performance Manager: Installing Technology Packs

11 Additional information An SNMP technology pack is MIB-based and its configuration is relatiely straightforward. UBA Technology Packs collect data against non-snmp deices, and rely on the UBA of the Tioli Netcool Performance Manager DataChannel to process the data. Before you configure a technology pack, ensure that you: Hae the following documentation for your ersion of Tioli Netcool Performance Manager: Release Summary for Tioli Netcool Performance Manager for the current technology pack release Installing Tioli Netcool Performance Manager - Wireline Component Upgrading Tioli 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 inentory profile and initiate a discoery. Hae access to the following site to check for interim fixes or fix packs that might apply to your technology pack: NetcoolProiso.html Hae the Tioli Netcool Performance Manager documentation and the Pack Release Summary, which are aailable 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. The Oracle TNS name of the serer on which you installed Oracle serer with the Tioli Netcool Performance Manager database configuration. For more information, see Specifying a Basename for DB_USER_ROOT topic in the IBM Tioli Netcool Performance Manager: Installation Guide. The DB2 name of the serer on which you installed DB2 serer with the Tioli Netcool Performance Manager database configuration. For more information, see IBM Tioli Netcool Performance Manager: Installation Guide. Installing packs 3

12 Preinstallation setup tasks Ensure that all necessary configuration steps are completed on the prerequisite software. 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. Completed the following tasks: Reiewed the release summary for the current technology pack. 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 ersion of the Tioli Netcool Performance Manager components, as described in the Installing Tioli 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 hae 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 serer with permission to FTP and delete files. Open a terminal emulator and log on to the DataMart serer as puser. Change your working directory to the DataMart home directory (/opt/datamart, by default). Load the shell with the DataMart enironment by sourcing the datamart.en file, as follows:. /opt/datamart/datamart.en Note: After you load the DataMart enironment into the shell, the PVMHOME ariable is set to the DataMart home directory, /opt/datamart, by default. These instructions assume that this ariable is set. Set and export the DISPLAY enironment ariable (see Installing Tioli Netcool Performance Manager - Wireline Component) so that the Technology Pack Installer GUI displays back on your system. Installed the Technology Pack. Note: Localization is done automatically during installation of the technology pack. 4 IBM Tioli Netcool Performance Manager: Installing Technology Packs

13 Preparing to install technology pack patches Describes how to install technology pack patches. Before you begin For the latest patch information for Tioli Netcool Performance Manager, see Installing an interim fix in the Installing Tioli Netcool Performance Manager - Wireline Component. For the latest patch information for technology packs, download the Release Summary for Tioli Netcool Performance Manager of the required technology pack release from the information center. Reiew 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. Preparing the pack installation directory You can obtain technology pack installation files from the IBM product distribution website, or from the Tioli Netcool Performance Manager technology pack CD. Before you begin If you are installing the packs by using an instance of the Tioli 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 Tioli Netcool Performance ManagerDVD, 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. 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 ProisoPackInstaller.jar file. For example: mkdir -p $PVMHOME/ersion/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 app-packs directory that you created in Step 1. For example: cd $PVMHOME/ersion/app-packs b. Download the following from this website: ProisoPackInstaller.jar file JAR files for technology packs you want to install (the bundled JAR file for bundled packs or indiidual JAR files for stand-alone packs) Installing packs 5

14 3. If you want to use technology packs from the Tioli Netcool Performance Manager technology pack CD, browse to the /Proiso/AP/jar location on the CD and copy the following files to the temporary directory: ProisoPackInstaller.jar file JAR files for technology packs you want to install (the bundled JAR file for bundled packs or indiidual JAR files for stand-alone packs) 4. Unmount the CD. Installing a technology pack You can install a Tioli Netcool Performance Manager technology pack either from a launchpad or by using the command line. Installing technology packs by using the launchpad Use this information to install a technology pack by using the launchpad. Before you begin Check the ersion of Jaa running on your system by entering the following command: jaa -ersion You must upgrade your ersion of Jaa depending on the technology pack release. Important: For all technology packs, the launchpad requires you to enter the path to supported Jaa runtime binary files. Only ersion 1.6.0_b(14+) is supported. The Tioli Netcool Performance Manager topology editor proides a supported ersion of the Jaa binary files. Using the older Jaa ersion might result in an error detailing that it is not possible to proceed with the installation. About this task To install a Tioli Netcool Performance Manager technology pack, follow these steps: Procedure 1. Start the installer as follows: a. If it is not already open, open the launchpad (see Starting the Launchpad in the Installing Tioli Netcool Performance Manager - Wireline Component). Note: Open a terminal emulator and log on to the DataMart serer as puser. 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: The DataMart home directory (for example,/opt/datamart, by default). The Jaa run time enironment home directory (for example, /opt/ibm/proiso/topologyeditor/jre/bin). Note: For information about supported JRE ersions, see the Configuration Recommendations. The Tioli Netcool Performance Manager user (for example, puser). d. Click the Install Technology Pack link. A window prompts you to select the technology pack installation setup directory. 6 IBM Tioli Netcool Performance Manager: Installing Technology Packs

15 e. Click Browse to locate the temporary directory ($PVMHOME/ersion/apppacks) that you created in Preparing the pack installation directory on page 5, or the directory on the Tioli Netcool Performance Manager CD where the pack JAR files are located (by default, /Proiso/AP/jar). The technology pack can be loaded to the serer where the Tioli 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 Tioli Netcool Performance Manager Technology Packs Welcome window. 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 alues that you specified when installing and configuring Oracle, the Tioli Netcool Performance Manager database, and Tioli Netcool Performance Manager DataMart. For more information, see Installing and configuring the prerequisite software and Installing in a distributed enironment in the Installing Tioli 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 Serices Hub or Tioli Integrated Portal access parameter alues that you specified when installing and configuring Tioli Netcool Performance Manager DataView as described in Installing in a distributed enironment in the Installing Tioli Netcool Performance Manager - Wireline Component. Note: The Technology Pack Installer GUI always displays as the default port number for Tioli Integrated Portal or Dashboard Application Serices Hub. If you want to use a different port number, you must gie the port number at the time of Tioli 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 Serices Hub or Tioli Integrated Portal user, which is smadmin by default, or tipadmin for the Tioli Integrated Portal user. 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 panel. 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 Installing packs 7

16 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. Go to What to do next section to 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 Tioli Netcool Performance Manager Technology Packs screen opens, and the installation of bundled packs begins. Bundled packs: To install the bundle packs, follow these steps: 8 IBM Tioli Netcool Performance Manager: Installing Technology Packs CAUTION: For 4.3-Y or higher Technology Packs Only. Before you install bundled packs, the Installer looks for an enironment ariable named PROVISO_JAVA. This points to the directory that contains the approed 1.5 (or aboe) IBM Jaa irtual machine. If PROVISO_JAVA enironment ariable is not set, the installer attempts to use the default system Jaa and causes an issue when you install bundled packs. a. An Update Proiso Database message box displays briefly, followed by a Tioli Netcool Performance Manager Technology Packs screen. Click Next to continue. The Technology Pack Installer displays the Database Details screen with the parameter alues that you specified when installing and configuring Oracle, the Tioli Netcool Performance Manager database, and Tioli Netcool Performance Manager DataMart as described in preious chapters of this installation guide. For more information, see Installing and configuring the prerequisite software and Installing in a distributed enironment in the Installing Tioli 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: If not preiously installed, select the Pack Bundle Prerequisites. Select indiidual 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 remoe 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 seeral status windows. Note: If it detects existing files, the Technology Pack Installer might display Replace File window, for example, inentory_elements.txt and inentory_subelements.txt. For more information about backing up these files, see Backing up inentory files on page 1.

17 What to do next 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 reiewing the README file is selected. The README file tells you to download the 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. 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 described in Adding a UBA collector for UBA packs 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 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. Proide the run permission to the importlogtofilefamilydictionary.rmg script file by using the following command: chmod +x importlogtofilefamilydictionary.rmg 3. Source the DataMart enironment by using the following command:.$pvmhome/datamart.en 4. Run the importlogtofilefamilydictionary.rmg script file by using the following command:./importlogtofilefamilydictionary.rmg Initially, you receie the $Import has started message. When the import is completed, you see the $Completed import message. Installing packs 9

18 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 hae Collector UBA 1.1, with Complex Metric Engine 1.1 and File Transfer Engine 1.1. The FTE writes data to the file /ar/adm/wtmpx on each system that hosts a collector. As part of routine maintenance, check the size of this file to preent it from growing too large. For more information about Disk Quota Management, see Installing Tioli Netcool Performance Manager - Wireline Component. Note: The Solaris ersion can be configured with strict access default settings for secure enironments. Strict FTP access settings might interfere with automatic transfers between a DataChannel subchannel and the DataLoad serer. 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 Tioli Netcool Performance Manager - Wireline Component). b. Open a deployed topology (a topology.xml file) (see Opening an Existing Topology File in the Installing Tioli Netcool Performance Manager - Wireline Component). c. In the Technology Pack iew, 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 Tioli Netcool Performance Manager CD. f. For bundled UBA packs: 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. 10 IBM Tioli Netcool Performance Manager: Installing Technology Packs

19 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 iew. g. For stand-alone UBA packs: Select a technology pack JAR file, and then click OK. The pack JAR file is displayed in the configuration metadata window. Click Finish. The Topology Editor adds the selected stand-alone technology pack to the list of technology packs displayed in the Technology Packs iew. 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 iew, 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 aailable 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 iew. f. Highlight the collector to iew 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. Reiew the alues for the parameters to make sure that they are alid. 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 Tioli 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 sole 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 enironment ariable was not set. For more information, see setting up a remote X Window Display in the Installing Tioli Netcool Performance Manager - Wireline Component. Installing packs 11

20 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 hae the format APInstall<number>.log. For example: APInstall log. 12 IBM Tioli Netcool Performance Manager: Installing Technology Packs

21 Appendix. Installing technology packs by using the command line You can install a Tioli 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 Tioli 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/ersion/app-packs) that you created in Preparing the pack installation directory on page 5, or to the directory on the Tioli Netcool Performance Manager CD where the pack JAR files are located (by default,/proiso/ap/jar). Note: The Technology Pack Installer and pack jar files need to be owned by puser. Else, change the file ownership before starting the installation. 2. To start the Technology Pack Installer, enter the following command: jaa -Xmx256M -jar ProisoPackInstaller.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 4.3-X and higher Technology Packs. 3. To start the Technology Pack Installer for technology pack, enter the following command: jaa -Xmx512M -jar ProisoPackInstaller.jar When the Technology Pack Installer starts, it displays a Tioli 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 Tioli Netcool Performance Manager: Installing Technology Packs

23 Notices This information was deeloped for products and serices offered in the U.S.A. IBM may not offer the products, serices, or features discussed in this document in other countries. Consult your local IBM representatie for information on the products and serices currently aailable in your area. Any reference to an IBM product, program, or serice is not intended to state or imply that only that IBM product, program, or serice may be used. Any functionally equialent product, program, or serice that does not infringe any IBM intellectual property right may be used instead. Howeer, it is the user's responsibility to ealuate and erify the operation of any non-ibm product, program, or serice. IBM may hae patents or pending patent applications coering subject matter described in this document. The furnishing of this document does not gie you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drie Armonk, NY U.S.A. For license inquiries regarding double-byte (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 proisions 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 might 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 improements 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 Web sites are proided for conenience only and do not in any manner sere as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. Copyright IBM Corp. 1997,

24 IBM may use or distribute any of the information you supply in any way it beliees appropriate without incurring any obligation to you. Licensees of this program who wish to hae 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 2Z4A/ Burnet Road Austin, TX U.S.A. Such information may be aailable, 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 aailable for it are proided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equialent agreement between us. Any performance data contained herein was determined in a controlled enironment. Therefore, the results obtained in other operating enironments may ary significantly. Some measurements may hae been made on deelopment-leel systems and there is no guarantee that these measurements will be the same on generally aailable systems. Furthermore, some measurement may hae been estimated through extrapolation. Actual results may ary. Users of this document should erify the applicable data for their specific enironment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly aailable 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 objecties only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may ary. This information is for planning purposes only. The information herein is subject to change before the products described become aailable. 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 indiiduals, 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: This information contains sample application programs in source language, which illustrate programming techniques on arious operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to 16 IBM Tioli Netcool Performance Manager: Installing Technology Packs

25 IBM, for the purposes of deeloping, 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 hae not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, sericeability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of deeloping, using, marketing, or distributing application programs conforming to IBM's application programming interfaces. Each copy or any portion of these sample programs or any deriatie work, must include a copyright notice as follows: (your company name) (year). Portions of this code are deried from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights resered. If you are iewing this information in softcopy form, the photographs and color illustrations might not be displayed. 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 serice names might be trademarks of IBM or other companies. A current list of IBM trademarks is aailable on the web at Copyright and trademark information at 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 Goernment 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 Toralds 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. Notices 17

26 Jaa and all Jaa-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Additional copyright notices 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. The following copyright information is for software used by Tioli 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 Uniersity 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 indiidual files. The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation for any purpose, proided that existing copyright notices are retained in all copies and that this notice is included erbatim 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, proided 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. goernment, the Goernment shall hae 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 Goernment shall hae only "Restricted Rights" as defined in Clause (c) (1) of DFARs. Notwithstanding the foregoing, the authors grant the U.S. Goernment and others acting in its behalf permission to use and distribute the software in accordance with the terms specified in this license. 18 IBM Tioli Netcool Performance Manager: Installing Technology Packs

27 SCOTTY Stack This software is copyrighted by Juergen Schoenwaelder, the Technical Uniersity of Braunschweig, the Uniersity of Twente, and other parties. The following terms apply to all files associated with the software unless explicitly disclaimed in indiidual files. The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation for any purpose, proided that existing copyright notices are retained in all copies and that this notice is included erbatim 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, proided 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. Various copyrights apply to this package, listed in 3 separate parts below. Please make sure that you include all the parts. Up until 2001, the project was based at UC Dais, and the first part coers all code written during this time. From 2001 onwards, the project has been based at SourceForge, and Networks Associates Technology, Inc hold the copyright on behalf of the wider Net-SNMP community, coering all deriatie work done since then. An additional copyright section has been added as Part 3 below also under a BSD license for the work contributed by Cambridge Broadband Ltd. to the project since Part 1: CMU/UCD copyright notice: (BSD like) Copyright 1989, 1991, 1992 by Carnegie Mellon Uniersity Deriatie Work , Copyright 1996, The Regents of the Uniersity of California All Rights Resered Permission to use, copy, modify and distribute this software and its documentation for any purpose and without fee is hereby granted, proided that the aboe copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of CMU and The Regents of the Uniersity of California not be used in adertising or publicity pertaining to distribution of the software without specific written permission. Notices 19