IBM Tivoli Monitoring 6.3.0 Fix Pack 7 Service Pack 7 TEMS fix for APAR IJ32640 (6.3.0.7-TIV-ITM-IF0009-IJ32650)

(C) Copyright International Business Machines Corporation 2021.
           All rights reserved.


Date: Thu May 13 04:11:27 PM 2021

Interim Fix Name: 6.3.0.7-TIV-ITM-IF0009-IJ32650

Based on IBM(R) Tivoli(R) Monitoring, Version 6.3.0: Fix Pack 07, Interim Fix 09


Contents:

1.0 General description
2.0 Problems fixed
3.0 Architecture and prerequisites
4.0 Image directory contents
5.0 Installation instructions
6.0 Additional Installation information
7.0 Known problems and workarounds
8.0 Additional product information
9.0 Notices

1.0 General description
=======================
This is a interim fix for ITM Tivoli Monitoring, Version 06.30.07.09.

This interim fix is provided as a temporary solution until an official maintenance
release is made available.

IMPORTANT NOTE: When performing any future code updates or maintenance,
it is critical that you validate that the APAR(s) from any previous
fixes are contained in the maintenance package you are installing to avoid
any code regressions. If there are any questions, please contact L2 for support.


2.0 Problems fixed
==================
The following problems are addressed by this interim fix.

  2.1 APARs
  ---------
  
        IJ32650 THE HUB MAY CRASH AFTER FP7 SP7 IS INSTALLED IF LDAP AUTHENTICAT
                ION IS ENABLED ON THE HUB

  2.2 Defects:
  ------------
  None.

  2.3 Enhancements: 
  -----------------
  None.
 
  2.4 Superseded fixes:
  ---------------------
  None.

  2.5 APARS and defects included from superseded fixes
  ----------------------------------------------------           
  None.

  2.6 Files modified or added in this fix
  ----------------------------------------------------           

  aix536
        aix536/ms/lib/libkglbase.a

  li6263
        li6263/ms/lib/libkglbase.so

  ls3266
        ls3266/ms/lib/libkglbase.so

  lx8266
        lx8266/ms/lib/libkglbase.so

  sol283
        sol283/ms/lib/libkglbase.so

  sol603
        sol603/ms/lib/libkglbase.so 
  winnt
        CMS\kglbase.dll

  wix64
        CMS\kglbase.dll



3.0 Platforms and prerequisites
==================================
This interim fix is supported on the following platforms:


  aix536      AIX 5.3 or later (64 bit)
  li6263      Linux Intel 2.6 kernel (32/64 bit all supported distributions)
  ls3266      Linux zSeries 2.6 kernel (64 bit all supported distributions)
  lx8266      Linux Intel 2.6 kernel (64 bit all supported distributions)
  sol283      Solaris Sparc V8 or later (32/64 bit)
  sol603      Solaris Intel V10 (64 bit)
  winnt       Windows 2003 or later (32/64 bit)
  wix64       Windows 2003 or later (64 bit)

  The following link is for the Tivoli operating system and application
  support matrix. Please refer to this matrix for the latest 
  certification information.

  http://www.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html

  3.1 Prerequisites for this interim fix
  ---------------------------------------------
  
  This interim fix is intended to be applied to this level of software:
        IBM Tivoli Monitoring, Version 6.3.0 Fix Pack 07, Service Pack 7

 
4.0 Files provided and Image contents
============================
- 6.3.0.7-TIV-ITM-IF0009-IJ32650.README - This README file
- 6.3.0.7-TIV-ITM-IF0009-IJ32650.tar - For extracting patch files using tar utility
- 6.3.0.7-TIV-ITM-IF0009-IJ32650.zip - For extracting patch files using unzip utility

   Extracting either of the above bundles (tar or zip) creates the following
   directory and files:

        6.3.0.7-TIV-ITM-IF0009-IJ32650
        |-- itmpatch.exe
        |-- kms_aix536_tems_ij32650.tar
        |-- kms_li6263_tems_ij32650.tar
        |-- kms_ls3266_tems_ij32650.tar
        |-- kms_lx8266_tems_ij32650.tar
        |-- kms_sol283_tems_ij32650.tar
        |-- kms_sol603_tems_ij32650.tar
        |-- kms_winnt_tems_ij32650.cab
        |-- kms_wix64_tems_ij32650.cab
        |-- patchtool
        `-- provpatch


                       
5.0 Installation instructions 
=============================

  5.1 Before installing the interim fix
  ------------------------------------------
  
  5.1.1 Assign CANDLEHOME environment variable (UNIX/LINUX ONLY)
  
  Before installing this interim fix on Unix systems, make sure that the 
  environment variable $CANDLEHOME is set to the IBM Tivoli Monitoring 
  installation directory. 

  Note: The directory /opt/IBM/ITM is the default installation directory.

    For example: 
    > CANDLEHOME=/opt/IBM/ITM 
    > export CANDLEHOME
   
   
  5.1.2 Determine the architecture of the target system.
  
  You need to determine the install architecture of the target system so that
  you can select the correct patch file(s) to apply to the system. To do this
  execute the following command for each patch component in the terminal 
  window on your target system.

  Note: <pc> is the product code from the above listed file(s):

      k<pc>_<arch>_<component>_<apar>.<tar or cab>
  
  For Windows:
  
  kincinfo -t <pc>   
  
  
  For Linux and Unix:
  
  $CANDLEHOME/bin/cinfo -t <pc>
  
  Record the architecture information that is listed under the PLAT column which
  appears in the output.
  
  In the following example, the architecture information column lists WINNT as 
  the architecture for the UE Product Code.
  
  C:\>kincinfo -t ue
  ************* Tuesday, May 24, 2011 3:38:15 PM **************
  User       : username              Group     : NA
  Host Name  : IBM-56C968D408C       Installer : Ver: 062205000
  CandleHome : C:\IBM\ITM
  Installitm : C:\IBM\ITM\InstallITM
  *************************************************************
  ...Product Inventory
  
  
  PC  PRODUCT DESC                                   PLAT   VER          BUILD         INSTALL DATE
  
  UE  Tivoli Enterprise Services User Interface Ext  WINNT  06.30.07.09  <DATENAME>        <YYYYMMDD> <TIME>

  5.1.3 Stopping affected IBM Tivoli Monitoring components

  The installation process will automatically stop most affected 
  agent components. However you will have to manually stop the TEMS and the TEPS 
  (product codes ms and cq respectively).  Note on Windows systems you will also 
  need to stop the "Manage Tivoli Enterprise Monitoring Services" application if 
  running.  Once the update is complete, components that were executing prior to 
  this patch installation should be restarted with the exception of TEMS(ms) and 
  TEPS(cq) which have to be manually started.
        
  5.1.4 Backup files to be modified
  
  For each fix applied, the installation will backup 
  affected files as follows:

        kms_aix536_tems_ij32650.tar     $CANDLEHOME/InstallITM/prov/06300709/kms_aix536_tems_pre-ij32650.tar
        kms_li6263_tems_ij32650.tar     $CANDLEHOME/InstallITM/prov/06300709/kms_li6263_tems_pre-ij32650.tar
        kms_ls3266_tems_ij32650.tar     $CANDLEHOME/InstallITM/prov/06300709/kms_ls3266_tems_pre-ij32650.tar
        kms_lx8266_tems_ij32650.tar     $CANDLEHOME/InstallITM/prov/06300709/kms_lx8266_tems_pre-ij32650.tar
        kms_sol283_tems_ij32650.tar     $CANDLEHOME/InstallITM/prov/06300709/kms_sol283_tems_pre-ij32650.tar
        kms_sol603_tems_ij32650.tar     $CANDLEHOME/InstallITM/prov/06300709/kms_sol603_tems_pre-ij32650.tar
        kms_winnt_tems_ij32650.cab      %CANDLE_HOME%\InstallITM\prov\06300709\kms_winnt_tems_pre-ij32650.cab
        kms_wix64_tems_ij32650.cab      %CANDLE_HOME%\InstallITM\prov\06300709\kms_wix64_tems_pre-ij32650.cab
    
  5.1.5 Patch Installation Requirements

  This fix should be applied to the following entities of your IBM Tivoli
  Monitoring environment.

        HUB Tivoli Enterprise Monitoring Server running with ITM 630 Fix Pack 7 Service Pack 7


  Note: See "Required order of installation or upgrade of IBM Tivoli
        Monitoring component products" for general rules:

        "http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/advanced/searchView.jsp?searchWord=Required order of installation or upgrade of IBM Tivoli Monitoring"

  5.1.6 Additional information

  - The prerequisites listed under section 3.1 entitled 'Prerequisites
    for this interim fix' must be installed before this interim fix
    can be installed.

  5.2 Local interim fix installation
  ------------------------------------------
  1. Transfer the appropriate archive file: 
     6.3.0.7-TIV-ITM-IF0009-IJ32650.tar or 6.3.0.7-TIV-ITM-IF0009-IJ32650.zip
     to a temporary directory on the system that contains the code to be 
     updated.  For the purpose of this README, the symbol <TEMP> represents
     the fully qualified path to this directory. 
     Note: On Windows, this includes the drive letter.

  2. Expand the archive file using the tar command on UNIX systems or 
     an unzip utility on Windows systems.  This creates a directory 
     structure that contains fixes for all of the supported platforms.
     
  3. Use the provpatch(or itmpatch.exe for windows) command to install the interim fix for each platform.
     For more information on the provpatch(itmpatch) command, see section 6.1.      

     On a UNIX/Linux systems, if the interim was expanded to <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650, 
     the install command for each <pc> and applicable platform would be:

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/kms_aix536_tems_ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/kms_li6263_tems_ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/kms_ls3266_tems_ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/kms_lx8266_tems_ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/kms_sol283_tems_ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/kms_sol603_tems_ij32650.tar

     On a Windows system, if the interim was expanded to <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650, 
     the install commands would be:

        <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650\itmpatch -h %CANDLE_HOME%
        -i <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650\kms_winnt_tems_ij32650.cab

        <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650\itmpatch -h %CANDLE_HOME%
        -i <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650\kms_wix64_tems_ij32650.cab
     

  5.3 Verifying the update
  ------------------------
  If the patch installs successfully, provpatch(itmpatch) should return the following
  message:

  "Command completed successfully"

  Finally, if the version of IBM Tivoli monitoring you are using supports it, 
  (ITM 6.2.1 FP2 or later, ITM 6.2.2 FP1 or later) you can run the cinfo 
  command with the -z option, which should print out the following messages
  On a UNIX/Linux systems, where $CANDLEHOME is the IBM Tivoli Monitoring
  installation directory.

  $CANDLEHOME/bin/cinfo -i -z

  will print one (or more) of the following:

    ms      Tivoli Enterprise Monitoring Server
             aix536  Version: 06.30.07.09
                           Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

    ms      Tivoli Enterprise Monitoring Server
             li6263  Version: 06.30.07.09
                           Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

    ms      Tivoli Enterprise Monitoring Server
             ls3266  Version: 06.30.07.09
                           Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

    ms      Tivoli Enterprise Monitoring Server
             lx8266  Version: 06.30.07.09
                           Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

    ms      Tivoli Enterprise Monitoring Server
             sol283  Version: 06.30.07.09
                           Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

    ms      Tivoli Enterprise Monitoring Server
             sol603  Version: 06.30.07.09
                           Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650                   

  On a windows system.

  kincinfo -i -z

  will print one (or more) of the following:

    MS      Tivoli Enterprise Monitoring Server
              WINNT  Version: 06.30.07.09 Build: cn-TEMA
                      Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

    MS      Tivoli Enterprise Monitoring Server
              WIX64  Version: 06.30.07.09 Build: cn-TEMA
                      Patch: 6.3.0.7-TIV-ITM-IF0009  APARs:IJ32650               

  5.4 Remote interim fix installation (if applicable)
  ------------------------------------------------------------

  Note: This section is only applicable if Descriptor Files (filenames which
  include the ".dsc" extension) accompany this interim fix.

  1. Transfer the appropriate archive file (6.3.0.7-TIV-ITM-IF0009-IJ32650.tar 
     or .zip) to a temporary directory on the system that contains the
     code to be updated.  For the purpose of this README, the 
     symbol <TEMP> represents the fully qualified path to this
     directory. Note: On Windows, this includes the drive letter.

  2. Expand the archive file using the tar command on UNIX systems or 
     an unzip utility on Windows systems.  This creates a directory 
     structure that contains fixes for all of the supported platforms.

  3. Add the files to the TEMS Depot by executing the following command
     
     For Unix and Linux packages

     cd <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/unix

     For Windows packages

     cd <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650

     tacmd addbundles -i . -n 

  4. Record the "Version" number that is displayed as output from executing
     the addbundles command in step 3 above.

     Example:

        Type         : Component
        Product Code : tf
        Deployable   : True
        Version      : 063007133      <=== Record this value
        Description  : 6.3.0.7-TIV-ITM-IF0009-IJ32650
        Host Type    : aix523
        Host Version : aix523,aix533
        Prerequisites:

  5. Distribute the fix to the target machines requiring this fix by
     executing the following command on the HUB TEMS for Unix Systems

     $CANDLEHOME/bin/tacmd updateframework -n <Managed System Node Name:KUX> -v XXXXXXXXX

     and for Linux Systems

     $CANDLEHOME/bin/tacmd updateframework -n <Managed System Node Name:LZ> -v XXXXXXXXX

     and for Windows Systems

     %Candle_Home%/bin/tacmd updateframework -n <Managed System Node Name:NT> -v XXXXXXXXXX

     Note: You must be have previously issued the command to log onto the HUB TEMS
           prior to executing the above commands. 
     Note: Where XXXXXXXXX is the Version value recorded from step 4 above.


6.0  Additional installation information
========================================


  6.1 Additional information on using provpatch(itmpatch) command
  ----------------------------------------------------
  The provpatch(itmpatch) command has the following syntax.

  Usage: <provpatch|itmpatch> -h <installation home> [OPTIONS]

  (provpatch|itmpatch) -h <installation home> 
           -t { <patch_file_directory> | <patch_file> }
           
  <provpatch|itmpatch> -h <installation home> 
           -i { <patch_file_directory> | <patch_file> }

  where

  -h  Specifies the IBM Tivoli Monitoring installation directory
  -i  Specifies the path to the directory or patch file to be installed
  -t  Generates a report of the actions to be taken by the patch

  For example, on a UNIX system:
  - To preview the interim fix installation, use the "-t" option:
    > <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h <CANDLEHOME> -t <TEMP>
    
  - To install the interim fix, use the "-i" option:
    > <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h <CANDLEHOME> -i <TEMP>
    
  where:   
  <CANDLEHOME> is the fully qualified IBM Tivoli Monitoring installation
  directory. On Windows, this must include the drive letter.
  <TEMP> represents the fully qualified directory specification, where
  the interim fix is located. On Windows, this must include the drive letter.

  6.2 Uninstalling the interim fix
  ------------------------------------


  To uninstall the patch on UNIX/Linux systems, stop all affected components then
  execute the following commands for each applicable system:

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i $CANDLEHOME/InstallITM/prov/06300709/kms_aix536_tems_pre-ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i $CANDLEHOME/InstallITM/prov/06300709/kms_li6263_tems_pre-ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i $CANDLEHOME/InstallITM/prov/06300709/kms_ls3266_tems_pre-ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i $CANDLEHOME/InstallITM/prov/06300709/kms_lx8266_tems_pre-ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i $CANDLEHOME/InstallITM/prov/06300709/kms_sol283_tems_pre-ij32650.tar

        <TEMP>/6.3.0.7-TIV-ITM-IF0009-IJ32650/provpatch -h $CANDLEHOME
                -i $CANDLEHOME/InstallITM/prov/06300709/kms_sol603_tems_pre-ij32650.tar

  To uninstall the patch on a Windows system, stop all affected components then
  execute the following commands for each applicable system:

        <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650\itmpatch -h %CANDLE_HOME%
                -i %CANDLE_HOME%\InstallITM\prov\06300709\kms_winnt_tems_pre-ij32650.cab

        <TEMP>\6.3.0.7-TIV-ITM-IF0009-IJ32650\itmpatch -h %CANDLE_HOME%
                -i %CANDLE_HOME%\InstallITM\prov\06300709\kms_wix64_tems_pre-ij32650.cab

7.0 Known problems and workarounds
==================================
None.
              
8.0 Additional product information
==================================
None.