File Name: readme.txt **************************************************************** ** ** ** IBM(R) Director Version 4.20 ** ** Upward Integration Module (UIM) for ** ** IBM Tivoli(R) Management Environment(R) ** ** ** ** Part number 01R0548 ** ** ** ** (C) Copyright IBM Corp. 1999, 2004 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 22 July 2004. | ================================================================ CONTENTS 1.0 Overview 2.0 Documentation 3.0 Installation 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 OVERVIEW IBM Director Version 4.20 is an upgrade release to IBM Director Version 4.1 and Version 4.11. You can use the IBM Director Upward Integration Module (UIM) for IBM Tivoli Management Environment to access the following functions from Tivoli Enterprise Region(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.20" CD: o "IBM Director 4.20 Installation and Configuration Guide" o "IBM Director 4.20 Systems Management Guide" The following documents are available from the IBM Support Web site (see section 5.0, "Support Web sites"): o "IBM Director 4.20 Upward Integration Modules Installation Guide" o "IBM Director 4.1 Events Reference" These documents are in Portable Document Format (PDF) and require Adobe Acrobat Reader to view them. 3.0 INSTALLATION The installation instructions are provided in the "IBM Director 4.20 Upward Integration Modules Installation Guide." This guide is available from the IBM Support Web site (see section 5.0, "Support Web sites"). The guide is in Portable Document Format (PDF) and requires Adobe Acrobat Reader to view it. 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, it is provided in this readme file for you to cut and paste 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 and Unix platforms, execute permissions might have to be set on all the *.sh files that are used for installation. o (Managed systems running Windows NT only) Software Distribution of the Director Agent 4.20 package to an Endpoint running on Windows NT 4.0 requires the administrator be logged onto the Endpoint when the package is distributed for new installs only. 5.0 CORRECTIONS TO THE DOCUMENTATION None. 6.0 CHANGE HISTORY o IBM Director Agent UIM for Tivoli Enterprise(TM) 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 Agents running on Linux. - Added new monitors for Tivoli Distributed Monitors. o IBM Director Agent UIM for Tivoli Enterprise(TM) Framework 4.1 to 4.11 - Added support for Software Distribution of version 4.11 agent. - Updated to handle events from MultiNode Servers. o IBM Director Agent UIM for Tivoli Enterprise(TM) Framework 3.1 to 4.1 - Changed to non-Plus installation 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(R) Windows(R) 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.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 and xSeries 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 and IBM Director Multiplatform. o IBM ServerProven page http://www.ibm.com/pc/us/compat/index.html The ServerProven Web page provides information about xSeries, BladeCenter, and IntelliStation 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: the e-business logo Alert on LAN Asset ID BladeCenter eServer IBM IBM Virtualization Engine Netfinity ServeRAID ServerProven Tivoli Tivoli Enterprise Tivoli Enterprise Console Tivoli Enterprise Region Tivoli Management Environment xSeries Java is a trademark 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. Other company, product, or service names may be trademarks or service marks of others.