IBM Tioli Netcool Performance Manager Wireline Component October 2015 Document Reision R2E1 Pack Upgrade Guide IBM
Note Before using this information and the product it supports, read the information in Notices on page 49. Copyright IBM Corporation 1997, 2015. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents Oeriew.............. Audience............... Organization.............. Tioli Netcool Performance Manager - Wireline Component............... Tioli Netcool Performance Manager documentation i Chapter 1. Introduction........ 1 Before you begin the upgrade........ 1 Supported upgrade paths for Tioli Netcool Performance Manager technology packs..... 1 Installing prerequisite software........ 2 Tioli Netcool Performance Manager technology pack distribution............... 2 Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3.......... 3 Oeriew............... 3 Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and technology packs........... 3 Upgrade scenario for Tioli Netcool/Proiso 4.4.3 and Alcatel-Lucent 5620 SAM......... 4 Upgrading the Alcatel-Lucent 5620 SAM Technology Pack............ 5 Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and Netflow IPFIX............ 6 Upgrading the Netflow IPFIX Technology Pack.. 7 Documents you need for technology pack upgrade 8 Current limitations with Tioli Netcool/Proiso 4.4.3 fix pack 1 and pre-fix pack 3......... 11 Limitations with how the Topology Editor treats UBA pack-specific parameters....... 11 Limitations with UBA pack-specific parameter key/alue pairs............ 12 Before you begin a technology pack upgrade... 13 Standard procedure for upgrading technology packs (Except Alcatel-Lucent 5620 SAM and Netflow IPFIX)................ 14 Upgrade scenario 1 (SNMP and UBA technology packs)............... 14 Upgrade scenario 2 (UBA packs only).... 16 Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager.............. 19 Oeriew............... 19 Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and Tioli Netcool Performance Manager technology packs............ 20 Upgrade scenario for Tioli Netcool/Proiso 4.4.3 and Alcatel-Lucent 5620 SAM........ 21 Upgrading the Alcatel-Lucent 5620 SAM Technology Pack............ 22 Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 or Tioli Netcool Performance Manager and Netflow IPFIX............. 22 Upgrading the Netflow IPFIX Technology Pack 23 Netflow IPFIX upgrade scenario 1...... 24 Netflow IPFIX upgrade scenario 2...... 25 Documents you need to perform a technology pack upgrade............... 25 Essential information in the pack installation and configuration guide........... 28 Essential information in pack release notes... 29 Essential Information in the Installation Guide.. 29 Essential information in the Tioli Netcool/Proiso fix pack 3 or Tioli Netcool Performance Manager ReadMe....... 30 Topology Editor and UBA pack-specific properties 30 Technology pack XSD upgrade wizard.... 31 Limitations with UBA pack-specific parameter key/alue pairs............ 32 Before you begin a technology pack upgrade... 33 Before you begin upgrade scenario 2 (UBA packs only)............... 34 Standard procedure for upgrading technology packs 36 Upgrade scenario 1 (SNMP and UBA technology packs) (except Alcatel-Lucent 5620 SAM, Netflow IPFIX)............... 36 Upgrade scenario 2 (UBA packs only) (Including Alcatel-Lucent 5620 SAM, Netflow IPFIX)... 41 Upgrading to Alcatel-Lucent 5620 SAM LogToFile 2.5.0.0............... 43 Upgrading Alcatel-Lucent 5670 RAM..... 44 Upgrading Huawei U2000 DSLAM Technology Pack................ 45 Notices.............. 49 Terms and conditions for product documentation.. 51 Trademarks.............. 52 Additional copyright notices......... 53 Copyright IBM Corp. 1997, 2015 iii
i IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
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 should hae a thorough understanding of the following subjects: Basic principles of TCP/IP networks and network management SNMP 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 4.4.3 fix pack 1 or pre-fix pack 3, on page 3 Chapter 3, Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager, on page 19 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. DataView is a reliable application serer for on-demand, web-based network reports. Copyright IBM Corp. 1997, 2015
Technology Packs extend the Tioli Netcool Performance Manager system with serice-ready reports for network operations, business deelopment, and customer iewing. The following figure shows the different Tioli Netcool Performance Manager modules. Tioli Netcool Performance Manager documentation consists of the following: Release notes Configuration recommendations Installation and upgrade information User guides Technical notes Online help The documentation is aailable for iewing and downloading on the information center at http://www-01.ibm.com/support/knowledgecenter/ssbnj7_1.4.0/ com.ibm.tnpm_1.4_kc.doc/tnpm_1.4_kc_welcome.html?lang=en. Tioli Netcool Performance Manager documentation IBM proides the following Tioli Netcool Performance Manager documentation: Release notes Configuration recommendations References Technology pack upgrade guide Installation guide Technical notes Online help i IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
Chapter 1. Introduction 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 4.4.3 fix pack 3 or Tioli Netcool Performance Manager ersion 1.3.0 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 4.4.3 or Tioli Netcool Performance Manager 1.3.1. For more information, see Supported upgrade paths fortioli 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 Upgrading Tioli Netcool Performance Manager - Wireline Component 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 Upgrading Tioli Netcool Performance Manager - Wireline Component 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 Upgrading Tioli Netcool Performance Manager - Wireline Component 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 Upgrading Tioli Netcool Performance Manager - Wireline Component 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, 2015 1
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 Configuration Recommendations. 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
Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 Oeriew Describes how to upgrade Tioli Netcool/Proiso technology packs after you upgrade your system to Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3. About this task If you hae upgraded your Tioli Netcool/Proiso 4.4.3 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 4.4.3 fix pack 3 or Tioli Netcool Performance Manager, on page 19. What to do next Important: IBM does not support Tioli Netcool/Proiso pre-4.3.3 from 1.3-E release onwards. It is recommended that you upgrade to Tioli Netcool/Proiso 4.4.3 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 4.4.3 pre-fix pack 3. Guidelines for erifying UBA technology pack-specific properties when upgrading a UBA technology pack after upgrading to Tioli Netcool/Proiso 4.4.3 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 4.4.3 and technology packs This section proides information you need to upgrade technology packs so that they operate correctly on a Tioli Netcool/Proiso 4.4.3 system. Table 1 on page 4 identifies the upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and technology packs. Copyright IBM Corp. 1997, 2015 3
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 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2. You want to upgrade to Tioli Netcool/Proiso 4.4.3 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 4.4.3. 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 4.4.3 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 1 (SNMP and UBA technology packs) on page 14 for details about this upgrade scenario. Perform the following steps: 1. Upgrade Tioli Netcool/Proiso 4.4.3 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 16 for details. Upgrade scenario for Tioli Netcool/Proiso 4.4.3 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 4.4.3 fix pack 1 or pre-fix pack 3 system. Important: Design changes in Tioli Netcool/Proiso 4.4.3 require you to upgrade Alcatel-Lucent 5620 SAM before upgrading to Tioli Netcool/Proiso 4.4.3 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 4.4.3 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
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 4.4.3. 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 4.4.3 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 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2. You want to upgrade to 4.3-U or later after upgrading to Tioli Netcool/Proiso 4.4.3 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 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2. You want to upgrade to 4.3-U or later after upgrading to Tioli Netcool/Proiso 4.4.3 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 4.4.3 pre-fix pack 3, follow these steps: Procedure 1. Upgrade to Tioli Netcool/Proiso 4.4.3 pre-fix pack 3 by following the instructions in Upgrading Tioli Netcool Performance Manager - Wireline Component 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 4.4.3 pre-fix pack 3. See Essential information in the technology pack release notes on page 9 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 4.4.3 pre-fix pack 3. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 5
Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 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 4.4.3 fix pack 1 or pre-fix pack 3 system. About this task Important: Design changes in Tioli Netcool/Proiso 4.4.3 require you to upgrade the Netflow IPFIX Technology Pack before upgrading to Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre- fix pack 3. Otherwise, this pack stops working. Table 3 identifies the upgrade scenarios for Tioli Netcool/Proiso 4.4.3 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 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2. You want to upgrade to Tioli Netcool/Proiso 4.4.3 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 4.4.3. 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 4.4.3 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 4.4.3 fix pack 1 or pre-fix pack 3. 6 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
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 must 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 1.3-L Upgrade to Tioli Netcool/Proiso 4.4.3 pre-fix pack 3 Note: The Cisco Netflow Technology Pack is renamed Netflow IPFIX Technology Pack in 1.3-L because it now supports IPFIX. To upgrade to the 1.3-L Netflow IPFIX Technology Pack and Tioli Netcool/Proiso 4.4.3 pre-fix pack 3, follow these steps: Procedure Uninstall the preious flow collector or Aurora Netflow Collector before installing the TNPMFLOW Collector by following these steps: Important: You must perform these steps when upgrading from 4.3-T or 4.3-U. You must be logged in as root user to perform the following procedure: 1. For flow collector, follow these steps: 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. Note: For Aurora Netflow Collector, follow these steps: a. Stop the currently running Aurora Netflow Collector by issuing the following command: aurora stop b. Uninstall the Aurora Netflow Collector by issuing the following command: aurora deinstall 2. Install the 1.3-L Netflow IPFIX Technology Pack using the instructions contained in the Installing and Configuring Technology Packs. 3. Using the root account, install the tnpmflow adaptor by changing to the following directory: cd /opt/datamart/apfiles/cisco_netflow/adaptor 4. Extract the tnpmflow tar gunzip file. For example: Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 7
gunzip tnpmflow-4.1.1.9-2013.06.13-sparc64.tar.gz tar -xf tnpmflow-4.1.1.9-2013.06.13-sparc64.tar 5. Change to the tnpmflow directory, and then run the INSTALL script. 6. Configure the 1.3-L Netflow IPFIX Technology Pack by following the instructions contained in the Technology Pack Installation and Configuration Guide. Note: See Limitations with UBA pack-specific parameter key/alue pairs on page 12 for information related to specifying UBA key/alue pairs. Important: Technology packs might not work unless they are configured. 7. Validate that the Netflow IPFIX Technology Pack is working in the Netflow IPFIX enironment before upgrading to Tioli Netcool/Proiso 4.4.3 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 4.4.3 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 Upgrading Technology Packs, and Pack Release Summary and Installing and Configuring Common Packs are aailable at the http://www-01.ibm.com/support/knowledgecenter/ssbnj7_1.3.2/ com.ibm.tnpm.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) Upgrade scenario 2 (UBA packs only) Installing Tioli Netcool Performance Manager - Wireline Component (for 4.4.3) Upgrading Technology Packs Pack Release Summary (for 4.3-U and the later) Installing Tioli Netcool Performance Manager - Wireline Component (for 4.4.3) Upgrading Technology Packs The ReadMe for pre-fix pack 3 Pack Release Summary (for 4.3-V or later) See Essential information in the installation guide on page 10 See Essential information in the technology pack release notes on page 9 See Essential information in the installation guide on page 10 See Essential information in Tioli Netcool/Proiso pre-fix pack 3 ReadMe on page 10 See Essential information in the technology pack release notes on page 9 8 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
Table 4. 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/Proiso: Installation Guide (for 4.4.1 or 4.4.2) and Installing Tioli Netcool Performance Manager - Wireline Component (for 4.4.3) Upgrading Tioli Netcool Performance Manager - Wireless Component (for 4.3-V) See Essential information in the installation guide on page 10 See Essential information in the technology pack release notes Upgrading Technology Packs Netflow IPFIX upgrade scenario 1 IBM Tioli Netcool/Proiso: Installation Guide (for 4.4.1 or 4.4.2) and Installing Tioli Netcool Performance Manager - Wireline Component (for 4.4.3) Upgrading Technology Packs See Essential information in the installation guide on page 10 See Essential information in the technology pack release notes Pack Release Summary (for 4.3-V or later) Netflow IPFIX upgrade scenario 2 Installing Tioli Netcool Performance Manager - Wireline Component (for 4.4.3) Upgrading Technology Packs Pack Release Summary (for 4.3-V) See Essential information in the installation guide on page 10 See Essential information in the technology pack release notes Note: For technology packs released in 1.3-E release onwards, the user guides are deprecated. For more information, see Pack Release Summary. 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 4.4.3.3 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 Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 9
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: http://www-306.ibm.com/software/sysmgmt/products/support/ NetcoolProiso.html Note: To receie announcements about new interim fixes, you might sign up for email 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 4.4.3 IBM Tioli Netcool/Proiso: 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) on page 14 for more details. Upgrade scenario 2 Refer to the technology pack installation chapter proided in the 4.4.3 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 16 for more details. Netflow IPFIX upgrade scenario 1 Refer to the 4.3-U/4.3-V technology pack installation appendix that is proided in the 4.4.1 or 4.4.2 IBM Tioli Netcool/Proiso: Installation Guide. You need these instructions to upgrade (install) the 4.3-V ersions of these packs. Refer to the 4.4.3 IBM Tioli Netcool/Proiso: Installation Guide to install Tioli Netcool/Proiso 4.4.3. 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 4.4.3 to pre-fix pack 3. See Essential information in the technology pack release notes on page 9 for the URL to the site address for interim fixes and fix packs. 10 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
Current limitations with Tioli Netcool/Proiso 4.4.3 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) by using an XML format. Typical pack-specific properties that are defined in these XSD files include DELETEONACQUIRE, DESIGNFILE, and URI. In fact, the pack-specific properties that are 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 by using a topology.xml file, the alues that are 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 4.4.3 core components and a UBA technology pack. When you upgrade to Tioli Netcool/Proiso 4.4.3 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 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2 to Tioli Netcool/Proiso 4.4.3 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 5 on page 12 describes the current limitations that are associated with how the Topology Editor treats UBA pack-specific property settings for the upgrade scenarios that are described in Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and technology packs on page 3. Note: SNMP technology packs do not hae associated XSD files. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 11
Table 5. Current limitations with Topology Editor and UBA pack-specific properties Upgrade Scenario 1 Upgrade Scenario 2 Upgrade scenario 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 that are associated with the UBA Collectors. You need not do anything 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. It 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. 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 (by 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 14. 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 4.4.3 effect 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.1.100.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. 12 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
Before you begin a technology pack upgrade About this task Before you upgrade a technology pack, ensure that you completed 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 you perform the pack upgrade, see Essential information in the technology pack release notes on page 9. Consulted with your IBM Professional Serices representatie before you upgrade a technology pack. Your IBM Professional Serices Representatie uses the documentation sources that are described in Documents you need for technology pack upgrade on page 8. CAUTION: If you hae a customized technology pack that is 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 you upgrade 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 9. Access to the product distribution site: https://www-112.ibm.com/software/howtobuy/softwareandserices 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: http://www-306.ibm.com/software/sysmgmt/products/support/netcoolproiso.html For more information, see Essential information in the technology pack release notes on page 9. Access to the Tioli Netcool Performance Manager documentation, technology pack user guides, and technology pack release notes, which are aailable at the Tioli Netcool Performance Manager Technology Pack Knowledge Center For more information about what to look for in the documents that are needed 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 4.4.3 fix pack 1 and pre-fix pack 3 on page 11 for current limitations.) - How to work with custom properties Read and understood the upgrade scenarios that are described in the chapter. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 13
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) Upgrade scenario 2 (UBA packs only) on page 16 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. Upgrade scenario 1 (SNMP and UBA technology packs) About this task You are currently running Tioli Netcool/Proiso 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2. You want to do the following: Upgrade to Tioli Netcool/Proiso 4.4.3 pre-fix pack 3 (which you do before performing the pack upgrade by following the instructions in the Upgrading Tioli Netcool Performance Manager - Wireline Component 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 that is proided in the 4.4.3 IBM Tioli Netcool/Proiso:Upgrading Technology Packs 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 that you upgraded, by referring to the configuration appendix of the appropriate technology pack user's guide. Important: Technology packs do 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 that is associated with the UBA pack you upgraded. c. In the Application Pack iew, select the UBA pack that you upgraded. d. Display the COLLECTOR_UBA.x.x entry. The DataChannel core and pack-specific properties display in the properties window. 14 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
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 subelement. Value - Specifies the alue that is 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 that is 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 that is specified would be ERRORFILEMAX. Note: Do not enter the channel number (<CHANNEL>, collector number(<collector>, instance (UNIV_WAN_MGR, and schema(avail) in the Name field. h. Specify a alue in the Alias field according to the 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 that is associated with the UBA pack you upgraded. c. In the Application Pack iew, select the UBA pack that 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 4.4.3 Tioli Netcool/Proiso Upgrading Technology Packs. 7. Configure the UBA technology pack that you upgraded, by referring to the configuration appendix of the appropriate technology pack user guide. Important: Technology packs do not work unless they are configured. Table 6. Example Mappings for Ciena Transmission Technology Pack Template file parameter Topology Editor property Comments UBA.2.100. INSTANCES= streaming INSTANCES=CIENA_DEVICE The INSTANCES parameter that is 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. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 15
Table 6. Example Mappings for Ciena Transmission Technology Pack (continued) Template file parameter Topology Editor property Comments UBA.2.100. streaming. DESIGNFILE= CienaAdaptor.js UBA.2.100.streaming.CEMS.URI= file:///export/ home/puser/ uba_files/cems/ input/*.cs UBA.2.100. streaming. DELETEONACQUIRE= false CIENA_DEVICE. DESIGNFILE= CienaAdaptor.js CIENA_DEVICES.CEMS.URI=$5f tp://$1:$2@$3/ $4/*.cs CIENA_DEVICE.CEMS. DELEATEONACQUIRE=false 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. 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 that are listed. In this example, the DELETEONACQUIRE parameter in the template file and the Topology Editor property hae the same alue (false). It 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 that are 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 4.4.3. Completed the update of Tioli Netcool/Proiso 4.4.3 to fix pack 3 or Tioli Netcool Performance Manager by following the instructions in the 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. 16 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
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. 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 you replace 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 that is associated with the UBA pack you upgraded. c. In the Application Pack iew, select the UBA pack that 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 4.4.3 Tioli Netcool/ProisoInstalling Technology Packs. 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 that are proided in the pack installation chapter of the 4.4.3 Tioli Netcool/ProisoInstalling Technology Packs. 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 that 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. Chapter 2. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3 17
18 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide
Chapter 3. Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager This chapter describes how to upgrade your technology packs, after you upgraded to Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager. If you upgraded to Tioli Netcool/Proiso 4.4.3 fix pack 1 or pre-fix pack 3, you must follow the upgrade instructions that are presented in Chapter 2, Upgrading technology packs on Tioli Netcool/Proiso 4.4.3 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 you upgrade to Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager ( Topology Editor and UBA pack-specific properties on page 30.) Guidelines for erifying UBA technology pack-specific properties when you upgrade a UBA technology pack after you upgrade to Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager ( Topology Editor and UBA pack-specific properties on page 30.) Specific upgrade scenarios for the following technology packs: Alcatel-Lucent 5620 SAM Technology Pack. For more information, see Upgrade scenario for Tioli Netcool/Proiso 4.4.3 and Alcatel-Lucent 5620 SAM on page 4. Netflow IPFIX Technology Pack. For more information, see Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and Netflow IPFIX on page 6. Important: Design changes in Tioli Netcool/Proiso 4.4.3 require that you must upgrade Alcatel-Lucent 5620 SAM and Netflow IPFIX before you upgrade from Tioli Netcool/Proiso 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, and 4.4.2 to Tioli Netcool/Proiso 4.4.3 fix pack 3 or Tioli Netcool Performance Manager. Otherwise, these packs stop working. See also the Pack Release Summary to determine the ersion from which a technology pack is upgradeable. For example, the Release Summary for Tioli Netcool Performance Manager might specify that your technology pack is upgradeable from ersion 4.3-V or later. Copyright IBM Corp. 1997, 2015 19
Upgrade scenarios for Tioli Netcool/Proiso 4.4.3 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 4.4.3 fix pack 3 or Tioli Netcool Performance Manager system. Table 7 identifies the upgrade scenarios for Tioli Netcool/Proiso 4.4.3 and technology packs. Table 7. 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 4.4.1 MR1 or earlier, 4.4.1 fix pack 1 or later, or 4.4.2. You want to upgrade to Tioli Netcool/Proiso 4.4.3 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 4.4.3. You want to update to Tioli Netcool/Proiso 4.4.3 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 4.4.3 fix pack 3 or Tioli Netcool Performance Manager. 2. See Documents you need to perform a technology pack upgrade on page 25 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 36 for details about this upgrade scenario. Perform the following steps: 1. Upgrade Tioli Netcool/Proiso 4.4.3 to fix pack 3 or Tioli Netcool Performance Manager 2. See Documents you need to perform a technology pack upgrade on page 25 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 41 for details. 20 IBM Tioli Netcool Performance Manager: Pack Upgrade Guide