IBM Tivoli Monitoring: UNIX OS Agent 6.2.2.6-TIV-ITM_UNIX-IF0002

Downloadable files


Abstract

This fix resolves the APARs and defects listed in the “Problems Fixed” section below

Download Description

(C) Copyright International Business Machines Corporation 2012. All

rights reserved.

Component: IBM(R) Tivoli(R) Monitoring: UNIX(R) OS Agent,
Version 6.2.2

Component ID: 5724C040U

Fix: Interim Fix 0002 (6.2.2.6-TIV-ITM_UNIX-IF0002)

Date: 16 December 2012

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 fix resolves the APARs and defects listed in the "Problems Fixed"
section below. This fix also includes the superseded fixes listed in
section 2.4.


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

2.1 APARs
---------
APAR: IV32051
Abstract: MISSING CIFS FILE SYSTEMS
Additional Information: On AIX the Monitoring Agent for UNIX OS is not
able to monitor CIFS file systems when KBB_SHOW_NFS=TRUE is set.

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

2.3 Enhancements
----------------
None.

2.4 Superseded fixes
--------------------
6.2.2.6-TIV-ITM_UNIX-IF0001

2.5 APARS and defects included from superseded fixes
----------------------------------------------------
6.2.2.6-TIV-ITM_UNIX-IF0001
---------------------------
APAR: IV06922
Abstract: KUXAGENT HAS PERFORMANCE PROBLEM IN COPYING STRINGS
Additional Information: The Monitoring Agent for UNIX OS kuxagent
process generates high cpu usage when it copies a huge number
of strings that are related to process attribute group, while
using strncpy() API.

APAR: IV06977
Abstract: ITM OS AGENT OPENS UTMPX FILE IN RW MODE ON SOLARIS
Additional Information: On Solaris the Monitoring Agent for UNIX
OS kuxagent and stat_daemon processes open, using Solaris APIs,
OS utmpx file in RW mode. In order to open this file in READ_ONLY
mode a new configuration key has been added: KUX_UTMPX_READONLY
Default values is FALSE but it can be enabled using the following
key in the ux.ini file:
KUX_UTMPX_READONLY=TRUE

APAR: IV10238
Abstract: SLOW TEP UPDATE WHILE USING PARGS COMMAND
Additional Information: On Solaris the Monitoring Agent for UNIX OS
kuxagent process takes a very long time to collect process info
while executing pargs command.
A new variable KUX_PARGS_ENABLE has been added in order to permit
to the user to decide if pargs command should be used to collect
process information, the default value for this variable is FALSE.
It can be enabled setting the following in the ux.ini file:
KUX_PARGS_ENABLE=TRUE

Defect: 165471
Abstract: Avoid to use utmpx in HP and return 'Not Available'
for related values
Additional Information:
On HP the Monitoring Agent for UNIX OS kuxagent and stat_daemon
processes open, using HP APIs, utmpx file in RW mode. In order
to avoid to open this file a new configuration key has been added:
KUX_SKIP_HP_UTMPX
Default values is FALSE but it can be enabled using the following
key in the ux.ini file:
KUX_SKIP_HP_UTMPX=True
In this way the following attributes show 'Not Available':
- "User Sessions" in "Unix All Users" Group
- "Number of User Sessions", "Up Time Seconds)" and "Boot Time"
in "System Attribute" Group
- "Idle Time" and "User ID" in "User Attribute" Group

'No one logged on':
- "Login Name", "Login Name (Unicode)" in "User Attribute" Group

3.0 Architecture and prerequisites
==================================
This fix is supported on all operating systems listed in the
IBM Tivoli Monitoring: UNIX OS Agent User's Guide, version 6.2.2.

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 fix
------------------------------
- IBM Tivoli Monitoring, Version 6.2.2 Fix Pack 6.


4.0 Image directory contents
============================
This fix image contains the following files:

- 6.2.2.6-TIV-ITM_UNIX-IF0002.README - This README file
- 6.2.2.6-TIV-ITM_UNIX-IF0002.tar - Fix archive .tar format
- 6.2.2.6-TIV-ITM_UNIX-IF0002.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 environment; use the .zip file if
you are working in a Microsoft Windows(R) environment.

The fix archive file contains the following :
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_tems_teps_tepd_if0002.tar - Support files for IBM Tivoli Enterprise Monitoring Server/Tivoli Enterprise Portal Servers
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_tems_teps_tepd_if0002.zip - Support files for IBM Tivoli Enterprise Monitoring Server/Tivoli Enterprise Portal Servers
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_aix523_tema_if0002.tar - UNIX Agent binaries for AIX 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_aix526_tema_if0002.tar - UNIX Agent binaries for AIX 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_hp11_tema_if0002.tar - UNIX Agent binaries for HP-UX 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_hp116_tema_if0002.tar - UNIX Agent binaries for HP-UX 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_hpi116_tema_if0002.tar - UNIX Agent binaries for HP-UX Itanium.
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_sol283_tema_if0002.tar - UNIX Agent binaries for Solaris 8 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_sol286_tema_if0002.tar - UNIX Agent binaries for Solaris 8 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_sol293_tema_if0002.tar - UNIX Agent binaries for Solaris 9/10 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_sol296_tema_if0002.tar - UNIX Agent binaries for Solaris 9/10 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kux_sol606_tema_if0002.tar - UNIX Agent binaries for Solaris 10 Opteron 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxaix523.dsc - Descriptor file for AIX 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxaix526.dsc - Descriptor file for AIX 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxsol283.dsc - Descriptor file for Solaris 8 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxsol286.dsc - Descriptor file for Solaris 8 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxsol293.dsc - Descriptor file for Solaris 9/10 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxsol296.dsc - Descriptor file for Solaris 9/10 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxsol606.dsc - Descriptor file for Solaris 10 Opteron 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxhp11.dsc - Descriptor file for HP-UX 32-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxhp116.dsc - Descriptor file for HP-UX 64-bit
- 6.2.2.6-TIV-ITM_UNIX-IF0002/kuxhpi116.dsc - Descriptor file for HP-UX Itanium

Each tar or cab file has updates to the IBM Tivoli Enterprise Monitoring
Server component for a specific platform. The platform that each file
applies to is included in its name.

5.0 Installation instructions
=============================
This fix can only be installed over an existing installation. Use
the following steps to install this fix.

5.1 Before installing the fix
-----------------------------
- 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
- Since there is no uninstall utility for this fix, we suggest you
perform a backup of your environment before installing this fix.

- It is recommended to verify the "cinfo" commands are operating
correctly on the system prior to installing the patch. See
section "7.0 Known problems and workarounds" for the workaround
for the problem titled "Remote deploy of the patch fails"

5.2 Local agent update
----------------------
1. Transfer the appropriate archive file
(e.g. 6.2.2.6-TIV-ITM_UNIX-IF0002.tar) 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.

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 that agent platform.
For more information on the itmpatch command, see section 6.1

For example:
On a UNIX system, if the fix was expanded to
<TEMP>/6.2.2.6-TIV-ITM_UNIX-IF0002, the install command would be:

> itmpatch -h <CANDLEHOME>
-i <TEMP>/6.2.2.6-TIV-ITM_UNIX-IF0002/kux_xxxxxx_tema_if0002.tar

where:
- xxxxxx corresponds to the value in the first column returned
by the ./cinfo -i command.

In the following example, the file would be kux_aix523_tema_if0002.tar
> ./cinfo -i
ux Monitoring Agent for Unix OS
aix523 Version: 06.22.06.02


5.3 Remote agent update
------------------------
1. Transfer the appropriate archive file
(e.g. 6.2.2.6-TIV-ITM_UNIX-IF0002.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, this 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.

For example:
On UNIX systems,
if the fix was expanded to <TEMP>/6.2.2.6-TIV-ITM_UNIX-IF0002
> $CANDLEHOME/bin/tacmd addBundles -n -i <TEMP>/6.2.2.6-TIV-ITM_UNIX-IF0002

On a Windows system,
if the fix was expanded to <TEMP>/6.2.2.6-TIV-ITM_UNIX-IF0002
> %CANDLEHOME%\bin\tacmd addBundles -n -i <TEMP>\6.2.2.6-TIV-ITM_UNIX-IF0002

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. Please see Section 3.1 for the prerequisites
for this fix.
-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.

For example:
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 ux
-n <Managed System Name>
-v 062206002

On a Windows system:
> %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.

> %CANDLEHOME%/bin/tacmd updateAgent -t ux
-n <Managed System Name>
-v 062206002

Note:
- The component (-t) for the "tacmd updateAgent" command is
specified as two characters ([xx]), not three characters ([kxx]).
- 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.

5.4 Agent support update
------------------------
This fix (6.2.2.6-TIV-ITM_UNIX-IF0002) doesn't include changes to
the agent support files.

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

6.1 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.2 Additional information on using itmpatch command
-----------------------------------------------------
The itmpatch command has the following syntax.

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

itmpatch -h <installation home>
-i { <patch_file_directory> | <patch_file> }

itmpatch -h <installation home>
-t { <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:
<CANDLEHOME> points to the IBM Tivoli Monitoring installation directory
<TEMP> points to the temporary directory where the fix is located.

- 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, this must include the drive
letter.
<TEMP> represents the fully qualified directory specification, where
the fix is located. On Windows, this must include the drive letter.

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 login 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>
> $CANDLEHOME/bin/tacmd listSystems -t ux

On a Windows system, 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 ux

When the agent update is successful, the agent version should now
be:
06.22.06.01

Note:
- The component (-t) for the tacmd listSystems command is specified
as two characters UX, not three characters KUX.


On UNIX or Linux systems:
-------------------------
To validate that all components have been installed, run the
following command:

./cinfo -i

This command offers you four options on the CINFO menu shown in
the example that follows. Choose the option that meets your needs.

*********** Mon Feb 11 03:01:19 EST 2010 ******************
User : root Group: system bin sys security cron audit lp
Host name : candleaix3 Installer Lvl:06.22.06.00
CandleHome: /data/rthan/fp1temsteps
***********************************************************

-- CINFO Menu --
1) Show products installed in this CandleHome
2) Show which products are currently running
3) Show configuration settings
4) Show installed CD release versions
X) Exit CINFO
1

*********** Mon Feb 11 03:01:21 EST 2010 ******************
User : root Group: system bin sys security cron audit lp
Host name : candleaix3 Installer Lvl:06.22.06.00
CandleHome: /data/rthan/fp1temsteps
***********************************************************
...Product inventory
.
.
.

ux Monitoring Agent for UNIX OS
aix523 Version: 06.22.06.02

.
.
.

Sample output of the kincinfo command on a Windows System
---------------------------------------------------------
To validate that all components have been installed, run the
following command kincinfo -i and check UNIX OS Support Version.


7.0 Known problems and workarounds
==================================
It can happen that installation of this Interim Fix can fail when
there are a lot of defunct processes on the system related to kuxagent
process. When this issue occurs please stop situations related to
"Ping" attribute group, recycle the agent and them apply again the IF.


8.0 Additional product information
==================================
None.


9.0 Notices
===========
This information was developed for products and services offered in the United
States. IBM may not offer the products, services, or features discussed in this
document in other countries. Consult your local IBM representative for information
on the products and services currently available in your area. Any reference to an
IBM product, program, or service is not intended to state or imply that only that
IBM product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify
the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:

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

Trademarks and Service Marks
----------------------------
IBM, the IBM logo, and ibm.com(R) are trademarks or registered
trademarks of International Business Machines Corporation in the
United States, other countries, or both. If these and other IBM
trademarked terms are marked on their first occurrence in this
information with a trademark symbol (R or TM), these symbols
indicate U.S. registered or common law trademarks owned by IBM
at the time this information was published. Such trademarks may
also be registered or common law trademarks in other countries.
A current list of IBM trademarks is available on the Web at
"Copyright and trademark information" at
http://www.ibm.com/legal/copytrade.shtml.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks
of Microsoft Corporation in the United States, other countries, or
both.

Java and all Java-based trademarks are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States
and other countries.

Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both.

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

Prerequisites

IBM Tivoli Monitoring: Unix Agent 6.2.2 Fix Pack 6

Installation Instructions

Please refer to the 6.2.2.6-TIV-ITM_UNIX-IF0002.README contained in the Description section above for general installation instructions.

Download package

Fix Central

Fix Central is a new way to acquire fixes. In the future it will be the only option for downloading fixes, but for now we are including it as an additional download option. The two main differences from the current download options will be the FTP option will be replaced by HTTP and that you will need to use an IBM registered ID. The reason for this, is we can use Fix Central to notify you if there is a problem with the fix. Privacy is maintained.

To download the files using Fix Central use the following link:


Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central (FC)?
6.2.2.6-TIV-ITM_UNIX-IF0002 28 Dec 2012 English 1 FC

Problems (APARS) fixed
IV32051

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Components
ITM Agent UNIX V6

Software version:

6.2.2.6

Operating system(s):

AIX, HP-UX, Solaris

Reference #:

4034152

Modified date:

2013-11-25

Translate my page

Machine Translation

Content navigation