Download
Downloadable File
File link | File size | File description |
---|---|---|
Abstract
This fix pack resolves the APARs and defects listed in section 2.0 "Problems Fixed" section below and includes the superseded fixes listed in section 2.4.
It updates the IBM Tivoli Monitoring framework components to v6.3.0 Fix Pack 07 Service Pack 6, including the IBM SDK Java® Technology Edition Java Runtime Environment (JRE) and the IBM GSKit Security Interface.
See section "3.2 Windows prerequisites for this fix" for more details about prerequisites of ITM 6.30 FP7 Service Pack 6 and later.
Download Description
All rights reserved.
Component ID: 5724C04LF
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 Copyright and trademark information
10.0 Notices
1.0 General description
This fix pack resolves the APARs and defects listed in section 2.0 "Problems Fixed" section and includes the superseded fixes listed in section 2.4. It updates the IBM Tivoli Monitoring framework components to v6.3.0 Fix Pack 07 Service Pack 6, including the IBM SDK Java® Technology Edition Java Runtime Environment (JRE) and the IBM GSKit Security Interface.
prerequisites of ITM 6.30 FP7 Service Pack 6 and later.
2.0 Problems fixed
The following problems are addressed by this fix.
APAR: IJ31008
Abstract: On Windows, update Microsoft Visual C++ Redistributatble (runtimes).
Additional information: Update Microsoft Visual C++ Redistributable (runtimes) used for IBM Tivoli Monitoring Log File Agent for both 32 and 64 bit components on
Windows from VC++ 7.1 (32-bit) and VC++ 9.0 (64-bit) to VC++ 12.0 (both 32 and 64 bit).
APAR: IJ31042
Abstract: Log File Agent can hang indefinitely at agent shutdown.
Additional information: The Log File Agent can hang indefinitely at agent
shutdown. The problem has been observed rarely on Red Hat Linux 8.
Attempts to stop the agent using command "itmcmd agent -o <INSTANCE_NAME> stop lo"
can fail with error:
CDP_DP_SHUTDOWN_MODE=V2
in one of the configuration files and the agent will use an alternate method to stop the agent:
$CANDLEHOME/config/klo_<instance>.ini (UNIX/Linux)
%CANDLE_HOME%\TMAITM6<_X64>\KLOENV_<instance> (Windows)
how many seconds the code should wait for the shutdown to complete when
CDP_DP_SHUTDOWN_MODE=V2 has been set. The default is 10 seconds but can be between
1 and 20. For example:
CDP_DP_SHUTDOWN_TIMER_SECS=5
2.2 Defects
Defect: 219217
Abstract: Update the Log File Agent Tivoli Enterprise Portal (TEP) client jar file
certificate (klo_resources.jar) expiration. The certificate will now expire on
2024-01-05.
None.
6.3.0-TIV-ITM_LFA-FP0006 - not shipped
6.3.0-TIV-ITM_LFA-FP0005
6.3.0-TIV-ITM_LFA-FP0004
6.3.0-TIV-ITM_LFA-FP0003
6.3.0-TIV-ITM_LFA-FP0002
6.3.0-TIV-ITM_LFA-FP0001
6.3.0-TIV-ITM_LFA-IF0005
6.3.0-TIV-ITM_LFA-IF0004
6.3.0-TIV-ITM_LFA-IF0003
6.3.0-TIV-ITM_LFA-IF0002
6.3.0-TIV-ITM_LFA-IF0001
2.5 APARs and defects included from superseded fixes
6.3.0-TIV-ITM_LFA-FP0005
APAR: IJ29525
Abstract: On zLinux, Log File Agent does not start.
Additional information: On zLinux, the Log File Agent does not start.
The following message is in the agent log file <hostname>_lo_<nnnnnnnnnn>.log:
/opt/IBM/ITM/ls3266/lo/bin/kloagent: error while loading shared
libraries: libstdc++.so.5: cannot open shared object file:
No such file or directory
Abstract: On Windows, NUMEVENTSTOCATCHUP=-1 skips messages if the monitored
log file was reset while the agent was not running.
Additional information: On Windows, when using NumEventsToCatchUp=-1 to have
the agent process all data written to the monitored log(s) while the agent
was not running, the agent incorrectly skips messages written if the
monitored log is smaller than it was when the agent last read records.
The problem could occur on the Log File Agent versions 6.30 FP2 - 6.30 FP4.
Abstract: Log File Agent does not install on zLinux with newer z/OS hardware.
Additional information: Log File Agent 6.30 FP4 does not install on zLinux
on newer z/OS hardware (z15). The installation loops due to issues with
GSKit 8.0.50.69 which is included in the image.
Abstract: Java 8 Webstart client fails with klo_resources.jar having a weak
signature.
Additional information: When using Java 8 to launch the Webstart Client, it
fails with the message "The following resource is signed with a weak
signature algorithm MD5withRSA and is treated as unsigned:
http://<hostname>:15200/classes/klo_resources.jar"
Abstract: Logname for syslog not compatible with old TEC Adapter.
Additional information: Logname for syslog not compatible with old TEC adapter.
The TEC adapter used a Logname (filename) SysLogd. Currently the Log File Agent
uses SysLogD.
In order for this APAR to be in effect, a new variable needs to be set in the
.conf file, named SyslogFilenameTEC. When set to "Y", then the Logname
attribute for the syslog will be SysLogd instead of SysLogD.
SyslogFilenameTEC=Y
continue to use SysLogD.
Abstract: On Linux, sighup does not cause rsyslog to reread syslog.conf file.
Additiional information: Starting around Red Hat version 4, when a new instance
of the Log File Agent is configured/started and the instance has been
configured to automatically initialize UNIX syslog to read messages from
the syslog, the agent will not receive messages written to syslog until
the rsyslog is restarted. This is because the SIGHUP command which the
agent has used to force the syslogd to re-read the conf file update does
not work with rsyslogd.
https://www.ibm.com/support/pages/node/256969
See 6.3.0-TIV-ITM_LFA-FP0004.README for a list of APARs and fixes included from
superseded fixes.
3.0 Architecture and prerequisites
This fix is supported on all operating systems listed in the Tivoli
Log File Agent User's Guide, version 6.3.0.
support matrix. Please refer to this matrix for the latest
certification information.
Please refer to the IBM Software Product Compatibility Reports (SPCR)
for the latest operating system certification information:
http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html
G
3.1 Prerequisites for this fix
This fix pack is a complete install image and as such, can be
installed on a pristine system.
this version, release, and mod level above the prerequisite version
6.3.0 FP7 SP6 of Tivoli Enterprise Monitoring Agent (TEMA/gl) Framework on
- Windows systems:
GL KGL(64-bit) CMA/Tivoli Enterprise Monitoring Agent Framework
- Linux or UNIX systems:
ax IBM Tivoli Monitoring Shared Libraries
li6263 Version: 06.30.00.00
lx8266 Version: 06.30.00.00
For details, see the Troubleshooting Wiki:
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?lang=en#/wiki/Tivoli%20Monitoring/page/Log%20File%20Agent
On Windows, starting in ITM 6.30 FP7 Service Pack 6, framework components and the Windows OS Agent shipped runtimes built using VC++12.0. In this fix pack for Log File Agent 6.30 FP7, the same is done via APAR IJ31008. As a result, when installing this fix on a system with other agents (e.g. Windows OS Agent) or server components (e.g. TEMS, TEPS), the runtimes must match how they were built (VC++12.0) or there can be
compatibility issues. Because of this, the framework files must be at the ITM 6.30 FP7 SP6 (or later) level as a prerequisite for this fix pack.
message (or write to the log in the case of remote deploy) indicating:
SP06 or greater framework install needed to continue
- If installing this fix on system where only the Log File Agent has been previously installed or on a new system, the installation can continue.
- If installing this fix on a system where other agents or server components are installed, the framework must first be upgraded to ITM 6.30 FP7 SP6 (or higher) before this Log File Agent Fix Pack 07 can be installed.
- If installing this fix using remote deploy, the remote system must be at ITM 6.30 FP7 SP6 (or later).
4.0 Image directory contents
This fix image contains the following files:
- 6.30-TIV-ITM_LFA-FP0007.README
- 6.30-TIV-ITM_LFA-FP0007.checksum
- The prerequisites listed under section 3.1 entitled 'Prerequisites for this fix' must be installed before this fix can be installed.
- 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.
un-install the WINNT 32-bit version of the agent and the 32/64
bit compatibility package.
5.2 Local agent update
For installation instructions, see the Log File Agent User's Guide v6.3.0:
http://www.ibm.com/support/knowledgecenter/SSTFXA_6.3.0/com.ibm.itm.doc_6.3/logfile/logfileagent_user.htm?lang=en
Note:
1. Transfer the archive file 6.3.0-TIV-ITM_LFA-FP0006.tar.gz 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.
an extract utility on Windows systems. This step creates a directory
structure that contains fixes for all of the supported platforms.
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.
1. The prerequisite Log File Agent bundles will be loaded into the
bundle using the addBundles command below.
2. Previous 6.3.0-TIV-ITM_LFA-FP000<n> bundles can be removed from the
depot when no longer needed, using the "tacmd removeBundles" command.
For example: tacmd removeBundles -t lo -v 06300000<n>
if the fix was expanded to <TEMP>/KLO_DVD-202202111727-20421:
> $CANDLEHOME/bin/tacmd addBundles -t LO -i <TEMP>/KLO_DVD-202202111727-20421/unix
On Windows systems,
if the fix was expanded to <TEMP>\KLO_DVD-202202111727-20421:
> %CANDLE_HOME%\bin\tacmd addBundles -t LO -i <TEMP>\KLO_DVD-202202111727-20421\WINDOWS\Deploy
where:
-i is the directory that contains the deployment bundles to be
added to the depot.
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.
> $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 lo
-n <Managed system name>
-v 06300700
> %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 LO
-n <Managed system name>
-v 06300700
Note:
- The component (-t) for the "tacmd updateAgent" command is
specified as two characters (LO), not three characters (KLO).
- 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.
This fix pack includes updates in the agent support files which need to be
installed. Install the updates to the Tivoli Enterprise Monitoring Server,
Tivoli Enterprise Portal Server, or Tivoli Enterprise Portal Desktop. For more
information about installing application support, see Installing and enabling
application support in the IBM Tivoli Monitoring Installation and Setup Guide.
6.0 Additional installation information
6.1 Update to Shared Components
Note: This fix pack includes updates to the following shared components which
might be installed into the IBM Tivoli Monitoring installation directory
(for example, CANDLEHOME), if a higher version does not already exist. These
are the same levels that are shipped as part of 6.30 FP7 Service Pack 6. The
installer is from 6.30 FP7 Service Pack 9.
for the JRE installed in the CANDLEHOME directory:
1.8.0 SR6 FP15 for CANDLEHOME on AIX, Linux, Solaris amd64 and Windows.
AIX 7.1 oslevel -r less than TL3 (7100-03) and for Linux RHEL < 6.0
and SLES < 11.1.
6.2 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.
6.3 Verifying the update
1. 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 prior to 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>
Monitoring installation directory, the default location
is 'C:\IBM\ITM'.
-u <itmuser>
-p <password>
> %CANDLE_HOME%\bin\tacmd listSystems -t LO
specified as two characters (LO), not three characters (KLO).
06.30.07.00.
After the agent is restarted, you can also use the GUI to verify
the agent was successfully updated.
For the agent on Windows systems, the version number is
06.30.07.00.
the "cinfo" command on Linux or UNIX systems or the "kincinfo"
command on Windows systems. The sample output shows the
minimum versions of IBM Tivoli Monitoring framework component,
IBM SDK Java Technology Edition Java Runtime Environment (JRE),
and the version of the Tivoli Enterprise Portal Server, Tivoli
Enterprise Monitoring Server, and Tivoli Enterprise Portal
Desktop systems after this fix pack has been successfully applied.
Note: The displayed date of the build might not be accurate. This
is a known problem.
On UNIX or Linux systems (except PowerPC little-endian):
To validate that all components have been installed, run the following command:
For example:
> $CANDLEHOME/bin/cinfo -i
User: root Groups: root
Host name : parents1 Installer Lvl:06.30.07.15
CandleHome: /opt/IBM/ITMlfa_fp7
***********************************************************
...Product inventory
lx8266 Version: 06.30.07.14
lx8266 Version: 08.00.55.17
lx8266 Version: 08.06.15.00
lx8266 Version: 06.30.07.00
lx8266 Version: 06.30.07.12
On Windows systems:
To validate that all components have been installed, run the following command:
For example:
> %CANDLE_HOME%\InstallITM\kincinfo -i
************ Tuesday, Januray 30, 2022 08:54:18 AM ************
User : Administrator Group : NA
Host Name : WINSERVER Installer : Ver: 063007120
CandleHome : C:\IBM\ITM
Installitm : C:\IBM\ITM\installITM
*************************************************************
...Product Inventory
WINNT Version: 06.30.07.15 Build: 202112071309
WINNT Version: 06.30.07.15 Build: 202112071309
WINNT Version: 06.30.07.12 Build: 202011121117
WIX64 Version: 06.30.07.12 Build: 202011121117
WIX64 Version: 06.30.07.14 Build: d0316a
WINNT Version: 06.30.07.14 Build: d0316a
WIX64 Version: 08.00.55.17 Build: d0283a
WINNT Version: 08.00.55.17 Build: d0283a
WINNT Version: 06.30.07.12 Build: 202011121117
WIX64 Version: 08.06.15.00 Build: 202010091045
WINNT Version: 08.06.15.00 Build: 202010091045
WIX64 Version: 06.30.07.00 Build: 202201041056
WINNT Version: 06.30.07.08 Build: d0316a
WINNT Version: 06.30.07.12 Build: 202011121117
fix, see the following lines in the agent log
<hostname>_lo_<instance>_kloagent_<timestamp>.log located in
$CANDLEHOME/logs on UNIX systems and
%CANDLE_HOME%\<tmaitm6 or tmaitm6_x64>\logs on Windows systems:
<timestamp> Driver: DEV:202110150948/5178383.3
<timestamp> Timestamp: Oct 15 2021 10:09:07
If running a remote deploy to a system running the 32-bit verison of the Monitoring
Agent for Windows OS that has been upgraded to 6.30 FP7 Service Pack 6 (or later),
there could be an issue due to "APAR IJ37883: Windows OS Agent 32-bit (6.30 FP7 SP6
and later)stops when processing event log messages".
remote deploy to the system, the remote deploy will fail if the agent stops. There
are a two workarounds listed in the APAR.
8.0 Additional product information
None.
9.0 Copyright and trademark information
A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at www.ibm.com/legal/copytrade.shtml.
10.0 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.
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.
Corporation in the United States, other countries, or both.
registered trademarks of Oracle and/or its affiliates.
and other countries.
other countries, or both.
marks of others.
-----------------------------------------------------------------
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.
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:
- IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT
NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE
AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE
- IBM will not be liable to you or indemnify you for any claims
related to the Excluded Components
- IBM will not be liable for any direct, indirect, incidental,
special, exemplary, punitive or consequential damages with respect
to the Excluded Components.
Prerequisites
- Windows systems:
GL KGL(64-bit) CMA/Tivoli Enterprise Monitoring Agent Framework
WIX64 Version: 06.30.00.00 Build: d3052a
- Linux or UNIX systems:
ax IBM Tivoli Monitoring Shared Libraries
li6263 Version: 06.30.00.00
lx8266 Version: 06.30.00.00
This fix pack is a complete install image and as such, can be installed on a pristine system. This fix is also cumulative, and can be installed on any fix level for this version, release, and mod level above the prerequisite.
Installation Instructions
Document Location
Worldwide
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
18 February 2022
UID
ibm16557312