******************************************************************           
| 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 <command> [-optional parameters]

where <command> 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 <component>, where <component> is a valid component name.          
      Specifies the component against which RTD will perform the 
      command.
        
   o  -a <action>, where <action> 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.

