File Name: dir4.20.2_readme.txt **************************************************************** | | | IBM(R) Director 4.20.2 | | | | (C) Copyright International Business Machines Corporation | | 1999, 2004. All rights reserved. | | | | US Government Users Restricted Rights -- Use, duplication | | or disclosure restricted by GSA ADP Schedule Contract with | | IBM Corp. | | | | Note: Before using this information and the product it | | supports, read the general information under | | "NOTICES" in this document. | | | | This readme file is provided only in English. You can | | obtain the latest version of the readme file from the IBM | | Support Web site. | | | | Updated 20 September 2004. | **************************************************************** CONTENTS -------- 1.0 About this readme 1.1 Compatibility with previous versions of IBM Director 1.2 Packages included in this update 1.2.1 Packages for Microsoft(R) Windows(R) 1.2.1.1 Packages that provide an update (patch) to a current installation 1.2.1.2 Packages that provide a full installation of IBM Director, version 4.20.2 1.2.2 Packages for Linux(R) 1.3 Notes on MSP files 2.0 Installation 2.1 Installation considerations 2.1.1 Installing the SAN Utility Director Extensions 2.1.2 Installing the IBM Director Server Plus Pack 2.2 Installation on Windows 2.2.1 Installing an IBM Director 4.20.2 patch on Windows 2.2.2 Installing IBM Director, version 4.20.2, on Windows 2.3 Installation on Linux 2.3.1 Installing IBM Director Agent, IBM Director Console, or IBM Director Server, version 4.20.2, on Linux 2.3.2 Installing IBM Director Agent and IBM Director Console patch, version 4.20.2, on Linux 3.0 New functions and support 3.1 General 3.2 IBM xSeries(R) hardware support 3.3 IBM eServer(TM) hardware support 3.4 IBM Director Upward Integration Modules (UIMs) 4.0 Authorized Program Analysis Reports (APARs) resolved by this release 5.0 Known problems and workarounds 6.0 Support Web sites 7.0 Notices 7.1 Trademarks and service marks 1.0 ABOUT THIS README ---------------------- This readme file provides information about IBM Director version 4.20.2. IBM Director 4.20.2 is an upgrade release to the following versions of IBM Director: o IBM Director 3.1 o IBM Director 3.1.1 o IBM Director 4.1 o IBM Director 4.10.2 o IBM Director 4.11 o IBM Director 4.12 IBM Director 4.20.2 is an update release (patch) to IBM Director 4.20. This readme file is provided as an addition to the IBM Director 4.20 readme file (dir4.20_readme.txt). Make sure that you read this file. It is included in this release. In addition to these readme files, the following documentation is available from the IBM Support Web site: o "IBM Director 4.20 Installation and Configuration Guide" o "IBM Director 4.20 Systems Management Guide" For additional information about known problems in IBM Director and their solutions or workarounds, see "Solving IBM Director problems" in either of the preceding documents. The following documents are available from the IBM Support Web site also: o "IBM Director 4.1 Events Reference" o "IBM Director 4.20 Upward Integration Modules Installation Guide" 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. 1.1 Compatibility with previous versions of IBM Director -------------------------------------------------------- When installing this update, consider the following compatibility statements: o IBM Director Server, version 4.20.2, supports connections to IBM Director Console, version 4.20.2 only. o IBM Director Console, version 4.20.2, supports connections to IBM Director Server, version 4.20.2 only. o IBM Director Agent, version 4.20.2, is supported by IBM Director Server, version 4.20.2 only. o IBM Director Server, version 4.20.2, supports the following versions of IBM Director Agent: o IBM Director Agent, version 3.1 o IBM Director Agent, version 3.1.1 o IBM Director Agent, version 4.1 o IBM Director Agent, version 4.10.2 o IBM Director Agent, version 4.11 o IBM Director Agent, version 4.12 o IBM Director Agent, version 4.20 o IBM Director Agent, version 4.20.2 If you upgrade your management server, you must upgrade all of your management consoles. Different versions of IBM Director Console and IBM Director Server do not communicate with one another. 1.2 Packages included in this update ------------------------------------ This update includes packages for IBM Director components running on Microsoft Windows or Linux. Note: For a list of the operating systems supported by IBM Director, see the "IBM Director Hardware and Software Compatibility" document at: http://www.ibm.com/servers/eserver/xseries/ systems_management/sys_migration/ibmdiragent.html 1.2.1 Packages for Microsoft Windows ------------------------------------- IBM Director version 4.20.2 provides the following packages for systems running Windows (32-bit or 64-bit): 1.2.1.1 Packages that provide an update (patch) to a current installation ------------------------------------------------------------- Use these packages to update IBM Director, version 4.20, for Windows (32-bit or 64-bit) to version 4.20.2. o IBM Director Agent for Windows patch Use this package (dir4.20.2_agent_patch_windows.zip) to update IBM Director Agent, version 4.20, for Windows to version 4.20.2. The files in this package are: o IBMDirectorAgentPatch4.20.2.exe o diragentpatch_windows.xml o IBMDirectorAgentPatch4.20.2.msp o IBM Director Agent for Windows (64-bit) patch Use this package (dir4.20.2_agent_patch_windows64.zip) to update IBM Director Agent, version 4.20, for Windows to version 4.20.2. The files in this package are: o IBMDirectorAgentPatch4.20.2.exe o diragentpatch_windows64.xml o IBMDirectorAgentPatch4.20.2.msp o IBM Director Console for Windows patch Use this package (dir4.20.2_console_patch_windows.zip) to update IBM Director Console, version 4.20, for Windows to version 4.20.2. The files in this package are: o IBMDirectorConsolePatch4.20.2.exe o IBMDirectorConsolePatch4.20.2.msp o IBM Director Server for Windows patch Use this package (dir4.20.2_server_patch_windows.zip) to update IBM Director Server, version 4.20, for Windows to version 4.20.2. The files in this package are: o IBMDirectorServerPatch4.20.2.exe o IBMDirectorServerPatch4.20.2.msp 1.2.1.2 Packages that provide a full installation of IBM Director version 4.20.2 --------------------------------------------------------- Use these packages to: o Install IBM Director, version 4.20.2, for Windows (32-bit or 64-bit) o Upgrade an existing IBM Director installation, versions 3.1, 3.1.1, 4.1, 4.10.2, 4.11, 4.12, for Windows (32-bit or 64-bit) to version 4.20.2. Note: You cannot use these packages to update existing IBM Director components, version 4.20. Instead, use the IBM Director for Windows patches (see Section 1.2.1.1 "Packages that provide an update (patch) to a current installation"). o IBM Director Agent for Windows Use this package (dir4.20.2_agent_windows.zip) to: o Install IBM Director Agent, version 4.20.2, for Windows o Upgrade an existing IBM Director Agent, versions 3.1, 3.1.1, 4.1, 4.10.2, 4.11, 4.12, for Windows to version 4.20.2. The files in this package are: o IBMDirectorAgent4.20.2.exe o diragent_windows.xml o diragent.rsp o IBM Director Agent for Windows (64-bit) Use this package (dir4.20.2_agent_windows64.zip) to: o Install IBM Director Agent, version 4.20.2, for Windows (64-bit) o Upgrade an existing IBM Director Agent, versions 3.1, 3.1.1, 4.1, 4.10.2, 4.11, 4.12, for Windows (64-bit) to version 4.20.2. The files in this package are: o IBMDirectorAgent4.20.2.exe o diragent_windows64.xml o diragent_windows64_XX.xml o diragent.rsp where XX indicates one of the following languages for the installation: o de is German o es is Spanish o fr is French o ja is Japanese o ko is Korean o zh_CN is Simplified Chinese o zh_TW is Traditional Chinese Note: The English installation file names do not contain a language indicator. o IBM Director Console for Windows Use this package (dir4.20.2_console_windows.zip) to: o Install IBM Director Console, version 4.20.2, for Windows o Upgrade an existing IBM Director Console, versions 3.1, 3.1.1, 4.1, 4.10.2, 4.11, 4.12, for Windows to version 4.20.2. The files in this package are: o IBMDirectorConsole4.20.2.exe o dircon.rsp o IBM Director Server for Windows Use this package (dir4.20.2_server_windows.zip) to: o Install IBM Director Server, version 4.20.2, for Windows o Upgrade an existing IBM Director Server, versions 3.1, 3.1.1, 4.1, 4.10.2, 4.11, 4.12, for Windows to version 4.20.2. This package includes the IBMDirectorServer4.20.2.exe file. This file does not support unattended or silent installationa. 1.2.2 Packages for Linux ------------------------- The IBM Director version 4.20.2 Update provides the following packages for systems running Linux: o IBM Director Agent for Linux patch Use this package (dir4.20.2_agent_linux.tar.gz) to: o Install IBM Director Agent, version 4.20.2, for Linux o Upgrade an existing IBM Director Agent, version 4.1x or version 4.20, for Linux to version 4.20.2 The files in this package are: o IBMDirectorAgent4.20-2.sh o diragentpatch_linux.xml o diragentpatch_linux_XX.xml o diragent_linux.xml o diragent_linux_XX.xml o dirinstall.alt where XX indicates one of the following languages for the installation: o de is German o es is Spanish o fr is French o ja is Japanese o ko is Korean o zh_CN is Simplified Chinese o zh_TW is Traditional Chinese Note: The English installation file names do not contain a language indicator. o IBM Director Console for Linux patch Use this package (dir4.20.2_console_linux.tar.gz) to: o Install IBM Director Console, version 4.20.2, for Linux o Upgrade an existing IBM Director Console, versions 4.1, 4.10.2, 4.11, 4.12, or 4.20, for Linux to version 4.20.2. The files in this package are: o IBMDirectorConsole4.20-2.sh o dirinstall.alt o IBM Director Agent and IBM Director Console for Linux patch Use this package (dir4.20.2_agentconsoleupgrade_linux.tar.gz) to update IBM Director Agent, version 4.20, for Linux and IBM Director Console, version 4.20, for Linux to version 4.20.2. You must use this package on any system that is installed with both IBM Director Agent and IBM Director Console. The files in this package are: o IBMDirectorAgentConsolePatch4.20-2.sh o dirpatch o IBM Director Server for Linux patch: Use this package (dir4.20.2_server_linux.tar.gz) to: o Install IBM Director Server, version 4.20.2, for Linux o Upgrade an existing IBM Director Server, versions 4.1, 4.10.2, 4.11, 4.12, or 4.20, for Linux to version 4.20.2. The files in this package are: o IBMDirectorServer4.20-2.sh o dirinstall.alt o IBM Director Agent for Linux (64-bit) patch Use this package (dir4.20.2_agent_linux64.tar.gz) to: o Install IBM Director Agent, version 4.20.2, for Linux (64-bit) o Upgrade an existing IBM Director Agent, version 4.20, for Linux (64-bit) to version 4.20.2 The files in this package are: o diragent_linux64.xml o diragent_linux64_XX.xml o diragentpatch_linux64.xml o diragentpatch_linux64_XX.xml o dirinstall.alt o IBMDirectorAgent4.20-2.sh where XX indicates one of the following languages for the installation: o de is German o es is Spanish o fr is French o ja is Japanese o ko is Korean o zh_CN is Simplified Chinese o zh_TW is Traditional Chinese Note: The English installation file names do not contain a language indicator. o IBM Director Agent for Linux (IBM PowerPC(R)) patch Use this package (dir4.20.2_agent_ppclinux.tar.gz) to: o Install IBM Director Agent, version 4.20.2, for Linux (IBM PowerPC) o Upgrade an existing IBM Director Agent, version 4.20, for Linux (IBM PowerPC) to version 4.20.2 The files in this package are: o diragent_plinux.xml o diragent_plinux_XX.xml o diragentpatch_plinux.xml o diragentpatch_plinux_XX.xml o dirinstall.alt o IBMDirectorAgent4.20-2.sh where XX indicates one of the following languages for the installation: o de is German o es is Spanish o fr is French o ja is Japanese o ko is Korean o zh_CN is Simplified Chinese o zh_TW is Traditional Chinese Note: The English installation file names do not contain a language indicator. 1.3 Notes on MSP files ----------------------- The IBM Director version 4.20.2 Update provides MSP files for each patch. The MSP files are provided for customers that prefer to use Microsoft Windows Installer and understand how to use MSP files. 2.0 INSTALLATION ----------------- The packages provided in this update are self-extracting executable files. Select the appropriate packages for your updates and execute the packages to install the update. Note: You can use the provided XML files with Director Update Assistant to install your update packages. For more information about Director Update Assistant, see the "IBM Director 4.20 Systems Management Guide." 2.1 Installation considerations -------------------------------- Before installing IBM Director version 4.20.2, review the following installation considerations. 2.1.1 Installing the SAN Utility Director Extensions ----------------------------------------------------- For installations that include the Qlogic SAN Utility and SAN Utility Director Extensions, you must uninstall the SAN Utility Director Extensions before uninstalling IBM Director Server on a management server or IBM Director Console on a management console. If you do not uninstall the SAN Utility Director Extensions, the reinstallation of IBM Director Server or IBM Director Console will succeed, but IBM Director Server or IBM Director Console will fail to start. Change to the IBM/director directory and run the following script: Uninstall_SANUtility 2.1.2 Installing the IBM Director Server Plus Pack --------------------------------------------------- The IBM Director Server Plus Pack includes the following extensions: o Active PCI(TM) Manager o Capacity Manager o Rack Manager o Software Rejuvenation o System Availability If your current installation includes IBM Director, versions 4.10, 4.10.2, 4.11, 4.12, or 4.20, and any of the Server Plus Pack extensions, the IBM Director 4.20.2 installation retains the extensions that you have installed. You do not uninstall and reinstall these extensions. If your current installation includes IBM Director, versions 3.1 or 3.1.1, you must purchase and install the Server Plus Pack version 4.20 when you install the IBM Director 4.20.2 release. The earlier versions of these extensions that were available with IBM Director, versions 3.1 or 3.1.1, are uninstalled by the IBM Director 4.20.2 release. 2.2 Installation on Windows --------------------------- Note: The MSP files are provided for customers that prefer to use Windows Installer and understand how to use MSP files. 2.2.1 Installing an IBM Director 4.20.2 patch on Windows -------------------------------------------------------- Complete the following steps to install an IBM Director patch on a system running Windows: 1. Select the appropriate package for your update. 2. From a command prompt, type one of the following commands and press Enter. Note: These commands are case-sensitive. ----------------------------------------------------------- For a standard installation: ----------------------------------------------------------- For an unattended installation: /v"/qb" ----------------------------------------------------------- For a silent installation: /S /v"/qn" ----------------------------------------------------------- where is the executable file provided in the patch you selected. 2.2.2 Installing IBM Director, version 4.20.2, on Windows --------------------------------------------------------- Complete the following steps to install IBM Director, version 4.20.2, on a system running Windows: 1. If you do not want to customize the default installation options, go to step 4. Note: Unattended and silent installations are not supported for the IBM Director Server installation. 2. If you want to customize the default installation options, open the diragent.rsp file in an ASCII text editor. 3. Modify and save the diragent.rsp file. This file follows the Windows INI file format and is fully commented. 4. From the command prompt, type one of the following commands and press Enter. Note: These commands are case-sensitive. ----------------------------------------------------------------- For a standard installation: ----------------------------------------------------------------- For an unattended installation: -a UNATTENDED RSP="" ----------------------------------------------------------------- For a silent installation: -s -a SILENT RSP="" ----------------------------------------------------------------- where: o is the executable file provided in the update you selected. o RSP is an optional parameter that you can use to specify a customized response file o is the path and name of the customized response file that you created in step 3. 2.3 Installation on Linux ------------------------- 2.3.1 Installing IBM Director Agent, IBM Director Console, or IBM Director Server, version 4.20.2, on Linux ----------------------------------------------------------- Complete the following steps to install or update IBM Director on a system running Linux: 1. Select the applicable package for your update. 2. If you do not want to customize the default installation options, go to step 5. 3. If you want to customize the default installation options, open the dirinstall.alt file in an ASCII text editor. 4. Modify and save the file. This file is fully commented. 5. From the command prompt, type the following command and press Enter: [-x | -r ] where: o is the executable file provided in the update or patch you selected. o -x is an optional parameter that you can use to extract the executable file contents without installing the patch or update and is the directory destination for the executable-file contents. o -r is an optional parameter that you can use to specify the name of a customized dirinstall file and is the name of the edited dirinstall.alt file. 2.3.2 Installing IBM Director Agent and IBM Director Console patch, version 4.20.2, on Linux ------------------------------------------------------------- Complete the following steps to update a system running Linux and both IBM Director Agent and IBM Director Console: 1. If you do not want to customize the default installation options, go to step 4. 2. If you want to customize the default installation options, open the dirpatch file in an ASCII text editor. 3. Modify and save the file. This file is fully commented. 4. From a command prompt, type the following command and press Enter: [-x | -r ] where: o is the executable file provided in the update or patch you selected. o -x is an optional parameter that you can use to extract the executable file contents without installing the patch or update and is the directory destination for the executable-file contents. o -r is an optional parameter you can use to specify the name of a customized dirpatch file and is the name of the edited dirpatch file. 3.0 NEW FUNCTIONS AND SUPPORT ------------------------------ IBM Director 4.20.2 provides the following new support. 3.1 General ------------ o Support for Windows XP Professional Edition with Service Pack 2 has been added for IBM Director Console and IBM Director Agent. 3.2 IBM xSeries hardware support --------------------------------- o Alert Standard Format (ASF) 2.0 support for the xSeries 226 o Intelligent Platform Management Interface (IPMI) baseboard management controller support for the xSeries 236, 336, and 346 models 3.3 IBM eServer hardware support --------------------------------- o IBM eServer BladeCenter(TM) T 4-Port Gb Ethernet Switch Module o IBM Director Agent now supports the following operating systems on the IBM eServer OpenPower(TM) 720 server and the eServer JS20 blade server only: o SUSE LINUX Enterprise Server 9 (IBM pSeries(R) only) o Red Hat(R) Enterprise Linux AS, version 3.3, for IBM PowerPC(R) (IBM pSeries only) o IBM Director Agent now supports the Java(TM) Runtime Environment (JRE) SR7p on the IBM eServer OpenPower 720 server and the eServer JS20 blade server only. 3.4 IBM Director Upward Integration Modules (UIMs) --------------------------------------------------- The following IBM Director UIMs are required to provide support for IBM Director Agent 4.20.2, or later: o IBM Director UIM for IBM Tivoli(R) NetView(R), version 4.20.2, for Windows and Linux o IBM Director UIM for HP OpenView, version 4.20.2 4.0 APARS RESOLVED BY THIS RELEASE ----------------------------------- IBM Director 4.20.2 resolves the following APARs: o IC41024: Managed systems have periodic Dr. Watson errors. o IC42073: In IBM Director Console, if you select a managed system and right-mouse click "Power Management --> Shutdown and Power off - Execute Now", the shutdown and power off fails if the managed system is locked (Ctrl+Alt+Del; then, click "Lock Computer"). o IC42074: The VPD.EXE program fails to retrieve the system machine type from the SMBus driver. 5.0 KNOWN PROBLEMS AND WORKAROUNDS ----------------------------------- IBM Director 4.20.2 has the following known problems and workarounds: o (SUSE LINUX Enterprise Server 9 only) For Remote Session tasks to work you must turn on password authentication. Complete the following steps: 1. Edit the /etc/ssh/sshd_config file. 2. Locate the line that includes the keyword PasswordAuthentication. 3. If the line is commented out, uncomment the line and set the value to "yes". For example: PasswordAuthentication yes o (SUSE LINUX Enterprise Server 8 only) You cannot cut and paste information into the ASF Configuration window. o The xSeries 336 does not support ASM interconnect. If you use the Management Processor Assistant task to configure the ASM interconnect settings, the settings will not take effect. o (Windows XP Professional Edition with Service Pack 2 only) You must enable the following ports for IBM Director to function properly: --------------+------------------------------+------------------ Category | Connection | Destination port --------------+------------------------------+------------------ IBM Director | IBM Director Server | 14247 UDP interprocess | <-> IBM Director Agent | 14247 TCP communication |------------------------------+------------------ | Web-based Access | 411 TCP | | 423 TCP --------------+------------------------------+------------------ SNMP | IBM Director Server | 161 TCP | <-> SNMP agent | 161 UDP |------------------------------+------------------ | SNMP agent <-> IBM Director | 162 TCP | Server | 162 UDP --------------+------------------------------+------------------ For more information about IBM Director ports, see the "IBM Director 4.20 Installation and Configuration Guide." o (Linux only) When running the Process Management task or any action that uses Linux operating-system commands, you might receive the following error message: error while loading shared libraries: libc.so.6: cannot open shared object file: No such file or directory This error is caused by Java setting the environment variable LD_ASSUME_KERNEL for its context which is incompatible with commands launched from the Java environment. To correct this problem, set the LD_ASSUME_KERNEL variable to an empty value as part of the action. For example, when running the ps command as a Process Management action, instead of issuing the command: ps -ef Use: LD_ASSUME_KERNEL=;ps -ef Note: This problem affects at least the following commands: o ps o top o pgrep o pstree 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.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(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, 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 ------------ 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: Active PCI BladeCenter eServer IBM IBM Virtualization Engine IntelliStation NetView OpenPower PowerPC pSeries ServerProven Tivoli 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 and Windows 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. Other company, product, or service names may be trademarks or service marks of others. (C) Copyright IBM Corporation 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. End