IBM Tivoli Netcool Performance Manager Wireline Component January 2012 Document Revision R2E1. Pack Upgrade Guide

Transcription

1 IBM Tioli Netcool Performance Manager Wireline Component January 2012 Document Reision R2E1 Pack Upgrade Guide

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

3 Contents Oeriew Audience Organization Tioli Netcool Performance Manager - Wireline Component Tioli Netcool Performance Manager documentation ii Chapter 1. Introduction Before you begin the upgrade Supported upgrade paths for Tioli Netcool Performance Manager technology packs Installing prerequisite software Tioli Netcool Performance Manager technology pack distribution Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack Oeriew Upgrade scenarios for Tioli Netcool/Proiso and technology packs Upgrade scenario for Tioli Netcool/Proiso and Alcatel-Lucent 5620 SAM Upgrading the Alcatel-Lucent 5620 SAM Technology Pack Upgrade scenarios for Tioli Netcool/Proiso and Netflow IPFIX Upgrading the Netflow IPFIX Technology Pack.. 7 Documents you need for technology pack upgrade 8 Current limitations with Tioli Netcool/Proiso fix pack 1 and pre-fix pack Limitations with how the Topology Editor treats UBA pack-specific parameters Limitations with UBA pack-specific parameter key/alue pairs Before you begin a technology pack upgrade Standard procedure for upgrading technology packs (Except Alcatel-Lucent 5620 SAM and Netflow IPFIX) Upgrade scenario 1 (SNMP and UBA technology packs) Upgrade scenario 2 (UBA packs only) Oeriew Upgrade scenarios for Tioli Netcool/Proiso and Tioli Netcool Performance Manager technology packs Upgrade scenario for Tioli Netcool/Proiso and Alcatel-Lucent 5620 SAM Upgrading the Alcatel-Lucent 5620 SAM Technology Pack Upgrade scenarios for Tioli Netcool/Proiso or Tioli Netcool Performance Manager and Netflow IPFIX Upgrading the Netflow IPFIX Technology Pack 25 Netflow IPFIX upgrade scenario Netflow IPFIX upgrade scenario Documents you need to perform a technology pack upgrade Essential information in the pack installation and configuration guide Essential information in pack release notes Essential Information in the Installation Guide.. 31 Essential information in the Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager ReadMe Topology Editor and UBA pack-specific properties 32 Technology pack XSD upgrade wizard Limitations with UBA pack-specific parameter key/alue pairs Before you begin a technology pack upgrade Before you begin upgrade scenario 2 (UBA packs only) Standard procedure for upgrading technology packs Chapter 4. Upgrading Common Packs 59 Upgrading Tioli Netcool Performance Manager Wireline Cognos report prompt pages for timezone support Notices Trademarks Additional copyright notices Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager Copyright IBM Corp. 1997, 2012 iii

4 i IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

5 Oeriew The purpose of this guide is to help upgrade your IBM Tioli Netcool Performance Manager technology packs and common packs. Audience The audience for this manual is the network administrator or operations specialist responsible for installing the Tioli Netcool Performance Manager product suite on an enterprise network. To install Tioli Netcool Performance Manager technology packs successfully, you must hae a thorough understanding of the following subjects: Basic principles of TCP/IP networks and network management SNMP and UBA concepts Administration of the Solaris or AIX operating enironment Administration of the Oracle database management system Tioli Netcool Performance Manager Upgrade scenarios associated with Tioli Netcool Performance Manager Organization This guide is organized as follows: Chapter 1, Introduction, on page 1 Chapter 2, Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3, on page 3 Chapter 3, Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, on page 21 Chapter 4, Upgrading Common Packs, on page 59 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. 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. Copyright IBM Corp. 1997, 2012

6 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 Technical notes Online help The documentation is aailable for iewing and downloading on the information center at com.ibm.netcool_pm.doc/welcome_tnpm.html. i IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

7 Tioli Netcool Performance Manager documentation IBM proides the following Tioli Netcool Performance Manager documentation: Pack Release notes Configuration recommendations References Pack upgrade guide Upgrade guide (for core software) Pack Installation and configuration guide Installation guide (for core software) Technical notes Oeriew ii

8 iii IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

9 Chapter 1. Introduction This chapter proides information concerning requirements and considerations that must be satisfied before you upgrade your Tioli Netcool Performance Manager technology packs. Before you begin the upgrade This guide assumes that you hae a fully functioning Tioli Netcool Performance Manager enironment. To upgrade your enironment to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager ersion or aboe, you must do the following tasks: Verify that your enironment is running the supported ersions of both the prerequisite software and Tioli Netcool/Proiso or Tioli Netcool Performance Manager For more information, see Supported upgrade paths for Tioli Netcool Performance Manager technology packs. Download the Tioli Netcool Performance Manager technology pack distribution to disk. For more information, see Downloading the Tioli Netcool Performance Manager distribution to disk in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of Tioli Netcool Performance Manager. Shut down Tioli Netcool Performance Manager. For more information, see Shutting down the Tioli Netcool Performance Manager components in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of Tioli Netcool Performance Manager. Create and prepare the upgrade topology for deployment in your enironment. For more information, see Preparing the upgrade topology for deployment in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of Tioli Netcool Performance Manager. Start Tioli Netcool Performance Manager. For more information, see Starting up the Tioli Netcool Performance Manager components in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of Tioli Netcool Performance Manager. Supported upgrade paths for Tioli Netcool Performance Manager technology packs See the IBM Tioli Netcool Performance Manager: Pack Release Notes to determine the ersion from which a technology pack is upgradeable. For example, the IBM Tioli Netcool Performance Manager: Pack Release Notes might specify that your technology pack is upgradeable from Tioli Netcool/Proiso ersion 4.3-U or later. Copyright IBM Corp. 1997,

10 Installing prerequisite software About this task Before upgrading your Tioli Netcool Performance Manager enironment and then upgrading the technology pack, you must install the prerequisite software listed in the IBM Tioli Netcool Performance Manager: Configuration Recommendations Guide. Tioli Netcool Performance Manager technology pack distribution The Tioli Netcool Performance Manager technology pack distribution is aailable as a DVD/CD and as an electronic image. The instructions in this guide assume that you are installing from an electronic image. If you install the product from an electronic image, be sure to keep a copy of the distribution image in a well-known directory, because you will need this image in the future to make changes to the enironment. 2 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

11 Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 Oeriew This chapter describes how to upgrade Tioli Netcool/Proiso technology packs after you upgrade your Tioli Netcool/Proiso MR1 or earlier, Tioli Netcool/Proiso fix pack 1 or later, or Tioli Netcool/Proiso system to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. About this task If you hae upgraded your Tioli Netcool/Proiso system to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, you must follow the upgrade instructions described in Chapter 3, Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, on page 21. What to do next Important: IBM does not support Tioli Netcool/Proiso pre from 1.3-E release onwards. It is recommended that you upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. This chapter explains how to upgrade technology packs after you upgrade your Tioli Netcool Performance Manager system. Specifically, this chapter proides instructions on how to upgrade technology packs according to seeral upgrade scenarios. For UBA technology packs, this chapter also proides: Information about what to expect with regards to UBA pack-specific property settings for deployed packs when upgrading to Tioli Netcool/Proiso pre-fix pack 3. Guidelines for erifying UBA technology pack-specific properties when upgrading a UBA technology pack after upgrading to Tioli Netcool/Proiso pre-fix pack 3. Specific upgrade scenarios for the Alcatel-Lucent 5620 SAM Technology Pack and the Netflow IPFIX Technology Pack. Upgrade scenarios for Tioli Netcool/Proiso and technology packs This section proides information you need to upgrade technology packs so that they operate correctly on a Tioli Netcool/Proiso system. Table 1 on page 4 identifies the upgrade scenarios for Tioli Netcool/Proiso and technology packs. Copyright IBM Corp. 1997,

12 Table 1. Tioli Netcool/Proiso and technology pack upgrade scenarios Upgrade scenario Upgrade scenario 1 (SNMP and UBA packs) Upgrade scenario 2 (UBA packs only) Upgrade scenario description Tioli Netcool/Proiso upgrade You are currently running Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to upgrade to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. Technology pack upgrade You want to upgrade currently deployed technology packs to 4.3-U or later. Tioli Netcool/Proiso fix pack update You are currently running Tioli Netcool/Proiso You want to update to fix pack 1 or pre-fix pack 3. Technology pack upgrade You want to upgrade currently deployed 4.3-U UBA technology packs to 4.3-V or later. Upgrade scenario steps Perform the following steps: 1. Upgrade Tioli Netcool/Proiso fix pack 1 or pre-fix pack See Documents you need for technology pack upgrade on page 8 for the documents you need to perform this upgrade scenario. 3. See Upgrade scenario 1 (SNMP and UBA technology packs) on page 17 for details about this upgrade scenario. Perform the following steps: 1. Upgrade Tioli Netcool/Proiso to fix pack 1 or pre-fix pack 3 2. See Documents you need for technology pack upgrade on page 8 for the documents you need to perform this upgrade scenario. 3. See Upgrade scenario 2 (UBA packs only) on page 19 for details. Upgrade scenario for Tioli Netcool/Proiso and Alcatel-Lucent 5620 SAM This section proides information you need to upgrade the Alcatel-Lucent 5620 SAM Technology Pack so that it operates correctly on a Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 system. Important: Design changes in Tioli Netcool/Proiso require you to upgrade Alcatel-Lucent 5620 SAM before upgrading to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. Otherwise, this pack stops working. Table 2 on page 5 identifies the upgrade scenario for Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 and the Alcatel-Lucent 5620 SAM Technology Pack. 4 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

13 Table 2. Alcatel-Lucent 5620 SAM Technology Pack and Tioli Netcool/Proiso upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario description Tioli Netcool/Proiso upgrade You are currently running Tioli Netcool/Proiso upgrade You want to upgrade to fix pack 1 or pre-fix pack 3. Technology pack upgrade You want to upgrade currently deployed Alcatel-Lucent 5620 SAM 4.3-T or 4.3-U UBA Technology Pack to 4.3-V or later. Alcatel-Lucent 5620 SAM upgrade scenario steps Perform the following steps: 1. See Documents you need for technology pack upgrade on page 8 for the documents you need to perform this upgrade scenario. 2. Follow the upgrade instructions described in Alcatel-Lucent 5620 SAM upgrade scenario 3. Upgrade to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. Upgrading the Alcatel-Lucent 5620 SAM Technology Pack The following section discusses how to upgrade the Alcatel-Lucent 5620 SAM Technology Pack according to the following scenario: Alcatel-Lucent 5620 SAM upgrade scenario In this scenario, you currently deployed a 4.3-V Alcatel-Lucent 5620 SAM Technology Pack on Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to upgrade to 4.3-U or later after upgrading to Tioli Netcool/Proiso pre-fix pack 3. Alcatel-Lucent 5620 SAM upgrade scenario In this scenario, you currently deployed a 4.3-V Alcatel-Lucent 5620 SAM Technology Pack on Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to upgrade to 4.3-U or later after upgrading to Tioli Netcool/Proiso pre-fix pack 3. About this task To continue to deploy the 4.3-V Alcatel-Lucent 5620 SAM Technology Pack after upgrading to Tioli Netcool/Proiso pre-fix pack 3, follow these steps: Procedure 1. Upgrade to Tioli Netcool/Proiso pre-fix pack 3 by following the instructions in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of IBM Tioli Netcool Performance Manager. 2. Check the Tioli Netcool Performance Manager product support site for the interim fixes that must be installed so that the Alcatel-Lucent 5620 SAM Technology Pack can operate on Tioli Netcool/Proiso pre-fix pack 3. See Essential information in the technology pack release notes on page 12 for the product support site URL. Note: Stop the Alcatel-Lucent 5620 SAM Technology Pack and DataChannel components before applying the necessary interim fixes on Tioli Netcool Performance Manager pre-fix pack 3. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 5

14 Upgrade scenarios for Tioli Netcool/Proiso and Netflow IPFIX This section proides information you need to upgrade the Netflow IPFIX Technology Pack so that it operates correctly on a Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 system. About this task Important: Design changes in Tioli Netcool/Proiso require you to upgrade the Netflow IPFIX Technology Pack before upgrading to Tioli Netcool/Proiso fix pack 1 or pre- fix pack 3. Otherwise, this pack stops working. Table 3 identifies the upgrade scenarios for Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 and the Netflow IPFIX Technology Pack. Table 3. Netflow IPFIX Technology Pack and Tioli Netcool/Proiso upgrade scenarios Netflow IPFIX upgrade scenario Netflow IPFIX upgrade scenario 1 Netflow IPFIX upgrade scenario 2 Netflow IPFIX upgrade scenario description Tioli Netcool/Proiso upgrade You are currently running Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to upgrade to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. Technology pack upgrade You want to upgrade the currently deployed 4.3-T or 4.3-U Netflow IPFIX Technology Pack to 4.3-V or later. Tioli Netcool/Proiso upgrade You are currently running Tioli Netcool/Proiso You want to update to fix pack 1 or pre-fix pack 3. Technology pack upgrade You want to upgrade currently deployed 4.3-U Netflow IPFIX Technology Pack to 4.3-V or later. Note: The Cisco Netflow Technology Pack is renamed Netflow IPFIX Technology Pack in 4.3-V because it now supports IPFIX. Netflow IPFIX upgrade scenario steps Perform the following steps: 1. See Documents you need for technology pack upgrade on page 8 for the documents you need to perform this upgrade scenario. 2. Follow the upgrade instructions described in Netflow IPFIX upgrade scenario 1 on page 7 3. Upgrade to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. Perform the following steps: 1. See Documents you need for technology pack upgrade on page 8 for the documents you need to perform this upgrade scenario. 2. Follow the upgrade instructions described in Netflow IPFIX upgrade scenario 2 on page 8 3. Upgrade to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3. 6 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

15 Upgrading the Netflow IPFIX Technology Pack The following sections discuss how to upgrade the Netflow IPFIX Technology Pack according to the following scenarios: Netflow IPFIX upgrade scenario 1 Netflow IPFIX upgrade scenario 2 on page 8 Netflow IPFIX upgrade scenario 1 You must perform these steps when upgrading from 4.3-T or 4.3-U. Before you begin You may need to be logged in as root user to perform the following procedure: About this task In this scenario, you want to: Upgrade the currently deployed 4.3-T or 4.3-U Netflow IPFIX Technology Pack to 4.3-V Upgrade to Tioli Netcool/Proiso pre-fix pack 3 Note: The Cisco Netflow Technology Pack is renamed Netflow IPFIX Technology Pack in 4.3-V because it now supports IPFIX. To upgrade to the 4.3-V Netflow IPFIX Technology Pack and Tioli Netcool/Proiso pre-fix pack 3, follow these steps: Procedure Uninstall the preious flow collector before installing the Aurora collector by following these steps: Important: You must perform these steps when upgrading from 4.3-T or 4.3-U. You might need to be logged in as root to perform the following procedure: 1. Stop the currently running flow collector by issuing the following command: /opt/netcool/flowcoll/support/stop_flowcoll 2. Delete S22flowcollstart and K22flowcollstart from the /etc/init.d and /etc/rc3.d directories. 3. Install the 4.3-V Netflow IPFIX Technology Pack using the instructions contained in the 4.3-U/4.3-V technology pack installation appendix proided in the or IBM Tioli Netcool Performance Manager: Installation Guide. 4. Using the root account, install the Aurora adaptor by changing to the following directory: cd /opt/datamart/apfiles/cisco_netflow/adaptor 5. Extract the Aurora tar gunzip file. For example: gunzip aurora sparc.tar.gz tar -xf aurora sparc.tar 6. Change to the aurora directory, and then run the INSTALL script. 7. Configure the 4.3-V Netflow IPFIX Technology Pack by following the instructions contained in the configuration appendix of the 4.3-V IBM Tioli Netcool/Proiso: Netflow IPFIX Technology Pack User's Guide. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 7

16 Note: See Limitations with UBA pack-specific parameter key/alue pairs on page 15 for information related to specifying UBA key/alue pairs. Important: Technology packs might not work unless they are configured. 8. Validate that the Netflow IPFIX Technology Pack is working in the Netflow IPFIX enironment before upgrading to Tioli Netcool/Proiso pre-fix pack 3. What to do next If you are not running the Alcatel-Lucent 5620 SAM Technology Pack 4.3-U or earlier, proceed to the next step. Netflow IPFIX upgrade scenario 2 In this scenario, you want to upgrade currently deployed 4.3-U Netflow IPFIX Technology Pack to 4.3-V or later, after upgrading to Tioli Netcool/Proiso pre-fix pack 3. Documents you need for technology pack upgrade Before upgrading a technology pack, ensure that you hae the documents listed in Table 4. Note: The Tioli Netcool Performance Manager documentation (including IBM Tioli Netcool Performance Manager: Pack Upgrade Guide, and IBM Tioli Netcool Performance Manager: Pack Release Notes and IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide are aailable at the publib.boulder.ibm.com/infocenter/tiihelp/8r1/topic/com.ibm.netcool_pm.doc/ welcome_tnpm.html Table 4. Documents needed to perform a technology pack upgrade Upgrade scenario Documents you need Essential information Upgrade scenario 1 (SNMP and UBA packs) IBM Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide The user guide for the technology pack you are upgrading. IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-U and the later) See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides on page 10 See Essential information in the technology pack release notes on page 12 8 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

17 Table 4. Documents needed to perform a technology pack upgrade (continued) Upgrade scenario Documents you need Essential information Upgrade scenario 2 (UBA packs only) Alcatel-Lucent 5620 SAM upgrade scenario Netflow IPFIX upgrade scenario 1 IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide The ReadMe for pre-fix pack 3 The user guide for the technology pack you are upgrading. IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-V or later) IBM Tioli Netcool/Proiso: Installation Guide (for or 4.4.2) and IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool/Proiso: Technology Pack Upgrade Guide (for 4.3-V) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide IBM Tioli Netcool/Proiso Alcatel 5620 SAM Release 3.0 Technology Pack User's Guide (for 4.3-V) IBM Tioli Netcool/Proiso: Installation Guide (for or 4.4.2) and IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide IBM Tioli Netcool/Proiso Netflow IPFIX Technology Pack User's Guide IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-V or later) See Essential information in the installation guide on page 12 See Essential information in Tioli Netcool/Proiso pre-fix pack 3 ReadMe on page 13 See Essential information in the technology pack user guides on page 10 See Essential information in the technology pack release notes on page 12 See Essential information in the installation guide on page 12 See Essential information in the technology pack release notes on page 12 See Essential information in the technology pack user guides on page 10 See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides on page 10 See Essential information in the technology pack release notes on page 12 Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 9

18 Table 4. Documents needed to perform a technology pack upgrade (continued) Upgrade scenario Documents you need Essential information Netflow IPFIX upgrade scenario 2 IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide IBM Tioli Netcool/Proiso Netflow IPFIX Technology Pack User's Guide (for 4.3-V) IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-V) See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides See Essential information in the technology pack release notes on page 12 Essential information in the technology pack user guides Table 5. Documents needed to perform a technology pack upgrade Upgrade scenario Documents you need Essential information Upgrade scenario 1 (SNMP and UBA packs) Upgrade scenario 2 (UBA packs only) IBM Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide The user guide for the technology pack you are upgrading. IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-U and the later) IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Pack Upgrade Guide The ReadMe for pre-fix pack 3 The user guide for the technology pack you are upgrading. IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-V or later) See Upgrading Tioli Netcool/Proiso See Essential information in the technology pack release notes on page 12 See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides See Upgrading Tioli Netcool/Proiso See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides See Essential information in Tioli Netcool/Proiso pre-fix pack 3 ReadMe on page 13 See Essential information in the technology pack release notes on page IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

19 Table 5. Documents needed to perform a technology pack upgrade (continued) Upgrade scenario Documents you need Essential information Alcatel-Lucent 5620 SAM upgrade scenario IBM Tioli Netcool Performance Manager: Pack Upgrade Guide IBM Tioli Netcool/Proiso: Technology Pack Upgrade Guide (for 4.3-V) IBM Tioli Netcool/Proiso: Installation Guide (for or 4.4.2) and IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool/Proiso Alcatel 5620 SAM Release 3.0 Technology Pack User's Guide (for 4.3-V) See Upgrading Netcool/Proiso See Essential information in the technology pack release notes on page 12 See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides on page 10 Netflow IPFIX upgrade scenario 1 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-V or later) IBM Tioli Netcool/Proiso: Installation Guide (for or 4.4.2) and IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) See Upgrading Netcool/Proiso See Essential information in the technology pack release notes on page 12 See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides on page 10 IBM Tioli Netcool/Proiso Netflow IPFIX Technology Pack User's Guide Netflow IPFIX upgrade scenario 2 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide IBM Tioli Netcool Performance Manager: Technology Pack Release Notes (for 4.3-V) IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool/Proiso Netflow IPFIX Technology Pack User's Guide (for 4.3-V) See Upgrading Netcool/Proiso See Essential information in the technology pack release notes on page 12 See Essential information in the installation guide on page 12 See Essential information in the technology pack user guides on page 10 The following information is essential to perform a pack upgrade: (SNMP and UBA packs) Configuration appendix - Each technology pack user's guide contains a configuration appendix. After upgrading a technology pack to a later ersion, you must perform the configuration steps described in the configuration appendix. The sections in this appendix that describe the upgrade scenarios specify when you must refer to the configuration appendix in the user's guide for the pack you are upgrading. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 11

20 (UBA packs only) - Each UBA technology pack user's guide also contains the following appendixes: UBA Parameters Reference (Tioli Netcool/Proiso and Higher) This appendix proides UNIX reference pages for each of the pack-specific UBA parameters supplied with the XSD file for the UBA technology pack. The descriptions are the same as those descriptions that display in the Topology Editor Help. Note: Some of the upgrade scenarios cause the Topology Editor to treat these pack-specific UBA parameters as free form custom parameters. Thus, the Topology Editor is be unable to display the associated Help. For more information, see Current limitations with Tioli Netcool/Proiso fix pack 1 and pre-fix pack 3 on page 13. Essential information in the technology pack release notes The following information in the technology pack release notes is essential when performing a technology pack upgrade: Complete list of supported technology packs table in Appendix A of the Release Notes- The following columns of the table are of particular interest: Technology pack - Specifies the name of the technology pack. Type - Specifies the type of technology pack you are upgrading. The pack configuration steps and pack upgrade steps differ, depending on the pack type. Upgradeable from - Indicates whether the pack you are upgrading supports an upgrade path. If this column displays No upgrade path then this technology pack does not support an upgrade. The pack upgrade procedures described in this chapter do not succeed. Dependencies - Specifies whether the pack has any dependencies. For example, some packs require that the MIB-II technology pack to be installed. Interim fixes for Tioli Netcool/Proiso and Interim fixes for Tioli Netcool Performance Manager 1.3 table - The following columns of the table are of particular interest: Pack - Gies the name of the technology Pack Interim fix - Gies the name of the interim fix for that technology pack Important: Before upgrading (installing) any technology pack, check the Tioli Netcool Performance Manager product support site for the latest interim fixes. Since status of interim fixes is subject to change at any time, it is important that you do this. The site address is: NetcoolProiso.html Note: To receie announcements about new interim fixes, you might sign up for updates or subscribe to the Tioli Netcool/Proiso support RSS feed. These options are aailable on the support page. Essential information in the installation guide This information is essential to performing a technology pack upgrade. Upgrade scenario 1 - Refer to the technology pack installation chapter proided in the IBM Tioli Netcool/Proiso: Installation Guide. Because there is an existing UBA Collector, you can skip the section that describes how to add UBA 12 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

21 Collectors. See Upgrade scenario 1 (SNMP and UBA technology packs) on page 17 for more details. Upgrade scenario 2 - Refer to the technology pack installation chapter proided in the IBM Tioli Netcool/Proiso: Installation Guide. Because you are instructed on how to associate an existing XSD file with the upgraded pack's XSD file, you can skip the section that describes how to add UBA Collectors. See Upgrade scenario 2 (UBA packs only) on page 19 for more details. Netflow IPFIX upgrade scenario 1 - Refer to the 4.3-U/4.3-V technology pack installation appendix proided in the or IBM Tioli Netcool/Proiso: Installation Guide. You need these instructions to upgrade (install) the 4.3-V ersions of these packs. Refer to the IBM Tioli Netcool/Proiso: Installation Guide to install Tioli Netcool/Proiso Alcatel-Lucent 5620 SAM upgrade scenario and Netflow IPFIX upgrade scenario 2 - There is no need to refer to the IBM Tioli Netcool/Proiso: Installation Guide because you are not upgrading the Alcatel-Lucent 5620 SAM Technology Pack or Netflow IPFIX Technology Pack in these scenarios. Essential information in Tioli Netcool/Proiso pre-fix pack 3 ReadMe The Tioli Netcool/Proiso pre-fix pack 3 ReadMe contains the instructions for updating Tioli Netcool/Proiso to pre-fix pack 3. See Essential information in the technology pack release notes on page 12 for the URL to the site address for interim fixes and fix packs. Current limitations with Tioli Netcool/Proiso fix pack 1 and pre-fix pack 3 Starting in 4.3-U, each UBA technology pack is deliered with an XML Schema Definition (XSD) file. Each pack's XSD file describes and alidates pack-specific parameters (referred to as properties in the Topology Editor enironment) using an XML format. Typical pack-specific properties defined in these XSD files include DELETEONACQUIRE, DESIGNFILE, and URI. In fact, the pack-specific properties defined in XSD files map almost one-to-one with the UBA pack-specific parameters deliered in UBA pack dc.cfg template files. Using the Topology Editor, you add a UBA Collector for a specific UBA pack. This task inoles loading the pack's XSD file into an existing topology configuration (represented by the topology.xml file). After you load the pack's XSD file, the Topology Editor displays all of the pack-specific UBA properties. Using the Topology Editor, you modify these pack-specific UBA properties. When you deploy a topology configuration using a topology.xml file, the alues specified for these properties are written to the database. The Topology Editor makes it easier for you to supply site-specific alues to these UBA properties because there is a built-in logic in the XSD files. For example, the DESIGNFILE property definition in the XSD file is set to read-only because the alue for this property must neer be changed. The Topology Editor enforces that state by displaying the property and its alue as read-only. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 13

22 The preious scenario describes a new installation of Tioli Netcool/Proiso core components and a UBA technology pack. When you upgrade to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3, howeer, the following limitations exist: Limitations with the way the Topology Editor treats pack-specific UBA parameters Limitations with UBA parameter key/alue pairs Limitations with how the Topology Editor treats UBA pack-specific parameters When you upgrade Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3, no XSDs are assigned to deployed UBA Collectors. In this case, the Topology Editor treats pack-specific UBA properties for deployed UBA packs as free form, custom settings. Thus, the Topology Editor cannot proide the appropriate alidation of settings as it normally would during a typical pack installation. Table 6 describes the current limitations associated with how the Topology Editor treats UBA pack-specific property settings for the upgrade scenarios described in Upgrade scenarios for Tioli Netcool/Proiso and technology packs on page 3. Note: SNMP technology packs do not hae associated XSD files. Table 6. Current limitations with Topology Editor and UBA pack-specific properties Upgrade scenario Upgrade Scenario 1 Current limitations (UBA Packs Only) The Topology Editor treats the UBA pack-specific property settings for currently deployed UBA packs as free form, custom settings because there are no XSD files associated with the UBA Collectors. There is nothing you need to do with these custom settings. Howeer, if you want to modify any of the UBA pack-specific property settings, you would need to modify the custom setting, which means the Topology Editor cannot proide the appropriate alidation of settings as it normally would during a typical pack installation. In addition, the Topology Editor cannot display any associated Help text. In this case, you would need to refer to the UBA Parameters Reference (Tioli Netcool Performance Manager 443 and Higher) appendix in this UBA pack's user guide. 14 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

23 Table 6. Current limitations with Topology Editor and UBA pack-specific properties (continued) Upgrade scenario Upgrade Scenario 2 Current limitations (UBA Packs Only) The Topology Editor treats the UBA pack-specific property settings for the upgraded UBA pack as free form, custom settings because there is no XSD file associated with the deployed UBA Collector. In this scenario, you need to erify (using the dc.cfg template file) that the site-specific alues for the pack-specific UBA properties are correct, as discussed in Upgrade scenario 1 (SNMP and UBA technology packs) on page 17. Note: The Topology Editor identifies custom properties with a check mark in the Is Custom column of the Properties and Adanced Properties tabs. Limitations with UBA pack-specific parameter key/alue pairs Design changes in Tioli Netcool/Proiso affect UBA pack-specific parameter key/alue pairs as follows: Each UBA parameter key/alue pair is limited to 40 characters. Each UBA parameter key must be specified in uppercase. Note: For the Alcatel-Lucent 5620 SAM Technology Pack, the preious limitations also apply to the BLB and SAMIF key/alue pairs. The following example shows a UBA pack-specific parameter key/alue pair from the Alcatel-Lucent 5620 SAM Technology Pack's dc.cfg template file that adheres to the preiously described limitations: UBA ALCATEL_5620_SAM.SAM_EQUIPMENT_INTERFACE.DELETEONACQUIRE=true In this example, the key/alue pair consists of the pack-specific UBA parameter DELETEONACQUIRE and its associated alue true. Before you begin a technology pack upgrade About this task Before upgrading a technology pack, ensure that you hae done the following steps: Procedure Consulted the latest ersion of theibm Tioli Netcool Performance Manager: Pack Release Notes. For more information about specific sections to consult before performing the pack upgrade, see Essential information in the technology pack release notes on page 12. Consulted with your IBM Professional Serices representatie before upgrading a technology pack. Your IBM Professional Serices Representatie makes use of the documentation sources described in Documents you need for technology pack upgrade on page 8. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 15

24 CAUTION: If you hae a customized technology pack installed at your site with modified content, it is oerwritten if the same pack is upgraded to a later ersion. Check with your IBM customer serice representatie before upgrading an existing technology pack to a later ersion. The correct ersion of Jaa. For more information, see Essential information in the technology pack release notes on page 12. Access to the product distribution site: On the product distribution site is the ProisoPackInstaller.jar file, the bundled JAR file, and indiidual stand-alone technology pack JAR files. Access to the following site to check for interim fixes or fix packs that might apply to your technology pack: For more information, see Essential information in the technology pack release notes on page 12. Access to the Tioli Netcool Performance Manager documentation, technology pack users' guides, and technology pack release notes, which are aailable at the Tioli Netcool Information Center For more information about what to look for in the documents required for technology pack upgrades, see Documents you need for technology pack upgrade on page 8. Used the following GUI components that were introduced in Tioli Netcool/Proiso 4.4.3: Topology Editor, including: - How to work with UBA technology pack XSD files (see Current limitations with Tioli Netcool/Proiso fix pack 1 and pre-fix pack 3 on page 13 for current limitations.) - How to work with custom properties Read and understood the upgrade scenarios described in this chapter. Standard procedure for upgrading technology packs (Except Alcatel-Lucent 5620 SAM and Netflow IPFIX) About this task The following sections discuss how to upgrade technology packs according to the following scenarios: Upgrade scenario 1 (SNMP and UBA technology packs) on page 17 Upgrade scenario 2 (UBA packs only) on page 19 Important: See Upgrading the Alcatel-Lucent 5620 SAM Technology Pack on page 5 and Upgrading the Netflow IPFIX Technology Pack on page 7 for instructions on how to perform the upgrade scenarios for these technology packs. 16 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

25 Upgrade scenario 1 (SNMP and UBA technology packs) About this task You are currently running Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to do the following: Upgrade to Tioli Netcool/Proiso pre-fix pack 3 (which you do before performing the pack upgrade by following the instructions in the IBM Tioli Netcool Performance Manager: Technology Pack Upgrade Guide that relates to your ersion of Tioli Netcool/Proiso). Upgrade currently deployed technology packs to 4.3-U or later. To upgrade currently deployed technology packs to 4.3-U or later, follow these steps: Procedure 1. Upgrade the technology pack to 4.3-U or later by following the instructions in the installing technology packs chapter proided in the IBM Tioli Netcool/Proiso: Installation Guide Note: (UBA packs only) Because there is an existing UBA Collector, you can skip the section that describes how to add UBA Collectors. 2. (For SNMP packs only) Configure the SNMP technology pack you upgraded, by referring to the configuration appendix of the appropriate technology pack user's guide. Important: Technology packs does not work unless they are configured. 3. Perform the following steps (for UBA packs only): a. Use the Topology Editor to display the pack-specific UBA properties. Remember that these properties are displayed as free form, custom properties. 4. Optional: If you must add a custom property, follow these steps: a. Open the Topology Editor. b. Open the topology associated with the UBA pack you upgraded. c. In the Application Pack iew, select the UBA pack you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific properties display in the properties window. e. Select the blue + (plus) icon that displays at the right top corner of the properties window. The Add Custom Property for UBA Collector wizard displays. f. The wizard displays three fields: Name - Specifies the pack-specific UBA property to associate with a UBA pack sub-element. Value - Specifies the alue associated with this pack-specific UBA property. Alias - Specifies the name of the property that the Topology Editor displays in the Property iew. Valid alues include the pack-specific UBA property name specified in the Name field or descriptie text. g. Specify the name of the new UBA pack-specific parameter in the Name field. In this example, the name specified would be ERRORFILEMAX. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 17

26 Note: Do not enter the channel number (<CHANNEL>, collector number(<collector>, instance (UNIV_WAN_MGR, and schema(avail) inthe Name field. h. Specify a alue in the Alias field according to the preiously discussed guidelines. In this example, ERRORFILEMAX is specified. i. Click Finish. 5. (Optional) If you must delete (remoe) a custom property, follow these steps: a. Open the Topology Editor. b. Open the topology associated with the UBA pack you upgraded. c. In the Application Pack iew, select the UBA pack you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific parameters display in the properties window. e. Select the pack-specific UBA custom property to remoe in the Properties or Adanced Properties tab. f. Click the Remoe Custom Property (a red X icon that appears in the Property iew). 6. After you alidate the UBA pack-specific properties: a. Redeploy the updated topology, as described in the IBM Tioli Netcool/Proiso: Installation Guide. 7. Configure the UBA technology pack you upgraded, by referring to the configuration appendix of the appropriate technology pack user guide. Important: Technology packs does not work unless they are configured. Table 7. Example Mappings for Ciena Transmission Technology Pack Template file parameter UBA INSTANCES= streaming UBA streaming. DESIGNFILE= CienaAdaptor.js Topology Editor property INSTANCES=CIENA_DEVICE CIENA_DEVICE. DESIGNFILE= CienaAdaptor.js Comments The INSTANCES parameter used to be an arbitrary string as illustrated by the string streaming specified in the template file parameter. The conention now is to use a string that represents the name of the technology pack, as illustrated by the Topology Editor property alue, CIENA_DEVICE. Note: It is not necessary to specify the channel number, collector number, and schema in the alues for the Topology Editor properties. See Step 4-g for an example of how to enter the name of a new UBA pack-specific parameter. The Bulk Adaptor Design file (in this case, CienaAdaptor.js) must be the same in both the template file parameter and the Topology Editor property. 18 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

27 Table 7. Example Mappings for Ciena Transmission Technology Pack (continued) Template file parameter Topology Editor property Comments UBA streaming.CEMS.URI= file:///export/ home/puser/ uba_files/cems/ input/*.cs CIENA_DEVICES.CEMS.URI=$5f $4/*.cs The alue in the template file for the URI parameter is typically an example URL specification. The URI property in the Topology Editor is typically read-only and its associated alue is a concatenation of the following properties: INPUT_USE_SECURE_FTP ($5) INPUT_FTP_HOST ($3) INPUT_FTP_USERNAME ($1) INPUT_FTP_PASSWORD ($2) INPUT_DIRECTORY ($4) Note: The alues ($1 through $5) specified here are taken from the Ciena Transmission Technology Pack's XSD file to show the concatenation of properties. Because there is no XSD, you must specify the URL specification in the URI property, not the indiidual properties listed aboe. UBA streaming. DELETEONACQUIRE= false CIENA_DEVICE.CEMS. DELEATEONACQUIRE=false In this example, the DELETEONACQUIRE parameter in the template file and the Topology Editor property hae the same alue (false). This might not always be the case. Upgrade scenario 2 (UBA packs only) Before you begin The Topology Editor maintains the association with the existing XSD file. Therefore, it erifies the alues currently specified for the UBA pack-specific property settings. In this scenario, you perform the following steps: Currently you deployed 4.3-U UBA technology packs running on Tioli Netcool/Proiso Completed the update of Tioli Netcool/Proiso to pre-fix pack 3 by following the instructions in the pre-fix pack 3 ReadMe Want to upgrade currently deployed 4.3-U technology packs to 4.3-V or later About this task To upgrade currently deployed 4.3-U technology packs to 4.3-V or later, follow these steps: Procedure 1. Update the UBA technology pack metadata by following these steps: a. Open the Topology Editor. b. Create a new empty topology by selecting File > create new topology. Retain the default number of resources as this operation is only necessary to populate the Application Pack iew. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 19

28 c. In the Application Pack iew, right-click the Application Packs folder and select Load Application Pack from the menu. d. Naigate to the directory where you copied the new stand-alone (or bundled) JAR file. The Topology Editor displays a message warning that the XSD exists. The message also asks if you want to replace the XSD. Specify that you want to replace the XSD. e. After replacing the XSD, close the Topology Editor. You successfully replaced the UBA technology pack metadata. 2. Reopen the Topology Editor and select the existing deployed topology (topology.xml). The UBA pack-specific properties are applied to the existing deployed topology according to the following rules: Properties that were added to the pack XSD displays in the Property tab with their default alues. You can modify, if necessary, any writable properties. Properties that were remoed in the XSD shows in the Property tab as custom properties. If not needed, you can remoe these properties by following these instructions: a. Open the Topology Editor. b. Open the topology associated with the UBA pack you upgraded. c. In the Application Pack iew, select the UBA pack you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific parameters display in the properties window. e. Select the pack-specific UBA custom property to remoe in the Properties or Adanced Properties tab. f. Click the Remoe Custom Property (a red X icon that appears in the Property iew). 3. Redeploy the updated topology, as described in the IBM Tioli Netcool Proiso: Installation Guide. 4. Use the dccmd command to stop the UBA application: dccmd -action stop UBA 5. Upgrade the 4.3-U UBA technology pack to 4.3-V or later by following the instructions proided in the pack installation chapter of the IBM Tioli Netcool/Proiso: Installation Guide. Note: Because there is an existing UBA Collector, you can skip the section that describes how to add UBA Collectors. 6. Configure the UBA technology pack you upgraded, by referring to the configuration appendix of the appropriate technology pack user guide. One of the configuration steps instructs you to restart the DataChannel to actiate the UBA and read in changes to the deployed topology. Important: Technology packs do not work unless they are configured. 20 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

29 Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager This chapter describes how to upgrade your technology packs, after you upgraded to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. If you upgraded to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3, you must follow the upgrade instructions presented in Chapter 2, Upgrading technology packs on Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3, on page 3. Oeriew This chapter explains how to upgrade technology packs after you upgrade your Tioli Netcool Performance Manager system. Specifically, the chapter proides instructions on how to upgrade technology packs according to seeral upgrade scenarios. For UBA technology packs, the chapter also proides: Information about what to expect regarding UBA pack-specific property settings for deployed packs when upgrading to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager ( Topology Editor and UBA pack-specific properties on page 32.) Guidelines for erifying UBA technology pack-specific properties when upgrading a UBA technology pack after upgrading to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager ( Topology Editor and UBA pack-specific properties on page 32.) Specific upgrade scenarios for the following technology packs: Alcatel-Lucent 5620 SAM Technology Pack. For more information, see Upgrade scenario for Tioli Netcool/Proiso and Alcatel-Lucent 5620 SAM on page 4. Netflow IPFIX Technology Pack. For more information, see Upgrade scenarios for Tioli Netcool/Proiso and Netflow IPFIX on page 6. Important: Design changes in Tioli Netcool/Proiso require that you must upgrade Alcatel-Lucent 5620 SAM and Netflow IPFIX before upgrading from Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, and to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Otherwise, these packs stop working. See also the IBM Tioli Netcool Performance Manager: Technology Pack Release Notes to determine the ersion from which a technology pack is upgradeable. For example, the IBM Tioli Netcool Performance Manager: Pack Release Notes might specify that your technology pack is upgradeable from ersion 4.3-V or later. Copyright IBM Corp. 1997,

30 Upgrade scenarios for Tioli Netcool/Proiso and Tioli Netcool Performance Manager technology packs This section proides information you need to upgrade technology packs so that they operate correctly on a Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager system. Table 8 identifies the upgrade scenarios for Tioli Netcool/Proiso and technology packs. Table 8. Tioli Netcool Performance Manager and technology pack upgrade scenarios Upgrade scenario Upgrade scenario 1 (SNMP and UBA packs) Upgrade scenario 2 (UBA packs only) Upgrade scenario description Tioli Netcool Performance Manager upgrade You are currently running Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Technology pack upgrade You want to upgrade currently deployed technology packs to 4.3-U or later. Tioli Netcool/Proiso fix pack update You are currently running Tioli Netcool/Proiso You want to update to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Technology pack upgrade You want to upgrade currently deployed 4.3-U UBA technology packs to 4.3-V or later. Upgrade scenario steps Perform the following steps: 1. Upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. 2. See Documents you need to perform a technology pack upgrade on page 27 for the documents you must perform this upgrade scenario. 3. See Upgrade scenario 1 (SNMP and UBA technology packs) (except Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 43 for details about this upgrade scenario. Perform the following steps: 1. Upgrade Tioli Netcool/Proiso to fix pack 3 or Tioli Netcool Performance Manager 2. See Documents you need to perform a technology pack upgrade on page 27 for the documents you must perform this upgrade scenario. 3. See Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 53 for details. 22 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

31 Upgrade scenario for Tioli Netcool/Proiso and Alcatel-Lucent 5620 SAM This section proides information you need to upgrade the Alcatel-Lucent 5620 SAM Technology Pack so that it operates correctly on a Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 system. Important: Design changes in Tioli Netcool/Proiso require you to upgrade Alcatel-Lucent 5620 SAM before upgrading to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Otherwise, this pack stops working. Table 9 identifies the upgrade scenario for Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager and the Alcatel-Lucent 5620 SAM Technology Pack. Table 9. Alcatel-Lucent 5620 SAM Technology Pack and Tioli Netcool/Proiso upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario description Tioli Netcool/Proiso upgrade You are currently running Tioli Netcool/Proiso You want to upgrade to fix pack 3 or Tioli Netcool Performance Manager. Technology pack upgrade You want to upgrade the currently deployed Alcatel-Lucent 5620 SAM 4.3-T or 4.3-U UBA Technology Pack to the IBM Tioli Netcool Performance Manager: Pack Release Notes.Tioli Netcool Performance Manager Release. Alcatel-Lucent 5620 SAM upgrade scenario steps Perform the following steps: 1. Documents you need for technology pack upgrade on page 8 for the documents you must perform this upgrade scenario. 2. Follow the upgrade instructions described in Alcatel- Lucent 5620 SAM upgrade scenario. 3. Upgrade to Tioli Netcool/ Proiso fix pack 1 or pre-fix pack 3. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 23

32 Upgrading the Alcatel-Lucent 5620 SAM Technology Pack Example The following section discusses how to upgrade the Alcatel-Lucent 5620 SAM Technology Pack according to the following scenario: Important: Tioli Netcool/Proiso Technology Pack Installer or later is required for the upgrade to Alcatel-Lucent 5620 SAM 4.3-Y or later technology pack. Alcatel-Lucent 5620 SAM upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario Follow the instructions for upgrade scenario, as described in Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 53. Important: For more information about upgrading from preious releases of the Alcatel-Lucent 5620 SAM Technology Pack to Alcatel-Lucent 5620 SAM Technology Pack for Alcatel-Lucent 5620 SAM Serer Release 9, see Alcatel-Lucent 5620 SAM Technology Pack User Guide. Upgrade scenarios for Tioli Netcool/Proiso or Tioli Netcool Performance Manager and Netflow IPFIX This section proides information you need to upgrade the Netflow IPFIX Technology Pack so that it operates correctly on a Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager system. About this task Important: Design changes in Tioli Netcool/Proiso require you to upgrade the Netflow IPFIX Technology Pack before upgrading from Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, and to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Otherwise, this pack stops working. Table 10 on page 25 identifies the upgrade scenarios for Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager and the Netflow IPFIX Technology Pack. 24 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

33 Table 10. Netflow IPFIX Technology Pack and Tioli Netcool Performance Manager upgrade scenarios Netflow IPFIX upgrade scenario Netflow IPFIX upgrade scenario 1 Netflow IPFIX upgrade scenario 2 Netflow IPFIX upgrade scenario description Tioli Netcool Performance Manager upgrade You are currently running Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Technology pack upgrade You want to upgrade the currently deployed 4.3-V Netflow IPFIX Technology Pack to 4.3-W or later. Tioli Netcool/Proiso fix pack update You are currently running Tioli Netcool/Proiso You want to upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Technology pack upgrade You want to upgrade a currently deployed Netflow IPFIX 4.3-V UBA Technology Pack to 4.3-X or later. Netflow IPFIX upgrade scenario steps Perform the following steps: See Documents you need to perform a technology pack upgrade on page 27 for the documents you must perform this upgrade scenario. Follow the upgrade instructions described in Netflow IPFIX upgrade scenario 1 on page 26 Upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. Perform the following steps: Upgrade Tioli Netcool/Proiso to fix pack 3 or Tioli Netcool Performance Manager. See Documents you need to perform a technology pack upgrade on page 27 for the documents you must perform this upgrade scenario. See Netflow IPFIX upgrade scenario 2 on page 27 for details. Upgrading the Netflow IPFIX Technology Pack About this task The following sections discuss how to upgrade the Netflow IPFIX Technology Pack according to the following scenarios: Netflow IPFIX upgrade scenario 1 on page 26 Netflow IPFIX upgrade scenario 2 on page 27 Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 25

34 Netflow IPFIX upgrade scenario 1 About this task In this scenario, you want to do the following: Upgrade the currently deployed 4.3-U or 4.3-V Netflow IPFIX Technology Pack to 4.3-X or later. Upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. To upgrade to the 4.3-X or later Netflow IPFIX Technology Pack and Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, follow these steps: Procedure 1. Uninstall the preious flow collector before installing the Aurora collector by following these steps: Important: You must perform these steps when upgrading from 4.3-U or 4.3-V. You might need to be logged in as root to perform the following procedure: a. Stop the currently running flow collector by issuing the following command: /opt/netcool/flowcoll/support/stop_flowcoll b. Delete S22flowcollstart and K22flowcollstart from the /etc/init.d and /etc/rc3.d directories. c. Install the 4.3-V Netflow IPFIX Technology Pack using the instructions contained in the 4.3-U/4.3-V technology pack installation appendix proided in the or IBM Tioli Netcool/Proiso: Installation Guide. d. Using the root account, install the Aurora adaptor by changing to the following directory: cd /opt/datamart/apfiles/cisco_netflow/adaptor e. Extract the Aurora tar gunzip file. For example: gunzip aurora sol9-sparc.tar.gz tar -xf aurora sol9-sparc.tar f. Change to the aurora directory and run the INSTALL script. 2. Configure the 4.3-X Netflow IPFIX Technology Pack by following the instructions contained in the configuration appendix of the 4.3-X IBM Tioli Netcool/Proiso Netflow IPFIX Technology Pack User Guide. Note: See Limitations with UBA pack-specific parameter key/alue pairs on page 34 for information related to specifying UBA key/alue pairs. Important: Technology packs do work unless they are configured. 3. Validate that the Netflow IPFIX Technology Pack is working in the Netflow IPFIX enironment before upgrading to Tioli Netcool/Proiso Upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager by following the instructions in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of Tioli Netcool Performance Manager. 26 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

35 Netflow IPFIX upgrade scenario 2 Follow the instructions for upgrade scenario 2, as described in Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 53. Documents you need to perform a technology pack upgrade Before upgrading a technology pack, ensure that you hae the documents listed in Table 11. Note: The Tioli Netcool Performance Manager documentation (including IBM Tioli Netcool Performance Manager: Upgrade Guide), IBM Tioli Netcool Performance Manager: Pack Release Notes and IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide that are aailable at the following website: Table 11. Documents you need to perform a technology pack upgrade Upgrade scenario Upgrade scenario 1 (SNMP and UBA packs) Documents you need IBM Tioli Netcool Performance Manager: Installation Guide IBM Tioli Netcool Performance Manager: Upgrade Guide IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide IBM Tioli Netcool Performance Manager: Pack Release Notes Essential information See Essential Information in the Installation Guide on page 31 See Essential information in the pack installation and configuration guide on page 30 See Essential information in pack release notes on page 31 Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 27

36 Table 11. Documents you need to perform a technology pack upgrade (continued) Upgrade scenario Upgrade scenario 2 (UBA packs only) Documents you need IBM Tioli Netcool Performance Manager: Installation Guide IBM Tioli Netcool Performance Manager: Upgrade Guide The Fix pack 3 (or later) ReadMe IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide IBM Tioli Netcool Performance Manager: Pack Release Notes (for 4.3-U or later) Essential information See Essential Information in the Installation Guide on page 31 See Essential information in the Tioli Netcool/ Proiso fix pack 3 or Tioli Netcool Performance Manager ReadMe on page 32 See Essential information in the pack installation and configuration guide on page 30 See Essential information in pack release notes on page IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

37 Table 11. Documents you need to perform a technology pack upgrade (continued) Upgrade scenario Alcatel-Lucent 5620 SAM upgrade scenario Netflow IPFIX upgrade scenario 1 Documents you need IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Upgrade Guide IBM Tioli Netcool Performance Manager: Alcatel-Lucent 5620 SAM Technology Pack User Guide IBM Tioli Netcool Performance Manager: Pack Release Notes (for January 2012 release) IBM Tioli Netcool/Proiso: Installation Guide (for or 4.4.2) IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Upgrade Guide IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide IBM Tioli Netcool Performance Manager: Pack Release Notes (for January 2012 release) Essential information See Essential information in pack release notes on page 31 See Essential Information in the Installation Guide on page 31 See Essential information in the pack installation and configuration guide on page 30 See Alcatel- Lucent 5620 SAM upgrade scenario on page 24 See Essential Information in the Installation Guide on page 31 See Essential information in the pack installation and configuration guide on page 30 See Essential information in pack release notes on page 31 Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 29

38 Table 11. Documents you need to perform a technology pack upgrade (continued) Upgrade scenario Netflow IPFIX upgrade scenario 2 Documents you need Essential information IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.3) IBM Tioli Netcool Performance Manager: Upgrade Guide IBM Tioli Netcool Performance Manager: Netflow IPFIX Technology Pack User Guide IBM Tioli Netcool/Proiso Technology Pack: Release Notes (for 4.3-X) See Essential information in pack release notes on page 31 See Essential Information in the Installation Guide on page 31 See Essential information in the pack installation and configuration guide See Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 53 Essential information in the pack installation and configuration guide The following information is essential for performing a pack upgrade: (SNMP and UBA packs) Configuration- the IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide contains a configuration chapter. After upgrading a technology pack to a later ersion, you must perform the configuration steps described in the configuration chapter. The sections in this chapter that describe the upgrade scenarios specify when you must refer to the configuration chapter in IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide for the pack you are upgrading. Note: Before Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, some of the upgrade scenarios caused the Topology Editor to treat these pack-specific UBA properties as free from custom properties. Thus, the Topology Editor was unable to display the associated Help. For information about how Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager corrects these limitations, see Topology Editor and UBA pack-specific properties on page IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

39 Essential information in pack release notes The following information in the pack release notes is essential when performing a pack upgrade: Complete list of Supported technology packs table - The following columns of the table are of particular interest: Technology pack - Specifies the name of the technology pack. Type - Specifies the type of technology pack you are upgrading. The pack configuration steps and technology pack upgrade steps differ, depending on the technology pack type. Upgradeable from - Indicates whether the pack you are upgrading supports an upgrade path. If this column displays No upgrade path, then this technology pack does not support an upgrade. The pack upgrade procedures described in this chapter do not succeed. Dependencies - Specifies whether the pack has any dependencies. For example, some packs require that the MIB-II technology pack to be installed. Interim fixes for Tioli Netcool/Proiso and Interim fixes for Tioli Netcool Performance Manager 1.3 and aboe table - The following columns of the table are of particular interest: Pack - Gies the name of the technology Pack Interim fix - Gies the name of the interim fix for that technology pack Important: Before upgrading (installing) any technology pack, check the Tioli Netcool Performance Manager product support site for the latest interim fixes. Since status of interim fixes is subject to change at any time, it is important that you do this procedure. The site address is: NetcoolProiso.html Note: To receie announcements about new interim fixes, you might sign up for updates or subscribe to the Tioli Netcool Performance Manager support RSS feed. These options are aailable on the support page. Essential Information in the Installation Guide The following information is essential to performing a technology pack upgrade: For Upgrade Scenario 1 - Refer to the appropriate technology pack installation appendix proided in the IBM Tioli Netcool Performance Manager: Installation Guide. Because there is an existing UBA collector, you can skip the section that describes how to add UBA collectors. See Upgrade scenario 1 (SNMP and UBA technology packs) (except Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 43 for more details. For Upgrade Scenario 2, Alcatel-Lucent 5620 SAM Upgrade Scenario, and Netflow Upgrade Scenario 2- Refer to the appropriate technology pack installation appendix proided in the IBM Tioli Netcool Performance Manager: Installation Guide. Because you are instructed on how to associate an existing XSD file with the upgraded pack XSD file, you can skip the section that describes how to add UBA collectors. See Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 53 for more details. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 31

40 Essential information in the Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager ReadMe The Tioli Netcool/Proiso fix pack ReadMe contains the instructions for updating Tioli Netcool/Proiso to the latest fix pack (in this case fix pack 3 or Tioli Netcool Performance Manager). See Essential information in pack release notes on page 31 for the URL to the site address for interim fixes and fix packs. Topology Editor and UBA pack-specific properties Starting from 4.3-U, each UBA technology pack deliers with an XML Schema Definition (XSD) file. Each pack XSD file describes and alidates pack-specific parameters (referred to as properties in the Topology Editor enironment) using an XML format. Typical pack-specific properties defined in these XSD files include DELETEONACQUIRE, DESIGNFILE, and URI. Note: Before Tioli Netcool/Proiso 4.4.3, you added the pack-specific UBA parameters deliered in the pack template file to the deployed dc.cfg file. This is no longer required in Tioli Netcool/Proiso Using the Topology Editor, you add a UBA collector for a specific UBA pack. This task inoles loading the pack XSD file into an existing topology configuration (represented by the topology.xml file). After you load the pack XSD file, the Topology Editor displays all of the pack-specific UBA properties. For some more complicated UBA technology packs, adding a UBA collector causes the Topology Editor to also display pack-specific BLB (Bulk Load Balancer) and IF (Inentory File) properties. Using the Topology Editor, you modify these pack-specific UBA properties (and pack-specific BLB and IF properties if the pack defines these components in its XSD file). When you deploy a topology configuration using a topology.xml file, the alues specified for these properties are written to the database. The Topology Editor makes it easier for you to supply site-specific alues to these UBA properties because there is a built-in logic in the XSD files. For example, the DESIGNFILE property definition in the XSD file is set to read-only because the alue for this property must neer be changed. The Topology Editor enforces that state by displaying the property and its alue as read-only. The preious scenario describes a new installation of Tioli Netcool/Proiso core components and a UBA technology pack. Before Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, when you upgraded to Tioli Netcool/Proiso fix pack 1 or pre-fix pack 3 the following limitations existed: Limitations with the way the Topology Editor treated pack-specific UBA parameters Limitations with UBA parameter key/alue pairs Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager remoes the limitations with the way the Topology Editor treats pack-specific parameters by proiding a feature in the Topology Editor called the Technology pack XSD upgrade wizard. Howeer, Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager does not remoe the limitations with UBA parameter key/alue pairs. 32 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

41 The following sections describe the Technology pack XSD upgrade wizard and the Limitations associated with UBA parameter key/alue pairs. Technology pack XSD upgrade wizard The GUI and Technology Pack Installer (introduced in Tioli Netcool/Proiso and 4.3-U) make it easier to install and configure technology packs. The current technology pack release continues to take adantage of the graphical user interface (GUI) and the Technology Pack Installer single installation utility. The following list highlights GUI tools that help improe the installation and upgrade of technology packs: Launchpad - The launchpad, an HTML-based application, is the preferred method for installing technology packs. The launchpad proides an option for starting the Technology Pack Installer, which installs bundled and stand-alone technology packs. Topology Editor - In addition to improing the installation of Tioli Netcool Performance Manager components (DataChannel, DataView, and DataMart), the Topology Editor (accessed through the launchpad) makes it easier to add UBA collectors for UBA technology packs. Using the Topology Editor, you modify pack-specific UBA parameters (also referred to as properties). When you deploy a topology configuration using a topology.xml file, the alues specified for these parameters are written to the database. On Tioli Netcool/Proiso systems, there is no need to edit pack-specific UBA parameters in the pack template file and copy these edits to the dc.cfg file. In Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager the Topology Editor includes a Technology pack XSD upgrade wizard that makes it easier to deal with UBA pack-specific properties. Before Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, when you upgraded to Tioli Netcool/Proiso from a preious ersion of Tioli Netcool/Proiso, no XSDs were assigned to the deployed UBA collectors. In this case, the Topology Editor treated pack-specific UBA properties for deployed UBA packs as free form, custom settings. Thus, the Topology Editor might not proide the appropriate alidation of settings as it normally would during a typical pack installation. Because the Technology pack XSD upgrade wizard is included as part of the Topology Editor in Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, there is no need to start a separate utility. You start the Topology Editor as described in the IBM Tioli Netcool Performance Manager: Installation Guide. The Technology pack XSD upgrade wizard is automatically started when, in the Application Packs iew, you right-click the Application Packs folder and select Associate components with new AP from the menu. Note: Typically, you use the technology pack XSD upgrade wizard with upgrade scenario 2, specifically to upgrade UBA packs. For more information, see Upgrade currently deployed UBA technology packs to 4.3-U or later on page 44. Note: SNMP technology packs do not hae associated XSD files. The technology pack XSD upgrade wizard remoes the preiously described limitations from upgrade scenario 2, as described in Table 12 on page 34. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 33

42 Table 12. Remoal of limitations with Topology Editor and UBA pack-specific properties Upgrade scenario Upgrade scenario 2 Limitations (UBA packs only) before fix pack 3 or Tioli Netcool Performance Manager The Topology Editor treated the UBA pack-specific property settings for the upgraded UBA pack as free form, custom settings because there was no XSD file associated with the deployed UBA collector. Note: The Topology Editor identifies custom properties with a check mark in the Is Custom column of the Properties and Adanced Properties tabs. Remoal of limitations (UBA packs only) fix pack 3 or Tioli Netcool Performance Manager First, you load a technology pack XSD file into the Topology Editor. Then, the Technology pack XSD upgrade wizard is automatically started when, in the Application Packs iew, you right-click the Application Packs folder and select Associate components with new AP from the menu. You associate one of the listed UBA collectors with this technology pack XSD file. (You configured this UBA collector in MR1 or earlier, fix pack 1 or later, or and upgraded it to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager). The Technology pack XSD upgrade wizard displays: UBA pack-specific properties with Green check mark icons, indicating that the property alues are alid. The wizard obtains these alues from the corresponding UBA pack-specific parameters specified in the dc.cfg file. You hae the option to erify and/or change these alues. UBA pack-specific properties with Red X icons for any properties where the XSD does not proide a default alue or the alue is missing or is incorrect. Ideally, there must be few or zero properties with Red X icons where alues are missing or are incorrect. A property might display with a Red X icon if the XSD file defines a property without a corresponding parameter in the dc.cfg file. You use the Topology Editor Help to specify appropriate alues for all UBA pack-specific properties that display with Red X icons. UBA pack-specific properties with a check mark in the Is Custom column of the Properties and Adanced Properties tabs. Ideally, there must be few or zero custom properties. Limitations with UBA pack-specific parameter key/alue pairs Design changes in Tioli Netcool/Proiso affect UBA pack-specific parameter key/alue pairs as follows: Each UBA parameter key/alue pair is limited to 40 characters. Each UBA parameter key must be specified in uppercase. Note: For the Alcatel-Lucent 5620 SAM Technology Pack, the preious limitations also apply to the BLB and SAMIF key/alue pairs. 34 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

43 Before you begin a technology pack upgrade About this task Before upgrading a technology pack, ensure that you hae done the following steps: Procedure Consulted the latest ersion of the IBM Tioli Netcool Performance Manager: Pack Release Notes. For more information about specific sections to consult before performing the pack upgrade, see Essential information in pack release notes on page 31. Consulted with your IBM Professional Serices representatie before upgrading a technology pack. Your IBM Professional Serices Representatie makes use of the documentation sources described in Documents you need to perform a technology pack upgrade on page 27. CAUTION: If you hae a customized technology pack installed at your site with modified content, it is oerwritten if the same pack is upgraded to a later ersion. Check with your IBM customer serice representatie before upgrading an existing technology pack to a later ersion. The correct ersion of Jaa. See Essential information in pack release notes on page 31 for more information. Note: For 4.3-W and 4.3-X Technology packs the launchpad requires you to enter the path to supported Jaa runtime binaries. Only ersions 1.4.2_b(17+) and 1.5.0_b(14+) are supported. The Topology Editor proides a supported ersion of the Jaa binaries. Note: Note: For 4.3-Y, 4.3-Z, 1.3-A technology packs the launchpad requires you to enter the path to supported Jaa runtime binaries. Only ersion 1.5.0_b(14+) is supported. The Tioli Netcool/Proiso Topology Editor proides a supported ersion of the Jaa binaries. Using Jaa ersion 1.4 results in an error detailing that it is not possible to proceed with the installation. Access to the product distribution site: On the product distribution site are the ProisoPackInstaller.jar file, the bundled JAR file, and indiidual stand-alone technology pack JAR files. Access to the following site to check for interim fixes or fix packs that might apply to your technology pack: NetcoolProiso.html See Documents you need to perform a technology pack upgrade on page 27 for more information. Access to the Tioli Netcool Performance Manager documentation, technology pack user' guides, and technology pack release notes, which are aailable at the following site: com.ibm.netcool_proiso.doc/welcome.htm For more information about what to look for in the documents required for pack upgrades, see Documents you need to perform a technology pack upgrade on page 27. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 35

44 Used the following GUI components that were introduced in Tioli Netcool/Proiso 4.4.3: Topology Editor, including: - How to work with UBA technology pack XSD files (see Limitations with UBA pack-specific parameter key/alue pairs on page 34 for current limitations.) - How to work with custom properties Note: Because the Technology Pack XSD Upgrade wizard is included as part of the Topology Editor in Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, there is no need to start a separate utility. You start the Topology Editor as described in the IBM Tioli Netcool/Proiso: Installation Guide. The Technology pack XSD Upgrade wizard is automatically started when, in the Application Packs iew, you right-click the Application Packs folder and select Associate components with new AP from the menu. You are instructed on how to do this in Upgrade currently deployed UBA technology packs to 4.3-U or later on page 44 and Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49 Read and understood the upgrade scenarios described in this chapter. Before you begin upgrade scenario 2 (UBA packs only) About this task In addition to the prerequisite tasks described in Before you begin a technology pack upgrade on page 35, you must also perform the prerequisite tasks described in the following sections before performing the steps described in Upgrade currently deployed UBA technology packs to 4.3-U or later on page 44 and/or Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49. Before you begin upgrading a currently deployed UBA technology pack to 4.3-U or later About this task Before upgrading a currently deployed UBA technology pack to 4.3-U or later, ensure that you hae done the following: For UBA packs that require one UBA collector - Identified the UBA collector subchannel you configured for the pack. For UBA packs that require multiple UBA collectors - Identified the UBA collector subchannels you configured for the pack. For UBA packs that require a UBA collector, BLB (Bulk Load Balancer), and IF (Inentory File) - Identified the UBA collector subchannel, BLB, and IF you configured for the pack. You configured the UBA collector or collectors (and BLB and IF, if required) in Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or and upgraded it to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. The Topology Editor technology pack XSD upgrade wizard requires you to select this UBA collector or collectors in one of the steps described in Upgrade currently deployed UBA technology packs to 4.3-U or later on page IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

45 Table 13. Examples of identifying UBA collectors, BLB, and IF Technology pack UBA collector configured for technology pack BLB/IF configured for technology pack Comments Ciena Transmission UBA Not applicable The UBA collector for this pack was configured with a channel number of 1 and a sub-channel number of 100. The Topology Editor technology pack XSD upgrade wizard displays this UBA collector as a choice in one of the steps described in Upgrade currently deployed UBA technology packs to 4.3-U or later on page 44. Alcatel 5620 NM UBA BLB IF The UBA collector for this pack was configured with a channel number of 1 and a sub-channel number of 200. The technology pack-specific components - the BLB and QCIF - were also configured on channel 1 and sub-channel 200. The Topology Editor technology pack XSD upgrade wizard displays this UBA collector as a choice in one of the steps described in Upgrade currently deployed UBA technology packs to 4.3-U or later on page 44 Before you begin upgrading a Nortel CS2000 Technology Pack to 4.3-U or later About this task Before upgrading a currently deployed Nortel CS2000 Technology Pack to 4.3-U or later, ensure that you hae or hae done the following: Identified the UBA collectors you configured for each of the following deices: Passport Packet Voice Gateway (PVG) - The UBA collector executing on this subchannel retriees Bulk input files generated by the PVG deice. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 37

46 Uniersal Signaling Point (USP) - The UBA collector executing on this subchannel retriees Bulk input files generated by the USP deice. Nortel CS2000 Performance - The UBA collector executing on this subchannel retriees Bulk input files generated by the Nortel CS2000 Performance deice. Nortel Integrated Element Management System (IEMS) - The UBA collector executing on this subchannel retriees Bulk input files generated by the Nortel CS2000 IEMS deice. Nortel SSL (Session Serer Line) - The UBA collector executing on this subchannel retriees Bulk input files generated by the Nortel SSL deice. CAUTION: The following two UBA Collectors, SST and CPR, are only applicable for 4.3-X, 4.3-Y or later technology packs. Nortel SST (Nortel Session Serer Trunk) - The UBA collector executing on this subchannel retriees Bulk input files generated by the Nortel SST deice. Note: The Nortel CS2000 Technology Pack introduced support for a new UBA deice called Nortel SST (Session Serer Trunk) starting in 4.3-X. Nortel Common Performance Reporting (CPR) - CPR is a log format. The bulk input files generated by the PVG deice are manipulated by the IEMS system and conerted into CPR format. Nortel recommends that the CPR log format be manipulated ia the IEMS system, instead of directly from the MDM. So this is facilitated by the CPR Adaptor. Note: The CPR Adaptor is also somewhat of a generic adaptor as it can be used to support SST data in CPR format. One instance of the CPR Adaptor can simultaneously support both CPR and SST formats. Identified multiple UBA collectors for the Nortel Succession Communication Serer 2000 (CS2K) CDR deice. The UBA collectors executing on these subchannels retriee Bulk input files generated by the Nortel CS2000 CDR deice. Typically, you configured multiple UBA collectors for the Nortel CS2K CDR deice to handle a large olume of records the UBA collectors need to process. If there are large olumes of records, you most likely considered adding three or four UBA collectors. Identified the primary or master UBA collector. The primary UBA collector subchannel is the subchannel to which all of the other UBA collector subchannels are aliased to. The primary UBA collector subchannel for the Nortel CS2000 Technology Pack is the one associated with the Nortel CS2K stray handler. Note: The Nortel CS2K Stray Handler must share the same collector alias as you defined for the CS2K CDR deice. You configured the UBA collectors for the Nortel CS2000 technology pack in Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or and upgraded it to fix pack 3 or Tioli Netcool Performance Manager. The Topology Editor technology pack XSD upgrade wizard requires you to select these UBA collectors and the primary UBA collector (the Nortel CS2K Stray Handler) in the steps described in Upgrade currently deployed UBA technology packs to 4.3-U or later on page IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

47 Table 14. Examples of identifying UBA collectors and primary UBA collector for Nortel CS2000 Deice UBA collector or collectors configured for technology pack Primary UBA collector Comments PVG UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 100. The Topology Editor technology pack XSD upgrade wizard will display this UBA collector as a choice in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49. USP UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 101. The Topology Editor technology pack XSD upgrade wizard will display this UBA collector as a choice in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 39

48 Table 14. Examples of identifying UBA collectors and primary UBA collector for Nortel CS2000 (continued) Deice Nortel CS2000 Performance UBA collector or collectors configured for technology pack Primary UBA collector Comments UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 102. The Topology Editor technology pack XSD upgrade wizard will display this UBA collector as a choice in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49.. IEMS UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 103. The Topology Editor technology pack XSD upgrade wizard will display this UBA collector as a choice in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

49 Table 14. Examples of identifying UBA collectors and primary UBA collector for Nortel CS2000 (continued) Deice UBA collector or collectors configured for technology pack Primary UBA collector Comments SSL UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 104. The Topology Editor technology pack XSD upgrade wizard will display this UBA collector as a choice in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49. Nortel CS2K CDR UBA UBA UBA Not applicable The UBA collectors for this deice were configured with a channel number of 2 and subchannel numbers of 105 through 107. The Topology Editor technology pack XSD upgrade wizard will display these UBA collectors as choices in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 41

50 Table 14. Examples of identifying UBA collectors and primary UBA collector for Nortel CS2000 (continued) Deice Nortel CS2K stray handler UBA collector or collectors configured for technology pack Primary UBA collector Comments Not applicable UBA The primary UBA Collector for the Nortel CS2K stray handler was configured with a channel number of 2 and a subchannel number of 108. The Topology Editor technology pack XSD upgrade wizard will display the primary UBA collector as a choice in one of the steps described in Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later on page 49 SST UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 109. The CPRAdaptor is instantiated once for PVG, if the PVG data is processed after it is manipulated by the IEMS subsystem. One instance must be created to handle any SS-T data that may be present in the network. 42 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

51 Table 14. Examples of identifying UBA collectors and primary UBA collector for Nortel CS2000 (continued) Deice UBA collector or collectors configured for technology pack Primary UBA collector Comments CPR UBA Not applicable The UBA collector for this deice was configured with a channel number of 2 and a subchannel number of 110. CPR is a log format. The bulk input files generated by the PVG deice are manipulated by the IEMS system and conerted into CPR format. Nortel recommends that the CPR log format be manipulated ia the IEMS system, instead of directly from the MDM. So this is facilitated by the CPR Adaptor. Standard procedure for upgrading technology packs The following sections discuss how to upgrade technology packs according to the following scenarios: Upgrade scenario 1 (SNMP and UBA technology packs) (except Alcatel-Lucent 5620 SAM, Netflow IPFIX) Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) on page 53 Upgrade scenario 1 (SNMP and UBA technology packs) (except Alcatel-Lucent 5620 SAM, Netflow IPFIX) About this task You are currently running Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or You want to do the following: Upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager (which you do before performing the pack upgrade by following the instructions in IBM Tioli Netcool Performance Manager: Upgrade Guide that relates to your ersion of Tioli Netcool Performance Manager). Upgrade currently deployed technology packs to 4.3-U or later. Important: See Upgrading the Alcatel-Lucent 5620 SAM Technology Pack on page 24 and Upgrading the Netflow IPFIX Technology Pack on page 25 for instructions on how to perform the upgrade scenarios for these technology packs. Refer to the following sections for upgrade instructions: Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 43

52 Upgrade currently deployed SNMP technology packs to 4.3-U or later: About this task To upgrade currently deployed SNMP technology packs to 4.3-U or later, follow these steps: Upgrade the technology pack to 4.3-U or later by installing the 4.3-U or later SNMP pack, following the instructions in the appropriate technology pack installation appendix proided in the IBM Tioli Netcool Performance Manager: Installation Guide. Configure the 4.3-U or later SNMP technology pack you upgraded (installed), by referring to the configuration chapter in the IBM Tioli Netcool Performance Manager: Installation and Configuration Guide. Important: Technology packs do not work unless they are configured. Upgrade currently deployed UBA technology packs to 4.3-U or later: About this task To upgrade currently deployed UBA technology packs to 4.3-U or later, follow these steps: Procedure 1. Complete the pre-installation setup tasks, as described in the appropriate technology pack installation appendix proided in the IBM Tioli Netcool Performance Manager: Installation Guide. These setup tasks describe how to download the ProisoPackInstaller.jar file, any 4.3-U and later stand-alone JAR files, and the 4.3-U and later bundled JAR file. Important: Do not install any 4.3-U and later UBA technology packs yet. You are asked to install 4.3- U and later technology packs in STEP Make sure that you hae the aailable information described in Before you begin upgrade scenario 2 (UBA packs only) on page Open the Topology Editor. 4. Open a deployed topology (a topology.xml file). 5. After you click Finish the topology is displayed in the Topology Editor. 6. Load the UBA pack XSD file into the existing topology by following the instructions proided in the IBM Tioli Netcool/Proiso: Installation Guide. 7. In the Application Packs iew, right-click the Application Packs folder and select Associate components with new AP from the menu. Note: The technology pack XSD upgrade wizard is automatically started when you right-click the Application Packs folder and select Associate components with new AP from the menu. 8. Select a technology pack XSD file from the list of aailable technology packs. Note: The technology packs that display in this list are the 4.3-U and later packs you downloaded in STEP Click Next to continue. 10. The Create new AP from template and assign components window displays eery UBA collector subchannel that is not currently assigned to a technology pack. 44 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

53 Note: These UBA collectors were created in Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, and When you upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, the UBA collectors are not associated with any currently deployed UBA technology packs. The create new AP from template and assign components window allows you to associate these UBA collectors with currently deployed pre-4.3-u technology packs. The new AP from template and assign components window displays the following fields: Create - A check box that directs the Topology Editor to associate the UBA collector listed in the Collector ID field with the XSD file associated with the technology pack selected from the Collector Template list. Collector ID - The list of UBA collector(s) that were added to the topology when you upgraded from Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. For example: UBA If the technology pack you selected in STEP 8 has BLB (Bulk Load Balancer) and IF (Inentory File) components, this window displays only UBA collector subchannels that include the BLB and IF components. The Topology Editor does not display BLB/IF components in the Collector Template list because no technology pack XSD defines more than one BLB and IF. Note: These BLB and IF components were created in Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, and When you upgrade to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager, the BLB and IF components (and their associated UBA collectors) are not associated with any currently deployed UBA technology packs. The create new AP from template and assign components window allows you to associate these UBA collectors and their associated BLB and IF components with currently deployed pre-4.3-u technology packs. The Topology Editor automatically associates a UBA collector with its associated BLB and IF components when you load a technology pack XSD file that defines these components. 11. To associate a UBA collector with a UBA technology pack, follow these steps: a. Check the box in the Create field associated with a UBA collector subchannel listed in the Collector ID field. You must hae identified this UBA collector for a currently deployed pack, as described in Before you begin upgrading a currently deployed UBA technology pack to 4.3-U or later on page 36. b. Select a technology pack from the Collector Template list. You must hae identified this UBA pack, as described in Before you begin upgrading a currently deployed UBA technology pack to 4.3-U or later on page 36. c. Repeat STEP 11-a and STEP 11-b for each UBA collector subchannel you want to associate with a technology pack. d. Click Finish to continue. 12. Verify that each UBA collector is associated with the technology pack you selected in STEP 8. To do this, select technology packs iew in the Topology Editor. The UBA collector displays under the specified technology pack, for example: Collector UBA The Topology Editor also displays each UBA collector under the DataChannel x folder in the Logical iew. Highlight the collector to iew its properties. The Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 45

54 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. For information about the core properties, see the IBM Tioli Netcool Performance Manager: Properties Reference. The Topology Editor displays the UBA technology pack-specific properties according to the rules specified in Table 12 on page 34. Do the following: a. Verify the alues for the UBA technology pack-specific properties displayed with Green check mark icons. To illustrate how you might erify the technology pack-specific properties, Table 15 on page 47 proides a mapping of some dc.cfg file parameters to Topology Editor properties for the Ciena Transmission technology pack. The comments in the table proide additional guidelines you can use to help erify the properties in your technology pack. For information about the pack-specific properties, see the Topology Editor Help. b. Determine whether the UBA technology pack-specific properties displayed with Red X icons are alid. See Table 12 on page 34 for guidelines on how to deal with these types of properties. c. Determine whethe the UBA technology pack-specific properties displayed in the Is Custom column of the Properties and Adanced Properties tabs are alid. See Table 12 on page 34 for guidelines on how to deal with these types of properties. To delete a custom property, see STEP 14. To add a custom property, see STEP (Optional) If you must delete (remoe) a custom property, follow these steps: a. Open the Topology Editor. b. Open the topology associated with the UBA pack you upgraded. c. In the Application Packs iew, select the UBA pack you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific parameters display in the properties window. e. Select the pack-specific UBA custom property to remoe in the Properties or Adanced Properties tab. f. Click the Remoe Custom Property button (a Red X icon that appears in the Property iew). 15. (Optional) If you must add a custom property, follow these steps: a. Open the Topology Editor. b. Open the topology associated with the UBA pack you upgraded. c. In the Application Packs iew, select the UBA pack you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific properties display in the properties window. e. Select the blue + (plus) icon that displays at the right top corner of the properties window. The Add Custom Property for UBA Collector wizard displays. f. The wizard displays three fields: Name - Specifies the pack-specific UBA property to associate with a UBA pack sub-element. Value - Specifies the alue associated with this pack-specific UBA property. Alias - Specifies the name of the property that the Topology Editor displays in the Property View. Valid alues include the pack-specific UBA property name specified in the Name field or descriptie text. 46 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

55 g. Specify the name of the new UBA pack-specific parameter in the Name field. In this example, the name specified would be ERRORFILEMAX. Note: Do not enter the channel number (<CHANNEL>, collector number <COLLECTOR>, instance (UNIV_WAN_MGR), and schema (AVAIL) inthename field. h. Specify a alue in the Alias field according to the preiously discussed guidelines. In this example, ERRORFILEMAX is specified. i. Click Finish. 16. Specify the name of the new UBA pack-specific parameter in the Name field. In this example, the name specified would be ERRORFILEMAX. 17. Upgrade the currently deployed pre-4.3-u technology pack or packs by installing the 4.3-U or later ersion of the pack or packs, following the instructions in the appropriate technology pack installation appendix proided in the IBM Tioli Netcool Performance Manager: Installation Guide. Note: You downloaded the 4.3-U or later ersion of the currently deployed pre-4.3-u technology pack or packs in STEP 1. Note: Because there is an existing UBA collector, you can skip the section that describes how to add UBA collectors. You associated these UBA collectors with pre-4.3-u technology packs in STEP Configure the UBA technology pack you upgraded, by referring to the configuration chapter in IBM Tioli Netcool Performance Manager: Installation and Configuration Guide. Note: Technology packs do not work unless they are configured. Table 15. Example mappings for Ciena Transmission Technology Pack dc.cfg file parameter UBA INSTANCES= streaming Topology Editor property INSTANCES= CIENA_DEVICE Comments The Topology Editor displays the INSTANCES property with a Green check mark icon and the alue as specified in the dc.cfg file. The INSTANCES parameter used to be an arbitrary string as illustrated by the string streaming specified in the dc.cfg file parameter. The conention now is to use a string that represents the name of the technology pack, as illustrated by the Topology Editor property alue, CIENA_DEVICE. Some more recent technology packs delier with template files that specify INSTANCES parameters with strings that represent the names of the technology packs. Note: The INSTANCES property is read-only. In this case, either alue - arbitrary string or pack name string - that the Topology Editor obtains from the dc.cfg file is alid. Note: It is not necessary to specify the channel number, collector number, and schema in the alues for the Topology Editor properties. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 47

56 Table 15. Example mappings for Ciena Transmission Technology Pack (continued) dc.cfg file parameter UBA streaming. DESIGNFILE= CienaAdaptor.js Topology Editor property CIENA_DEVICE. DESIGNFILE= CienaAdaptor.js Comments The Topology Editor must display the DESIGNFILE property with a Green check mark icon and the string that identifies the name of the Bulk Adaptor Design file as specified in the dc.cfg file. UBA streaming. CEMS.URI= file:///export/ home/puser/ uba_files/cems /input/*.cs CIENA_DEVICES.CEMS. URI=$5ftp:// $1:$2@$3/ $4 /*. csciena_devices. CEMS.URI =file:///export/ home/puser/ uba_files/ CEMS/input /*.cs The name of the Bulk Adaptor Design file (in this case, CienaAdaptor.js) must be the same in both the template file parameter and the Topology Editor property. Note: The DESIGNFILE property is read-only. The Topology Editor must display the URI property with a Green check mark icon and the alue as specified in the dc.cfg file, in this case a URL specification that directs the UBA to the location for the Bulk input files (in this case, *.cs files). The Topology Editor displays the URI property as read-only and its associated alue is a concatenation of the following properties defined in the pack XSD file: INPUT_USE_SECURE_FTP ($5) INPUT_FTP_HOST ($3) INPUT_FTP_USERNAME ($1) INPUT_FTP_PASSWORD ($2) INPUT_DIRECTORY ($4) Note: The alues ($1 through $5) specified here are taken from the Ciena Transmission Technology Pack XSD file to show the concatenation of properties. The Topology Editor must display the INPUT-related properties with Red X icons because the pack XSD file does not proide default alues for these properties. UBA streaming. DELETEONACQUIRE= false CIENA_DEVICE.CEMS. DELEATEONACQUIRE =false It is recommended that you specify alues for the INPUT-related properties using the guidelines proided by the Topology Editor Help. The Topology Editor must display the DELETEONACQUIRE property with a Green check mark icon and the alue as specified in the dc.cfg file, in this case the alue false. In this example, the DELETEONACQUIRE parameter in the dc.fg file and the Topology Editor property hae the same alue (false). This might not always be the case. The Topology Editor displays the DELETEONACQUIRE property as read/write. Therefore, you can change the alue of this property using the Topology Editor. 48 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

57 Upgrade a currently deployed Nortel CS2000 UBA technology pack to 4.3-U or later: The Topology Editor simplifies the task of associating UBA collectors for Nortel CS2000 deices and the CS2K CDR call records by associating each with a technology pack that displays in the technology packs iew after you load the XSD file. About this task Table 16 maps each deice to its associated technology pack. Table 16. Nortel CS2000 deices mapped to technology packs Nortel CS2000 deice/system/calls Records PVG Nortel CS2K CDR Nortel CS2K stray handler USP Nortel CS2K Performance IEMS SSL SST CPR Pack displayed in Create new Ap from template and assign components window nortel_cs2000_uba_pg nortel_cs2000_uba_cdr nortel_cs2000_uba_stray nortel_cs2000_uba_usp nortel_cs2000_uba_perf nortel_cs2000_uba_iems nortel_cs2000_uba_ssl nortel_cs2000_uba_sst nortel_cs2000_uba_cpr Note: The Nortel CS2000 technology pack introduced support for new UBA deices called Nortel SST (Session Serer Trunk) and Nortel CPR starting in 4.3-X and 4.3-Y. To upgrade a currently deployed Nortel CS2000 technology pack to 4.3-U or later, follow these steps: Procedure 1. Complete the pre-installation setup tasks, as described in the appropriate technology pack installation appendix proided in the IBM Tioli Netcool Performance Manager: Installation Guide. These setup tasks describe how to download the ProisoPackInstaller.jar file and 4.3-U and later stand-alone JAR files. Note: Do not install the 4.3-U and later Nortel CS2000 technology pack yet. You are asked to install it in STEP Open the Topology Editor. 3. Open a deployed topology (a topology.xml file). 4. After you click Finish the topology is displayed in the Topology Editor. 5. Load the Nortel CS2000 pack XSD file into the existing topology by following the instructions proided in the IBM Tioli Netcool Performance Manager: Installation Guide. After you load the XSD file for the Nortel CS2000 technology pack, the technology packs listed in Table 16 display in the Application Packs iew. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 49

58 In effect, the Nortel CS2000 Technology Pack is organized into seen technology packs, one for each of the supported deices. Typically, you configured a UBA Collector for each of these technology packs. In addition, you more than likely configured multiple UBA Collectors and specified a primary or master ID for the Nortel CS2000 CDR pack listed in Table 16 on page To associate a UBA Collector with the nortel_cs2000_uba_pg technology pack: a. In the Application Packs iew, right-click the Application Packs folder and select Associate components with new AP from the menu. Note: The technology pack XSD upgrade wizard is automatically started when you right-click the Application Packs folder and select Associate components with new AP from the menu. b. Select the nortel_cs2000_uba_pg technology pack from the list of technology packs, then click Next. c. The nortel_cs2000_uba_pg technology pack has one UBA Collector, so the create new AP from template and assign components window displays the following fields: Create - A check box that directs the Topology Editor to associate the UBA collector listed in the Collector ID field with the XSD file associated with the technology pack selected from the Collector Template drop-down list. Collector ID - The list of UBA collector(s) that were added to the topology when you upgraded from Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. For example: UBA Collector Template - The list of Nortel CS2000 Technology Pack XSD files that you loaded in STEP 5. See Table 16 on page 49 for the mapping between deice and technology pack. To associate a UBA Collector with the nortel_cs2000_uba_pg technology pack, check the Create field adjacent to the UBA Collector listed in the Collector ID field and make sure the Collector Template is nortel_cs2000_uba_pg. You should already know which UBA Collectors are associated with which Nortel CS2000 deices, as described in Before you begin upgrading a Nortel CS2000 Technology Pack to 4.3-U or later on page 37. d. Click Finish. The Topology Editor displays the UBA Collector under the nortel_cs2000_uba_pg technology pack in the Application Packs iew. The Topology Editor also displays the UBA Collector under the DataChannel x folder in the Logical iew. e. 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. The Topology Editor displays most of the properties with Green check mark icons, as described in Technology pack XSD upgrade wizard on page 33. The Topology Editor might also display properties with Red X icons according to the rules specified in Technology pack XSD upgrade wizard on page 33 Verify the alues associated with Green check mark icons and supply alues for properties with Red X icons using the guidelines proided by the Topology Editor Help or by referring to the appropriate appendix in the IBM Tioli/Netcool Proiso Nortel CS2000 Technology Pack User Guide. You 50 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

59 might also want to check Table 15 on page 47 for a discussion of some common UBA pack-specific properties. Verify the alues associated with Green check mark icons and supply alues for properties with Red X icons using the guidelines proided by the Topology Editor Help or by referring to the appropriate appendix in the IBM Tioli/Netcool Proiso Nortel CS2000 Technology Pack User Guide. You might also want to check Table 15 on page 47 for a discussion of some common UBA pack-specific properties. f. To associate a UBA Collector for each of the nortel_cs2000_uba_usp, nortel_cs2000_uba_perf, nortel_cs2000_uba_iems, nortel_cs2000_uba_ssl, nortel_cs2000_uba_sst, and nortel_cs2000_uba_cpr technology packs, repeat STEP 6-a through STEP 6-e making sure to check the Create field next to the appropriate UBA Collector in the Collector ID field, and select the appropriate pack from the Collector Template field. 7. To specify a primary or master UBA Collector and associate multiple UBA Collectors with the nortel_cs2000_uba_cdr technology pack: a. In the Application Packs iew, right-click the Application Packs folder and select Associate components with new AP from the menu. Note: The Technology pack XSD upgrade wizard is automatically started when you right-click on the Application Packs folder and select Associate components with new AP from the menu. b. Select the nortel_cs2000_uba_cdr technology pack from the list of technology packs, then click Next. c. The nortel_cs2000_uba_cdr technology pack typically has multiple UBA Collector, so the create new AP from template and assign components window displays the following fields: Select - A radio button that directs the Topology Editor to associate the UBA collector listed in the Collector Template field with the XSD file associated with the nortel_cs2000_uba_cdr technology pack. See Table 16 on page 49 for the mappings. Collector ID - The list of UBA collector(s) that were added to the topology when you upgraded from Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. For example: UBA UBA UBA UBA UBA UBA Collector Template - The list of Nortel CS2000 Technology Pack XSD files that you loaded in STEP 5. See Table 16 on page 49 for the mapping between deice and technology pack. d. To specify a primary or master UBA Collector, click the Select radio button next to the UBA Collector listed in the Collector ID field and make sure that the Collector Template is nortel_cs2000_uba_stray. You must already know which UBA Collectors are associated with which Nortel CS2000 deices, as described in Before you begin upgrading a Nortel CS2000 Technology Pack to 4.3-U or later on page 37. Note: The primary UBA collector subchannel is the subchannel to which all of the other UBA collector subchannels are aliased to. The primary UBA collector subchannel for the Nortel CS2000 technology pack is the one associated with the Nortel CS2K stray handler. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 51

60 e. Click Next. The create new AP from template and assign components window displays the following fields: Create - A check box that directs the Topology Editor to associate the UBA collector listed in the Collector ID field with the XSD file associated with the technology pack selected from the Collector Template drop-down list. Collector ID - The list of UBA collector(s) that were added to the topology when you upgraded from Tioli Netcool/Proiso MR1 or earlier, fix pack 1 or later, or to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. For example: UBA UBA UBA Collector Template - The list of Nortel CS2000 technology pack XSD files that you loaded in STEP 5. See Table 16 on page 49 for the mapping between deice and technology pack. f. To associate multiple UBA Collectors with the nortel_cs2000_uba_cdr technology pack, check the Create fields next to the UBA Collectors listed in the Collector ID field and make sure that the Collector Template is nortel_cs2000_uba_cdr. You must already know which UBA Collectors are associated with which Nortel CS2000 deices, as described in Before you begin upgrading a Nortel CS2000 Technology Pack to 4.3-U or later on page 37 g. Click Finish. The Topology Editor displays the UBA Collector under the nortel_cs2000_uba_cdr technology pack in the Application Packs iew. The Topology Editor also displays the UBA Collector under the DataChannel x folder in the Logical iew. h. 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. The Topology Editor displays most of the properties with Green check mark icons, as described in Technology pack XSD upgrade wizard on page 33. The Topology Editor might also display properties with Red X icons according to the rules specified in Technology pack XSD upgrade wizard on page 33. Verify the alues associated with Green check mark icons and supply alues for properties with Red X icons using the guidelines proided by the Topology Editor Help or by referring to the appropriate appendix in the IBM Tioli/Netcool Proiso Nortel CS2000 Technology Pack User Guide. You might also want to check Table 15 on page 47 for a discussion of some common UBA pack-specific properties. 8. After you alidate the UBA pack-specific properties, redeploy the updated topology, as described in the IBM Tioli Netcool/Proiso: Installation Guide. 9. Upgrade the currently deployed pre-4.3-u Nortel CS2000 technology pack by installing the 4.3-U or later ersion of the pack, following the instructions in the installing technology packs appendix proided in the IBM Tioli Netcool/Proiso: Installation Guide. Note: Because there is an existing UBA collectors, you can skip the section that describes how to add UBA collectors. 10. Configure the Nortel CS2000 technology pack you upgraded, by referring to the configuration appendix in the IBM Tioli Netcool/Proiso Nortel CS2000 Technology Pack User Guide. 52 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

61 Important: Technology packs do not work unless they are configured. Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX) The Topology Editor maintains the association with the existing XSD file. Therefore, it erifies the alues currently specified for the UBA pack-specific property settings. Before you begin Currently, you deployed 4.3-V UBA technology packs running on Tioli Netcool/Proiso Completed the update of Tioli Netcool/Proiso to Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager by following the instructions in the Fix pack ReadMe. Want to upgrade currently deployed 4.3-V technology packs to 4.3-X or later. About this task To upgrade currently deployed 4.3-V technology packs to 4.3-X or later, follow these steps: Procedure 1. Update the UBA technology pack metadata by following these steps: a. Open the Topology Editor. b. Create a new empty topology by selecting File > Create new topology. Retain the default number of resources as this operation is only necessary to populate the Application Packs iew. c. In the Application Packs iew, right-click the Application Packs folder and select Load Application Pack from the menu. d. Naigate to the directory where you copied the new stand-alone (or bundled) JAR file. The Topology Editor displays a message warning that the XSD exists. The message also asks if you want to replace the XSD. Specify that you want to replace the XSD. e. After replacing the XSD, close the Topology Editor. You successfully replaced the UBA technology pack metadata. 2. Reopen the Topology Editor and select the existing deployed topology (topology.xml). The UBA pack-specific properties are applied to the existing deployed topology according to the following rules: Properties that were added to the pack XSD displays in the Property tab with their default alues. You can modify, if necessary, any writable properties. Properties that were remoed in the XSD shows in the Property tab as custom properties. If not needed, you can remoe these properties by following these instructions: a. Open the Topology Editor. b. Open the topology associated with the UBA pack you upgraded. c. In the Application Packs iew, select the UBA pack you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific parameters display in the properties window. e. Select the pack-specific UBA custom property to remoe in the Properties or Adanced Properties tab. Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 53

62 f. Click the Remoe Custom Property button (a red X icon that appears in the Property iew). 3. Redeploy the updated topology, as described in the IBM Tioli Netcool/Proiso: Installation Guide. 4. Use the dccmd command to stop the UBA application: dccmd -action stop UBA 5. Upgrade the 4.3-V UBA technology pack to 4.3-X or later by following the instructions proided in the pack installation chapter of the IBM Tioli Netcool/Proiso: Installation Guide. Note: Because there is an existing UBA collector, you can skip the section that describes how to add UBA collectors. 6. Configure the UBA technology pack you upgraded, by referring to the configuration appendix of the appropriate Technology Pack User Guide. One of the configuration steps instructs you to restart the DataChannel to actiate the UBA and read in changes to the deployed topology. Important: Technology packs do not work unless they are configured. Note: Starting with ersion 4.3-X, the Alcatel-Lucent 5620 SAM Technology Pack requires you to configure two UBA Bulk Collectors. For information about how to configure additional UBA Bulk Collectors, see the IBM Tioli Netcool Performance Manager: Installation Guide. For more information about this configuration change, see IBM Tioli Netcool Performance Manager: Alcatel-Lucent 5620 SAM Technology Pack User Guide. Deleting inalid reports after upgrade to 4.3-Y or later You must manually delete some inalid reports after you upgrade a currently deployed Technology Pack to 4.3-Y or later. About this task To do this, follow these steps: Procedure 1. Open a terminal emulator and log in to the DataMart serer as puser. 2. Change your working directory to the DataMart home directory (/opt/datamart, by default). 3. Load the shell with the DataMart enironment by sourcing the datamart.en file, as follows:.. /opt/datamart/datamart.en 4. Launch the PVM user interface by giing the following command: pm& 5. Click the Resource Editor tab, and then click the Report SEGroup tab from the Resource Editor window. 6. Naigate to the specific report, select the report, and then press Ctrl+X. Deleting some reports in Nortel CS2000 Technology Pack: About this task You must manually delete the location-based reports in the following scenarios: Currently, you deployed a 4.3-U or later Nortel CS2000 Technology Pack on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager. 54 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

63 You want to upgrade a Nortel CS2000 Technology Pack from 4.3-U or later to 4.3-Y. The design of the Nortel CS2000 technology pack needs to be changed. You do not require the SLA Voice Quality Report and Voice Quality reports in the updated design of the Nortel CS2000 technology pack. You can delete these reports from the following location in the Resource Editor: NOC Reporting > Carrier VOIP > User Experience > Voice Quality > CDR/IPDR > Nortel CS2K > Location For more information about manual deletion of reports, see Deleting inalid reports after upgrade to 4.3-Y or later on page 54. IEMSAdaptor.js: Datechannel has to be configured to use IEMSAdaptor.js file that replaces the old IEMSPERFAdaptor.js file in Nortel CS Y Technology Pack. The IEMSAdaptor.js script is updated to handle multi-file joins and does not require the methods from both IEMSPERFMethods.js file and IEMSPERFConfig.js file. The IEMSAdaptor.js is stream-based and supports data collection from all the deice types simultaneously. It also handles SPFS correctly as well as the SPFS interface. For more information, refer to IBM Tioli/Netcool Proiso Nortel CS Technology Pack User Guide. Deleting some reports in Alcatel-Lucent 5620 SAM Technology Pack: After you upgrade a currently deployed Alcatel-Lucent 5620 SAM technology Pack to 4.3-Y or later, you must delete or unlink the Jitter and Latency report. About this task To do this, follow these steps: Procedure 1. Start the Resource Editor by following the steps in section. Deleting inalid reports after upgrade to 4.3-Y or later on page Expand NOC Reporting > Alcatel-Lucent 5620 SAM > SAM OAM Tests > Jitter & Latency > Jitter and Latency report. 3. Press Ctrl+X to remoe the selected report. Deleting inalid reports for Alcatel-Lucent 5620 SAM Technology Pack after upgrade to 1.3-B or later This section describes the steps to delete extra reports and duplicate group in Alcatel-Lucent 5620 SAM Technology Pack after upgrade to 1.3-B or later. Deleting extra reports in Alcatel-Lucent 5620 SAM Technology Pack: If you deployed Alcatel-Lucent 5620 SAM Technology Pack to 1.3-A ( ) or earlier, you must delete or unlink the Packet Health and Packet Volume Reports after installing 1.3-E ( ). Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 55

64 About this task To do this, follow these steps: Procedure 1. Start the Resource Editor by following the steps in section. Deleting inalid reports after upgrade to 4.3-Y or later on page Naigate to Report SEGroup tab. 3. Expand NOC Reporting > Alcatel-Lucent 5620 SAM > SAM Router Health > Link Aggregation Groups (LAG) > %(samsitename)-%(samsiteid) for Packet Health and Packet Volume RST reports. 4. Check the Comment column. Look for reports with comment "Alcatel-Lucent 5620 SAM - Packet Health - RST/GTS" and "Alcatel-Lucent 5620 SAM - Packet Volume - RST/GTS". 5. Press Ctrl+X to remoe the selected report. 6. Expand NOC Reporting > Alcatel-Lucent 5620 SAM > SAM Router Health > Link Aggregation Groups (LAG) for Packet Health and Packet Volume Group Summary reports. 7. Check the Comment column. Look for reports with comment "Alcatel-Lucent 5620 SAM - Packet Health - ResDistrib GST" and "Alcatel-Lucent 5620 SAM - Packet Volume - ResDistrib GST". 8. Press Ctrl+X to remoe the selected report. Deleting Duplicate Group in Alcatel-Lucent 5620 SAM Technology Pack: If you deployed Alcatel-Lucent 5620 SAM Technology Pack to 1.3-B ( ) or earlier, you must delete or unlink the VCCV Ping before installing interim fix ( ) or interim fix ( ). About this task To do this, follow these steps: Procedure 1. Start the Resource Editor by following the steps in section. Deleting inalid reports after upgrade to 4.3-Y or later on page Expand NOC Reporting > Alcatel-Lucent 5620 SAM > SAM OAM Tests > Jitter & Latency > Jitter and Latency report. 3. Press Ctrl+X to remoe the selected report. 4. Select VCCV Ping, Rename the Group name, ordelete. Deleting Extra GST Grouping in Alcatel-Lucent 5620 SAM Technology Pack If you deployed Alcatel-Lucent 5620 SAM Technology Pack to 1.3-B ( ), you must delete the extra leel of GST before installing interim fix ( ) or interim fix ( ). About this task To do this, follow these steps: 56 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

65 Procedure 1. Start the Resource Editor by following the steps in section. Deleting inalid reports after upgrade to 4.3-Y or later on page Expand NOC Reporting > Alcatel-Lucent 5620 SAM > SAM Router Health > Interfaces > %(samsitename)-%(samsiteid) > %(samportname). 3. Delete the resources that bind in this leel. 4. Start the Rule Editor. 5. Expand NOC Reporting > Alcatel-Lucent 5620 SAM > SAM Router Health > Interfaces > %(samsitename)-%(samsiteid). 6. Delete the %(samportname). Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager 57

66 58 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

67 Chapter 4. Upgrading Common Packs Technology packs are enabled for Tioli Common Reporting by the additional installation of a common pack, which contains all the Cognos artifacts necessary for running common reports for a particular technology. The common packs are aailable from 1.3-C release onwards. You must also install some base common packs, which contain generic functionality used by multiple packs. Additional software is required to install and use common packs and their dependent base common packs. This chapter describes how to upgrade your common packs that are aailable after you installed and actiated the latest ersion of a common pack and the dependent Base Common Packs. For more information, see IBM Tioli Netcool Performance Manager: Pack Installation and Configuration Guide. Upgrading Tioli Netcool Performance Manager Wireline Cognos report prompt pages for timezone support Describes the procedure to upgrade Tioli Netcool Performance Manager Wireline Cognos report prompt pages to include support for timezone and resourcealias labels for 1.3-C common packs. The common packs aailable in 1.3-C release are MIB-II Common Pack and Cisco Deice Common Pack. About this task For more information about the upgrade procedure for timezone support, see tnpm_wireline_component_upgrade_procedure_for_timezone_support14?lang=en Copyright IBM Corp. 1997,

68 60 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

69 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 , Shimotsuruma, Yamato-shi Kanagawa 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,

70 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. 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 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. 62 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

71 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. Cell Broadband Engine and Cell/B.E. are trademarks of Sony Computer Entertainment, Inc., in the United States, other countries, or both and is used under license therefrom. 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. IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Goernment Commerce. ITIL is a registered trademark, and a registered community trademark of the Office of Goernment Commerce, and is registered in the U.S. Patent and Trademark Office. Jaa and all Jaa-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Linux is a trademark of Linus Toralds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and serice names may be trademarks or serice marks of others. For trademark attribution, isit the IBM Terms of Use Web site ( Notices 63

72 Additional copyright notices 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. 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 64 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

73 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. CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Part 2: Networks Associates Technology, Inc copyright notice (BSD) Notices 65

74 Copyright 2001, Networks Associates Technology, Inc All rights resered. Redistribution and use in source and binary forms, with or without modification, are permitted proided that the following conditions are met: Redistributions of source code must retain the aboe copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the aboe copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials proided with the distribution. Neither the name of the NAI Labs nor the names of its contributors may be used to endorse or promote products deried from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Part 3: Cambridge Broadband Ltd. copyright notice (BSD) Portions of this code are copyright 2001, Cambridge Broadband Ltd. All rights resered. Redistribution and use in source and binary forms, with or without modification, are permitted proided that the following conditions are met: Redistributions of source code must retain the aboe copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the aboe copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials proided with the distribution. The name of Cambridge Broadband Ltd. may not be used to endorse or promote products deried from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 66 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

75 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. BLT 2.4u Portions (c) 1993 AT&T, (c) Lucent Technologies, (c) Sun Microsystems, Inc., and (c) The Regents of the Uniersity of California. 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 names of AT&T, Lucent Technologies Inc., Sun Microsystems, Inc. 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. THE COPYRIGHT HOLDERS AND OTHER CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR OTHER CONTRIBUTORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. CMU-SNMP 1.14 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. CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Notices 67

76 Scotty 2.8, incrtcl 3.0, [incr TCL] 3.2 Portions Copyright (c) The Regents of the Uniersity of California. Copyright (c) Sun Microsystems, Inc. This software is copyrighted by the Regents of the Uniersity of California, Sun Microsystems, Inc., 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. RESTRICTED RIGHTS: Use, duplication or disclosure by the goernment is subject to the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software Clause as DFARS and FAR Portions Copyright (c) Lucent Technologies, Inc. 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 appear in all copies and that both that the copyright notice and warranty disclaimer appear in supporting documentation, and that the names of Lucent Technologies any of their entities not be used in adertising or publicity pertaining to distribution of the software without specific, written prior permission. Lucent disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness. In no eent shall Lucent be liable for any special, indirect or consequential damages or any damages whatsoeer resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortuous action, arising out of or in connection with the use or performance of this software. 68 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

77 UCD SNMP Portions 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. CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Portions Copyright: (c) , Networks Associates Technology, Inc, (c) , Cambridge Broadband Ltd, (c) , Sparta, Inc., (c) 2004, Cisco, Inc and Information Network Center of Beijing Uniersity of Posts and Telecommunications, (c) Fabasoft R&D Software GmbH & Co KG, 2003 [email protected]. All rights resered. Redistribution and use in source and binary forms, with or without modification, are permitted proided that the following conditions are met: 1. Redistributions of source code must retain the aboe copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the aboe copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials proided with the distribution. 3. Neither the names of Networks Associates Technology, Inc, Cambridge Broadband Ltd., Sparta, Inc., Cisco, Inc, Beijing Uniersity of Posts and Telecommunications, Fabasoft R&D Software GmbH & Co KG or any of its subsidiaries, brand or product names, nor the names of their contributors may be used to endorse or promote products deried from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT Notices 69

78 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. JDOM 1.0 Copyright (C) Jason Hunter & Brett McLaughlin. All rights resered. Redistribution and use in source and binary forms, with or without modification, are permitted proided that the following conditions are met: 1. Redistributions of source code must retain the aboe copyright notice, this list of conditions, and the following disclaimer. 2. Redistributions in binary form must reproduce the aboe copyright notice, this list of conditions, and the disclaimer that follows these conditions in the documentation and/or other materials proided with the distribution. 3. The name "JDOM" must not be used to endorse or promote products deried from this software without prior written permission. For written permission, please contact <request_at_jdom_dot_org>. 4. Products deried from this software may not be called "JDOM", nor may "JDOM" appear in their name, without prior written permission from the JDOM Project Management <request_at_jdom_dot_org>. In addition, we request (but do not require) that you include in the end-user documentation proided with the redistribution and/or in the software itself an acknowledgement equialent to the following: "This product includes software deeloped by the JDOM Project ( Alternatiely, the acknowledgment may be graphical using the logos aailable at THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This software consists of oluntary contributions made by many indiiduals on behalf of the JDOM Project and was originally created by Jason Hunter <jhunter_at_jdom_dot_org> and Brett McLaughlin <brett_at_jdom_dot_org>. For more information on the JDOM Project, please see < 70 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

79 Regex 1.1a Copyright (C) 1996, 1999 Vassili Byko. It is proided to the Smalltalk community in hope it will be useful. 1. This license applies to the package as a whole, as well as to any component of it. By performing any of the actiities described below, you accept the terms of this agreement. 2. The software is proided free of charge, and ``as is'', in hope that it will be useful, with ABSOLUTELY NO WARRANTY. The entire risk and all responsibility for the use of the software is with you. Under no circumstances the author may be held responsible for loss of data, loss of profit, or any other damage resulting directly or indirectly from the use of the software, een if the damage is caused by defects in the software. 3. You may use this software in any applications you build. 4. You may distribute this software proided that the software documentation and copyright notices are included and intact. 5. You may create and distribute modified ersions of the software, such as ports to other Smalltalk dialects or deried work, proided that: a. any modified ersion is expressly marked as such and is not misrepresented as the original software; b. credit is gien to the original software in the source code and documentation of the deried work; c. the copyright notice at the top of this document accompanies copyright notices of any modified ersion. Notices 71

80 72 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide

81

82 Printed in USA