****************************************************************** | IBM(R) xSeries(TM) Real Time Diagnostics, Version 2.11 | | Build ID:DIGT73A | | | | (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. | | | | Updated 17 June 2004. | ****************************************************************** 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.11 2.2 Real Time Diagnostics, Version 2.10 2.3 Real Time Diagnostics, Version 2.01 2.4 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 Starting Real Time Diagnostics 4.1 Starting Real Time Diagnostics on a Windows system 4.2 Using Web-based Access to start RTD on a managed system (Windows only) 4.3 Starting Real Time Diagnostics on a Linux system 5.0 Using the RTD command line interface (CLI) 6.0 Known issues, limitations, and workarounds 6.1 Real Time Diagnostics product information 6.2 IBM Director group 6.3 RTD system is not displayed 6.4 CD or DVD tests fail 6.5 SCSI disk drive tests fail for BladeCenter (HS20) IDE RAID 6.6 Unable to access RTD after twgreset 6.7 CPU tests 6.9 Scalability and RXE Ports test 6.10 System-management hardware actions 6.11 Read/Write Self test on tape drive 6.12 Parallel Port test 6.13 USB CD Rom tests 6.14 Unable to access RTD 6.15 Unable to access Help 7.0 Web sites and support 8.0 Notices 1.0 OVERVIEW ------------- This package is for systems that do not have IBM Director installed. Real Time Diagnostics can help you diagnose certain devices on xSeries servers at the same time the operating system is running. Using these diagnostic actions can prevent and minimize server downtime. 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 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 1.1 Operating-system support ----------------------------- Real Time Diagnostics is supported on the following operating systems: o Microsoft(R) Windows(R) 2000 Server o Microsoft Windows 2000 Advanced Server o Microsoft Windows 2000 Datacenter o Microsoft Windows 2000 Professional 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 RedHat Advanced Server 2.1 o RedHat Linux 7.3 1.2 Server support ------------------- Real Time Diagnostics is supported on the following xSeries servers and systems: x150 (8658) x300 (8672) BladeCenter(HS20) (8678) x200 (8478) x305 (8673) x445 (8870) x200 (8479) x330 (8654) x205 (8480) x330 (8674) x220 (8645) x330 (8675) x220 (8646) x335 (8676) x225 (8647) x340 (8656) x230 (8658) x342 (8669) x232 (8668) x345 (8670) x235 (8671) x350 (8682) x240 (8664) x360 (8686) x250 (8665) x370 (8681) x250 (8666) x440 (8687) x255 (8685) RXE-100 (8684) x260 (8665) BladeCenter(TM) unit (8677) 1.3 Prerequisites ------------------ Do not install this software on a server that has IBM Director installed. If you have IBM Director installed, use Real Time Diagnostics for IBM Director. Before you install Real Time Diagnostics, make sure that the appropriate service processor device-drivers are installed for the hardware configuration in your system. 2.0 CHANGE HISTORY ------------------- This section provides information about the updates and features that were added to earlier versions of Real Time Diagnostics. 2.1 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). 2.2 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. 2.3 Real Time Diagnostics 2.01 ------------------------------- Real Time Diagnostics, Version 2.01 includes the following changes: o Added support for additional server models. 2.4 Real Time Diagnostics 2.00 ------------------------------- Real Time Diagnostics, Version 2.00 includes the following changes: o Initial release. 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 --------------------------------------------------------- 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/ 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: 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. ./rtdinstall 4.0 STARTING REAL TIME DIAGNOSTICS ----------------------------------- The following section provides information about how to start the RTD graphical user interface (GUI) from Windows and Linux. 4.1 Starting Real Time Diagnostics on a Windows system ------------------------------------------------------- To start the RTD GUI from Windows click Start --> Programs --> Real Time Diagnostics. 4.2 Using Web-based Access to start RTD on a managed system (Windows only) ------------------------------------------------------------ If you installed Web-based Access when you installed IBM Director Agent, you can access the managed system by using the following Web browsers: o Microsoft Internet Explorer, version 4.1 or later o Netscape Navigator, version 4.x or 7.01 Complete the following steps to start Web-based Access on a local or remote system using a Web browser: 1. Open a web browser. 2. Type the following address in the Web browser address field: http://: where: o is the TCP/IP address of the managed system or the system name of the managed system, as returned by DNS. o is the port number that is assigned for use by Web-based Access during IBM Director Agent installation. Port number 411 is the default for initial access, and port number 423 is the default for secure access (https://localhost:423/index.html). If you used different values during configuration, you must use those values instead. 3. Log on to the system using the applicable username and password. When Web-based Access has connected to a managed system, the Web-based Access program opens in your Web browser. 4. In the left pane click the Tasks tab. The tasks page is displayed. 4.3 Starting Real Time Diagnostics 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. 5.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. 6.0 KNOWN ISSUES, LIMITATIONS, AND WORKAROUNDS ----------------------------------------------- This section provides information about known issues, limitations, and workarounds. 6.1 Real Time Diagnostics product information ---------------------------------------------- The RTD product name and version number are not displayed in the IBM Director help panel. To view the RTD product name and version number, open the Task Extension window. 6.2 IBM Director group ----------------------- When you maximize a group icon, the contents of the group might not be displayed. To display the contents of a group, maximize the "Systems with IBM Director" group. Then, drag the system with Real Time Diagnostics installed onto the Real Time Diagnostics Task Extension. 6.3 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. 6.4 CD or DVD tests fail ------------------------- CD or DVD tests might fail for Linear, Rand, and Funnel Seeks. 6.5 SCSI disk drive tests fail for BladeCenter (HS20) IDE RAID --------------------------------------------------------------- RTD does not support local IDE hard disk drives that are configured using RAID utilities. IDE RAID disk drives that are installed in BladeCenter (HS20) servers are displayed in the operating system and RTD as SCSI hard disks. SCSI disk drive tests are not valid with these hardware configurations. 6.7 Unable to access RTD after twgreset ---------------------------------------- To access RTD after you run the twgreset command, reinstall RTD. 6.8 CPU tests -------------- If a CPU test does not complete, restart Director Server or Agent, as applicable, on the system on which you are running RTD. 6.9 Scalability and RXE Ports test ----------------------------------- The Scalability and RXE Ports test is not supported on IBM eServer xSeries 365, machine type 8861 or 8862, with RedHat Advanced Server 2.1. 6.10 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. 6.11 Read/Write Self test on tape drive ---------------------------------------- The Read/Write Self test fails is unsupported on systems that have a tape drive that is connected to a RAID adapter. 6.12 Parallel Port test ------------------------ The Parallel Port test is unsupported on IBM eServer xSeries 225, machine type 8649, with a Remote Supervisor Adapter II installed. 6.13 USB CD Rom tests on -------------------------- If a USB CD Rom test fails to complete when run against an IBM eServer xSeries 230, machine type 8658, restart RTD and rerun the test. 6.14 Unable to access RTD --------------------------- RTD is unsupported on IBM eServer xSeries 200 servers, machine type 8479, if a RAID adapters installed. RTD might not start on these systems. Remove the RAID adapter and restart RTD. 6.15 Unable to access Help -------------------------- You might be unable to access the RTD Help system. To access RTD help, navigate to the help directory on your applicable system: o (Linux) IBM Director Console and IBM Director Server: /opt/IBM/director/classes/doc/ibm/sysmgt/diags/ o (Linux) IBM Director Agent: /opt/IBM/director/httpserv/help/en/diags/ o (Windows) IBM Director Console and IBM Director Server: C:\Program Files\IBM\Director\classes\doc\ibm\sysmgt\diags o (Windows) IBM Director Agent: C:\Program Files\IBM\Director\httpserv\help\en\diags 7.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 8.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. 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 ServeRAID 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.