COMPONENT_ID: 5724C01WL 
(c) COPYRIGHT 2004 Tivoli Systems, International Business Machines Corp.
All Rights Reserved
Licensed Materials - Property of IBM
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.


Date: 
    30 April 2004
    
Fix pack: 
    5.1.0-WLS-FP01
   
Component: 
    IBM Tivoli Monitoring for Web Infrastructure 5.1.0: WebLogic Server
    
Table of Contents:
  o Section 1. General Description
      - Section 1.1 General Description
      - Section 1.2 Function Added    
      - Section 1.3 Products Certified
      - Section 1.4 Architecture(s)
      - Section 1.5 Dependencies
      - Section 1.6 Fixpacks superceded by this patch     
      - Section 1.7 Patch contents
  o Section 2. Problems Fixed
      - Section 2.1 Problems Fixed
      - Section 2.2 Files replaced or added by this fix pack
  o Section 3. Installation Notes
      - Section 3.1 Applying the patch
      - Section 3.2 Additional installation instructions: 
                                                   Resource models
      - Section 3.3 Additional installation instructions: 
                                                   TBSM
      - Section 3.4 Additional installation instructions: 
                                                   Warehouse Enablement  
  o Section 4. Additional Notes
  o Section 5. Limitations and Known Problems  
      - Section 5.1 Limitations & Known Problems


########################################################################
# Section 1. General Description                                       #
########################################################################

1.1 General Description:
 
    This fix pack adds support for :
        BEA WebLogic Server 8.1
        Tivoli Enterprise Console 3.8 and 3.9
        Tivoli Business Systems Manager 2.1

1.2 Function Added:
    
    Support for Tivoli Enterprise Console 3.8 & 3.9: 
     
    The WebLogic Configure TEC task has been moved from the WebLogic 
    Configuration Tasks task library to IBM Tivoli Monitoring Component
    Services Tasks.
    To access this new task, navigate from the TME Desktop menu bar:
          Desktop-->
          Navigator-->
          TaskLibrary:IBM Tivoli Monitoring Component Services Tasks-->
          Configure Event Server-->
          IBM Tivoli Monitoring for WebLogic Server
 
                
1.3 Products Certified

    This product was certified with 
      BEA WebLogic Server 8.1, SP 1, SP2
      BEA WebLogic Server 7, SP4
      BEA WebLogic Server 6, SP3
      
      
1.4 Architecture(s):
 
    All platforms previously supported.


1.5 Dependencies: 

    IBM Tivoli Monitoring for Web Infrastructure 5.1.0: WebLogic Server 
    IBM Tivoli Monitoring Version 5.1.1 Fix pack 05 (5.1.1-ITM-FP05) 
    IBM Tivoli Monitoring Component Services, Version 5.1.1 -
        Interim fix 01 (5.1.1-ICS-0001LA)
    

1.6 Fix packs superceded by this patch: 
    None

       
1.7 Patch Contents:
    - this README file
    - A tar image for this patch


########################################################################
# Section 2. Problems Fixed                                            #
########################################################################

2.1 Problems Fixed:

     Defect:   150503  wuninst not listing WebLogic PAC for uninstall
     Symptoms: wuninst -list does not have an entry for WebLogic or 
               ITMWIWLS.  The wuninst command cannot be used to 
               remove IBM Tivoli Monitoring for Web Infrastucture:
               WebLogic Server. "wuninst WebLogic" results in error
               message FRWTT0003E.
     Additional Information: The wuninst command can now be used to
               remove the product. 
               Usage:    
                  wuninst WebLogic <node> -rmfiles
               The associated logfile is 
               $DBDIR/GWL/logs/trace_itmwls_uninstall_prod___1.log
                     
     Defect:   151824  Configure TEC task generates error message
     Symptoms: No check to see if rules have already been compiled;
               error message displayed such as 
               Error::ECO:0001:0196 Already defined class file in
               rule base.
     Defect:   152256  DBCS:TEC server fails to start with WLS rulebase
     Symptoms: When Configure TEC task is run, TEC server fails to
               start and error messages are displayed:
               "Error: Environment BINDIR not defined."
               TEC server startup fails, got error message:
               "System Problem: `ERROR: Process T/EC Rule exits with exit
               code 70: Error during rule base loading`"
     Additional Information:  The WebLogic Configure TEC task has been
               moved from the WebLogic Configuration Tasks task library
               to IBM Tivoli Monitoring Component Services Tasks.
               To access this new task, navigate from the TME Desktop
               menu bar:
               Desktop-->
               Navigator-->
               TaskLibrary:IBM Tivoli Monitoring Component Services Tasks-->
               Configure Event Server-->
               IBM Tivoli Monitoring for WebLogic Server
     
     APAR:     IY53885 uninstall script WLS510_uninstall.sh removes all
               Global User Roles
     Symptoms: The uninstall script tries to remove all of the Global
               Roles for the users.  The TMR won't let you remove the
               roles from the last user and so it exits but you are 
               left with a user with no roles, the files removed and 
               related objects still around.
     
     Defect:   156373 TDW: IBM Tivoli Monitoring FP5 AMX fails to 
               install due to WebLogic tag file
     Symptoms: ITM FP5 AMX fails to install after installing WebLogic
               warehouse enablement pack
               The GWL_4_WH_Month_dwc_data.tag file contained
               AMX source/targets.  

     Defect:   167338 TDW: Prune MSMT statements missing
     Symptoms: The inserts into twg.prune_msmt_control were not done
               in gwl_cdw_data.  By default, the 
               TDW CDW_m05_S010_PurgeMsmt process would not prune
               GWL data from the central data warehouse.

     Defect:   168324 No data in fact tables after running GWL ETLs 
     Symptoms: No data in fact tables because the name of the file
               gwl_m05_s010_mart_pre_extract.db2 in .../etl/sql 
               was truncated to gwl_m05_s010_mart_pre_extra.db2.                 


Enhancement Request:

    MR0918032817 WLS PAC Support of BEA WebLogic Server 8.1 with JRE 1.4 
    Description:  BEA WebLogic Server 8.1 is now supported.
              The ILT now runs in a JVM separate from ITM thus it is no
              longer necessary to link to the JRE supplied 
              with the BEA WebLogic Server product. You may use the JVM 
              that is shipped with IBM Tivoli Monitoring or any other
              compliant JRE.  The DmLinkJre task must be run to specify
              which JRE to use.  Do NOT link to the BEA WebLogic 
              Server JRE if it is using Java 1.4; IBM Tivoli Monitoring
              does not currently support Java version 1.4.

2.2 Files  replaced or added by this fixpack:
    
        ./lcf_bundle.40/TME/WEBLOGIC/TMA_WebLogicAction.sh
        ./lcf_bundle.40/TME/WEBLOGIC/wls511.jar
        ./lcf_bundle.40/TME/WEBLOGIC/WLSConfig.properties
        ./generic_unix/TME/WEBLOGIC/WLS510FP1.init
	./generic_unix/TME/WEBLOGIC/WLS510_uninstall.sh
	./generic_unix/TME/WEBLOGIC/TEC/WebLogic_send_to_TBSM.sh
	./generic_unix/TME/APPLSVCS/TEC_CONFIG/WebLogic.pac
	./generic_unix/TME/WEBLOGIC/TEC/WebLogic_fwd_evt.rls
        ./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_ExecutionQueue.tar
        ./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_HTTPSessions.tar
        ./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_JTA.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_JMS.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_JCA.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_DBPools.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_Servlets.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_ServerState.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_EJBs.tar
	./generic_unix/TME/WEBLOGIC/ITM/models/WebLogic_JVM.tar
	./bin/%INTERPS%/TME/WEBLOGIC/WebLogic
	./bin/linux-ix86/TME/WEBLOGIC/WebLogic
        ./lcf_bundle.40/TME/WEBLOGIC/register_server.d
        ./lcf_bundle.40/TME/WEBLOGIC/server_properties.d
        
        
########################################################################
# Section 3. Installation notes                                        #
########################################################################

3.1 Applying the patch:
       
    1)  Extract the patch:
    
        Extract the contents into a scratch directory. For the purpose
        of these instructions, assume that the symbol $patch (%patch% on
        Windows) points to this directory.

        On a Unix system:

        # cd $patch
        # tar -xvf 5.1.0-WLS-FP01.tar

        On a Windows system: 

        > %SystemRoot%\system32\drivers\etc\Tivoli\setup_env
        > X:
          where 'X' is drive letter where %patch% is found
        > cd %patch%
        > tar xvf 5.1.0-WLS-FP01.tar

        NOTE:  If you are extracting the tar image on a Windows
        system, you will find an executable for tar in the TME
        installation on Windows under bin/w32-ix86/tools/tar.exe.

    2)  Follow these instructions to install using Software
        Installation Service (SIS).  If not, skip to step 3 below.

        NOTE: SIS can install Tivoli products on any hardware
              platform supported by Tivoli, but there are some
              hardware platforms on which SIS cannot be run. Please
              check your SIS User's Manual for the list of platforms
              on which SIS can be run.

        NOTE: You must have the install_product and super authorization
              roles to successfully install this patch.

        a)  From the Tivoli Desktop, pull down
            Desktop --> Install --> Software Installation Service.
        b)  SIS will initialize, and bring up the Get Installation
            Password Dialog.  Enter your Installation Password.
        c)  Click the Install Button on the dialog which contains
            the Tivoli image.
        d)  Click the Select Product Button on the Install Spreadsheet
            Dialog.
        e)  Click the Import Product Button on the Select Product
            Dialog.
        f)  Locate the media to 5.1.0-WLS-FP01 using the file browser, and
            select the PATCHES.LST file by double-clicking it.
        g)  Select 5.1.0-WLS-FP01 in the Import Product Dialog, and click
            the Import Button.
        h)  When the import is complete, click the OK Button on the
            Global Progress Dialog.
        i)  Select 5.1.0-WLS-FP01 in the Select Product Dialog, if it is
            not already selected, and click the OK Button.
        j)  Now click the Select Machine Button on the Install
            Spreadsheet Dialog.
        k)  Select the machine(s) you would like to install 5.1.0-WLS-FP01
            to, and click the OK Button.
        l)  Click the appropriate cell(s) in the Install Spreadsheet
            Dialog. (NOTE: This should yield an "X" in the cell(s)
            for the machines where you want to install 5.1.0-WLS-FP01).
        m)  Click the Install Button.
        n)  Select the install algorithm you want to use on the
            Installation Algorithm Dialog, and click OK.
        o)  SIS will perform the installation(s) you designated
            in the Install Spreadsheet Dialog.
        p)  Installation is complete. Check the Additional
            Installation Instructions section below.

    3)  Follow these instructions to install using the original
        Tivoli desktop install mechanism. If not, skip to step 4 below.
        NOTE: You must have the install_product and super authorization
        roles to successfully install this patch.

        a)  From the "Desktop" menu, select the "Install -> Install Patch..." 
            option to display the "Install Patch" dialog.
        b)  Press the "Select Media..." button to display the "File
            Browser" dialog.
        c)  In the "Path Name:" field, enter the path to the directory
            containing the patch file 510WLSFP01.IND.
            This will be under $patch/WLS510FP1/WLS510FP1.image
        d)  Press the "Set Media & Close" button to return to the
            "Install Patch" dialog.
        e)  The patch install list now contains the name of the patch.
            Select the patch by clicking on it.
        f)  Select the clients to install this patch on. This should be the TME
            server and on each managed node where the product is installed.
        g)  Press the "Install" button to install the patch.

    4)  The patch can also be installed using the wpatch command line utility.
        
        wpatch -c $patch/WLS510FP1/WLS510FP1.image -i WLS510FP.IND


3.2 Additional installation instructions - Resource Models

      1) The instructions have changed for linking the JRE used to run ITM.
         These originally appeared in the IBM Tivoli Monitoring for Web 
         Infrastructure 5.1.0 - WebLogic Server User's Guide, 

         It is no longer necessary to link to the JRE supplied with the 
         BEA WebLogic Server product. You may use the JVM 
         that is shipped with IBM Tivoli Monitoring (like other PACs) or any 
         other compliant JRE.  The DmLinkJre task must be run to specify
         which JRE you use.  Do NOT link to the BEA WebLogic Server JRE if
         it is using Java 1.4; IBM Tivoli Monitoring does not 
         support version 1.4.
         
         
     2) After the patch has been installed, if IBM Tivoli Monitoring for Web 
        Infrastructure 5.1.0 - WebLogic Server resource models had been
        previously distributed, take the following steps to distribute
        changes to the endpoint: 

        a. Before redistributing monitoring profiles to Windows 
        endpoints, shut down the IBM Tivoli Monitoring engine. 
        It is not necessary to shut down the engine on Unix endpoints
        running WebLogic resource models.

        Use the following command:
           "wdmcmd -stop -e <endpoint label>"
           
                
        b. Validate the WebLogic Server object.  This will distribute
        updated versions of files. This function is available from the 
        right mouse button of the WebLogicServer icon and from the
        WebLogic Control Tasks library. If the WebLogic server
        is not started, you will receive a connection error.  
        
        c. Redistribute the Monitoring Profiles.
        
 
3.3 Additional installation instructions - TBSM

        Tivoli Business Systems Manager (TBSM) -
        The refreshed files are in the TBSM subdirectory in $patch.
        Refer to Tivoli Business Systems Manager User's Guide.
        
        
3.4 Additional installation instructions - Warehouse Enablement

        The $patch\tedw_apps_etl directory included with this fix pack
        is a new version (v120) of the IBM Tivoli Monitoring for
        Web Infrastructure: WebLogic Server version 5.1.0 warehouse
        enablement pack.  The original version v110 of the warehouse
        enablement pack has been withdrawn due to installation problems
        associated with IBM Tivoli Monitoring Fix Pack 05.  This is a
        replacement to the existing warehouse enablement pack and not
        a fixpack update. 

        If you have not yet installed IBM Tivoli Monitoring for Web
        Infrastructure: WebLogic Server  version 5.1.0 warehouse
        enablement pack v110, install the version included with this
        fixpack. If you already have the IBM Tivoli Monitoring for
        Web Infrastructure: WebLogic Server  version 5.1.0 warehouse
        enablement pack v110 installed, contact support for information
        on uninstalling the v110 version before installing the new 
        version.  See Known Defects and Limitations.
        
        

########################################################################
# Section 4. Additional Notes                                          #
########################################################################

4.1 Additional Notes: 
     
     If a custom resource model has been created, 
     because some of the mof files and the data provider have changed,
     you will need to rebuild your resource model.
     Refer to the IBM Tivoli Monitoring for Web Infrastructure: 
     WebLogic Server User's Guide or the IBM Tivoli Monitoring Resource
     Model Builder User's Guide for more information on building resource
     models. 
     The following resource model dependencies have changed:
     
        Data provider:
        TME/WEBLOGIC/wls511.jar  (replaces wls510.jar)
        
        Mof files used to build resource models:
        These are in $patch/WORKBENCH in the fix pack tar image.
        and are also installed with the fix pack and are 
        found in $BINDIR/../lcf_bundle.40/TME/WEBLOGIC/Mof  
       
        WebLogic_Application_10-unix.mof
        WebLogic_Application_10-wmi.mof
        WebLogic_EJBRuntimeComposite_10-unix.mof
        WebLogic_EJBRuntimeComposite_10-wmi.mof
        WebLogic_EJBComponent_10-unix.mof
        WebLogic_EJBComponent_10-wmi.mof
        WebLogic_ExecuteQueueRuntime_10-unix.mof
        WebLogic_ExecuteQueueRuntime_10-wmi.mof
        WebLogic_JTARuntime_10-unix
        WebLogic_JTARuntime_10-wmi
        WebLogic_ServerRuntime_10-unix.mof
        WebLogic_ServerRuntime_10-wmi
        WebLogic_ServletRuntime_10-unix.mof
        WebLogic_ServletRuntime_10-wmi.mof
        WebLogic_WebAppComponent_10-unix.mof
        WebLogic_WebAppComponent_10-wmi.mof
        WebLogic_WebAppComponentRuntime_10-unix.mof
        WebLogic_WebAppComponentRuntime_10-wmi.mof

     After a new package (tar file) is built, it is added into the Tivoli 
     Management Region (TMR) with the following command:
       wdmrm -add <resource-model-tar-file>

########################################################################
# Section 5. Limitations and Known Problems                            #
########################################################################

5.1 Limitations & known problems:

    Defect:  170705  WebLogic_EJBs RM: transactionsTimedOut always 0

    The BEA WebLogic Server does not update the transactionsTimedOut
    metric used by the EJB Resource Model. As a result, the threshold 
    EJBTransactionsTimedOutPercent_UpperBound is not exceeded and the 
    WebLogic_EJBTransactionsTimedOutPercentHigh event will not be sent.
    BEA is aware of this problem and identified it as case CR127951.
    BEA is planning a fix in service pack 3 of WebLogic Server 8.1.

    Defect:  152174  Servlet Resource Model performance
    
    A performance concern has been identified in the ITM for Web 
    Infrastructure product: 
    WebLogic 5.1  "Web Application Servlets and JSPs" resource model.
    Increased CPU usage may be seen on the endpoint when running this
    resource model with a substantial number of Servlets and JSPs.
    IBM Tivoli is working with BEA to resolve the issue for retrieving
    servlet metrics from the WebLogic server. Case 494413  has been 
    opened with BEA for this issue.   Future updates will be provided
    when this case is resolved.   If you require additional
    information, please contact IBM Tivoli customer support.
    
    Defect:  167391 TDW parameters can become corrupted after 
    uninstalling the WEP. This is a problem with the iwh2imp tool.
         
