HP Array Diagnostics and SmartSSD Wear Gauge Utility
Version 9.10-22.0 (linuxX64)
4/10/2012

Description
-----------

  The HP Array Diagnostics and SmartSSD Wear Gauge Utility is a web-based
  and command line application that creates a report of all HP storage
  controllers and disk drives. This report provides vital information to 
  HP service personnel to assist in identifying faults or conditions that
  may require attention. 
  
  The utility can also generate SmartSSD Wear Gauge reports.  These 
  reports contain wear (usage) information for all SmartSSD devices 
  attached to the system.

* All other product names mentioned herein may be trademarks of their 
  respective companies.

Support
-------
Supported Operating Systems

  32bit Platforms:
  Red Hat Enterprise Linux 4
  Red Hat Enterprise Linux 5
  Red Hat Enterprise Linux 6
  SuSE Linux Enterprise Server 10, 11

  64bit Platforms:
  SuSE Linux Enterprise Server 10 (x86_64)
  SuSE Linux Enterprise Server 11 (x86_64)
  Red Hat Enterprise Linux 4 (x86_64)
  Red Hat Enterprise Linux 5 (x86_64)
  Red Hat Enterprise Linux 6 (x86_64) with the "Compatibility Package" installed to include the 32-bit libraries.
  
* All these platforms need to have the following driver upgrades:  
  CISS driver version 2.4.50 or later

  These drivers and Fibre Channel HBA drivers are available from http://www.hp.com.

   
Supported Client Side Browsers

  Firefox 2.0 or later on Linux.
  Microsoft Internet Explorer 6 or above.

  * Please make sure the following browser options are enabled:
    1. Automatically load images and other data types.
    2. Javascript.
    3. Stylesheets.

Supported Controllers

  Smart Array products:
     Smart Array 5i Controller  
     Smart Array 532 Controller
     Smart Array 5302 Controller
     Smart Array 5304 Controller
     Smart Array 5312 Controller
     Smart Array 6i Controller
     Smart Array 641 Controller
     Smart Array 642 Controller
     Smart Array 6400 Controller
     Smart Array 6400 EM Controller
     Smart Array P600 Controller
     Smart Array P400 Controller
     Smart Array P400i Controller
     Smart Array E200 Controller
     Smart Array E200i Controller
     Smart Array E500 Controller
     Smart Array P800 Controller
     Smart Array P700m Controller
     Smart Array P410 Controller
     Smart Array P410i Controller
     Smart Array P411 Controller
     Smart Array P212 Controller
     Smart Array P711m Controller
     Smart Array P712m Controller
     Smart Array B110i SATA RAID
     Smart Array P812 Controller
     Smart Array P220i Controller
     Smart Array P222 Controller
     Smart Array P420 Controller
     Smart Array P420i Controller
     Smart Array P421 Controller
     Smart Array P822 Controller
     Dynamic Smart Array B320i RAID
     Dynamic Smart Array B120i RAID

  MSA products:
     MSA20 Controller  
     MSA500 Controller
     MSA500 G2 Controller
     MSA1000 Controller     
     MSA1500 CS Controller
 
Installing & Running the Array Diagnostics and SmartSSD Wear Gauge Utility
--------------------------------------------------------------------------
Installation Notes:
  * ADU requires "HP System Management Homepage" installed. If you have not
      installed "HP System Management Homepage", please download and install 
      it from hp.com first. (NOTE: If only the ADU CLI application is required,
      the dependency on the System Management Homepage can be overridden by the
      following command: rpm -i --nodeps hpadu-xxx.rpm 

  * ADU is distributed using Red Hat Package Manager (RPM) packages and .deb
      for Debian. 
  * If there is an older version of ADU installed on the system, please use 
      "rpm -e hpadu" to remove it first. Use "rpm -i <file name>" 
	  to install the application.
    Please type "man rpm" for other details regarding RPM.
  * NOTE: On Debian systems, a ".deb" package file can be installed using the
      "dpkg -i hpadu.xxx.deb" command.  "dpkg -r hpadu" can be used to remove
      the package.
  * The software resides in /opt/hp/hpadu
  * The executable names are "hpadu" and "hpaducli" and are located in /usr/sbin.

  * When attempting to run ADU on any HP-supported version of Linux, it is highly 
    recommended that you install the latest version of the HP ProLiant Smart Array
    Controller driver for your intended Linux operating system.  Drivers may be obtained 
    by clicking on Support & Drivers from HPs website at:  http://www.hp.com

  * For Debian 64 bit.
     dpkg -i --force-architecture <file name>.  ADU requires the
     libstdc++2.10-glibc2.2 32 bit package to be installed.

Running ADU in server (daemon) mode:  
  * Make sure that you have gone through the following checklist:
    . Only run ADU on servers that are on a local intranet
      or a secure network.
    . Secure the management port (port 2301) on your network.
    . You run cpqacuxe as root.

  * To start the server:
    If /usr/sbin is already added in your path, just type:
    "hpadu -start" for local and remote access. 

Running the ADU GUI client:
  1. Open your browser. Netscape Navigator 6.2, Mozilla 1.5 (or later), or Firefox 
     on Linux or Internet Explorer 6 or above on Microsoft Windows are supported.

  2. Type "https://<SERVERNAME>:2381" into the address field. The servername should 
     be the IP address or server name of the host on which the ADU server
     is running.

  3. You are required to log in to the "HP's System Management Homepage". Please
     refer to the online help of the System Management Homepage for account management
     details.
       
  4. Click the Array Diagnostic Utility link button inside the Storage section of the
     home page.

Exiting ADU:
  1. To exit the ADU client, close the browser by clicking on the Exit ADU button.
  2. To exit the ADU server, type "hpadu -stop".


Running ADU in command line (CLI) mode:  
  * Make sure that you have gone through the following checklist:
    . You run hpaducli as root.

  * To generate a diagnostic report, enter the following command:

       hpaducli -f adu-report.zip

  * To generate a SmartSSD Wear gauge report, enter the following command:

       hpaducli -ssdrpt -f ssd-report.zip
   
  * More options can be found by "hpaducli -help".


ADU Report Output Notes
-----------------------
Both the diagnostic and SmartSSD wear gauge reports are generated in compressed (ZIP) format.

The diagnostic report output archive contains the following files:

   * ADUReport.txt          => Diagnostic report in text format
   * ADUReport.xml          => Diagnostic report in XML format
   * ADUReport.htm          => HTML viewer for diagnostic report
   * report.checksum        => checksum file
   * SlotX.txt (SlotX.old)  => Controller serial output log

   Note: The serial output log file(s) are only available if the "HP Smart Array SAS/SATA
         Event Notification Service" is installed and running.

   To view the diagnostic report in a browser, extract the ADUReport.htm. Open ADUReport.htm 
   in the browser.

The SmartSSD wear gauge report output archive contains the following files:

   * SmartSSDWearGaugeReport.txt  => SmartSSD wear gauge report in text format
   * SmartSSDWearGaugeReport.json => SmartSSD wear gauge report in JSON format
   * SmartSSDWearGaugeReport.htm  => HTML viewer for the JSON wear gauge report   

   To view the SmartSSD wear gauge report in a browser, extract the SmartSSDWearGaugeReport.json,
   SmartSSDWearGaugeReport.htm files to a directory (both files must reside in the
   same directory).  Open SmartSSDWearGaugeReport.htm in the browser.

Additional Notes
----------------
 1. On Debian 64bit, if hpadu is running and the ADU web page is up, you must
    exit the ADU web page before running "hpadu -stop" in a command line. In general,
    you should exit an applications web page before stopping the daemon process.
 2. On Debian 64bit, if after 10 seconds the "hpadu -stop" command hangs, use "CTRL-C"  
    to interrupt the command, and then rerun "hpadu -stop" to finish cleanup before
    attempting to run hpadu again.
 3. On RHEL5 systems, for this version of ADU, version 3.6.18-10 or newer of the 
    HP ProLiant Smart Array Controller Driver for Red Hat Enterprise Linux 5 (x86, x86-64)
    is required. Drivers may be obtained by clicking on Support & Drivers from HPs 
    website at:  http://www.hp.com

Known Issues
------------
N/A

Feedback
--------
For support for ADU or Smart Array controllers, please visit the web at 
    http://support.hp.com.
For feedback or suggestions on ADU, please send comments to ACU@hp.com;
    however, we regret support cannot be provided through this address.
