IBM Tivoli Netcool® Performance Manager for Wireless

Readme file for: IBM Tivoli Netcool® Performance Manager for Wireless - 9.2 Interim Fix 1
Product/Component Release: 9.2
Update Name: , 9.2.0.38-TIV-TNPMW-IF0001
Fix ID: Tivoli Netcool Performance Manager for Wireless 9.2.0.38.007
Publication Date: 19 June 2009
Last modified date: 17 June 2009

Important: If you are viewing this readme offline, the most current version of the readme file can always be found online at: http://www.ibm.com/support/docview.wss?rs=3256&uid=swg27016062

Description

IBM Tivoli Netcool® Performance Manager for Wireless - 9.2 Interim Fix 1 is a patch release for TNPMW. It can only be applied on TNPMW 9.2 General Availability. This is a mandatory patch on TNPMW 9.2.

Contents

Download location
Prerequisites and co-requisites

Installation information:
  Prior to installation
  Installing
  Performing the necessary tasks after installation
  Troubleshoot Installation from Support Site
  Uninstalling if necessary

Additional information
List of fixes
Recommended patch level
Copyright and trademark information
Document change history

Download location

Download TNPMW 9.2 Interim Fix 1 from the following location:
http://www.ibm.com/eserver/support/fixes/ or access the fix from the table below.

Below is a list of products/components names, platforms, and file name(s) that apply to this readme file.

Product/Component Name: Platform: File Name:
TNPMW 9.2 Interim Fix 1 Solaris

ftp://ftp.software.ibm.com/software/tivoli_support/patches/patches_9.2.0.38/9.2.0.38-TIV-TNPMW-IF0001/9.2.0.38-TIV-TNPMW-IF0001.tar
TNPMW 9.2 Interim Fix 1 Linux

ftp://ftp.software.ibm.com/software/tivoli_support/patches/patches_9.2.0.38/9.2.0.38-TIV-TNPMW-IF0001/9.2.0.38-TIV-TNPMW-IF0001.tar

Please note that the download is the same for both Linux and Solaris


Prerequisites and co-requisites

Required products needed before installation of 9.2 Interim Fix 1

Product/Component Name: Platform: File:
TNPMW 9.2 General Availability Solaris / Linux Please see Passport Advantage

 

Installation information:

Before proceeding with the installation process, view the online version of the readme file to check if information has changed since the readme file download: http://www.ibm.com/support/docview.wss?rs=3256&uid=swg27016062

Prior to installation

Before installing TNPMW 9.2 Interim Fix 1, perform the following steps:

  1. Download the fix pack to an appropriate location
  2. Review the license terms and conditions
  3. Print and read this document and all associated references before applying this maintenance package.

 

Installing TNPMW 9.2 Interim Fix 1

1) Untar the 9.2.0.38-TIV-TNPMW-IF0001.tar distribution using the following commands:

   $ tar -xvf 9.2.0.38-TIV-TNPMW-IF0001.tar

    The following two files should now be available:
      vallent-vt-patch-P92038007-PMW9.2.0.38.007.tar.gz
      9.2.0.38-TIV-TNPMW-IF0001.README

2) Verify that the database is running.
 All other services should be stopped (sap stop).

   As user root:  
   # ksh
   # export WMCROOT= /appl/virtuo

   Run the patch deploy
   # $WMCROOT/admin/common/install/scripts/deploy_patch -wmcr /appl/virtuo -patch vallent-vt-patch-P92038007-PMW9.2.0.38.007.tar.gz

 Providing /appl as the location of the patch.

3) Run the post installation script 

      As user virtuo:

   $ cd /appl/virtuo/admin/support/bin
   $ ./post_install_TNPMW920_IF001.ksh

   Note: The script post_install_TNPMW920_IF001.ksh prompts the user for the Oracle
       'sys' password and this must be provided in order for the script to run.

4) To complete the installation, the following commands must be run.
   The application server should be started prior to running these command(sap start as).
   As user virtuo:

  a) Update the data dictionary with extra supplementary tables created for busy hour storage
   $ sbh_ext_tab_upgrader

   b) Remove secondary key fields dependencies
   $ sbh_sk_remover -i

   c) Provision the Stored Busy Hour KPIs
   $ sbh_admin -reprovision -n %

 

Post Installation Instrustions

TNPMW 9.2 stored busy hours(SBH) does not support the provisioning of secondary key fields.
Prior to provisioning of SBH definitions, the following command must be run.
As user virtuo:

   $ sbh_sk_remover -f <BusyHourInstance.xml>

The sbh_sk_remover tool removes secondary key fields from SBH definitions to enable
provisioning on the TNPMW 9.2 system.

This command will read the input file, remove all SBH definitions that use a secondary
key field as a determiner and remove secondary key fields from all other SBH definitions
in the file.

The input file will be backed up with the original file name with the suffix “_original”
added before the xml extension, and a new modified file output with the original file name.
For example:

   $ sbh_sk_remover -f BusyHourInstance.xml

will result in output file:

   BusyHourInstance.xml

and a back up copy of the original file named:

   BusyHourInstance_original.xml

 

Troubleshoot Installation from Support site.
http://www-01.ibm.com/software/sysmgmt/products/support/TivoliNetcoolPerformanceManagerforWireless.html


Uninstalling if necessary

Uninstalling Interim Fix 1

  • When the IF01 patch is uninstalled, the system will be rolled back to the previous version of TNPMW which was installed.

    The only supported upgrade path for IF01 is on top of 9.2.0 GA. So when IF01 is uninstalled the system is rolled back to 9.2.0 GA.

    The patch can be removed by running the following commands:

  •  

    1) All services, apart from the database, should be stopped (sap stop):

       Verify that the services are not running using the following command:
       $ sap disp
      
    2) As user root:

       $ ksh  
       $ cd /appl/virtuo/admin/software/core
       $ ./vallent-vt-patch-P92038007.remove    
          
    3) As user virtuo:

       $ ksh
       $ cd /appl/virtuo/admin/support/bin
       $ ./uninstall_TNPMW920_IF001.ksh

       Note: The script uninstall_TNPMW920_IF001.ksh prompts the user for the Oracle
             'sys' password and this must be provided in order for the script to run.


    List of fixes

    Fixes included in IBM Tivoli Netcool® Performance Manager for Wireless - 9.2 Interim Fix 1:
     http://www.ibm.com/support/docview.wss?rs=3256&uid=swg27016059

     APARs ClearQuest Description
    86262 NJLoader fails to parse LIF containing & and ]

    IZ53617

         		89768 SBH Provisioning omits those with secondary keys
    89666 9.2 UPGRADE : additional <entity>_dbh tables are not created when upgrade from 9.1.2 to 9.2 is performed
    88839 Data dictionary failed to run after TP upgrade.

    Recommended patch level

    Please review the the recommended patch level for IBM Tivoli Netcool® Performance Manager for Wireless:
    http://www.ibm.com/support/docview.wss?rs=3256&uid=swg21380997

    Copyright and trademark information

    http://www.ibm.com/legal/copytrade.shtml

  • Notices

    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 jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

    This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

    Other company, product, or service names may be trademarks or service marks of others.

    THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

    The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

    Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions:

    Document change history

    Created/Revised By: Date of Creation/Update: Summary of Changes:
    SOR 17 June 2009 Offline version created