IBM Support

IBM Tivoli Monitoring: AIX Premium Agent 6.2.2.3-TIV-ITM_AIX_PREM-IF0001

Fix Readme


Abstract

This is a cumulative interim fix for IBM Tivoli Monitoring: AIX Premium Agent 6.2.2.3.

Content

Release details

Product name System P Monitoring Agent
Component name Aix Premium agent
Release name 6.2.2.3-TIV-ITM_AIX_PREM-IF0001
Build ID 6.2.2.3-TIV-ITM_AIX_PREM-IF0001
Release date  17th June 2025

APARs fixed

Following is the list of APARs fixed with this release.

  • APAR: DT435260
    Abstract: Aix premium agent is randomly crashing.
    Additional information: The PX agent installed for some SYBASE databases is crashing periodically and generating core dumps.
       The core dump generates following stack trace:
         
unnamed block in UTF8String::initFromASCIIString(char*)(this = (nil), asciiString = "sybase"), line 56 in "UTF8String.cpp"
UTF8String::initFromASCIIString(char*)(this = (nil), asciiString = "sybase"), line 56 in "UTF8String.cpp"
unnamed block in CustomProviderServer::buildResultInstance(instance*,CustomQueryClass*)(this = 0x21cfbce0, instPtr = 0x2d81f4b8, customQueryClass = 0x21d9a390), line 1982 in "CustomProviderServer.cpp"
unnamed block in CustomProviderServer::buildResultInstance(instance*,CustomQueryClass*)(this = 0x21cfbce0, instPtr = 0x2d81f4b8, customQueryClass = 0x21d9a390), line 1982 in "CustomProviderServer.cpp"
unnamed block in CustomProviderServer::buildResultInstance(instance*,CustomQueryClass*)(this = 0x21cfbce0, instPtr = 0x2d81f4b8, customQueryClass = 0x21d9a390), line 1982 in "CustomProviderServer.cpp"
CustomProviderServer::buildResultInstance(instance*,CustomQueryClass*)(this = 0x21cfbce0, instPtr = 0x2d81f4b8, customQueryClass = 0x21d9a390), line 1982 in "CustomProviderServer.cpp"
unnamed block in CustomProviderServer::collectData(CustomQueryClass*,char*,List*,bool)(this = 0x21cfbce0, customQueryClass = 0x21d9a390, requestStartedID = "229fdc70", filterData = (nil), traceThisGroup = false), line 1235 in "CustomProviderServer.cpp"
unnamed block in CustomProviderServer::collectData(CustomQueryClass*,char*,List*,bool)(this = 0x21cfbce0, customQueryClass = 0x21d9a390, requestStartedID = "229fdc70", filterData = (nil), traceThisGroup = false), line 1235 in "CustomProviderServer.cpp"
unnamed block in CustomProviderServer::collectData(CustomQueryClass*,char*,List*,bool)(this = 0x21cfbce0, customQueryClass = 0x21d9a390, requestStartedID = "229fdc70", filterData = (nil), traceThisGroup = false), line 1235 in "CustomProviderServer.cpp"
CustomProviderServer::collectData(CustomQueryClass*,char*,List*,bool)(this = 0x21cfbce0, customQueryClass = 0x21d9a390, requestStartedID = "229fdc70", filterData = (nil), traceThisGroup = false), line 1235 in "CustomProviderServer.cpp"
CustomQueryClass::internalCollectData(char*)(this = 0x21d9a390, requestStartedID = "229fdc70"), line 349 in "CustomQueryClass.cpp"
ResultsManager::collectData(char*)(this = 0x21d9a390, requestStartedID = "229fdc70"), line 2965 in "ResultsManager.cpp"
CustomQueryClass::collectData(char*)(this = 0x21d9a390, requestStartedID = "229fdc70"), line 584 in "CustomQueryClass.cpp"
ResultsManager::collectDataIfNeeded(char*)(this = 0x21d9a390, requestStartedID = "229fdc70"), line 2925 in "ResultsManager.cpp"
unnamed block in GenericAgent::tsCollectData(List*,List*)(this = 0x229fdc70, qlist = 0x21cf0ad0, msnlist = 0x21cf0760), line 679 in "GenericAgent.cpp"
GenericAgent::tsCollectData(List*,List*)(this = 0x229fdc70, qlist = 0x21cf0ad0, msnlist = 0x21cf0760), line 679 in "GenericAgent.cpp"
GenericAgent::TakeSample()(this = 0x229fdc70), line 849 in "GenericAgent.cpp"
ctira::DriveDataCollection()(0x229fdc70) at 0x2020055c
TableManager::checkForExpiredRequests(int)(0x220905d0, 0x67b92d4f) at 0x20210004
TableManager::timeout(CTRA_Timerspec_*)(0x220906ac) at 0x2021209c
CTRA_timer_base::TimerCallbackHandler()(0x22082590) at 0x20219150
krabutmr.Handler_base(void*)(0x22082590) at 0x202198c0
krabuptm.CTRA_timer_task(void*)(0x22082b00) at 0x2021c63c

Agent defects
 -

Prerequisites

Following is the list of the prerequisites.

This fix is supported on all operating systems listed in the IBM Tivoli Monitoring: AIX Premium Agent User's Guide, version 6.2.2.1, which is the User's Guide for v6.2.2 Interim Feature 1 and Interim Feature 2.
The following link is for the Tivoli operating system and application support matrix.
Please refer to this matrix for the latest certification information.
  
The prerequisite level for this fix is as follows (available from Passport Advantage):
  • AIX Premium Agent 6.22 Fix Pack 3 which is contained in IBM Tivoli Monitoring for System p V 6.2.2.2 Fix Pack 4 (M0FD0EN) on Passport Advantage
As this fix is cumulative, it can be installed on any fix level for this version, release, and mod level above the prerequisite.

Download details

Following are the download details for this release.

  1. Go to the Fix Central download link: http://www.ibm.com/support/fixcentral/quickorder?fixids=6.2.2.3-TIV-ITM_AIX_PREM-IF0001&product=ibm%2FTivoli%2FIBM+Tivoli+Monitoring&source=dbluesearch&platform=All
  2. In the Select fixes page, ensure that the release is selected, and click Continue.
  3. In the Download options page, select an appropriate option from the Select download options.
  4. Ensure you select Include prerequisites and co-requisite fixes (you can select the ones you need later), and click Continue.
  5. Depending upon the Operating system on which your agent is installed, click the appropriate download link.

Additional information

The Secure Hash Algorithm 1 (SHA1) checksum of the image follows.

  • 6.2.2.3-TIV-ITM_AIX_PREM-IF0001.tar = 23043a8a9f21b5460a728963524c8bba64c94fa

The image contains the following files.

  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001.README - This README file
  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001.tar  - Fix archive .tar format
  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001.zip  - Fix archive .zip format.
Note: The .tar and .zip files are identical in content. Use the .tar file if you are working in a UNIX(R) environment; use the .zip file if you are working in a Windows(R) environment. 
    
The fix archive contains the following files:
  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001/px_dd_062203001.xml
  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001/px_dd.properties
  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001/kpx_aix523_tema_if0001.tar
  •  6.2.2.3-TIV-ITM_AIX_PREM-IF0001/kpxaix523.dsc

Installation instructions

This fix can only be installed over an existing installation.  Use the following steps to install this fix.
Before installing the fix 
------------------------------
  • For the purpose of this README, the symbol <CANDLEHOME> is the IBM Tivoli Monitoring installation directory. The default value for CANDLEHOME is '/opt/IBM/ITM' on UNIX systems and 'C:\IBM\ITM' on Windows systems.
  • Before installing this fix on UNIX systems, set the environment variable CANDLEHOME to the IBM Tivoli Monitoring installation directory.
    For example: 
    > CANDLEHOME=/opt/IBM/ITM 
    > export CANDLEHOME
  • Because there is no uninstall utility for this fix, make sure to perform a backup of your environment before installing this fix. 
Local agent update
  --------------------------
  1. Transfer the appropriate archive file (6.2.2.3-TIV-ITM_AIX_PREM-IF0001.tar or .zip) to a temporary directory on the system that contains the agent code to be updated.  For the purpose of this README, the symbol  <TEMP>  represents the fully qualified path to this directory.
    Note: On Windows systems, this path includes the drive letter.
  2. Expand the archive file using the "tar" command on UNIX systems or an extract utility on Windows systems. This step creates a directory structure that contains fixes for all of the supported platforms.
  3. Use the "itmpatch" command to install the fix for the operating system for that agent.  For more information on the "itmpatch" command, see section 6.2.    
On UNIX systems, if the fix was expanded to <TEMP>/6.2.2.3-TIV-ITM_AIX_PREM-IF0001, the install command is: 
> itmpatch -h <CANDLEHOME> 
-i <TEMP>/6.2.2.3-TIV-ITM_AIX_PREM-IF0005/kpx_aix523_tema_if0001.tar
Remote agent update
----------------------------
  1. Transfer the appropriate archive file (6.2.2.3-TIV-ITM_AIX_PREM-IF0001.tar or .zip) to a temporary directory on the IBM Tivoli Enterprise Monitoring Server system. For the purpose of this README, the symbol <TEMP> represents the fully qualified path to this directory. Note: On Windows systems, this path includes the drive letter.
  2. Expand the archive file using the "tar" command on UNIX systems or an extract utility on Windows systems.  This step creates a directory structure that contains fixes for all of the supported platforms.
  3. To add the agent fix bundles into the remote deploy depot, use the "tacmd addBundles" command found in $CANDLEHOME/bin on UNIX systems or in %CANDLE_HOME%\bin on Windows systems. For more information on the "tacmd addBundles" command, see the IBM Tivoli Monitoring Administrator's Guide.
    On UNIX systems, if the fix was expanded to <TEMP>/6.2.2.3-TIV-ITM_AIX_PREM-IF0001:
    > $CANDLEHOME/bin/tacmd addBundles -n -i <TEMP>/6.2.2.3-TIV-ITM_AIX_PREM-IF0001
    On Windows systems, if the fix was expanded to <TEMP>\6.2.2.3-TIV-ITM_AIX_PREM-IF0001:
    > %CANDLE_HOME%\bin\tacmd addBundles -n -i <TEMP>\6.2.2.3-TIV-ITM_AIX_PREM-IF0001
    Where,
    -n indicates that prerequisite bundles are not automatically added. The -n parameter must be used because the fix directory does not contain any prerequisites that the fix might require. 
    -i is the directory that contains the deployment bundles to be added to the depot. 
  4. To log in to the Tivoli Enterprise Monitoring server and deploy the fix to the appropriate nodes where the agent is running, use the following "tacmd" commands.  For more information on the "tacmd login" and "tacmd updateAgent" commands, see the IBM Tivoli Monitoring Administrator's Guide.
    On UNIX systems:  
    > $CANDLEHOME/bin/tacmd login -s <server>
                              -u <itmuser> 
                              -p <password>
> $CANDLEHOME/bin/tacmd listSystems
    The output shows the Managed System Name for the OS agent on the remote system to be updated. Use this value as the target of the "tacmd updateAgent" command. 
> $CANDLEHOME/bin/tacmd updateAgent -t px
                                    -n <Managed system name>
                                    -v 062203001
On Windows systems: 
> %CANDLE_HOME%\bin\tacmd login -s <server>
                                -u <itmuser> 
                                -p <password>
                                    
> %CANDLE_HOME%\bin\tacmd listSystems
The output shows the Managed System Name for the OS agent on the remote system to be updated. Use this value as the target of the "tacmd updateAgent" command. 
> %CANDLE_HOME%\bin\tacmd updateAgent -t PX 
                                      -n <Managed system name>    
                                      -v 062203001
Note:
  •  The component (-t) for the "tacmd updateAgent" command is specified as two characters (PX), not three characters (KPX).
  • The node (-n) for the "tacmd updateAgent" command is the managed system name of the operating system (OS) agent to be updated.
  • The target node for the "tacmd updateAgent" command is always an OS agent.
Agent support update
------------------------------
There are no agent support updates for the Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server, or Tivoli Enterprise Portal Desktop included in this fix or any of the superseded fixes. No additional installation steps are required.
    
Additional installation information
========================
For additional troubleshooting installation information, see the itmpatch.log in the patchlogs directory in <CANDLEHOME>.
Installation instructions for agent baroc file
  -----------------------------------------------------
  There are no updates to the baroc files included in this fix or
  any of the superseded fixes.  No additional installation steps are
  required.
Additional information on using "itmpatch" command
  --------------------------------------------------------------
  The "itmpatch" command has the following syntax:
  Usage: itmpatch -h <installation home> [OPTIONS]
  itmpatch -h <installation home>
           -t { <patch_file_directory> | <patch_file> }
  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 UNIX systems:
  - To preview the fix installation, use the "-t" option:
    > <CANDLEHOME>/bin/itmpatch -h <CANDLEHOME> -t <TEMP>
  - To install the fix, use the "-i" option:
    > <CANDLEHOME>/bin/itmpatch -h <CANDLEHOME> -i <TEMP>
  where:
  <CANDLEHOME> is the fully qualified IBM Tivoli Monitoring
  installation directory. On Windows systems, this path must include the drive letter.
  <TEMP> represents the fully qualified directory specification where the fix is located. On Windows systems, this must include the drive letter.

Post-installation tasks

 To verify the agent was updated correctly, use the "tacmd" command to view the agent's current version after the agent is restarted.
You are required to log in to a Tivoli Enterprise Monitoring Server before viewing the agent version.
For example:
On UNIX systems, where $CANDLEHOME is the IBM Tivoli Monitoring installation directory, the default location is '/opt/IBM/ITM'.    
> $CANDLEHOME/bin/tacmd login -s <server>
                              -u <itmuser> 
                              -p <password>
> $CANDLEHOME/bin/tacmd listSystems -t PX
On Windows systems, where %CANDLE_HOME% is the IBM Tivoli Monitoring installation directory, the default location is 'C:\IBM\ITM'.    
> %CANDLE_HOME%\bin\tacmd login -s <server>
                                -u <itmuser> 
                                -p <password>
> %CANDLE_HOME%\bin\tacmd listSystems -t PX 
Note: The component (-t) for the "tacmd listSystems" command is specified as two characters (PX), not three characters (KPX). When the agent update is successful, the agent version is now: 6.22.03.01.

Known issues

==============

None

Known limitations

==============

None

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"ARM Category":[{"code":"a8mKe000000TN31IAG","label":"General"}],"Platform":[{"code":"PF002","label":"AIX"}],"Version":"6.2.2"}]

Document Information

Modified date:
18 June 2025

UID

ibm17236100

Page Feedback