IBM Tivoli Monitoring for Virtual Environments Agent for Linux
Kernel-based Virtual Machines, Version 7.2 Fix Pack 3 IF 1

Download Description

Copyright International Business Machines Corporation 2018.
All rights reserved.


Component: IBM Tivoli Monitoring for Virtual Environments Agent for Linux
Kernel-based Virtual Machines, Version 7.2 Fix Pack 3 IF 1

Component ID: 5724L92CU

Interim Fix: 0001, 7.2.0.3-TIV-ITM_Linux_KVM-IF0001

Date: Jan 20, 2018

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 defects listed in the "Problems Fixed" section below.


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

 2.1 APARs
 ----------  
APAR IJ03006
Abstract :
V1 AGENT (KERNEL-BASED VIRTUAL MACHINES) SUPPORT FOR RHEV-H 4.X
ERROR DESCRIPTION:
Monitoring Agent for Linux Kernel-based Virtual Machines            
07.20.03.00 cannot establish a valid connection with the target      
RHEVM
This is related to the version of the ovirt-engine being connected.                                                      
If the RHV Host is:                                                  
RHEV-M 4.1 (RHEL 7.4 based OS).                                      
   
Current agent cannot connect to it because the connection url        
changed from
https://<hostname>:443/
to
https://<hostname>/ovirt-engine/api

APAR IJ03125
Abstract :
SDA SUPPORT FOR V1 AGENT (KERNEL-BASED VIRTUAL MACHINES)
ERROR DESCRIPTION:                                                  
Current version of V1 agent (7.20.03.00) does not have support      
for SDA feature.
This means that ITM administrators need to manually install        
application support on all ITM servers where the V1 agents will    
connect to.


 2.2 Defects
 ------------
 
 2.3 Enhancements
 ------------
None

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

 2.5 APARs and defects included from superseded fixes
 ----------------------------------------------------
None
     
3.0 Architecture and prerequisites
==================================
This fix is supported on all the operating systems that are listed
in the Prerequisites topic in the IBM Tivoli Monitoring for Virtual
Environments information center, version 7.2 Fix Pack 3.

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.2 Fix Pack 3 IF 1
  - IBM Tivoli Monitoring for Virtual Servers: Linux Kernel-based Virtual
  Machines, version 7.2 Fix Pack 3

Note:  When the prerequisite is installed, the version number 07.20.03.000.

 
4.0 Image directory contents
===================
This fix image contains the following files:
7.2.0.3-TIV-ITM_Linux_KVM-IF0001.tar.gz

5.0 Installation instructions
==============================
You can install this fix over an existing installation only.  Complete the
following steps to install this fix:

 5.1 Before installing the fix
 -------------------------------
 - Before you install this fix, ensure that you have installed the
   prerequisites that are listed under section 3.1 entitled
'Prerequisites for this fix'.
   
 - 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 you install this fix on the UNIX systems, set the environment
   variable CANDLEHOME to the IBM Tivoli Monitoring installation
   directory.
       
   For example:
   > CANDLEHOME=/opt/IBM/ITM
   > export CANDLEHOME

 - Since there is no uninstall utility for this fix, we suggest you to perform
   a backup of your environment before installing this fix.
       
 5.2 Local agent update
 --------------------------------
 Please refer to the IBM Tivoli Monitoring for Virtual Environments:
 Linux Kernel-based Virtual Machines agent, Version 7.2 Fix Pack 3 User's Guide.

 5.3 Remote agent update
 -----------------------
 Please refer to the IBM Tivoli Monitoring for Virtual Environments:
 Linux Kernel-based Virtual Machines agent, Version 7.2 Fix Pack 3 User's Guide.


5.4 Agent support update
 ------------------------------
 Please refer to the IBM Tivoli Monitoring for Virtual Environments:
 Linux Kernel-based Virtual Machines agent, Version 7.2 Fix Pack 3 User's Guide.


6.0 Additional installation information
========================================
 
 6.1 Verifying the update
 ------------------------
 1. To verify that the agent was updated correctly, use the tacmd
    command to view the current version of the agent after the agent
 is restarted. You must log on to the 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 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 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 be:
    07.20.03.01
 

 2. To verify that the agent support files were updated correctly,
    use the "kincinfo" command on Windows systems or the "cinfo" command
 on Linux or UNIX system. 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 displayed date of the build 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
 
 For Example:
 [root@in-ibmibm834 bin]# ./cinfo -i

 *********** Wed Jan 10 15:35:18 IST 2018 ******************
 User: root Groups: root
 Host name : in-ibmibm834         Installer Lvl:06.30.05.00
 CandleHome: /opt/IBM/ITM
 ***********************************************************
 ...Product inventory
 ......
 ......
 ......
 v1      Monitoring Agent for Linux Kernel-based Virtual Machines
   tms     Version: 07.20.03.01
   tps     Version: 07.20.03.01
   tpw     Version: 07.20.03.01

    On Windows systems:
    ---------------------
    To validate that all components have been installed, run the
    following command:
   
    > %CANDLE_HOME%\InstallITM\kincinfo -i
 
 For Example:
 C:\IBM\ITM\BIN>kincinfo -i
 ************ Friday, January 5, 2018 4:23:46 PM *************
 User       : Administrator         Group     : NA
 Host Name  : IBMESX4V18            Installer : Ver: 063002000
 CandleHome : C:\IBM\ITM
 Installitm : C:\IBM\ITM\InstallITM
 *************************************************************
 ...Product Inventory
    .
    .
    .
 V1        TEMS App Support/Monitoring Agent for Linux Kernel-based Virtual Machines
   WINNT Version: 07.20.03.01 Build: 201801040133

 V1        TEPS App Support/Monitoring Agent for Linux Kernel-based Virtual Machines
   WINNT Version: 07.20.03.01 Build: 201801040133

 V1        TEPB App Support/Monitoring Agent for Linux Kernel-based Virtual Machines
   WINNT Version: 07.20.03.01 Build: 201801040133

   
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
=======
{Add or remove non-IBM trademark names as appropriate. Mark the first
occurrence of IBM and special non-IBM trademark names with a '(R)'.
See http://www.ibm.com/legal/copytrade.shtml for a complete list of
non-IBM trademark names.}

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.

Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Oracle and/or its affiliates.

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.