HP Insight Diagnostics

Insight Diagnostics represents an enhancement to currently available service tools such as 
Inspect and the Survey Utility. Inspect has long been used as an offline utility to capture 
detailed hardware configuration information such as types of hardware devices. The 
Survey Utility was the traditional online utility used to gather software and critical error 
log information.  

Insight Diagnostics replaces this capability by capturing software information in addition 
to the hardware elements, allowing access to and management of the Integrated 
Management Log, and the ability to manage and compare various Survey sessions.  
Insight Diagnostics delivers this critical data, and addresses customer requirements for 
enhanced service tools and higher server availability through its comprehensive feature 
design:

* Online installation and operation - No requirement to take the server offline or 
reboot the server in order to use Insight Diagnostics.

* Comprehensive configuration capture under a single tool - Gathers detailed 
hardware and operating system configuration information under a single tool.

* Automatic configuration audit trail - Automatically maintains a configuration 
history for the server. By storing multiple configuration snapshots and highlighting 
changes and differences, the utility can provide a detailed record of the server history.

* Integrated Management Log Viewer - Allows you to view and manage the 
Integrated Management Log (IML) system event entries on a local or remote system. 
This non-volatile log records system events and errors for post diagnosis review thus 
helping system administrators to promptly identify server failures. 

Insight Diagnostics no longer uses proprietary ASCII text files like the Survey Utility.  
Insight Diagnostics has made an evolutionary change by generating XML files instead of 
ASCII text files.  XML is a widely implemented industry standard and this allows our 
customers to take full advantage of a wide variety of available tools to parse the Survey 
XML data.  XML provides flexibility, accessibility, and portability advantages over the 
ASCII text files produced by the legacy Survey Utility.  Searching the Survey data is now 
easier and more efficient than the legacy Survey Utility. Search engines can simply parse 
the description-bearing tags rather than muddling in the data. 

Insight Diagnostics includes a Web browser interface in addition to the command-line 
Interface.  This enables remote control of the utility and facilitates easy transfer of 
configuration information from remote machines to a service provider.  It can be updated 
from the Version Control Repository Manager (VCRM), using the Version Control Agent 
(VCA) and with Systems Insight Manager (SIM), which offers pro-active notification 
when an updated version is available. 

For more information on HP Insight Diagnostics, review the White Paper available on the 
HP Insight Diagnostics website at http://www.hp.com/servers/diags.  To review 
information on other ProLiant Essentials software, including VCRM, VCA, and SIM, 
visit http://www.hp.com/servers/proliantessentials.  


Transitioning the Survey Utility

HP Insight Diagnostics Online Edition replaces the Survey Utility in the ProLiant 
Support Packs for Microsoft Windows 2000 and Microsoft Windows Server 2003.  As a 
result, all new feature development will be focused on Insight Diagnostics Online Edition.    
The Survey Utility for those two operating systems will be available from the website 
www.hp.com/go/support, for legacy systems, however, there will be no support for this 
utility after December 2004.  HP Insight Diagnostics Online Edition offers enhanced 
functionality over the Survey Utility.  HP recommends that customers transition to the 
HP Insight Diagnostics for additional operating system support, increased functionality, 
and continued maintenance.

===============================================================
What's New

* Tighter integration with the Systems Management Homepage 2.0 and other ProLiant Management Integration Modules

      * Streamlined configuration
      * Increased Security
      * SMH 2.0 required

New Features

      * Support for SuSE Linux and UnitedLinux
      * Driver versions available
      * Detailed configuration data 
      * Part number and spare part numbers
      * Serial number
      * Increased Logical Drive Volume information
          - Complete Volume Information,
          - Detailed Logical Drive Strings, 
          - Free Disk Space remaining
      * Array Diagnostic Information
          - Controller error report 
          - Report of configured logical drives 
          - Hard Drive Diagnosis Monitor and Performance statistics
          - Last failure reason
          - Physical drive flags (Drive Present and Operational, Synchronous data transfer supported, 16-bit data transfer, etc)

      * iLO/RILOE II information and testing
          - iLO and RILOE II configuration information now available
          - New offline self test feature which allows validation of the management processor 

===============================================================
Converting Survey XML

A stylesheet file named survey.xsl has been provided to convert a Survey XML file to HTML or plain ASCII text files.  You can use this stylesheet with existing utilities available on the Internet.  Examples of such tools are Microsoft Windows MSXSL or open source EXSLT for Linux. The command line for both of these example utilities is the same:

Utility_Name XML_file_name XSL_file_name -o HTML_file_name

Example:

Msxsl.exe survey2004-11-10-07-54-29.xml survey.xsl -o survey.html

To output a file in HTML, make sure the xsl:output tag is set to "HTML".  To output a file in plain ASCII text format, make sure the xsl:output tag is set to "text".

Examples:

HTML file:  <xsl:output method="html"/>

Text file: <xsl:output method="text"/>

===============================================================
Environment and Requirements


Servers Supported:  

ProLiant BL10e	
ProLiant BL10 G2
ProLiant BL20p	
ProLiant BL20p G2	
ProLiant BL20p G3	
ProLiant BL25p	
ProLiant BL30p	
ProLiant BL35p	
ProLiant BL40p	
ProLiant BL45p	
ProLiant DL320 G2 	
ProLiant DL320 G3	
ProLiant DL360 G2	
ProLiant DL360 G3	 
ProLiant DL360 G4	
ProLiant DL380 G2 	
ProLiant DL380 G2 
ProLiant DL380 G3	
ProLiant DL380 G3 Packaged Cluster with MSA500  	
ProLiant DL380 G3 Packaged Cluster with MSA1000   	
ProLiant DL380 G4	
ProLiant DL380 G4 Packaged Cluster with MSA500 G2	
ProLiant DL385	
ProLiant DL560	
ProLiant DL580 G2	
ProLiant DL580 G3	
ProLiant DL585	 
ProLiant DL740	
ProLiant DL760	
ProLiant DL760 G2	
ProLiant ML310	
ProLiant ML330 G2	
ProLiant ML330 G3	
ProLiant ML350 G2	 
ProLiant ML350 G3	
ProLiant ML350 G4	
ProLiant ML370 G2	
ProLiant ML370 G3	
ProLiant ML370 G4	
ProLiant ML530	
ProLiant ML530 G2	
ProLiant ML570	
ProLiant ML570 G2	
ProLiant ML570 G3	
ProLiant ML750	


Operating Systems Supported:

Microsoft Windows Server 2003 Slipstream, Standard Edition SP1
Microsoft Windows Server 2003 Slipstream, Web Edition 	SP1
Microsoft Windows Server 2003 Slipstream, Enterprise Edition  SP1
Microsoft Windows Server 2003 SBS, Standard & Premium
Microsoft Windows 2000 Server SP4	
Microsoft Windows 2000 Advanced Server	SP4
Microsoft Windows 2000 Server Slipstream	SP4
Microsoft Windows 2000 Advanced Server Slipstream SP4	
Microsoft Small Business Server 2000	SP4	
Red Hat Enterprise Linux 2.1 with update 5 or greater.
Red Hat Enterprise Linux 3 for x86 with update 3 or greater.
UnitedLinux 1.0 for x86 (UnitedLinux = Conectiva Linux Enterprise Edition, SCO Linux 
4.0 and Turbolinux 8 all powered by UnitedLinux 1.0)
	SP3 + latest errata
SUSE LINUX Enterprise Server (SLES) 9 for x86

===============================================================
Uninstalling Survey Utility

To Uninstall the Survey Utility in Windows:

Log on to the Windows server with administrator access rights.
Open the Control Panel.  Open Add/Remove Programs.  Select Survey Utility
and click on Remove.

To Uninstall the Survey Utility in Linux:

Log in as root.  Uninstall the Survey Utility rpm, using the command:

rpm -e survey

===============================================================
Installing Insight Diagnostics in Windows

It is strongly recommended that you uninstall the current Survey Utility for 
Windows or Linux before beginning the installation of 
Insight Diagnostics.  

Prerequisites:

Insight Diagnostics for Windows requires the following Smart 
Component to make full use of its capabilities:

- HP Advanced System Management Driver
- HP System Management Homepage
- HP Server Management Application and Agents

To install Insight Diagnostics for Windows:

Log on to the Windows server with administrator access rights.

Install the ProLiant Support Pack from SmartStart 7.2.  Insight Diagnostics for Windows 
is installed by default with the support pack.

Hp Insight Diagnostics can also be downloaded as a Smart Component to a directory on 
your hard drive.  The self extracting-executable with the Smart Component Number; 
cp004821.exe is Hp Insight Diagnostics 7.00.  Change to the downloaded directory and 
run the self-extracting executable for installation.  .  

===============================================================
Installing Insight Diagnostics in Linux

It is strongly recommended that you uninstall the current Survey Utility for 
Windows or Linux before beginning the installation of 
Insight Diagnostics.  

Prerequisites:

Insight Diagnostics for Linux requires the following Smart Component
to make full use of its capabilities:

- HP Server Management Application and Agents 
- HP System Management Homepage
- HP ProLiant Linux Deployment Utility
- HP Server Management Application and Agents for Red Hat Enterprise

To install Insight Diagnostics for Linux:

The Support Pack for SmartStart 7.2 Linux should be installed 

See http://h18023.www1.hp.com/support/files/server/us/download/18425.html for 
current support pack.

Login as root and download the Insight Diagnostics rpm to a directory on your
hard drive and change to that directory. Enter the following command to install
the utility:

rpm -Uvh [rpmFilename]

For example, rpm -Uvh hpdiags-[version].linux.i386.rpm.


The Insight Diagnostics package installs itself and all related files in the
directory: /opt/hp/hpdiags


To start the HP System Management Homepage web daemon now: /etc/init.d/hpsmhd 
start



To stop the HP System Management Homepage web daemon now: /etc/init.d/hpsmhd 
stop


For other Insight Diagnostics command line options: cd /opt/hp/hpdiags/

./hpdiags -?


To start the web server automatically on startup:

chkconfig --add hpsmhd

To stop the web server from starting automatically on startup:

chkconfig --del hpsmhd


===============================================================
Accessing Insight Diagnostics from the HP System Management Homepage

HP Insight Diagnostics allows you to view information from a Web browser.  

Browser Requirements

The requirements are TCP/IP and one of the following browsers:
Mozilla 1.5, 1.6 or higher
Microsoft? Internet Explorer 6.0 or higher
The minimum browser requirements include support for tables, frames, Java?, 
JavaScript, and CSS.

IMPORTANT: You must have all of the following browser options enabled for the Web-
enabled diagnostics to work properly:

Enable Java
Enable JavaScript
Accept all cookies	
Additional browsers, or the browsers mentioned, used with different operating systems, 
may or may not work correctly, depending upon the specific implementations of the 
required browser technologies.

Determine the address of the target machine on which you wish to run Insight 
Diagnostics

To run Insight Diagnostics locally, use the URL: https://127.0.0.1:2381/

To run Insight Diagnostics remotely, use the URL: https://machine:2381/ where machine 
is the IP address, or the computer name under DNS.

Enter the machine address in the URL field of the browser. The Web-Based System 
Management Homepage is displayed for that machine. You may select the login account 
link to log in as another user. Use this option if you need to perform operations that 
require additional access rights, such as capturing a new configuration sample.

===============================================================
Accessing Insight Diagnostics from Systems Insight Manager

Go to the server Device page. Select Insight Diagnostics from the Device Links box. 

The Insight Diagnostics home page is displayed.

Logging In
For login instructions refer to the Systems Insight Manager documentation 
The Login dialog box allows you to access any of the available Web agents. To access 
the desired agent:
Navigate to https://machine:2381 where machine is the IP address, or the computer name 
under DNS.  The first time you navigate to this link, the Security Alert dialog box is 
displayed asking you to indicate whether or not to trust the server.	

Accessing Insight Diagnostics from the Windows Start Menu

Go to the Windows Start button.  Select HP Information Center. Then select 
HP Insight Diagnostics Online Edition for Windows

===============================================================
Diagnostics Issues

Diagnostics issues are known problems in Diagnostics that will be 
corrected in a future Diagnostics release.

*       Install does not remove previously installed version of Insight Diagnostics

Description

Insight Diagnostics installation does not uninstall previously installed versions
of Insight Diagnostics for Windows.  Both versions of Insight Diagnostics are listed 
in the Microsoft Windows Add/Remove Programs.  If Insight Diagnostics is executed 
from the Start Menu, a blank white window appears and Insight Diagnostics does
not start.  In the System Management Homepage, two links for Insight Diagnostics 
are listed.  When the top link is clicked, a blank white window appears and 
Insight Diagnostics does not start.  When the bottom link is clicked, the previous
installed version of Insight Diagnostics starts.

Workarounds 

Go into the Microsoft Windows Add/Remove Programs in the Conrol Panel and 
manually uninstall Insight Diagnostics for Windows prior to installing the 
new Insight Diagnostics version.

*       Save feature does not work for USB Floppy or USB DiskOnKey in Microsoft Windows

Description

Unable to save information from Insight Diagnostics to a USB Floppy
or USB DiskOnKey in Microsoft Windows

Workarounds 

No workaround. A correction will be added in a future version of 
diagnostics.

*       Configuration captures cannot be scheduled in monthly mode

Description

When monthly mode is selected, nothing happens when the "OK" button is
clicked; the window does not close, and the cron files are not updated.  

Workarounds 

Use weekly mode for scheduling the Survey capture.  A correction will be 
added in a future version of 
diagnostics.


*       System section in Survey incorrectly states hyperthreading is disabled

Description

In the System section of Survey, hyperthreading is reported as disabled when 
the system has hyperthreading enabled in Linux.

Workarounds 

This is not a hardware issue.  A correction will be added in a future version of 
diagnostics.

*       Drive diagnostic predictions are displaying all zeros

Workarounds 

No workaround. A correction will be added in a future version of 
diagnostics.

*       Testing continues after a failure when "Stop on first error" 
checkbox is selected

Workarounds 

No workaround. A correction will be added in a future version of 
diagnostics.

*       Resilient Memory information missing in Survey

Description

Survey does not display DIMMS that are configured for RAID memory

Workarounds 

No workaround. A correction will be added in a future version of 
diagnostics.

*	Some user messages may not be localized and are displayed in English 

Description 

Some messages presented to the user may be in English when 
running in French, Italian, German, Spanish, or Japanese.

Workarounds 

No workaround. A correction will be added in a future version of 
diagnostics.

*	SATA incorrectly identified as IDE or SCSI

Description

On systems with SATA, the device may be incorrectly labeled as SCSI or IDE 
depending upon the configuration.

Workarounds

No workaround. A correction will be added in a future version of diagnostics.

*       ATA RAID logical drives are incorrectly identified as SCSI hard drives 

Description 

On systems with ATA RAID controllers, only configured RAID volumes are visible 
through diagnostics, and they are labeled as SCSI hard drives.

Workarounds 

No workaround. A correction will be added in a future version of diagnostics.

*	Storage section under Survey reports the existence of a floppy drive 
when there is not one installed

Description

On systems without a floppy drive, the system may be incorrectly reporting the 
existence of a floppy drive.

Workarounds

No workaround. A correction will be added in a future version of diagnostics.


*       UID Tests are missing on some systems

Workarounds

No workaround. A correction will be added in a future version of diagnostics.

*       NC3131 NIC is incorrectly identified as NC3163

Description

When viewing Survey Communication information under Microsoft Windows, NC3131 NIC is 
incorrectly identified as NC3163

Workarounds

No workaround. A correction will be added in a future version of diagnostics.

*       A combination of NC3131 and NC3135 NICs are incorrectly identified as NC3134

Description

When viewing Survey Communication information under Microsoft Windows,a combination of 
NC3131 and NC3135 NICs are incorrectly identified as NC3134

Workarounds

No workaround. A correction will be added in a future version of diagnostics.

===============================================================
Diagnostics Limitations

Diagnostics limitations are feature constraints due to the environment 
that diagnostics is running or features that have not been added in the 
current version. 

*	Limited Survey information

Description

Survey may not display complete information for some devices or information 
for some devices may be limited.  Data captures are based upon drivers 
available to diagnostics.


*	No Fan, Temperature, or Power Supply information available without 
the HP Management Agents installed and running. 

Description 

Diagnostics is dependent on the HP Management Agents for 
several health related devices such as fans, temperature sensors, 
and power supplies. If the Management Agents are not running, 
diagnostics ignores these devices and it appears as if they do not 
exist. 

Workarounds 

Ensure that you are running the latest HP Management Agents. 
Then Install Insight Diagnostics on your Linux partition.

===============================================================

Diagnostics Test Limitations

*	Limited Survey data in RILOE II 

Description 

Survey data viewed through RILOE II is limited. 

*	No memory testing support for systems with 256MB system 
memory or less installed.

Description

Due to limited available system memory on 256MB computers, memory tests 
are listed as untestable.

*	No keyboard, mouse, or graphics diagnostics support for systems 
with 512MB system memory or less installed.

Description       

Due to limited available memory on systems with less than 512MB system memory, 
keyboard, mouse, and graphics tests have been disabled. 

*	No Fibre Channel diagnostics support

Description

Fibre Channel PCI cards are identified, but testing and identification of 
attached storage devices are not available at this time. 

*	Certain devices are not available for testing when running Insight Diagnostics

Description

Network Interface Controllers and CD-ROM drives cannot be tested. 

*	Extended periods of testing, that last over 48 hours, may 
unexpectedly cause Insight Diagnostics to stop running.

Description

When running Insight Diagnostics continuously for several days or 
performing multiple diagnostics activities in a single session, the 
user interface may stop responding to user input.

Workarounds

Power cycle the system and re-run Insight Diagnostics.

===============================================================
Diagnostics Notes

Diagnostics notes are usability issues that the user should be aware of, 
but should not be considered problems.

*	Floppy I/O error reported during Survey capture 

Description 

During Survey capture, HP Insight Diagnostics attempts to determine the 
size of the media installed in the floppy drive.  If no media is inserted 
in the floppy drive, a Floppy I/O error is reported by the Operating System. 


*	"Unsupported operating system" reported 

Description 

This error indicates that HP Insight Diagnostics is attempting to run on an 
unsupported operating system. 

Workarounds 

Run Insight Diagnostics on a supported operating system. 

*	RPM does not uninstall all diagnostics files. 

Description 

Uninstallation of Insight Diagnostics does not remove files generated 
when running diagnostics. 

Workarounds 

Some files may be generated during the execution of Insight Diagnostics. 
Manually remove the /opt/hp/hpdiags directory with the command 
"rm -rf /opt/hp/hpdiags".  By default Survey capture XML files are not removed. 

*	Incorrect PCI slot number reported a device 

Description 

An incorrect PCI slot number may be reported by the SMBIOS 
and subsequently by Insight Diagnostics.

Workarounds 

Update to the current system ROM and rerun Insight Diagnostics. 

*	Array Controller memory size is reported incorrectly on some controllers 

Description 

Array Controller memory is often underreported in the Overview 
section of diagnostics, especially for controllers with 64 MB or 
less of memory. This is a problem where the array controller 
firmware misreports the physical memory size to diagnostics.

Workarounds 

The actual controller memory size is reported during power-on 
self-test (POST). An Array Controller firmware upgrade may 
resolve this issue.

*	USB Root Hub information is different from what is reported by the 
Operating System

Description

The Root Hub information may be displayed differently from the Operating System information.

Workarounds 

USB information is correctly displayed by the operating system. A correction 
will be added in a future version of diagnostics.

*	Unable to save to USB Floppy

Description

If you attach a USB floppy to the system after Insight Diagnostics is already running, you
will be unable to save information to floppy.

Workarounds 

Install the USB floppy drive and reboot the system and run Insight Diagnostics. 