IBM Support

IBM Tivoli Monitoring For Virtual Servers: Citrix Agent 6.1.0-TIV-ITM_CTX-IF0004

Download


Abstract

This fix resolves the APARs and defects listed in the "Problems Fixed" below.

Download Description

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

Component: IBM(R) Tivoli(R) Monitoring for Virtual Servers: Citrix
Agent, Version 6.1.0

Component ID: 5724L92CO

Interim Fix 0004, 6.1.0-TIV-ITM_CTX-IF0004

Date: March 1, 2010

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 the fix.

2.1 APARS
---------
APAR: IZ67658
Abstract: HISTORICAL DATA COLLECTION MISSING DATA FOR CITRIX 4.5
Additional Information: Historical data collection does not
populate data for Citrix(R) 4.5 and 5.0 because some
files are missing on the agent.

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

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

2.4 Superseded fixes
--------------------
6.1.0-TIV-ITM_CTX-LA0003
6.1.0-TIV-ITM_CTX-LA0002

2.5 APARS and defects included from superseded fixes
----------------------------------------------------
6.1.0-TIV-ITM_CTX-LA0003
------------------------
Upon moving to Citrix 4.5, the Presentation Srv attribute group
no longer displays data. This is because Citrix moved several
metrics from one perfmon object to another. This limited
availability fix creates two new attribute groups, Presentation
Srv 45 and Citrix Licensing, to display the data for Citrix 4.5.

6.1.0-TIV-ITM_CTX-LA0002
-------------------------------
APAR: IY83878
Abstract: No data display in Tivoli Enterprise(TM) Portal
for 'Presentation Server' workspace.
Additional Information: Reporting of the Operational Status of
the Presentation Server has been added to the
agent. The Operational Status represents the abililty
of the Presentation Server to respond to requests made
to it.

Upon applying Citrix hotfixes PSE400W2KR01 or
PSE400W2K3R01 to the monitored Citrix machine, the
'Presentation Server' workspace no longer shows data,
as the DSCHECK metric is no longer posted to perfmon.
This limited availability fix allows data to be
displayed for the Presentation Srv attribute group.
This fix updates the agent with updated kqx.ref
file.


3.0 Architecture and prerequisites
==================================
The following link is for the Tivoli platform 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:
--------------------------------
The prerequisite level for this fix is as follows:

- IBM Tivoli Monitoring for Virtual Servers: Citrix Agent,
version 6.1.0.

As this fix is cumulative, it can be installed on any fix level for
this version, release, and mod level above the prerequisite.

4.0 Image directory contents
============================
Each fix image contains the following files:
- 6.1.0-TIV-ITM_CTX-IF0004.README - This README file
- 6.1.0-TIV-ITM_CTX-IF0004.tar - Fix archive .tar format
- 6.1.0-TIV-ITM_CTX-IF0004.zip - Fix archive .zip format.

The fix archive file contains the following files:
- 6.1.0-TIV-ITM_CTX-IF0004/kqx-teps-tems-if0004.tar
- 6.1.0-TIV-ITM_CTX-IF0004/kqx-teps-tems-if0004.zip
- 6.1.0-TIV-ITM_CTX-IF0004/kqxwinnt.dsc
- 6.1.0-TIV-ITM_CTX-IF0004/kqx_winnt_tema_if0004.cab
- 6.1.0-TIV-ITM_CTX-IF0004/qx_dd.properties
- 6.1.0-TIV-ITM_CTX-IF0004/qx_dd_061000004.xml


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(R) systems and 'C:\IBM\ITM'
on Windows(R) 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

5.2 Local agent update
----------------------
1. Transfer the archive file (6.1.0-TIV-ITM_CTX-IF0004.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, this includes the drive letter.

2. Expand the archive file using the an unzip utility on Windows
systems. This creates a directory structure that contains the
fixes.

3. Use the itmpatch command to install the fix. For more
information on the itmpatch command, see section 6.2.

On a Windows system, if the fix was expanded to
<TEMP>\6.1.0-TIV-ITM_CTX-IF0004, the install command would be:

> itmpatch -h <CANDLEHOME>
-i
<TEMP>\6.1.0-TIV-ITM_CTX-IF0004\kqx_winnt_tema_if0004.cab


5.3 Remote agent update
-----------------------
1. Transfer the appropriate archive file
(6.1.0-TIV-ITM_CTX-IF0004.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
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 Commands reference of the
IBM Tivoli Monitoring Administrator's Guide.

On a UNIX system,
if the fix was expanded to <TEMP>/6.1.0-TIV-ITM_CTX-IF0004:
> $CANDLEHOME/bin/tacmd addBundles -n
-i <TEMP>/6.1.0-TIV-ITM_CTX-IF0004

On a Windows system,
if the fix was expanded to <TEMP>/6.1.0-TIV-ITM_CTX-IF0004:
> %CANDLE_HOME%\bin\tacmd addBundles -n
-i <TEMP>\6.1.0-TIV-ITM_CTX-IF0004

where:
-n indicates that prerequisite bundles are not automatically
added. The -n parameter must be used because the patch
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 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 a UNIX system:
> $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 qx
-n <Managed system name>
-v 061000004

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.

> %CANDLE_HOME%\bin\tacmd updateAgent -t QX
-n <Managed system name>
-v 061000004
Note:
- The component (-t) for the updateAgent command is specified as
two characters (qx), not three characters (kqx).

- 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
------------------------
This fix (6.1.0-TIV-ITM_CTX-IF0004) includes support files
which need to be installed. Use the following steps to update
the Tivoli Enterprise Monitoring Server, Tivoli Enterprise
Portal Server, or Tivoli Enterprise Portal Desktop.

1. Transfer the archive file (6.1.0-TIV-ITM_CTX-IF0004.tar or .zip)
to the IBM Tivoli Enterprise Monitoring Servers, IBM Tivoli
Enterprise Portal Servers or Tivoli Enterprise Portal Desktops.

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. Expand the archive file (kqx-teps-tems-if0004.tar or .zip)
that contains the updates for Tivoli Enterprise Monitoring Server,
Tivoli Enterprise Portal Server, and Tivoli Enterprise Portal Desktop
using the tar command on UNIX systems or an unzip utility on Windows
systems. 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 a UNIX system:

> $CANDLEHOME/JRE/<platform>/bin/java -jar setup.jar

On a Windows system:

> <"C:\Program Files\IBM\Java50">\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 may vary.

When prompted by the Application Support Installer for the fix
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 three Tivoli Monitoring components
you would like to add application support to. For this fix
(6.1.0-TIV-ITM_CTX-IF0004) 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 Citrix
06.10.00.04 support to complete the installation.

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


6.0 Additional installation information
========================================
6.1 Installation instructions for agent baroc file
-----------------------------------------------------
Fix 6.1.0-TIV-ITM_CTX-IF0004 includes changes to the agent
baroc files which need to be reinstalled.
Please refer to the IBM Tivoli Monitoring, Version 6.2.1,
Installation and Setup Guide under "Installing monitoring
agent baroc files on the event server" in "Installing the
IBM Tivoli Enterprise Console Event Synchronization" section
for more information.

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 a UNIX system:
- 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.

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 QX

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

When the agent update is successful, the agent version is:
06.10.00.04.

2. To verify the agent support files were updated correctly, use the
kincinfo command on Windows systems or the cinfo command on Linux
or 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 might 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

*********** Mon Feb 22 13:37:20 EST 2010 ******************
User: root Groups: root bin daemon sys adm disk wheel
Host name : mylinuxsys Installer Lvl:06.21.00.01
CandleHome: /opt/IBM/ITM
***********************************************************
...Product inventory
.
.
.
Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal
Server and Tivoli Enterprise Portal Desktop update:

qx Monitoring Agent for Citrix Access Suite
tms Version: 06.10.00.04
tpd Version: 06.10.00.04
tps Version: 06.10.00.04

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

For example:
> %CANDLE_HOME%\InstallITM\kincinfo -i

*********** Monday, February 22, 2010 3:02:07 PM ************
User : Administrator Group : NA
Host Name : mywinbox Installer: Ver: 062100000
CandleHome: C:\IBM\ITM
Installitm: C:\IBM\ITM\InstallITM
*********************************************************************
.
.
.
Tivoli Enterprise Monitoring Server, Tivoli Enterprise
Portal Server and Tivoli Enterprise Portal Desktop update:

QX IBM Tivoli Monitoring for Virtual Servers: Citrix Agent
WINNT Version: 06.10.00.04 Build: 20041231 0000

QX IBM Tivoli Monitoring for Virtual Servers: Citrix Agent
WINNT Version: 06.10.00.04 Build: 20041231 0000

QX Citrix Support
WINNT Version: 06.10.00.00 Build: 200603081403

QX IBM Tivoli Monitoring for Virtual Servers: Citrix Agent
WINNT Version: 06.10.00.04 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 are trademarks or registered trademarks
of International Business Machines Corp., registered in many
jurisdictions worldwide. Other product and service names might be
trademarks of IBM or other companies. A current list of IBM trademarks
is available on the Web at "Copyright and trademark information" at
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 for Virtual Servers: Citrix Agent, version 6.1.0

Installation Instructions

Please refer to the full README contained in the Download Description section above for general installation instructions.

On
[{"DNLabel":"6.1.0-TIV-ITM_CTX-IF0004","DNDate":"3/2/2010","DNLang":"English","DNSize":"21281225","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=6.1.0-TIV-ITM_CTX-IF0004&product=ibm%2FTivoli%2FTivoli+Monitoring+for+Virtual+Servers&source=dbluesearch&platform=All","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SS9U76","label":"Tivoli Monitoring for Virtual Environments"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ITM Agent for Citrix V6","Platform":[{"code":"PF033","label":"Windows"}],"Version":"6.1","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

Citrix Agent

Document Information

Modified date:
15 June 2018

UID

swg24026026