Copyright International Business Machines Corporation 2010. 
 All rights reserved.

Component: IBM(R) Tivoli(R) Composite Application Manager for 
Microsoft(R) Applications: Host Integration Server Agent,
Version 6.2.2
           
Component ID: 5724C04HI

Interim Fix: 0001, (6.2.2-TIV-ITM_HIS-IF0001)

Date: December 07, 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.

Note: This fix contains only TEPS support updates.


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

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

  2.2 Defects 
  -----------
  Defect: 140076
  Abstract: Host Integration Server instances generated by the 
            Discovery Library Adapter (DLA) are not identical
            to the instances that are discovered and collected by
            the sensors in the Tivoli Application Dependency
            Discovery Manager (TADDM) Server.

  Problem Description: The TADDM Server displayes the last data
            that is received from either the DLA or the sensor.
            As a result, incomplete data is displayed on the TADDM
            Server.
 
  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 operating systems listed in the IBM
Tivoli Composite Application Manager for Microsoft Applications: 
Host Integration Server Agent User's Guide, version 6.2.2.

The following link is for the Tivoli operating system 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 Composite Application Manager for Microsoft
   Applications: Host Integration Server Agent, Version 6.2.2    
  -IBM Tivoli Monitoring, Version 6.2.2, Fix Pack 2
  -Monitoring Agent for Windows OS, Version 6.2.2, Fix Pack 2
  
  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:
-  6.2.2-TIV-ITM_HIS-IF0001.README - This README file
-  6.2.2-TIV-ITM_HIS-IF0001.tar - Fix archive .tar format
-  6.2.2-TIV-ITM_HIS-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(R) environment; use the .zip file if 
you are working in a Windows(R) environment. 

The fix archive file contains the following files:
-  6.2.2-TIV-ITM_HIS-IF0001/kqh_tems_teps_tepd_if0001.tar
-  6.2.2-TIV-ITM_HIS-IF0001/kqh_tems_teps_tepd_if0001.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
    
  - Refer to section 7.0 entitled "Known problems and workarounds" before
    installation.
    
  - 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
  ----------------------
    Not applicable.

  5.3 Remote agent update
  -----------------------
    Not applicable.

  5.4 Agent support update
  ------------------------
  This fix (6.2.2-TIV-ITM_HIS-IF0001) includes changes to the agent
  support files which need to be installed. Use the following steps
  to update the support for Tivoli Enterprise Portal Server.

  1. Transfer the appropriate archive file (6.2.2-TIV-ITM_HIS-IF0001.tar
     or .zip) to the Tivoli Enterprise Portal Servers. 
     
  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 (KQH_tems_teps_tepd_if0001.tar or .zip)
     that contains the updates for Tivoli Enterprise Portal Server
	 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:

     unchecked - Tivoli Enterprise Monitoring Server (TEMS)
     checked - Tivoli Enterprise Portal Server (TEPS)
     unchecked - Tivoli Enterprise Desktop Client (TEPD)

     Continue through the remaining GUI panels selecting the Monitoring 
     Agent for Microsoft Host Integration Server 06.22.00.01 
	 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
  --------------------------------------------------
  There are no updates in the agent baroc file that is included 
  in this fix or any of the superseded fixes. 
  No additional installation steps are required.

  6.2 Additional information on using "itmpatch" command
  ------------------------------------------------------
  Not applicable.

  6.3 Verifying the update
  ------------------------
  1. 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 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
     *********** Mon Dec 6 11:18:54 IST 2010  ******************
     User      : root          Group: root bin daemon sys adm disk wheel
     Host name : ITM-RHEL5-32      Installer Lvl:06.22.02.00
     CandleHome: /opt/IBM/ITM
     ***********************************************************

     ...Product inventory
     .
     .
     .
     qh     Microsoft Host Integration Server Agent
             tms     Version: 06.22.00.00
             tpd     Version: 06.22.00.00
             tps     Version: 06.22.00.01
             tpw     Version: 06.22.00.00
     .
     .
     .

     On Windows systems:
     -------------------
     To validate that all components have been installed, run the
     following command:
    
     For example:
     > %CANDLE_HOME%\InstallITM\kincinfo -i

     *********** Monday, December 6, 2010 11:06:23 PM  ******
     User      : Administrator Group    : NA
     Host Name : mywinbox     Installer: Ver: 062202000
     CandleHome: C:\IBM\ITM
     Installitm: C:\IBM\ITM\InstallITM
     ********************************************************
     .
     .
     .

     QH     Microsoft Host Integration Server Support
            WINNT Version: 06.22.00.00 Build: 01801 

     QH     Microsoft Host Integration Server Support
            WINNT Version: 06.22.00.01 Build: 02731

     QH     Microsoft Host Integration Server Support
            WINNT Version: 06.22.00.00 Build: 01801

     QH     Microsoft Host Integration Server Support
            WINNT Version: 06.22.00.00 Build: 01801	  
     .
     .
     . 
 
7.0 Known problems and workarounds
==================================
None.


8.0 Additional product information
==================================
This fix (6.2.2-TIV-ITM_HIS-IF0001) includes changes only to the 
Tivoli Enterprise Portal Server (TEPS) support of the HIS agent. 
This fix provides support for integration with the TADDM Server.

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.

