File Name: readme.1st IBM Director Agent Plus Module for Tivoli Enterprise Framework version 3.1 readme.1st Version 3.1 CONTENTS --------- 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Web Sites 5.0 Trademarks and Notices 6.0 Disclaimer 1.0 Overview: 1.1 Overview of the Director Agent Plus Module The IBM Director Agent Plus Module for Tivoli Enterprise Framework allows customers to access the data, events, and interface of the Director Agent product from a Tivoli managed node. In addition, tasks are provided that give the user access to the WakeOnLan, reboot, and shutdown features of Director Agent, as well as a task for building a file package for deploying Director Agent. 1.2 Limitations - Windows2000 Servers running Terminal Services may be severely limited in functionality. This is not a supported configuration. (Tivoli Limitation) - Software Distribution 4.0 is not currently supported by PLUS modules. - Preparing the File Package on Solaris will result in the following error: ################################################################### Task Name: Prepare_for_UM_Services_install Task Endpoint: XXXXX@XXXXX-region (ManagedNode) ------Standard Output------ Source_Host_: XXXXX Source_Path_: /win32/install/en Destination_Path_: c: emp Successfully configured FilePackage 'Install UM Services' ------Standard Error Output------ Unable to locate nested file package! ################################################################### It will however successfully create the package and can be ignored. - The Plus Module Uninstall feature has two limitations. The first is that the uninstall will report some errors in its output. These should be ignored as they are a result of supporting both the Windows and Unix platform. The second limitation is that the Uninstall does NOT remove anything that is added to the TEC by the Setup TEC for Director Agent task. You can manually remove these items if you wish. - Tivoli Distributed Monitors are only supported on Windows NT endpoints, not Windows 95 nor Windows 98 endpoints. Hence the Monitors provided in the Plus Module for Director Agent work only against Windows NT clients - Tivoli Distributed Monitoring 3.6.2 is required for DM to work on Windows2000 endpoints - Native TEC Events are not supported if your Endpoint/TEC gateway is a WindowsNT machine with Service Pack 6 or 6a (Tivoli Limitation) - Due to a limitation in the way Tivoli classifies events. All informational events from Director Servers will be classified as test traps. 1.3 Level of Recommendations and Prerequisites for the Update: - IBM strongly recommends using the following patches with Tivoli Enterprise Framework 3.6: 3.6-TMF-0033, 3.6-TMF-0038 Fixes a problem with oserv.exe crashing during Plus Module install 3.6-TMF-0034 Fixes some problems with the endpoint - IBM strongly recommends using the following patches with Tivoli Enterprise Framework 3.6.1: 3.6.1-TMF-0031, 3.6.1-TMF-0051 Causes the correct icon to be displayed for 'Subscribers of Director Agent' dataless profile manager Also required for DB2 RIM Host 3.6.1-COU-0018 Allows correct status of software distribution and install of Director Agent file package to be returned from Win9x endpoints. 3.6.1-DM-0008, 3.6.1-DM-0013 Fixes the following problem some systems experience when installing the Director Agent Plus Module: Something went wrong: Media Packet: "C:/roadrunner/umsplus/FILE3.PKT" barryps2:FAILED (soft error) Failure: the last few lines of the error log (D:\Tivoli\db\barryps2.db\tmp/UM_Services_ALIDB_after.error): ++log_echo >>> Creating monitor SNMPCheck ++echo >>> Creating monitor SNMPCheck ++IsValidMonitorCollection IBM_Corp__Monitors_for_UM_ Services__V1_0 ++IsValidProfileMonitoringCapabilityCollection_IBM_Corp_ _Monitors_for_UM_Services__V1_0 ++return 1 ++log_failure IBM_Corp__Monitors_for_UM_Services__V1_0 does not exist ++log_echo --- IBM_Corp__Monitors_for_UM_Services__V1_0 does not exist ++echo --- IBM_Corp__Monitors_for_UM_Services__V1_0 does not exist ++return 1 ++exit 1 completed with errors. - IBM strongly recommends using the following patches with Tivoli Enterprise Framework 3.6.2: 3.6.2-INV-004 3.6.2-INV-005 3.6.2-INV-022 Fixes for custom mif file inventory problems. And the supporting patches. - IBM strongly recommends using the following patches with Tivoli Enterprise Framework 3.7.1: 3.7.1-TMF-0021 3.7.1-TMF-0026 For Windows XP support and other fixes. 3.7-DMN-0002 e-fix This patch fixes Custom distributed monitors. This patch is not official release software at this date. Please read the prerelease agreement enclosed with this patch. If you wish to use the DM features of this PLUS Module and do not want to use this patch you must use DM 3.6.2 1.4 Dependencies: - Director Agent version 2.1, 2.11, 2.12, 2.2, 2.21, or 3.1 on endpoints - Director Agent version 2.2, 2.21, or 3.1 to revieve native TEC Events - Netscape Navigator 4.5 and above or Microsoft Internet Explorer 4.01 and above for Director Agent launch support from the Plus Module - Java 1.1.7 and above for wakeup task 2.0 Change History -------------------- 2.1 IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.3 to 3.1 - Support for Framework 3.7.1, Inventory 4.0, DM 3.7, TEC 4.0 - Support for Windows XP 2.2 IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.2 to 1.3 - UMStecad_snmp.baroc, .cds, and .oid now contain necessary changes for ServeRAID SNMP traps - Install dialog has changed to remove unnecessary options - Uninstall option now works - Native TEC Events 2.3 IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.11 to 1.2 - Director Agent remote install now reports correct install status to Software Distribution on Win9x endpoints - UMStecad_snmp.baroc now correctly labels Netfinity Director traps in TEC console - Reboot option for Director Agent file package to Win9x endpoints now works correctly 2.4 IBM Director Agent Plus Module for Tivoli Enterprise Framework 1.10 to 1.11 - Inventory to Oracle database now works correctly - Support for receiving TEC events from Netfinity Director SNMP traps - Added Geographic Information to inventory - Added System Slots, DMI, AlertOnLan Settings to inventory - Added AssetID, BIOS Details, SNMP Agent Configuration to inventory 3.0 Installation and Setup Instructions ----------------------------------------- 3.1 Please refer to the Director Agent Plus Module User Guide, UM_Services_Plus.pdf, for detailed install instructions. 4.0 WEB Sites --------------- 4.1 IBM Support Web Site: http://www.pc.ibm.com/support 4.2 IBM Marketing Netfinity Web Site: http://www.pc.ibm.com/netfinity 4.3 IBM PSG Discussion Forum: http://www7.pc.ibm.com/~UMS/login 5.0 Trademarks and Notices ---------------------------- 5.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM, Universal Manageability Services, Wake On Lan, and Netfinity Director. 5.2 Tivoli and Tivoli Enterprise Framework are trademarks of Tivoli Corporation. Java is a trademark of Sun Microsystems, Inc. Netscape and Netscape Navigator are trademarks of Netscape. Microsoft, Windows, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. 5.3 Other company, product, and service names may be trademarks or service marks of others. 6.0 Disclaimer ---------------------------- 6.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 6.2 Note to Government Users Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.