******************************************************************           
| 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://<system>:<port_number> 
    
    where: 
    o  <system> is the TCP/IP address of the managed system or the 
       system name of the managed system, as returned by DNS. 
    o  <port_number> 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 <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.



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.
