ITM for Virtual Environments: Citrix XenServer agent 7.2.0.3-TIV-ITM_CTXS-IF0001

Download Description

Copyright International Business Machines Corporation 2016.
All rights reserved.

Component: IBM® Tivoli® Monitoring for Virtual Environments Agent for
Citrix® XenServer®

Component ID: 5724L92XS

Interim Fix 0001, 7.2.0.3-TIV-ITM_CTXS-IF0001

Date: May 12, 2016


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 Copyright and trademark information
10.0 Notices


1.0 General description
===============
This interim fix resolves APAR IV84455 (KXI agent to uses a large
amount of memory) listed in the "Problems fixed" section below.


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

2.1 APARs
-------------
APAR: IV84455
Abstract: KXI agent to uses a large amount of memory
Additional Information: A large amount of memory - usually several
gigabytes - is consumed shortly after the agent is started.
This behavior is typically seen on large environments with a
large number of XenServer virtual machines on the monitored
XenServer system that have been running for several weeks.

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

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

2.4 Superseded fixes
-------------------------
None.


3.0 Architecture and prerequisites
======================
This fix is supported on all operating systems listed in the IBM
Tivoli Monitoring for Virtual Environments Agent for Citrix XenServer
User's Guide, version 7.2.0.

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

3.1 Prerequisites for this fix
--------------------------------
The prerequisite level for this fix is as follows:
- IBM Tivoli Monitoring for Virtual Environments Agent for Citrix XenServer,
Version 7.2.0.3

- IBM Tivoli Monitoring, Version 6.2.2: Fix Pack 04 or higher
(6.2.2-TIV-ITM-FP0004). 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
===================
This fix image contains the following files:

- 7.2.0.3-TIV-ITM_CTXS-IF0001.README - This README file
- 7.2.0.3-TIV-ITM_CTXS-IF0001.tar - Fix archive .tar format
- 7.2.0.3-TIV-ITM_CTXS-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® environment; use the .zip file if
you are working in a Windows® environment.

The fix archive file contains the following files:
- 7.2.0.3-TIV-ITM_CTXS-IF0001/kxi_li6263_tema_if0001.tar
- 7.2.0.3-TIV-ITM_CTXS-IF0001/kxi_lx8266_tema_if0001.tar
- 7.2.0.3-TIV-ITM_CTXS-IF0001/kxi_winnt_tema_if0001.cab
- 7.2.0.3-TIV-ITM_CTXS-IF0001/kxi_wix64_tema_if0001.cab
- 7.2.0.3-TIV-ITM_CTXS-IF0001/kxili6263.dsc
- 7.2.0.3-TIV-ITM_CTXS-IF0001/kxilx8266.dsc
- 7.2.0.3-TIV-ITM_CTXS-IF0001/KXIWINNT.dsc
- 7.2.0.3-TIV-ITM_CTXS-IF0001/KXIWIX64.dsc
- 7.2.0.3-TIV-ITM_CTXS-IF0001/xi_dd_072003001.xml
- 7.2.0.3-TIV-ITM_CTXS-IF0001/xi_dd.properties

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

- Because there is no uninstall utility for this fix, make sure to
perform a backup of your environment before installing this fix.

5.2 Local agent update
--------------------------
1. Transfer the appropriate archive file
(7.2.0.3-TIV-ITM_CTXS-IF0001.tar or .zip) to a temporary
directory on the system that contains the agent 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 of that agent. For more information on the "itmpatch"
command, see section 6.2.

On UNIX systems, if the fix was expanded to
<TEMP>/7.2.0.3-TIV-ITM_CTXS-IF0001, the install command is:

> itmpatch -h <CANDLEHOME>
-i <TEMP>/7.2.0.3-TIV-ITM_CTXS-IF0001/kxi_xxxxxx_tema_if0001.tar

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

In the following example, the file is "kxi_li6263_tema_if0001.tar".
> ./cinfo -i
xi Monitoring Agent for Citrix XenServer
li6263 Version: 07.20.03.00

On Windows systems, if the fix was expanded to
<TEMP>\7.2.0.3-TIV-ITM_CTXS-IF0001, the install command is:

> itmpatch -h <CANDLEHOME>
-i <TEMP>\7.2.0.3-TIV-ITM_CTXS-IF0001\kxi_winnt_tema_if0001.cab

5.3 Remote agent update
----------------------------
1. Transfer the appropriate archive file (7.2.0.3-TIV-ITM_CTXS-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>/7.2.0.3-TIV-ITM_CTXS-IF0001:
> $CANDLEHOME/bin/tacmd addBundles -n -i <TEMP>/7.2.0.3-TIV-ITM_CTXS-IF0001


On Windows systems,
if the fix was expanded to <TEMP>\7.2.0.3-TIV-ITM_CTXS-IF0001:
> %CANDLE_HOME%\bin\tacmd addBundles -n -i <TEMP>\7.2.0.3-TIV-ITM_CTXS-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. 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.

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 xi
-n <Managed system name>
-v 072003001

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 XI
-n <Managed system name>
-v 072003001

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


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

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

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 XI

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

When the agent update is successful, the agent version is:
07.20.03.01

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
07.20.03.01.
For the agent on UNIX systems, the version number is
07.20.03.01.


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


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.

This information could include technical inaccuracies or typographical
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.

Microsoft, Windows, and Windows Server are trademarks of Microsoft
Corporation 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.

Citrix and XenServer are trademarks or registered trademarks of Citrix
in the United States, other countries, or both.

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

Third-Party License Terms and Conditions, Notices and Information
-----------------------------------------------------------------
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.

Notwithstanding the terms and conditions of any other agreement you
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:

- the Excluded Components are provided on an "AS IS" basis
- 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.