IBM Tivoli OMEGAMON XE for WebSphere Application Server Interim Fix 2 Readme

(C) Copyright International Business Machines(R), 2005. All rights reserved.

Patch: 1.3.0-TIV-OXEWAS-IF0002



CONTENTS
---------
1.0 ABOUT THIS FIX PACK
  1.1 Supported operating systems
  1.2 Dependencies
  1.3 Fix Pack Contents
2.0 PROBLEMS FIXED
3.0 APPLYING THE FIX PACK
4.0 KNOWN DEFECTS
5.0 WEBSPHERE APPLICATION SERVER V6 TOLERATION SUPPORT




1.0 ABOUT THIS FIX PACK
-----------------------
This is a cumulative interim fix pack for IBM Tivoli OMEGAMON XE for WebSphere
Application Server v130.

  1.1 Supported operating systems

    The following operating systems are supported by this fix pack:

    WEAX4002 - AIX 4.3.3 and later
    WEHX4002 - HP-UX 11.0
    WELI4002 - LINUX INTEL 2.4
    WELS4002 - LINUX S390 2.2 and later
    WESL4002 - SOLARIS 2.8 and later
    WEWS4002 - Microsoft Windows


  1.2 Dependencies

    This fix pack has no dependencies.


  1.3 Fix Pack Contents

    This fix pack contains the following files:

    1.3.0-TIV-OXEWAS-IF0002.README
    Patch 1.3.0-TIV-OXEWAS-IF0002 includes:

    - 1.3.0-TIV-OXEWAS-IF0002.README

    - weax4002.tar.Z  (AIX 4.3.3 and later)
           3891  classes/Candle_WA_Enabler.class
         240878 classes/kwepmiclient.jar
        1349182  classes/kwewa.jar
         646380  aix433/we/bin/KWEMSGS
        6194909  aix433/we/bin/kweagent
           3891  aix433/we/classes/Candle_WA_Enabler.class
         240878  aix433/we/classes/kwepmiclient.jar
        1349182  aix433/we/classes/kwewa.jar
          88935  aix433/we/lib/libkweprof.a
          86686  aix433/we/lib/libkweprof.a.4.3.3

    - wehx4002.tar.Z  (HP-UX 11.0)
           3891  classes/Candle_WA_Enabler.class
         240878  classes/kwepmiclient.jar
        1349182  classes/kwewa.jar
        1272780  hp11/we/bin/KWEMSGS
        6160888  hp11/we/bin/kweagent
           3891  hp11/we/classes/Candle_WA_Enabler.class
         240878  hp11/we/classes/kwepmiclient.jar
        1349182  hp11/we/classes/kwewa.jar
         216552  hp11/we/lib/libkweprof.sl


    - weli4002.tar.Z  (LINUX INTEL 2.4)
           3891  classes/Candle_WA_Enabler.class
         240878  classes/kwepmiclient.jar
        1349182  classes/kwewa.jar
         646380  li6243/we/bin/KWEMSG
       10927358  li6243/we/bin/kweagent
           3891  li6243/we/classes/Candle_WA_Enabler.class
         240878  li6243/we/classes/kwepmiclient.jar
        1349182  li6243/we/classes/kwewa.jar
         216751  li6243/we/lib/libkweprof.so


    - wels4002.tar.Z  (LINUX S390 2.2 and later)
           3891  classes/Candle_WA_Enabler.class
         240878  classes/kwepmiclient.jar
        1349182  classes/kwewa.jar
         646380  ls3223/we/bin/KWEMSGS
       13221840  ls3223/we/bin/kweagent
           3891  ls3223/we/classes/Candle_WA_Enabler.class
         240878  ls3223/we/classes/kwepmiclient.jar
        1349182  ls3223/we/classes/kwewa.jar
          83807  ls3223/we/lib/libkweprof.so

    - wesl4002.tar.Z  (SOLARIS 2.8 and later)
           3891  classes/Candle_WA_Enabler.class
         240878  classes/kwepmiclient.jar
        1349182  classes/kwewa.jar
         646380  sol283/we/bin/KWEMSGS
       15133236  sol283/we/bin/kweagent
           3891  sol283/we/classes/Candle_WA_Enabler.class
         240878  sol283/we/classes/kwepmiclient.jar
        1349182  sol283/we/classes/kwewa.jar
         303604  sol283/we/lib/libkweprof.so

    - wews4002.exe  (Microsoft Windows)
           3891  CMA\Candle_WA_Enabler.class
        2162754  CMA\kweagent.exe
          24642  CMA\kwecgwav.exe
         646380  CMA\KWEMSGS
         240878  CMA\kwepmiclient.jar
          32768  CMA\kweprof.dll
        1349182  CMA\kwewa.jar
           2479  CMA\setupCandleWAEnabler.bat


2.0 PROBLEMS FIXED
------------------
The following APARS are addressed in this fix pack:

  136809     Global security on WebSphere Application Server V6 not supported.
  137304     Missing XMI packages on WebSphere Application Server V6
  137391     Improve messages
  IY70232    Error calculating historical rates
  IY70577    Abend reading non-WAS5 Advanded Format messages that contain "source=".
  IY71925    Class instrumentation sorts class fields.
  IY71926    Avoid unecessary class instrumentation.
  IY71927    High memory usage.
  IY71928    Invalid localtime using Europe's DST rules.

The following APARS are addressed in previous fix packs:

  Internal   Excessive heap consumption used by the workload analysis feature.
  Internal   WebSphere Application Server V6 not supported.
  IY67393    Java excepcion in BCEL during instrumentation.
  IY68102    Clustered environments not supported.
  OA09946    wsinstance not supported.
  OA10880    Incorrect timestamp in Linux for zSeries.
  OA10421    Wrong PMI classpath in WebSphere Application Server V5 with security on.
  OA10537    Message PMIJMXBRIDGEL NO PMIMODULE FOUND in SystemOut.log.
  OA10850    Deadlock in class RememberedDataSource.
  OA11055    Deadlock in method Instrumenter.forceLoadClassFile.


3.0 APPLYING THE FIX PACK
-------------------------
The following sections provide information about installing this fix pack.

  1. In the list of files in section "1.3 Fix Pack Contents," identify
     the fix pack file that corresponds to the target operating system.

  2. Copy the fix pack file you identified in Step 1 to the $CANDLE_HOME
     directory.

  3. Stop IBM Tivoli OMEGAMON XE for WebSphere Application Server.

  4. Stop all monitored application servers.

  5. Make backup copies of all of the files listed under the appropriate
     operating system in section "1.3 Fix Pack Contents."

  6. At a shell prompt, run the following command from the $CANDLE_HOME
     directory:

    - On a Unix system:
      uncompress -c <FIXPACK> | tar xvf - 

    - On a Windows system:
      <FIXPACK> -d -o

    where <FIXPACK> is the name of the file identified in Step 1.

  7. Restart the application servers stopped in Step 4.

  8. Restart IBM Tivoli OMEGAMON XE for WebSphere Application Server.



4.0 KNOWN DEFECTS
-----------------
None.


5.0 WEBSPHERE APPLICATION SERVER V6 TOLERATION SUPPORT 
------------------------------------------------------
The following sections provide information for monitoring WebSphere Application
Server V6.
 
  1. This fixpack monitors all the existing features that IBM Tivoli Omegamon XE
     for WebSphere Application Server version 130 supports for WebSphere
     Application Server V6.  Newly introduced features are not supported.
    
  2. A separate agent instance is required to monitor each profile in a 
     stand-alone configuration.  In a Network Deployment configuration, the 
     deployment manager profile does not require an instance.  Only the profiles
     whose nodes are added to the deployment manager require an instance.
    
     The agent's configuration file (kwe.xml) must be setup as follows:
    
     - The parameter WASAppServerRoot indicates the directory path name to the
       location where WebSphere Application Server product is installed.

     - A new parameter called WASInstanceRoot indicates the directory path name
       to the the profile to be monitored by the agent.
      
     For example:

     <KWEAGENT
        AgentID="MyFirstProfile"
        ...
        WASAppServerRoot="/opt/websphere/AppServer"
        WASInstanceRoot="/opt/websphere/AppServer/profiles/MyFirstProfile"
        ...
      >
      </KWEAGENT>
      
  3. The interpretation of the PMI instrumentation levels are limited to the
     instrumentation levels supported in previous WebSphere Application Server
     versions.  The following mapping relates the new statistic sets to previous
     instrumentation levels:
    
     WAS 6.0             pre-WAS 6
     Statistic Sets      Instrumentation Levels
     -----------------------------------------------------
     None                None
     Basic               Low
     Extended            Medium
     All                 High
     Custom              Max
        
    - During "Take Action" commands, selecting "Max" will select the "All" 
      statistic set.
    - Selecting a level for an individual PMI module or CNP data row, will change
      the overall statistic set to "Custom" and will enable parameters specific 
      to the selected statistic set.
    - It is recommended that the Custom statistic set and enabling desired
      parameters be done through the Administrative Console.
    
    

