IBM Tivoli Monitoring: Unix(R) OS Agent, 6.1.0.7-TIV-ITM_UNIX-IF0005

Downloadable files


Abstract

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.3.

Download Description

(C) Copyright International Business Machines Corporation 2009. All

rights reserved.

Component: IBM(R) Tivoli(R) Monitoring: UNIX(R) OS Agent,
Version 6.1.0, Fix Pack 0007

Component ID: 5724C040U

Fix: Interim Fix 0005 (6.1.0.7-TIV-ITM_UNIX-IF0005)

Date: February 12, 2009

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.3.


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

2.1 APARs
-------------
APAR: IZ41973
Abstract: FILES WITH SIZE > 2GB ARE NOT SHOWING UP ON THE FILE INFORMATION
WORKSPACE.
Additional Information : Files with size > 2GB are not showing up on the File
Information workspace of the TEP, on AIX 5.1 32 bit.
The problem does not appear when the same agent is used in a 64-bit
environment. On 64-bit, when the max size of 214783647 is found, the
value reported is the expected "MAX VALUE EXCEEDED" in the
workspace. On 32-bit, nothing is reported, and the file is not listed.

APAR: IZ31059
Abstract: THE UNIX OS AGENT DOESN'T MONITOR FOR THE MISSING FILES
SITUATION PROPERLY.
Additional Information: The Unix OS agent doesn't monitor for the Missing File
situations properly. This happens in both ITM61 and ITM62 agents with
situations like the following one:
*IF *VALUE File_Information.Path_U *EQ '/opt/IBM/ITM/itoht' *AND
*MISSING File_Information.File_U *EQ ('testfile1.dat',
'testfile2.dat','testfile3.dat','testfile4.dat','testfile5.dat')

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

2.3 Superseded fixes
-------------------------
6.1.0.7-TIV-ITM_UNIX-LA0001
6.1.0.7-TIV-ITM_UNIX-LA0002
6.1.0.7-TIV-ITM_UNIX-LA0003
6.1.0.7-TIV-ITM_UNIX-LA0004

2.4 APARS and defects included from superseded fixes
---------------------------------------------------------------
6.1.0.7-TIV-ITM_UNIX-LA0001
-----------------------------------
APAR: IZ16547
Abstract: Workspaces system summary over time (daily, hourly),
availability (hourly) don't show data for the UNIX
systems.
Additional Information: Monitoring Agent for UNIX OS agents using
Oracle as the warehouse database do not show data for the
following workspaces:
1) Historical Summarized Availability Daily
2) Historical Summarized Availability Hourly.

APAR: IZ18894
Abstract: UX agent running on HP reports incorrect CPU stats.
Additional Information: Monitoring Agent for UNIX OS agents running
on an HP-UX machine which has processors in excess of 32
CPUs displays CPU values that are incorrect.

APAR: IZ18926
Abstract: UNIX OS agent gives false alerts for situations based on
disk attribute.
Additional Information: Monitoring Agent for UNIX OS Agent does not
return the data for all the Disks available in the system
to the Tivoli Enterprise Monitoring server and hence causes
the situations framed against Disks to give false alerts.

APAR: IZ20711
Abstract: UNIX agent running on AIX 5.2 DLPAR reports CPU system
idle value in excess of 100%.
Additional Information: The CPU idle percentage on an AIX 5.2 DLPAR
environment shows values in excess of 100%. This happens
when the configured number of CPU's is greater than
on-line CPU's.

6.1.0.7-TIV-ITM_UNIX-LA0002
-----------------------------------
APAR: IZ24169
Abstract: On AIX machines the attribute "number of system procs" will
only show a maximum of 10000 processes.
Additional Information: The Monitoring Agent for UNIX OS running
on an AIX machine displays the number of system procs to
be 10000 even though the actual number of processes
running on the box is in excess of 10000.

6.1.0.7-TIV-ITM_UNIX-LA0003
-----------------------------------
APAR: IZ26379
Abstract: ITM 6.1 agent displays negative values on TEPS for received and
transmitted count (frames) under the network attribute group.
Additional Information: The Monitoring Agent for UNIX OS displays negative
values for received and transmitted count (frames) under the
network attribute group when the value of these attributes go
beyond 2147483648.

6.1.0.7-TIV-ITM_UNIX-LA0004
-----------------------------------
APAR: IZ32551
Abstract: ITM UNIX OS AGENT ON HP MACHINES DOESN'T REPORT CORRECT
VALUES FOR THE ATTRIBUTE "AVERAGE QUEUE".
Additional Information: The Monitoring Agent for UNIX OS reports
wrong values for the "Average Queue" attribute on HP-UX machines.


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

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.1.0: Fix Pack 0007
(6.1.0-TIV-ITM-FP0007)


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

- 6.1.0.7-TIV-ITM_UNIX-IF0005.README - This README file
- 6.1.0.7-TIV-ITM_UNIX-IF0005.tar - Fix archive .tar format
- 6.1.0.7-TIV-ITM_UNIX-IF0005.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 file contains the following files :

- 6.1.0.7-TIV-ITM_UNIX-/kux_tems_teps_tepd_IF0005.tar - Support files for TEMS/TEPS
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_tems_teps_tepd_IF0005.zip - Windows TEPS Support files
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_aix513_tema_IF0005.tar - Binaries for AIX 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_aix516_tema_IF0005.tar - Binaries for AIX 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_hp11_tema_IF0005.tar - Binaries for HP-UX 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_hp116_tema_IF0005.tar - Binaries for HP-UX 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_hpi116_tema_IF0005.tar - Binaries for HP-UX Itanium.
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_sol283_tema_IF0005.tar - Binaries for Solaris 8 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_sol286_tema_IF0005.tar - Binaries for Solaris 8 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_sol293_tema_IF0005.tar - Binaries for Solaris 9/10 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_sol296_tema_IF0005.tar - Binaries for Solaris 9/10 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kux_sol606_tema_IF0005.tar - Binaries for Solaris 10 Opteron 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxaix513.dsc - Descriptor file for AIX 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxaix516.dsc - Descriptor file for AIX 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxsol283.dsc - Descriptor file for Solaris 8 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxsol286.dsc - Descriptor file for Solaris 8 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxsol293.dsc - Descriptor file for Solaris 9/10 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxsol296.dsc - Descriptor file for Solaris 9/10 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxsol606.dsc - Descriptor file for Solaris 10 Opteron 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxhp11.dsc - Descriptor file for HP-UX 32-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/kuxhp116.dsc - Descriptor file for HP-UX 64-bit
- 6.1.0.7-TIV-ITM_UNIX-IF0005/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> points to
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

- For APAR IZ18894, only on HP machines with processors in excess of 32,
set the environmental variable KBB_HPUX_SAR=TRUE.

- Since there is no uninstall utility for this fix, we suggest you
perform a backup of your environment before installing this fix.

5.2 Local agent update
--------------------------
1. Transfer the appropriate archive file
(6.1.0.7-TIV-ITM_UNIX-IF0005.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. Note: On Windows, this includes the drive letter.

2. Expand the archive file using the tar command
(tar -xvf 6.1.0.7-TIV-ITM_UNIX-IF0005.tar) on UNIX
systems. This creates a directory structure that contains fixes
for all of the supported platforms.

3. Use the itmpatch command to install the included fix for the target agent
platform. For more information on the itmpatch command, see section 6.1

On UNIX systems, if the fix was expanded to <TEMP>/6.1.0.7-TIV-ITM_UNIX-IF0005,
the install command would be:

> itmpatch -h <CANDLEHOME>
-i <TEMP>/6.1.0.7-TIV-ITM_UNIX-IF0005/kux_xxxxxx_tema_if0005.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_aix513_tema_if0005.tar
> ./cinfo -i
ux Monitoring Agent for UNIX OS
aix513 Version: 06.10.07.05

5.3 Remote agent update
----------------------------
1. Transfer the appropriate archive file
(6.1.0.7-TIV-ITM_UNIX-IF0005.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
(tar -xvf 6.1.0.7-TIV-ITM_UNIX-IF0005.tar) or unzip utility on Windows
systems. This 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 Appendix A. Commands reference
of the IBM Tivoli Monitoring Administrator's Guide.

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

On Windows systems, if the fix was expanded to
<TEMP>/6.1.0.7-TIV-ITM_UNIX-IF0005:
> %CANDLE_HOME%\bin\tacmd addBundles -n -i <TEMP>\6.1.0.7-TIV-ITM_UNIX-IF0005

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 may 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 login 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
updateAgent commands, see Appendix A. Commands reference of 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 ux
-n <Managed System Name>
-v 061007005

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 ux
-n <Managed System Name>
-v 061007005

Note:
- The component (-t) for the updateAgent command is specified as two
characters (ux), not three characters (kux).
- The node (-n) for the updateAgent command is the managed system
name of the operating system (OS) agent to be updated. The target
node for an updateAgent command is always an OS agent.

5.4 Agent support update
------------------------------
Use the following steps to update the Tivoli Enterprise Monitoring
Server, Tivoli Enterprise Portal Server, and Tivoli Enterprise
Portal Desktop.

1. Transfer the appropriate archive file (6.1.0.7-TIV-ITM_UNIX-IF0005.tar
to UNIX systems, or .zip to Windows systems) to the IBM Tivoli
Enterprise Monitoring Servers, IBM Tivoli Enterprise Portal Servers
and Tivoli Enterprise Portal Desktop.

2. Expand the archive file (tar -xvf kux_tems_teps_tepd_if0005.tar
on UNIX systems, or unzip kux_tems_teps_tepd_if0005.zip on
Windows systems). This creates a directory structure that contains
fixes for all of the supported platforms.

3. Expand the archive file
(kux_tems_teps_tepd_if0005.tar on UNIX systems, or .zip
on Windows systems) that contains the updates for Tivoli Enterprise
Monitoring Server,Tivoli Enterprise Portal Server and Tivoli Enterprise
Portal Desktop. This creates a directory structure that includes a
subdirectory called CD-ROM with the necessary updates.

4. Start the Application Support Installer GUI to install the fix.
The GUI can be started by using the following command from within
the CD-ROM directory where setup.jar is located:

On UNIX systems:
> $CANDLEHOME/JRE/<platform>/bin/java -jar setup.jar

On a Windows system:
> <"C:\Program Files\IBM\Java142">\jre\bin\java -jar setup.jar

where <"C:\Program Files\IBM\Java142"> is the default drive
and location of IBM Java 1.4.2. The location of IBM Java 1.4.2
on your system might vary.

When prompted by the Application Support Installer for the installable
media directory, select the CD-ROM directory, not the component
directory. The installer can install updates for multiple
components at the same time.

5. The next panel presented by the Application Support Installer asks
for the selection of which Tivoli Monitoring components you
would like to add application support to. For this fix the check
boxes should be as follows:

checked - Tivoli Enterprise Monitoring Server (TEMS)
checked - Tivoli Enterprise Portal Server (TEPS)
checked - Tivoli Enterprise Desktop Client (TEPD)

Continue through the remaining GUI panels selecting the UNIX OS Agent
06.10.07.05 support to complete the installation.

6. If the Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Desktop
or Tivoli Enterprise Portal Browser was running when the update was installed,
it must be restarted.


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

Note:
For APAR IZ18894, if you have not already done so, only on HP machines
with processors in excess of 32, set the environmental variable
KBB_HPUX_SAR=TRUE, and then stop and restart the agent.

6.1 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, 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.2 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 Window 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.10.07.05

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

2. To verify the agent support files were updated correctly, use the
kincinfo command on Windows systems or the cinfo command on
UNIX systems. The sample output below shows the versions of the
Tivoli Enterprise Portal Server, Tivoli Enterprise Monitoring
Server or Tivoli Enterprise Portal Desktop systems after this fix
has been successfully applied.

Note:
- The date of the build displayed may not be accurate. This is a
known problem.

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

./cinfo -i

*********** Fri February 13 05:03:29 EST 2009 **************
User : root Group: system bin sys security cron audit lp
Host name : mybox_dev Installer Lvl:06.10.07.00
CandleHome: /data/temsteps
******************************************************
...Product inventory
.
.
.

ux Monitoring Agent for UNIX OS
hp116 Version: 06.10.07.05
.
.
.

On a Windows System:
---------------------------
To validate that all components have been installed, run the
following command:

For example:
> %CANDLE_HOME%\InstallITM\kincinfo -i
*********** Thu Feb 13 08:24:39 Eastern Daylight Time 2009 ***********
User : Administrator Group : NA
Host Name : mybox_dev Installer: Ver: 061007000
CandleHome: C:\IBM\ITM
Installitm: C:\IBM\ITM\InstallITM
****************************************************************
...Product Inventory

.
.
.

UX IBM Tivoli Monitoring: UNIX OS Agent
WINNT Version: 06.10.07.05 Build: 20041231 0000
.
.
.


7.0 Known problems and workarounds
=========================
None.


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 Version 6.1.0 Fix Pack 7 (6.1.0-TIV-ITM-FP0007)

URL LANGUAGE SIZE(Bytes)
IBM Tivoli Monitoring Version 6.1.0 Fix Pack 7(ftp) English 999999999
IBM Tivoli Monitoring Version 6.1.0 Fix Pack 7(http) English 999999999

Installation Instructions

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

Download package


Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is DD?
6.1.0.7-TIV-ITM_UNIX-IF0005.zip 2/27/2009 English 16879000 FTP DD
6.1.0.7-TIV-ITM_UNIX-IF0005.tar 2/27/2009 English 29030000 FTP DD
6.1.0.7-TIV-ITM_UNIX-IF0005.README 2/27/2009 English 26000 FTP DD

Product Alias/Synonym

Unix Agent

Problems (APARS) fixed
IZ41973, IZ31059

Rate this page:

(0 users)Average rating

Document information


More support for:

Tivoli Components
ITM Agent UNIX V6

Software version:

6.1

Operating system(s):

AIX, HP-UX, Solaris

Reference #:

4022207

Modified date:

2014-01-14

Translate my page

Machine Translation

Content navigation