****************************************************************** | IBM(R) xSeries(TM) Real Time Diagnostics, Version 2.20 | | Build ID:DIGT85A | | | | (C) Copyright International Business Machines Corporation | | 1999, 2005 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. | | | | Updated 23 March 2005. | ****************************************************************** CONTENTS -------- 1.0 Overview 1.1 Operating-system support 1.2 Server support 1.3 Prerequisites 2.0 Change history 2.1 Real Time Diagnostics, Version 2.20 2.2 Real Time Diagnostics, Version 2.11 2.3 Real Time Diagnostics, Version 2.10 2.4 Real Time Diagnostics, Version 2.01 2.5 Real Time Diagnostics, Version 2.00 3.0 Installing Real Time Diagnostics 3.1 Installing Real Time Diagnostics on a Windows system 3.2 Installing Real Time Diagnostics on a Linux(R) system 4.0 Uninstalling Real Time Diagnostics 4.1 Uninstalling Real Time Diagnostics from a Windows system 4.2 Uninstalling Real Time Diagnostics from a Linux system 5.0 Starting Real Time Diagnostics 5.1 Starting RTD on a Windows system 5.2 Starting RTD on a Linux system 6.0 Using the RTD command line interface (CLI) 7.0 Known issues, limitations, and workarounds 7.1 ServeRAID not supported on Linux 7.2 RTD system is not displayed 7.3 Unable to access RTD after twgreset 7.4 RTD does not complete loading when it is started using IBM Director Console 7.5 System-management hardware actions 7.6 Read/Write Self test on tape drive 7.7 Desktop icon not created 7.8 Second tape test does not run 8.0 Web sites and support 9.0 Notices 1.0 OVERVIEW ------------- This package is for systems that do not have IBM Director already installed. Real Time Diagnostics can help you to diagnose certain devices on xSeries servers with IBM Director installed. This software can be used while the operating system is running. You can perform actions for the following devices: o BladeCenter diagnostics o CD-ROM drive o Diskette drive o Light path diagnostics o ServeRAID controller o Intel Ethernet device o Broadcom Ethernet device o Microprocessor o Parallel port o QLogic Fibre Channel device o Scalability and RXE Ports o SCSI or IDE disk drive o SCSI tape drive o Serial port o System-management hardware o System memory information o USB host controller o USB CD-ROM Real Time Diagnostics includes a help system that you can access from the application. 1.1 Operating-system support ----------------------------- Real Time Diagnostics is supported on the following operating systems: o Microsoft(R) Windows(R) 2000 Server with Service Pack 3 o Microsoft Windows 2000 Advanced Server with Service Pack 3 o Microsoft Windows 2000 Datacenter with Service Pack 3 o Microsoft Windows 2000 Professional with Service Pack 3 o Microsoft Windows 2003 Standard Edition o Microsoft Windows 2003 Enterprise Edition o Microsoft Windows 2003 Datacenter Edition o Microsoft Windows 2003 Web Edition o Micorsoft Window XP Professional with service pack 1 o RedHat Advanced Server 2.1 o RedHat Linux Enterprrise Linux AS 3.0 with update 3 o RedHat Linux Enterprrise Linux ES 3.0 with update 3 o RedHat Linux Enterprrise Linux WS 3.0 with update 3 Note: The 32-bit versions of these operation systems are supported. The 64-bit versions are not supported. 1.2 Server support ------------------- Real Time Diagnostics is supported on the following eServer xSeries servers and systems: x150 (8658) x200 (8478) x200 (8479) x205 (8480) x206 (8482) x220 (8645) x220 (8646) x225 (8647) x226 (8648) x232 (8668) x235 (8671) x236 (8841) x255 (8685) x260 (8665) x300 (8672) x305 (8673) x306 (8836) x330 (8654) x330 (8674) x330 (8675) x335 (8676) x336 (8837) x342 (8669) x345 (8670) x346 (8840) x360 (8686) x365 (8861) x440 (8687) x445 (8870) RXE-100 (8684) BladeCenter(TM) unit (8677) (8720) HS20 (8678) (8832) (8843) HS40 (8839) JS20-GA2 (8842) Note: For the HS40 and JS20-GA2, the Real Time Diagnostics product only provides support for BladeCenter diagnostics. 1.3 Prerequisites ------------------ o The system management device drivers for your server must be installed. The device drivers that you need depend on the service processors that are installed on your server. Go to http://www.ibm.com/us/. Click Support & Download --> Downloads & drivers. 2.0 CHANGE HISTORY ------------------- This section provides information about the updates and features that were added to previous versions of Real Time Diagnostics. 2.1 Real Time Diagnostics 2.20 ------------------------------- Real Time Diagnostics, Version 2.20 includes the following changes: o Added support for the base management controller (BMC) which supports the Intelligent Platform Management Interface (IPMI). The following servers now support BMC: x236 (8841) x336 (8837) x346 (8837) HS20 (8678) (8832) (8843) HS40 (8839) o Added support for additional server models. o Added support for Red Hat Enterprise Linux 3.0 2.2 Real Time Diagnostics 2.11 ------------------------------- Real Time Diagnostics, Version 2.11 includes the following changes: o Added support for additional server models. o Added support for additional devices. o Added the Restart I/O Module Extended Diagnostics task. o Added support for the RTD command line interface (CLI). o Added QLogic Fibre Channel device actions (Linux only). o Updated the installation process to automatically stop and start SNMP as needed. 2.3 Real Time Diagnostics 2.10 ------------------------------- Real Time Diagnostics, Version 2.10 includes the following changes: o Added support for additional server models. o Added support for additional devices. o Added support for Linux. 2.4 Real Time Diagnostics 2.01 ------------------------------- Real Time Diagnostics, Version 2.01 includes the following changes: o Added support for additional server models. 2.5 Real Time Diagnostics 2.00 ------------------------------- Real Time Diagnostics, Version 2.00 includes the following changes: o Added BladeCenter Unit Diagnostics installing and running on a system with a Linux operating system o Added Default event action plans for BladeCenter Unit Diagnostics o Added RXE and Scalability ports test for IBM xSeries 360 and xSeries 440 3.0 INSTALLING REAL TIME DIAGNOSTICS ------------------------------------- Before you install Real Time Diagnostics, make sure that the appropriate service processor device-drivers are installed for the hardware configuration in your system. You can download the appropriate Real Time Diagnostics installation files from the IBM Support Web Site: http://www.ibm.com/pc/support/ 3.1 Installing Real Time Diagnostics on a Windows system --------------------------------------------------------- Complete the following steps to install Real Time Diagnostics on a Windows system without IBM Director installed: 1. Download the .zip file. 2. Extract the .zip file to your directory. 3. Run the setup.exe file. The InstallShield Wizard window opens. 4. Click Next. Review and accept the License Agreement. 5. Click Next. Click Change if you want to change the directory where Real Time Diagnostics is installed. 6. Click Next. 7. Click Install. 8. Click Finish. 3.2 Installing Real Time Diagnostics on a Linux system ------------------------------------------------------- Complete the following steps to install Real Time Diagnostics on a Linux system without IBM Director installed: 1. Download the .tgz file to a temporary directory. 2. To extract the file, type the following command: tar -zxvf <.tgz Filename> The contents are extracted to the current directory. 3. Type "./rtdinstall" and press Enter. 4.0 UNINSTALLING REAL TIME DIAGNOSTICS --------------------------------------- This section contains information about uninstalling Real Time Diagnostics. 4.1 Uninstalling Real Time Diagnostics from a Windows system ------------------------------------------------------------- Complete the following steps to uninstall Real Time Diagnostics from a Windows system: 1. Navigate to the Windows Control Panel. 2. Double-click Add/Remove Programs. The "Add/Remove" window opens. 3. Click Real Time Diagnostics. 4. Click Change/Remove. The uninstall window opens. 5. Click Next and follow the on-screen instructions. 6. Once returned to "Add/Remove Programs" window, Click Real Time Diagnostics. 7. Click Remove. The confirmation window opens. 8. Click Yes and follow the on-screen instructions. 9. Restart the system to complete the uninstallation process. 4.2 Uninstalling Real Time Diagnostics from a Linux system ----------------------------------------------------------- Complete the following steps to uninstall Real Time Diagnostics from a Linux system: 1. From a terminal window, change to the directory where Real Time Diagnostics is installed. 2. To remove PC Doctor, type the following command: rpm -e PCDRPegasusCIMProvider-050406-1 3. To remove Real Time Diagnostics, type the following command: rpm -e RealTimeDiagnostics-agent-2.20-1 4. To remove Management Processor Assistant, type the following command: rpm -e MPAAgent-4.21-1 5. To remove Director Agent installed with RTD, type the following commands: rpm -e DirAgent-4.21-1 rpm -e ITDAgent-4.21-1 6. Restart the system to complete the uninstallation process. 5.0 STARTING REAL TIME DIAGNOSTICS ----------------------------------- The following section provides information about how to start the RTD graphical user interface (GUI) from Windows and Linux. 5.1 Starting RTD on a Windows system ------------------------------------- To start the RTD GUI from Windows click Start --> Programs --> Real Time Diagnostics. 5.2 Starting RTD on a Linux system ----------------------------------- Complete the following steps to start the RTD GUI from Linux: 1. From a command prompt, navigate to the following directory: /opt/IBM/director/classes 2. Type "./rtd.sh" and press Enter. 6.0 USING THE RTD COMMAND LINE INTERFACE (CLI) ----------------------------------------------- The RTD command line interface is supported only on Linux systems. You can use the RTD CLI to run IBM Real Time Diagnostics tasks from a command line. You can use the CLI locally on the server or remotely through a Linux console. The RTD CLI executable file is rtdcli. If you installed RTD in the default location, the CLI executable file is located in the following directory: /opt/IBM/director/CIMOM/bin directory The command-line syntax in this document uses the following conventions: o Commands are shown in lowercase letters. o Variables are shown in angle brackets italics and explained immediately afterward. o Optional commands are enclosed in brackets. o When you must type one of two or more alternative parameters, the parameters are separated by vertical bars. The rtdcli command uses the following syntax: ./rtdcli [-optional parameters] where is a valid rtdcli command. The following commands are supported: o help Displays the available commands and optional parameters for the rtdcli command. o actions Displays the Common Diagnostics Model (CDM) actions that are currently installed. o components Displays the installed components and applicable CDM actions that can be run against these components. o run Runs the CDM actions that you specify. When used without any optional parameters, RTD will execute all of the applicable non-destructive CDM actions for all installed components in sequence. The following optional parameters can be used with the run command: o -x Runs the destructive actions in addition to the non- destructive actions. Note: Destructive actions potentially modify existing data. For example, a floppy drive write test could potentially overwrite the existing data. o -c , where is a valid component name. Specifies the component against which RTD will perform the command. o -a , where is a valid action that can be run. Specifies an action to be run by the command. Note: If an action name or the path to a component includes spaces, enclose the action name in quotes. For example, rtdcli run -c "/dev/my share/sdb1" Complete the following steps to run an RTD task from a command line interface: 1. Change to the /opt/IBM/director/CIMOM/bin directory. 2. Enter the applicable rtdcli command and press enter. The results of the command are displayed. 7.0 KNOWN ISSUES, LIMITATIONS, AND WORKAROUNDS ----------------------------------------------- This section provides information about known issues, limitations, and workarounds. 7.1 IBM Director ServeRAID Manager not compatible with RTD on Linux -------------------------------------------------------------------- The Real Time Diagnostics feature is not supported on Linux platforms on which support for the IBM Director ServeRAID Manager feature has been installed. ServeRAID Manager support is an optional feature of IBM Director and is not installed by default. 7.2 RTD system is not displayed -------------------------------- Some systems might not be displayed in the "Systems with Diagnostics" group. To ensure that all systems are displayed, perform an inventory collection on all systems. By default, IBM Director performs a mandatory inventory collection during system discovery and repeats the collection every seven days. When you make changes, such as creating a system or adding diagnostics to an existing managed object, IBM Director does not perform inventory collection. 7.3 Unable to access RTD after twgreset command ------------------------------------------------ To access RTD after you run the twgreset command, uninstall and then reinstall RTD. 7.4 RTD does not complete loading when it is started using IBM Director Console ----------------------------------------------------------- When you use IBM Director Console to start RTD, RTD remains in the loading state. If this occurs, restart Director Server or Agent, as applicable, on the system on which you are running RTD. 7.5 System-management hardware actions ---------------------------------------- (Linux only) RTD might list an inaccurate number of processors when you run System-management hardware actions against a system that contains processors with hyper-threading support. 7.6 Read/Write Self test on tape drive ---------------------------------------- The Read/Write Self test is not supported on systems that have a tape drive that is connected to a RAID adapter. 7.7 Desktop icon not created ------------------------------------------- Use the following procedure to create a desktop icon if you receive an error message that the desktop icon was not created: 1. Open the Program Files/IBM/Director/Classes folder. 3. Right click the rtd.exe file. 4. Click Create Shortcut. A file named "Shortcut to rtd.exe" is created in the same folder. 5. Drag this file to either the desktop or the start menu Note: Remember to remove the shortcut when you uninstall RTD. 7.8 Second tape test does not run ------------------------------------------- If a tape test runs more than 3 minutes, a subsequent tape test fails. The workaround is to restart the server. 8.0 WEB SITES AND SUPPORT -------------------------- Use the following Web sites to get support for Real Time Diagnostics: o IBM Support Web Site: http://www.ibm.com/pc/support/ o IBM Marketing eServer(TM) xSeries Web site: http://www.ibm.com/eserver/xseries o If you have any questions about this update, or problems applying the update, see the following HelpCenter(R) World Telephone Numbers Web page: http://www.ibm.com/pc/qtechinfo/YAST-3P2QYL.html 9.0 NOTICES ------------ This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of a ny non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send l icense inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. 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 states 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: o BladeCenter o e-business logo o eServer o HelpCenter o IBM o Predictive Failure Analysis o go o xSeries Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel is a trademark of Intel 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. UNIX is a registered trademark of The Open Group in the United States and other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.