File Name: dir4.21_uim_netview.txt **************************************************************** ** ** ** IBM(R) Director Version 4.21 ** ** Upward Integration Module (UIM) for ** ** IBM Tivoli(R) NetView(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 24 January 2005. | ================================================================ CONTENTS 1.0 About this readme file 2.0 Documentation 3.0 Installation 4.0 Known problems and workarounds 5.0 Corrections to the documentation 6.0 Support Web sites 7.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 NetView to access the following functions from Tivoli NetView Console: o Event notification o Inventory collection o Web browser launch 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 6.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." 4.0 KNOWN PROBLEMS AND WORKAROUNDS ----------------------------------- See the "IBM Director 4.20 Upward Integration Modules Installation Guide" for any additional limitations. o The IBM Director UIM for Tivoli Netview version 4.21 is required for support of IBM Director Agent version 4.21 or later. o (Managed systems running Microsoft(R) Windows(R) only) IBM Tivoli NetView might not display system health correctly for managed systems running IBM Director Agent 3.1. To correct this problem, obtain and install the ic33063 efix from the following Web site: http://www-1.ibm.com/support/docview.wss?uid=psg1MIGR-55279 o Creating a certificate Before you can save IBM Director inventory data to the SQL Server database that is used by NetView, you must create a certificate. The UIM uses the certificate to authenticate communication. To create a certificate in NetView, complete the following steps: 1. From the NetView menu bar, click "Tools" -> "Director Agent" -> "Create Certificate." The Client Authentication window opens. 2. In the "Username" field, type a valid username. 3. In the "Password" field, type the password. 4. In the "Re-Type Password" field, retype the password. 5. Click "OK". After the certificate is created, you can save the IBM Director inventory to the database. o SSL Incompatibility With IBM Director Agent versions 3.1 and 4.1 In IBM Director 4.21, security has been improved in NetView UIM through the use of SSL technology, which is supported by IBM Director Agent version 4.2 or later. SSL technology has been implemented in the UIM design for retrieving inventory from systems that are running IBM Director Agent. When the Tivoli NetView server tries to retrieve IBM Director Agent inventory, the server checks for a certificate on the managed system. o If a certificate is present, the inventory function is performed. o If a certificate is not present, you are prompted for a username and password. If username and password are valid, a certificate is created on the managed system and the inventory function is performed. Once a certificate is created, you are not prompted for the username and password again. SSL technology is not supported on IBM Director Agent versions 3.1 and 4.1. On these versions, the UIM cannot create a certificate, so it will prompt for a username and password every time the user retrieves inventory. If you use these versions of IBM Director Agent and want to avoid this issue, do not implement IBM Director 4.21. 5.0 CORRECTIONS TO THE DOCUMENTATION ------------------------------------- None. 6.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(R) page http://www.ibm.com/pc/us/compat/index.html The ServerProven 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). 7.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.