(C) Copyright International Business Machines Corporation 2010. 
    All rights reserved.

Component: IBM(R) Tivoli(R) Monitoring for Energy Management - Reporting and Optimization
           Version 6.2.1 Interim Feature 01 
               
           
Component ID: 5724V08DO

Interim Fix: 0001, 6.2.1.1-TIV-ITM_EM-RO-IF0001

Date: 31 March 2010        

Contents:

1.0 General description
2.0 Problems fixed
3.0 Architecture and prerequisites
4.0 Image directory content
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 interim 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 Defects
  -----------
 
  Defect: 33154
  Abstract: CPU data in reports is always 0 or 100
  Additional Information: This is fixed by fetching CPU usage data from the
                                      OS agents instead of the hardware agents.

  Defect: 33941
  Abstract: First day missing in DCiE/PUE chart
  Additional Information: This is fixed by considering the entire 24 hours within 
                                      the start and end dates of the date range.

  Defect: 34161
  Abstract: PDUs & UPSes are excluded from the report/chart when the input  
                power is not available
  Additional Information: This is fixed by assuming that the input power  
                                      is the same as the output power when the input power 
                                      is not available.
 
  Defect: 34687
  Abstract: Power distribution from the power device is not working for the 
                    custom CRAC devices
  Additional Information: This is fixed by allowing power distribution to devices
				that report power usage as -1.

  Defect: 34827
  Abstract: Power value appears as 0 when it is not available from the agent
  Additional Information: This is fixed by showing NA when power data is not available.

  Defect: 35309
  Abstract: Fetching the storage and network data from the Tivoli Data Warehouse is failing
  Additional Information: Reporting and Optimization expected the column name 'Type' 
                                   in the network and storage database tables in the Tivoli Data Warehouse. 
                                   'Type' is not a key attribute in the attribute groups; therefore, the column
                                   name is created as 'LAT_Type'. This is fixed by using 'LAT_Type'
                                   instead of 'Type'.


3.0 Architecture and prerequisites
----------------------------------

This fix is supported on all operating systems listed in the IBM 
Tivoli Monitoring for Energy Management Offering Guide, 
Version 6.2.1 Interim Feature 01. Refer to the guide
in the IBM Tivoli Monitoring for Energy Management Information 
Center located at:

http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.itmem.doc_621if1/EM_welcome.htm

The following link is for the Tivoli platform 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 Monitoring for Energy Management Reporting and 
  Optimization Version 6.2.1 Interim Feature 01
  Download it from the following ftp site:
  ftp://public.dhe.ibm.com/software/tivoli_support/patches/patches_6.2.1/6.2.1-TIV-ITM_EM-IF0001/


- IBM Tivoli Monitoring for Energy Management: Active Energy Manager Agent 
  Version 6.2.1 Interim Feature 01, which is bundled with IBM Tivoli Monitoring for
  Energy Management Version 6.2.1 Interim Feature 01, and the agent's
  Interim Fix 0001 (6.2.1.1-TIV-ITM_EM-AEM-IF0001) 
  Download IBM Tivoli Monitoring for Energy Management Version 6.2.1 
  Interim Feature 01 from the following ftp site:
  ftp://public.dhe.ibm.com/software/tivoli_support/patches/patches_6.2.1/6.2.1-TIV-ITM_EM-IF0001/


- IBM Tivoli Monitoring Operating System agents for Windows, UNIX,
   and Linux Version 6.2 with Fix Pack 2 or later versions, installed 
   on every associated server required to provide CPU utilization     
   data. Refer to the Installation and Setup Guide in the IBM Tivoli  
   Monitoring Information Center located at:

   http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.itm.doc_6.2.2fp1/welcome.htm

The prerequisite configuration level for this fix is as follows:

- Enable the daily summarization level for data warehousing 
  (Daily check box in the Summarization section of the History  
  Configuration Collection window). Refer to Configuring historical 
  data collection in the IBM Tivoli Monitoring Information Center 
  located at:

  http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.itm.doc_6.2.2fp1/welcome.htm

- Configure the new attributes that have been introduced in the attribute 
  groups for IBM Tivoli Monitoring for Energy Management: Active 
  Energy Manager. Refer to Section 8.1.3.1 for more information.

- Configure the new attributes that have been introduced in the reporting 
  attribute groups for IBM Tivoli Agent Builder monitoring agents 
 (custom agents). Refer to Section 8.1.3.2 for more information.

4.0 Image directory content
---------------------------

This fix image contains the following files:

File                                          		                  Description

6.2.1.1-TIV-ITM_EM-RO-IF0001.README	This README file  	
6.2.1.1-TIV-ITM_EM-RO-AIX-IF0001.tar.gz	Archive file in tar.gz format
6.2.1.1-TIV-ITM_EM-RO-HP-IF0001.tar.gz	Archive file in tar.gz format
6.2.1.1-TIV-ITM_EM-RO-Linux-IF0001.tar.gz	Archive file in tar.gz format
6.2.1.1-TIV-ITM_EM-RO-Sol-IF0001.tar.gz	Archive file in tar.gz format
6.2.1.1-TIV-ITM_EM-RO-Windows-IF0001.zip     Archive file in zip format

5.0 Installation instructions
-----------------------------
This fix can only be installed over an existing installation 
(IBM Tivoli Monitoring for Energy Management 
Reporting and Optimization Version 6.2.1 Interim Feature 01). 
Use the following steps to install this fix.

  5.1 Before installing the fix
  -----------------------------
  - Since there is no uninstall utility for this fix, we suggest you
    perform a backup of your environment before installing this fix.
    
  - The prerequisites listed under section 3.1 entitled 'Prerequisites
    for this fix' must be installed before this fix can be installed.

  - Ensure that your current version of Reporting and Optimization
    is Version 6.2.1.01.

  - Ensure you have execute permissions to the Tivoli Integrated 
    Portal command-line interface script on UNIX operating systems.

 - Ensure that you have granted CREATE TABLE privileges to the
   database users of the Tivoli Data Warehouse when the database
   server product is Oracle; for example:
   GRANT CREATE TABLE TO <user_name>
  
  5.2 Install the fix
  -------------------

  5.2.1 Run the installation program in GUI mode
  ------------------------------------------
  You can run the wizard to install Reporting and Optimization 
  Version 6.2.1.01.01 and upgrade your existing Reporting and 
  Optimization Version 6.2.1.01 environment.

  1. Extract the contents of the compressed package to a
      temporary directory. 
  2. From a command line, change to the directory of the 
      product installation image. 
  3. Execute the binary file that was extracted from the 
      compressed package.
  4. Select your preferred language.
  5. On the Welcome page of the installation wizard, click Next.
  6. Read and accept the license agreement and then click Next.
  7. Accept the default path to the installation location of the 
      existing Reporting and Optimization environment in the 
      Where Would You Like to Install field; alternatively, click 
      Choose to select another directory. Click Next.
  8. Accept the default values or enter details for the existing 
      Tivoli Integrated Portal (TIP) or Tivoli Common Reporting (TCR) 
      Server in the following fields, and click Next.

      - Provide TCR Installed path.
        The installation directory for the existing Tivoli Integrated 
        Portal or Tivoli Common Reporting Server.

      - Port.
        The port number for the Tivoli Integrated Portal Server that 
        has a default  value of 16316 (secured access). The value for 
        unsecured access is 16315.

      - Profile Name.
        The Tivoli Integrated Portal profile name that has a default 
        value of TIPProfile in an embedded WebSphere Application 
        Server.

      - Cell Name.
        The Tivoli Integrated Portal cell name that has a default value 
         of TIPCell in an embedded WebSphere Application Server.

      - Server Name.
        The name of the Tivoli Integrated Portal Server that has a 
        default value of server1 in an embedded WebSphere Application 
        Server.

      - User Name.
        The Tivoli Integrated Portal administrator user ID that has a 
        default value of tipadmin.

      - Password.
        The password for the Tivoli Integrated Portal administrator user 
        ID that has no default value.

9. Review the installation parameters, and click Install.



6.0 Additional installation information
---------------------------------------
None


7.0 Known problems and workarounds
----------------------------------
1. There are no identifying attributes which match between the hardware and 
     Windows servers data if the following criteria occur:
     - The data center contains only Windows machines.
     - The IBM Tivoli Monitoring Operating System agent for 
        Windows collects only MAC Address.
     - No other matching attributes are available.
No match occurs because the attribute group NT_IP_Address is not 
warehoused and is therefore not available to Reporting and Optimization. 
A fix will be available for the IBM Tivoli Monitoring Operating System
agent for Windows in a future release.



8.0 Additional product information
----------------------------------

  8.1 Enhancements for Defect 33154
  ----------------------------------
  This fix enables Reporting and Optimization to match and associate  
  the following separately reported data for servers and group the
  data into the relevant reports:

  - Power metrics that are reported by the server hardware 
    and monitored by IBM Tivoli Monitoring for Energy Management: 
    Active Energy Manager Agent and IBM Tivoli Agent Builder  
    monitoring agents (custom agents)
  - CPU utilization (CPU %) that is reported by the server 
    software and monitored by IBM Tivoli Monitoring Operating System 
    agents

  This fix provides the following enhancements:

  - New attributes added to the attribute groups for the IBM Tivoli  
    Monitoring for Energy Management: Active Energy Manager 
    Agent and the custom agents

    8.1.1 Impacted reports
    ----------------------

    The following reports are directly impacted by the fix:

    - CPU Utilization of Servers
    - Dynamic Power Savings Recommendation for Servers
    - Standby and Power-down Recommendations for Server Pool

    The following reports have UI only impacts because CPU utilization
    and power consumed are two disparate metrics; therefore, CPU
    utilization data has been removed:

    - Data Center Power Usage
    - Data Center Power Usage Comparison

    8.1.2 Hardware and operating system data mapping
    ------------------------------------------------

    You can configure data warehousing for the monitoring agents (IBM 
    Tivoli Monitoring for Energy Management: Active Energy Manager  
    Agent, custom agents, and IBM Tivoli Monitoring Operating System 
    agents) to collect data for the following common sets of identifying 
    attributes:

    - System board universally unique identifier (system UUID)
    - Primary MAC address
    - Fully qualified domain name (FQDN)
    - Manufacturer, machine type and model, and serial number

    Note: In Tivoli Data Integration, the "naming context" for servers  
    comprises these identifying attributes.

    Reporting and Optimization uses these sets of identifying 
    attributes to match the data for the same server from different  
    monitoring agents. It stores the values of the identifying 
    attributes linking the hardware to operating system data.

    8.1.3 Updates to the attribute groups
    -------------------------------------

    To support matching of the identifying attributes, the attribute 
    groups for the following agents have been updated:
    - IBM Tivoli Monitoring for Energy Management: Active Energy 
      Manager Agent
    - Custom agents

      8.1.3.1 New attributes for IBM Tivoli Monitoring for Energy  
                   Management: Active Energy Manager Agent
      -----------------------------------------------------------
      The attribute groups for the IBM Tivoli Monitoring for Energy  
      Management: Active Energy Manager Agent are updated with the  
      following new attributes:

      KE9 ALL BLADECENTERS POWER DATA attribute group
      - System_Board_UUID
      - FQDN
      - Manufacturer
      - Model
      - OS_Type

      KE9 ALL RACK SERVERS POWER DATA attribute group
      - System_Board_UUID
      - FQDN
      - Manufacturer
      - Model
      - OS_Type

      Note: If a new attribute has no value, define it as an enumeration 
      and set its value to -1. These enumerations notify Reporting and 
      Optimization that there is no data available for the attributes. Also, 
      ensure that you configure the MAC_Address_List. 
      For information on setting the attribute to -1, refer to the Active Energy
      Manager  Agent User's Guide in the IBM Tivoli Monitoring for Energy
      Management Information Center located at: 
        
      http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.itmem.doc_621if1/EM_welcome.htm    

      

      8.1.3.2 New attributes for the custom agents
      ---------------------------------------------

      The attribute groups for the custom agents are updated with the 
      following new attributes:

      RPTG_BLADE_SERVER reporting attribute group
      - System_Board_UUID
      - MAC_Address_List
      - FQDN
      - Manufacturer
      - Model
      - Serial_Number

      RPTG_SERVER reporting attribute group
      - System_Board_UUID
      - MAC_Address_List
      - FQDN
      - Manufacturer
      - Model
      - Serial_Number 

      Note: If a new attribute has no value, define it as an enumeration 
      and set its value to -1. These enumerations notify Reporting and 
      Optimization that there is no data available for the attributes. 
      For information on setting the attribute to -1, refer to the Agent Builder
      User's Guide in the IBM Tivoli Monitoring Information Center located at: 

http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.itm.doc_6.2.2fp1/welcome.htm
  
    8.1.4 Mandatory configuration of attributes for IBM Tivoli Monitoring 
              Operating System agents
    --------------------------------------------------------------------------------------------

      8.1.4.1  IBM Tivoli Monitoring Operating System 
                    agent for Windows attributes 
      ------------------------------------------------
      NT Computer Information attribute group
      - Computer_UUID_Number
      - Computer_Domain_Name
      - Computer_Vendor
      - Computer_Name
      - Computer_ID_Number


     8.1.4.2 IBM Tivoli Monitoring Operating System
                    agent for Linux attributes              
      -----------------------------------------
      Linux Machine Information attribute group
      - System_Board_UUID
      - Hardware_Brand
      - Hardware_Model
      - Machine_Serial
     
     Linux Network attribute group
      - MAC_Address
   
    Linux IP Address attribute group
      - DNS_Name  

    8.1.4.3 IBM Tivoli Monitoring Operating System
                   agent for UNIX attributes    
      ----------------------------------------
      Machine Information attribute group
      - System_Board_UUID
      - Hardware_Manufacturer
      - Hardware_Model
      - Machine_Serial
     
     Network attribute group
      - MAC_Address
   
    Unix IP Address attribute group
      - DNS_Name 


    8.1.5 Linking of hardware and OS data
    --------------------------------------
    When you synchronize the server and device data in the  
    Reporting and Optimization configuration database settings page, 
    Reporting and Optimization matches the data for the same server from 
    different monitoring agents (hardware and OS agents) and stores the 
    CPU attribute data. To get a successful match, you must configure the new
    attributes. Refer to Section 8.1.3 for more information.

    Synchronize data using one of the following portlets:

    - Server Settings configuration portlet
    - Database Settings configuration portlet
  
    Note: The Reporting and Optimization configuration database  
    refers to a data store. It is a set of XML files when Reporting  
    and Optimization is installed in a simple Tivoli Integrated 
    Portal environment, or it is a configuration database in the 
    Tivoli Integrated Portal high availability environment.  
    

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 
http://www.ibm.com/legal/copytrade.shtml.

Microsoft and Windows 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, and service names may be trademarks or service
marks of others.