IBM Tivoli Monitoring for Virtual Servers: Linux Kernel-based Virtual Machines 7

Downloadable files


Abstract

This is an Interim Fix for IBM Tivoli Monitoring for Virtual Servers: Linux Kernel-based Virtual Machines Version 7.1.0: 7.1.0-TIV-ITM_LINUX_KVM-IF0002.

Download Description

Copyright International Business Machines Corporation 2012.

All rights reserved.

Component: IBM(R) Tivoli(R) Monitoring for Virtual Environments Agent
for Linux(R) Kernel-based Virtual Machines
Version 7.1.0

Component ID: 5724L92VM

Interim Fix 0002, 7.1.0-TIV-ITM_LINUX_KVM-IF0002

Date: August 14, 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 interim fix provides the new function described in section 2.3.


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

2.1 APARs
-------------
None.

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

2.3 Enhancements
------------------
Feature: 181202
Abstract: Modify the agent to retrieve and report the "cpu_share"
scheduler parameter.
Additional Information: In Linux Kernel-based Virtual Machines,
virtual machines are called domains. Domains have
scheduler parameters which describe to Linux Kernel-based
Virtual Machines how resources (in particular, CPU) should
be allocated to each domain.

This enhancement retrieves and reports the "cpu_share"
scheduler parameter in the following way:

1) Scheduler Parameters - a new attribute group which
contains new attributes for the libvirt scheduler
parameters.
- Table name: KV1SCHPAG
- Warehouse table name: KV1_SCHEDULER_PARAMETERS
or KV1SCHPAG

The attributes of the Scheduler_Parameters attribute
group are modeled after the values returned by the virsh
"schedinfo" command. The "schedinfo" command returns both
the scheduler type and a list of scheduler parameters.
Since virsh does not make a distinction between the
scheduler type and the scheduler parameters when
when reporting, the agent does not make a distinction
for the Scheduler_Parameters attribute group.

The attributes in Scheduler_Parameters include the names
of the host and virtual machine to which the parameters
belong, as well as a strings for the name, value, and
original type of the parameters.

2) Virtual Machines Attribute Group has a new attribute.

CPU Shares - The scheduler parameter, cpu_shares, for
the virtual machine.
Type: is64BitGauge
Warehouse name: CPU_SHARES

If a virtual machine is defined but not running, then the
cpu_shares is reported as zero, just as libvirt
reports it in the API. If a virtual machine does not
have a cpu_shares scheduler parameter, or if an error
occurs while retrieving the scheduler parameters, then
the -1 enumerated value is returned, which is translated
to Unavailable in the Tivoli Enterprise Portal.

3) New custom queries are available:

VMs_Host_V3
VMs_VM_Name_V3
VMs_Ascending_V3
VM_BY_KEY_V3
VM_CPU_CNSMD_D_V3
VM_MEMRY_USED_D_V3.

No workspaces were modified or added for this feature.
Duplicate versions of all the custom queries based on
the Virtual_Machines attribute group were created for
this feature. Each of the new custom queries has the
the cpu_shares attribute added as the final attribute.
The new custom query also has the same name as the
original, except the name and description end with "V3".
The user can modify any of the existing workspaces
to show the cpu_shares attribute by substituting the V3
version of the custom query for the current version of
the custom query.

The new attributes require that the minimum version of
the libvirt package installed on the host (where the
hypervisor is running) be 0.9.0 or higher. To determine
the level of your libvirt package run the 'rpm' command,
for example, "rpm -qa | grep libvirt".

2.4 Superseded fixes
-------------------------
There are no superseded interim fixes. This interim fix,
7.1.0-TIV-ITM_LINUX_KVM-IF0002, is the first available for this
product.

2.5 APARs and defects included from 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 Linux
Kernel-based Virtual Machines User's Guide version 7.1.0.

Please refer to the IBM Software Product Compatability 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
Linux Kernel-based Virtual Machines version 7.1.0
- Libvirt 0.9.0 or higher on the host.


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

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

The fix archive file contains the following files:
- 7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1_li6263_tema_if0002.tar
- 7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1_lx8266_tema_if0002.tar
- 7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1li6263.dsc
- 7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1lx8266.dsc
- 7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1_tems_teps_tepd_if0002.tar
- 7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1_tems_teps_tepd_if0002.zip


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.1.0-TIV-ITM_LINUX_KVM-IF0002.tar
or .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 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.1.0-TIV-ITM_LINUX_KVM-IF0002, the install command is:

> itmpatch -h <CANDLEHOME>
-i <TEMP>/7.1.0-TIV-ITM_LINUX_KVM-IF0002/kv1_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 is
kvm_li8266_tema_if0002.tar.
> ./cinfo -i
Monitoring Agent for Linux Kernel-based Virtual Machines
li8266 Version: 07.10.00.00


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

On Windows systems,
if the fix was expanded to <TEMP>\7.1.0-TIV-ITM_LINUX_KVM-IF0002:
> %CANDLE_HOME%\bin\tacmd addBundles -n -i <TEMP>\7.1.0-TIV-ITM_LINUX_KVM-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
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 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 v1
-n <Managed system name>
-v 071000002

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 v1
-n <Managed system name>
-v 071000002

Note:
- The component (-t) for the "tacmd updateAgent" command is
specified as two characters (v1), not three characters (kv1).
- 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 an "tacmd updateAgent" command is always an
OS agent.

5.4 Agent support update
------------------------------
This fix 7.1.0-TIV-ITM_LINUX_KVM-IF0002 includes changes to the agent
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 appropriate archive file
(7.1.0-TIV-ITM_LINUX_KVM-IF0002.tar or .zip) to the Tivoli
Enterprise Monitoring Servers, Tivoli Enterprise Portal Servers,
or Tivoli Enterprise Portal Desktops.

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. Expand the archive file (kv1_tems_teps_tepd_if0002.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 extract
utility on Windows systems. This step creates a directory
structure that includes a subdirectory called CD-ROM, with the
necessary updates.

4. Use the Application Support Installer(ASI) GUI or the silent
installation method to install the application support files.

GUI installation option
------------------------
The GUI can be started by using one of the following commands
from within the CD-ROM directory where setup.jar is located.

On UNIX systems:
> ./itmasi.sh [-h <CANDLEHOME>] [-j <JAVAHOME>]

On Windows systems:
> itmasi [-h <CANDLEHOME>] [-j <JAVAHOME>]

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.

Silent installation option
--------------------------
To use the silent installation option, use one of the following
commands from within the CD-ROM directory where setup.jar is
located.

Note: Using the silent installation option for Linux and zLinux
operating systems requires the following files contained in
interim fix 6.2-TIV-ITM_ASI-IF0001:
- Linux: setupLinux.bin
- zLinux: setupLinux390.bin
Follow the installation instructions contained in the
"6.2-TIV-ITM_ASI-IF0001.README".

On UNIX systems:
> ./itmasi.sh -h <CANDLEHOME>[-silent]
[-r <response file>]
[-j <JAVAHOME>]

On Windows systems:
> itmasi -h <CANDLEHOME> [-silent]
[-r <response file>]
[-j <JAVAHOME>]

where:
-h <CANDLEHOME> - Required. The path to the IBM Tivoli
Monitoring installation directory.

-r <response file> - Optional. Customized response file name.
The default response file "response.txt" in
the CD-ROM directory can be copied and modified
for your environment. Do not update "response.txt".

-j <JAVAHOME> - Optional. The fully-qualified path to the "bin"
directory where Java(R) is installed. The
location of Java on your system might vary.

5. The next panel presented by the Application Support Installer asks
for the selection of which Tivoli Monitoring components you want
to add application support to. For this fix, check or clear the
check boxes 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 Linux
Kernel-based Virtual Machines 07.01.00.02 support to complete the
installation.

6. If the 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
========================

6.1 Installation instructions for agent baroc file
-----------------------------------------------------
This fix 7.1.0-TIV-ITM_LINUX_KVM-IF0002 includes changes to the
agent baroc files that must be reinstalled. Refer to IBM Tivoli
Monitoring 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>
-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 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 V1

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 V1

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

When the agent update is successful, the agent version is now:
07.10.00.02.


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 Environments Agent for Linux Kernel-based Virtual Machines version 7.1.0.

- Libvirt 0.9.0 or higher on the host.

Installation Instructions

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

Download package

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central (FC)?
7.1.0-TIV-ITM_LINUX_KVM-IF0002 15 Aug 2012 English 30469287 FC

Product Alias/Synonym

KVM Agent

Rate this page:

(0 users)Average rating

Document information


More support for:

Tivoli Monitoring for Virtual Environments
Linux Kernel-based Virtual Machines agent

Software version:

7.1

Operating system(s):

Linux

Reference #:

4033284

Modified date:

2014-07-14

Translate my page

Machine Translation

Content navigation