File Name: readme.txt **************************************************************** ** ** ** IBM(R) Director Version 4.12 ** ** 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. ** ** ** **************************************************************** CONTENTS 1.0 Overview 1.1 Publications 2.0 Installation 3.0 Known problems and workarounds 4.0 Corrections to the publication 5.0 Change History 6.0 Support Web sites 7.0 Notices 7.1 Trademarks and service marks 1.0 OVERVIEW IBM Director Version 4.12 is an upgrade release to IBM Director Version 4.1 and Version 3.1 Service Pack 1. 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 1.1 Publications The following publications are available on the "IBM Director Version 4.1" CD in the docs directory: o "IBM Director 4.1 Installation and Configuration Guide" o "IBM Director 4.1 Systems Management Guide" The following publications are available from the IBM Support Web site (see section 5.0, "Support Web sites"): o "IBM Director 4.1 Upward Integration Modules Installation Guide" o "IBM Director 4.1 Events Reference" These publications are in Portable Document Format (PDF) and require Adobe Acrobat Reader to view them. 2.0 INSTALLATION The installation instructions are provided in the "IBM Director 4.1 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. 2.1 Configuring the UIM inventory component In the "IBM Director 4.1 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, we provide it 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 3.0 KNOWN PROBLEMS AND WORKAROUNDS o The currently available Director Agent Software Distribution package cannot be installed on a clean system without full Administrator rights. Until an updated package is available use the following workaround: o Use the existing Software Distribution directions, but only when upgrading or patching existing 3.1x or 4.1x Director Agent machines to 4.12. o This method will allow the install to complete normally. Because of limitations of the local system account not all old drivers will be properly removed from the Device Manager. If after you upgrade your agent there are undefined devices they can be ignored or deleted. This issue will be resolved in a future release of the software package. 4.0 CORRECTIONS TO THE PUBLICATION Software Distribution The directions provided in the IBM Director 4.1: Upward Integration Modules Installation Guide are still applicable with the following exceptions. You will now be downloading the 4.12 agent packages from the web. IBMDirectorAgentWindows4.12.zip is used for upgrading existing 3.1x or 4.10 agents or for fresh installs of 4.12. Use daswd.sh to create the software distribution package. IBMDirectorAgentWindowsPatch4.12.zip. is used for to upgrade existing 4.11 agents only to 4.12. Use the dapatchswd.sh to create the software distribution package. 5.0 CHANGE HISTORY o IBM Director Agent UIM for Tivoli Enterprise(TM) Framework 4.1x to 4.12 - Added support for Software Distribution of version 4.12 full agent and patch. o IBM Director Agent UIM for Tivoli Enterprise(TM) Framework 4.1 to 4.11 - Added support for Software Distribution of version 4.11 o IBM Director Agent UIM for Tivoli Enterprise(TM) 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 3.7.1 - 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. 6.0 SUPPORT WEB SITES The following Web pages provide resources for understanding, using, and troubleshooting IBM Director and systems-management tools. o IBM Online Assistant and e-Mail http://www.ibm.com/pc/qtechinfo/MIGR-4Z7HJX.html This Web page offers a quick resource to help solve your technical questions. Follow the instructions on this page to find additional solutions for your systems-management tools. If you do not find an acceptable solution, or if you just want to bypass looking for your own solution, you can submit an electronic question. From any page within the IBM Online Assistant, click "None of the above" to submit an electronic inquiry. Response times vary between 24 and 48 hours. o IBM Universal Manageability Discussion Forum http://www7.pc.ibm.com/~ums/ IBM forums put you in contact with other IBM users. The forums are monitored by IBM technicians. 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. o IBM xSeries(TM) 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. Click "IBM Director 4.1" for the latest information and publications. o Systems Management - Quick Reference Guide http://www.ibm.com/pc/qtechinfo/MIGR-4WEP53.html This Web page includes links to software downloads, interim fixes, Microsoft Service Packs, and publications for supported releases of IBM Director. o IBM Universal Manageability page http://www.ibm.com/pc/us/pc/um/index.html This Web page links to an IBM portfolio of advanced management tools that help lower costs and increase availability throughout the life cycle of a product. o IBM ServerProven(R) page http://www.ibm.com/pc/us/compat/index.html This Web page provides information about IBM hardware compatibility with IBM Director 4.1. o IBM Director Agent page http://www.ibm.com/pc/ww/eserver/xseries/systems_management/ nfdir/agent.html This Web page includes the Compatibility Documents for IBM Director 4.1. It lists all the supported operating systems and is updated every 6 to 8 weeks. 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". If you are preparing to install IBM Director and you need to download updates for your server, click "Servers" on the IBM Support Web site. The IBM xSeries, Netfinity, and PC Server support Web page opens. On the left, click "Downloadable files". The Downloadable files by category drop-down list is displayed. Click the category of downloadable files that you need. If you want to use UpdateXpress(TM) to update your server, on the right click "UpdateXpress CD" for the latest release of UpdateXpress. 7.0 NOTICES 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. 7.1 Trademarks and service marks 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 eServer IBM Netfinity NetView ServeRAID ServerProven Tivoli Tivoli Enterprise Tivoli Enterprise Console Tivoli Management Environment UpdateXpress xSeries Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. 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. (C) Copyright IBM Corporation 1999, 2003. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. End