File Name: dir4.21_uim_tme.txt **************************************************************** ** ** ** IBM(R) Director Version 4.21 ** ** Upward Integration Module (UIM) for ** ** IBM Tivoli(R) Management Environment(R) ** ** ** ** (C) Copyright IBM Corp. 1999, 2005 All rights reserved. ** ** ** ** Note to U.S. Government Users Restricted Rights -- Use, ** ** duplication or disclosure restricted by GSA ADP Schedule ** ** Contract with IBM Corp. ** ** ** **************************************************************** ================================================================ | Updated 13 January 2005. | ================================================================ CONTENTS 1.0 About this readme file 2.0 Documentation 3.0 Installation 3.1 Configuring the UIM inventory component 4.0 Known problems and workarounds 5.0 Corrections to the documentation 6.0 Change history 7.0 Support Web sites 8.0 Notices and trademarks 1.0 ABOUT THIS README FILE --------------------------- IBM Director Version 4.21 is an upgrade release to IBM Director Version 4.20. You can use the IBM Director Upward Integration Module (UIM) for IBM Tivoli Management Environment to access the following functions from Tivoli Enterprise Console(R): o Event notification o Inventory collection o Discovery 2.0 DOCUMENTATION ------------------ The following documents are available in the docs directory on the "IBM Director Version 4.21" CD: o "IBM Director 4.20 Installation and Configuration Guide" o "IBM Director 4.20 Systems Management Guide" o "IBM Director 4.21 Release Notes" The following documents are available from the IBM Support Web site (see section 7.0, "Support Web sites"): o "IBM Director 4.20 Upward Integration Modules Installation Guide" o "IBM Director 4.20 Events Reference" The documentation is in Portable Document Format (PDF). You need Adobe Acrobat Reader or Xpdf to view it. Check the IBM Support Web site regularly for updated IBM Director documentation and readme files. 3.0 INSTALLATION ----------------- The installation instructions are provided in the "IBM Director 4.20 Upward Integration Modules Installation Guide." 3.1 Configuring the UIM inventory component ------------------------------------------- In the "IBM Director 4.20 Upward Integration Modules Installation Guide", the section about modifying the DA_Inventory profile includes a script for PC systems. Because of the length of the script, the script is included in this readme file. You can cut and paste it into the "Scripts and MIF files" section of the Inventory Administration window. %UMS_DRIVE% @cd "%UMS_HOME%\inventory" IF NOT EXIST "%UMS_HOME%" GOTO tag IF NOT EXIST "%UMS_HOME%"\jre\bin\java.exe GOTO jre @..\jre\bin\java.exe -D:WINDIR="%WINDIR%" -cp .\cim2mif.jar;"%UMS_HOME%\httpserv\cimdre.jar";"%UMS_HOME%\httpserv\cimxml.jar";"%UMS_HOME%\httpserv\guitools.jar";"%UMS_HOME%\httpserv\cimfac.jar";"%UMS_HOME%\httpserv\cimwmi.jar";"%UMS_HOME%\httpserv\cimcmn.jar" com.ibm.sysmgt.cim.cim2mif.cim2mif /TME c:\ "%UMS_HOME%\inventory\dmi2tiv.exe" @dmi.lst exit 0 :jre IF NOT EXIST "%UMS_HOME%"\jre\bin\jre.exe GOTO jview @..\jre\bin\jre.exe -D:WINDIR="%WINDIR%" -cp .\cim2mif.jar;"%UMS_HOME%\httpserv\cimdre.jar";"%UMS_HOME%\httpserv\cimxml.jar";"%UMS_HOME%\httpserv\guitools.jar";"%UMS_HOME%\httpserv\cimfac.jar";"%UMS_HOME%\httpserv\cimwmi.jar";"%UMS_HOME%\httpserv\cimcmn.jar" com.ibm.sysmgt.cim.cim2mif.cim2mif /TME c:\ "%UMS_HOME%\inventory\dmi2tiv.exe" @dmi.lst exit 0 :jview @jview -d:WINDIR="%WINDIR%" -cp:a .\cim2mif.jar;"%UMS_HOME%\httpserv\cimdre.jar";"%UMS_HOME%\httpserv\cimxml.jar";"%UMS_HOME%\httpserv\guitools.jar";"%UMS_HOME%\httpserv\mswmi.jar";"%UMS_HOME%\httpserv\xml4j2.jar";"%UMS_HOME%\httpserv\xml4j.jar" com.ibm.sysmgt.cim.cim2mif.cim2mif /TME c:\ "%UMS_HOME%\inventory\dmi2tiv.exe" @dmi.lst exit 0 :tag pegsunprv.exe -D"WINDIR=%WINDIR%" -cp %%DIRECTOR_HOME%%\classes\cim2mif.jar;%%DIRECTOR_HOME%%\classes\cimdre.jar;%%DIRECTOR_HOME%%\httpserv\cimxml.jar;%%DIRECTOR_HOME%%\httpserv\guitools.jar;%%DIRECTOR_HOME%%\classes\cimfac.jar;%%DIRECTOR_HOME%%\classes\cimwmi.jar;%%DIRECTOR_HOME%%\classes\cimutl.jar;%%DIRECTOR_HOME%%\classes\cimcmn.jar com.ibm.sysmgt.cim.cim2mif.cim2mif /TME exit 0 4.0 KNOWN PROBLEMS AND WORKAROUNDS ----------------------------------- See the "IBM Director 4.20 Upward Integration Modules Installation Guide" for any additional limitations. o On Linux(R) and UNIX(R) platforms, execute permissions might have to be set on all the *.sh files used for installation. o Software Distribution of the IBM Director Agent 4.20 package to an endpoint running on Microsoft(R) Windows NT(R) 4.0 requires the administrator be logged onto the endpoint when the package is distributed for new installations only. o (Managed systems running Windows(R) Server 2003 and Windows XP) The Shutdown and Reboot task might fail on systems that are running IBM Director Agent if a user is not logged in on the system. 5.0 CORRECTIONS TO THE DOCUMENTATION ------------------------------------- The directions for software distribution provided in the "IBM Director 4.20 Upward Integration Modules Installation Guide" are still applicable with the following exceptions: o You now download the IBM Director Agent 4.21 packages from the IBM Support Web site. o To install IBM Director Agent 4.21 on a system that does not have IBM Director installed, complete the following steps: 1. Download the dir4.21_agent_windows.zip file. 2. Follow the instructions in the "IBM Director 4.20 Upward Integration Modules Installation Guide." 3. Use the daswd.sh to create the new installation software package. o To upgrade a system that has a previous version of IBM Director Agent installed, complete the following steps: 1. Download the dir4.21_agent_patch_windows.zip file. 2. Use the dapatchswd.sh file to create the upgrade installation software package. 6.0 CHANGE HISTORY ------------------- o IBM Director Agent UIM for Tivoli Enterprise(TM) Framework 4.20 to 4.21 - New Power Supply monitor for Tivoli Distributed Monitors - Includes fixes for APARs IC43049, IC43050, and IC43288 o IBM Director Agent UIM for Tivoli Enterprise Framework 4.11 to 4.20 - Added support for IBM Management Processors SNMP trap support - Added support for Tivoli Windows Event Log adapter - Added support for IBM Director Agent running on Linux - New monitors for Tivoli Distributed Monitors o IBM Director Agent UIM for Tivoli Enterprise Framework 4.1 to 4.11 - Added support for Software Distribution of IBM Director Agent version 4.11 - Updates to handle events from multinode servers o IBM Director Agent UIM for Tivoli Enterprise Framework 3.1 to 4.1 - Changed to non-Plus install method - Added Tivoli Monitoring Support o IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.3 to 3.1 - Added support for Framework 3.7.1, Inventory 4.0, Distributed Monitoring 3.7, and Tivoli Enterprise Console 4.0 - Added support for Microsoft Windows XP o IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.2 to 1.3 - Corrected the following files to support ServeRAID(TM) SNMP traps: o UMStecad_snmp.baroc o UMStecad_snmp.cds o UMStecad_snmp.oid - Removed unnecessary options from the installation window - Corrected the uninstallation option - Added support for native Tivoli Enterprise Console events o IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.11 to 1.2 - Corrected the installation status report from an IBM Director Agent remote installation to Software Distribution on Windows 95 and Windows 98 endpoints - Corrected the file UMStecad_snmp.baroc to correctly label Netfinity(R) Director traps in the Tivoli Enterprise Console - Corrected the reboot (restart) option for the IBM Director Agent file package to Windows 95 and Windows 98 endpoints o IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.10 to 1.11 - Corrected the inventory to Oracle database - Added support for receiving Tivoli Enterprise Console events from Netfinity Director SNMP traps - Added Geographic information to inventory - Added System slots, DMI, and Alert on LAN(TM) settings to inventory - Added Asset ID(TM), BIOS details, SNMP agent configuration to inventory 7.0 SUPPORT WEB SITES ---------------------- The following Web pages provide resources for understanding, using, and troubleshooting IBM Director and systems-management tools: o IBM Director 4.21 http://www.ibm.com/pc/support/site.wss/ document.do?lndocid=MIGR-58219 o IBM Director 4.20 http://www.ibm.com/pc/support/site.wss/ document.do?lndocid=MIGR-55606 You can download the following IBM Director 4.20 code and information from this Web page: o CD image o Documentation o IBM LM78 and SMBus device drivers for Linux o Readme files o Extensible Markup Language (XML) files for use with the Software Distribution task Check this Web page regularly for updated readme files and documentation. o IBM Director Agent page http://www.ibm.com/servers/eserver/xseries/systems_management/ sys_migration/ibmdiragent.html You can download the IBM Director Hardware and Software Compatibility document from this Web page. This document lists supported eServer(TM) and xSeries(R) systems, as well as all supported operating systems. It is updated every 6 to 8 weeks. o IBM eServer Information Center http://www.ibm.com/servers/library/infocenter This Web page provides information about the IBM Virtualization Engine(TM) and IBM Director Multiplatform. o IBM ServerProven page http://www.ibm.com/pc/us/compat/index.html The ServerProven(R) Web page provides information about xSeries, BladeCenter(TM), and IntelliStation(R) hardware compatibility with IBM Director. o IBM Support page http://www.ibm.com/pc/support/ This is the IBM Support Web site for IBM hardware and systems- management software. For systems-management software support, click "Systems management". o IBM Systems Management Software: Download/Electronic Support page http://www.ibm.com/pc/us/eserver/xseries/systems_management/ dwnl.html Use this Web page to download IBM systems-management software, including IBM Director. Check this Web page regularly for new IBM Director releases and updates. o IBM xSeries Systems Management page http://www.ibm.com/pc/ww/eserver/xseries/systems_management/ index.html This Web page presents an overview of IBM systems management and IBM Director. It also contains links to Web pages for IBM Director extensions including Remote Deployment Manager, Scalable Systems Manager, Server Plus Pack, and Software Distribution (Premium Edition). 8.0 NOTICES AND TRADEMARKS --------------------------- 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. The following terms are trademarks of the IBM Corporation in the United States, other countries, or both: Alert on LAN Asset ID the e-business logo BladeCenter eServer IBM IBM Virtualization Engine IntelliStation Netfinity NetView ServerProven ServeRAID Tivoli Tivoli Enterprise Tivoli Enterprise Console Tivoli Management Environment Wake on LAN xSeries Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both. Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others.