IBM Support

IBM Tivoli Monitoring for Virtual Environment agents Version 7.2.0.10 readme

Release Notes


Abstract

This release contains new features and enhancements for VMware VI agent, NetApp Storage agent, and Linux Kernel-based Virtual Machines agent.

Content

Component: IBM Tivoli Monitoring for Virtual Environments
Component IDs: VMware VI (5724L92VI), NetApp Storage (5724L92NA), and Linux KVM (5724L92VX)
SHA256 Checksum: d7d75e68f10428703335e4ce4161a06d7a82df0c63c6f5e500eee2f466e3749b
Part number: M0H0CEN
Date: January 26, 2024
Contents
-------------

1.0 General description

==================
This fix pack resolves the APARs and the defects listed in the "Problems fixed" section.

This fix pack also includes the fixes from the earlier releases.

2.0 Architecture and prerequisites

===========================
For the latest operating system certification information, follow these steps.
  1. Go to the IBM Software Product Compatibility Reports (SPCR) site.
  2. Search for the Tivoli Monitoring for Virtual Environments, and then select the Show Fix packs checkbox to get the latest reports.
    Report link: https://www.ibm.com/software/reports/compatibility/clarity-reports/report/html/softwareReqsForProduct?deliverableId=1284600244173&osPlatforms=AIX|Linux|Windows&duComponentIds=S001|A004|A008|A007|A006|A002|A005|A003&mandatoryCapIds=130|45|69|26

2.1 Prerequisites for this fix

======================

You can use ITMfVE 7.2 Fix Pack 10 to install the latest agents or upgrade existing agent installations directly.

If you plan to upgrade the agents on Windows systems, ensure that the Tivoli Enterprise Monitoring Agent Framework (KGL) component version 06.30.07.14 or later is installed on the agent machine for the remote or local upgrade.

Check the KGL version as follows.

  1. Open the command prompt and run the following command.
    kincinfo -t
  2. Check the version of the product with product code GL.

If the KGL component version is older, upgrade the version as follows.

  1. Download and extract ITM 6.3 FP7 SP6 (6.3.0.7-TIV-ITM-Windows-SP0006.zip) for Windows from Fix Central.
  2. Run the setup.exe file from the <extracted_directory>/bundles/WINDOWS/ folder.
  3. Select Tivoli Enterprise Monitoring Agent Framework (KGL) from the list of features during installation. 

Note:

  • This requirement is only for Windows operating systems. Agents on Linux systems can be upgraded directly.
  • ITMfVE 7.2 Fix Pack 10 is not compatible with other than ITM 6.3 FP7 SP14 or higher versions when both (Agent and ITM components) coexist on the same <CANDLE_HOME> folder.

For VMware VI, Linux KVM, or NetApp Storage agents

  • This fix pack can be installed as a stand-alone installation or can be installed on top of the earlier release versions.
  • Download the IBM Tivoli Monitoring for Virtual Environments V7.2.0.10 package from the IBM Passport Advantage website.  

3.0 Problems fixed

==================


3.1 APARs
-------------

VMware VI Agent

The following APAR was fixed:

APAR: DT236720
Abstract: VMware VI ESXi subnodes populate under the first instance when multiple agent instances are present.
 

3.2 Defects

=========

N/A

3.3 Enhancements
------------------------

Linux Kernel-based Virtual Machines Agent

The following enhancements were made:

  • Added support for the Red Hat Enterprise Linux (RHEL) 9 operating system.
  • Upgraded IBM Tivoli Monitoring Software Development Kit to 6.3 Fix Pack 7 Service Pack 14.
  • Upgraded Agent JRE to 1.8.0_351 Version.
VMware VI Agent

The following enhancements were made:

  • Added support for Red Hat Enterprise Linux (RHEL) 9 operating system.
  • Enhanced support for the FQDN attribute in the ESX Virtual Machines attribute group by adding the following features:
    • The agent log now displays a message when there is a time lag in the FQDN resolution.
    • Changed the default value of the 'KVM_VIRTUAL_MACHINE_IP_TIMEOUT' environment variable to 5000 milliseconds.
    • Updated the help text that KVM_VIRTUAL_MACHINE_IP_TIMEOUT takes the value in milliseconds.
  • Upgraded IBM Tivoli Monitoring Software Development Kit to 6.3 Fix Pack 7 Service Pack 14.
  • Upgraded Agent JRE to 1.8.0_351 Version.
Known Limitations
  • Issue: vCenter Server 6.0 and its earlier versions use TLSv1 and TLSv1.1 protocols for communications. However, the TLSv1 and TLSv1.1 protocols are disabled by default, by JRE for security reasons. Hence, the communication between the vCenter Server and the agent is hindered.
    Workaround: Follow these steps.
    1. Navigate to the following directory:
      Linux
      <CANDLE_HOME>/JRE/lx8266/lib/security
      Windows
      <CANDLE_HOME>\java\java80_x64\jre\lib\security
    2. Edit the java.security file, search for "jdk.tls.disabledAlgorithms", and remove TLSv1 and TLSv1.1 from the list.
  • Issue: Agent Configuration parameters reset after successful remote upgrade using CLI on Windows.
    Workaround: Follow these steps.
    1. Reconfigure the agent once the upgrade is successful.
    2. Start the agent.
NetApp Storage Agent

The following enhancements were made:

  • The agent is supported to monitor the Active IQ Unified Manager 9.12
  • The agent is supported to monitor the Active IQ Unified Manager 9.13
  • Added support for the Red Hat Enterprise Linux (RHEL) 9 operating system.
  • Upgraded IBM Tivoli Monitoring Software Development Kit to 6.3 Fix Pack 7 Service Pack 14.
  • Upgraded Agent JRE to 1.8.0_351 Version.

Known Limitations

Agent fails to start after a successful remote upgrade by using CLI on Windows. To workaround this issue, you must complete the following steps:
  1. Manually reconfigure the agent once the upgrade is successful.
  2. Start the agent.  
For information about the dashboards, thresholds, and attributes, see the Monitoring Agent for Linux Kernel-based Virtual Machines Reference.
For information about the troubleshooting topics, see the Monitoring Agent for Linux Kernel-based Virtual Machines troubleshooting guide.  

3.4 Superseded fixes

--------------------------
All the fixes from 7.2 Fix Pack 9 and earlier releases.
 

3.5 APARs and defects included in earlier releases
------------------------------------------------------------

All the fixes from  7.2 Fix Pack 9 and earlier releases.

4.0 Image directory contents

======================
This fix image contains the following files:

ITMVE7.2.0.10VMVIKVMNAS_AGTMP_EN.tar.gz (Fix archive .tar format)
 
Note: Contents in the .gz files are identical for both Windows™ and UNIX™ platforms.

The same installer works for the Windows™ and UNIX™ operating systems. 

5.0 Installation instructions

=====================
This fix can be installed on an existing installation. Use the following steps to install this fix.

5.1 Installing the fix
-------------------------

Before installing this fix, see the Prerequisites for this fix section. 
For this readme file, <CANDLEHOME> is the IBM Tivoli Monitoring installation directory. 
The default value of CANDLEHOME is '/opt/IBM/ITM' on UNIX and LINUX systems and 'C:\IBM\ITM' on Windows systems. 

Linux
Run <extracted_directory>/ITMfVE_Agents/install.sh 

Windows
Run <extracted_directory>\ITMfVE_Agents\Windows\setup.exe 

For detailed information about configuration and installation, refer to the documents provided in the Local agent update section.

 

5.2 Local agent update
--------------------------

Refer to the agent's documentation.

 

6.0 Additional installation information

==============================

For information about troubleshooting the installation, see the itmpatch.log in the patch logs directory in the <CANDLEHOME>.


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 Verifying the update:
--------------------------
Note:
  • When the VMware VI agent update is successful, the agent's version is displayed as 07.30.06.00.
  • When the Linux Kernel-based Virtual Machines agent update is successful, the agent's version is displayed as 07.20.09.00.
  • When the NetApp agent update is successful, the agent's version is displayed as 07.30.05.00.
Linux or UNIX 
To validate that all components are installed successfully, run the following command:
$CANDLE_HOME/bin/cinfo -i
Example
[root~]# /opt/IBM/ITM/bin/cinfo -i

The following output is the sample output of agent component versions.

[root@HJS494-KVM-T-2 bin]# ./cinfo -i

ax IBM Tivoli Monitoring Shared Libraries
    lx8266  Version: 06.30.07.22   Build:  d3089a
gs  IBM GSKit Security Interface
    lx8266  Version: 08.00.55.24   Build:  d3088a
jr  Tivoli Enterprise-Supplied JRE
    lx8266  Version: 08.07.20.00   Build:  202212121650
ui Tivoli Enterprise Services User Interface
    lx8266  Version: 06.30.07.20   Build:  d3089a
nu  Monitoring Agent for NetApp Storage
    lx8266  Version: 07.30.05.00   Build:  202401010516
v1  Monitoring Agent for Linux Kernel-based Virtual Machines
    lx8266 Version: 07.20.09.00 Build: 202312140658
vm  Monitoring Agent for VMware VI
    lx8266 Version: 07.30.06.00 Build: 202312140401
Windows
To validate that all the components are installed successfully, run the following command:
%CANDLE_HOME%\InstallITM\kincinfo -i
Example
> %CANDLE_HOME%\InstallITM\kincinfo -i

The following output is the sample output of the agent component versions:
C:\IBM\ITM\InstallITM>kincinfo -i


IN        Install INS/Windows Install Component
          WINNT Version: 06.30.07.20 Build: 202303311402
IN        TEMA(32-bit) INS/ITM 6.x Agent Install Component
          WINNT Version: 06.30.07.20 Build: 202303311402
IN        TEMA(64-bit) INS/ITM 6.x Agent Install Component Extensions
          WINNT Version: 06.30.07.20 Build: 202303311402
AC        KAC(64-bit) CMA/32/64 Bit Agent Compatibility Package
          WIX64 Version: 06.30.07.20 Build: 202303311402
GL        KGL(64-bit) CMA/Tivoli Enterprise Monitoring Agent Framework
          WIX64 Version: 06.30.07.22 Build: d3089a
GL        KGL(32-bit) CMA/Tivoli Enterprise Monitoring Agent Framework
          WINNT Version: 06.30.07.22 Build: d3089a
GS        KGS(64-bit) GSK/IBM GSKit Security Interface
          WIX64 Version: 08.00.55.24 Build: d3088a
GS        KGS(32-bit) GSK/IBM GSKit Security Interface
          WINNT Version: 08.00.55.24 Build: d3088a
JM        KJM(64-bit) JVM/Embedded JVM
          WIX64 Version: 08.07.20.00 Build: 202212121650
JM        KJM(32-bit) JVM/Embedded JVM
          WINNT Version: 08.07.20.00 Build: 202212121650
VM        KVM(64-bit) CMA/Monitoring Agent for VMware VI
          WIX64 Version: 07.30.06.00 Build: 202312140401
NU        KNU(64-bit) CMA/Monitoring Agent for NetApp Storage
          WIX64 Version: 07.30.05.00 Build: 202401010516
UE        KUE(32-bit) CMA/Tivoli Enterprise Services User Interface Extensions
          WINNT Version: 06.30.07.15 Build: d3089a
UI        KUI(32-bit) CLI/Tivoli Enterprise Services User Interface
          WINNT Version: 06.30.07.20 Build: 202303311402

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

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

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.

[{"Type":"SW","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SS9U76","label":"Tivoli Monitoring for Virtual Environments"},"ARM Category":[{"code":"a8m50000000CljVAAS","label":"Linux KVM agent"},{"code":"a8m50000000CljRAAS","label":"NetApp Storage agent"},{"code":"a8m50000000CljaAAC","label":"VMware VI agent"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Version(s)"}]

Document Information

Modified date:
15 November 2024

UID

ibm17110406