Smart Storage Administrator (SSA)
Version 2.60-18.0
8/31/2016

Description
-----------
Smart Storage Administrator (SSA) is the storage configuration,
diagnostics, and management utility for ProLiant servers.

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

Supported Operating Systems and Platforms
-----------------------------------------
Linux 32-bit components:
   SuSE Linux Enterprise Server 10
   SuSE Linux Enterprise Server 11
   Red Hat Enterprise Linux 5
   Red Hat Enterprise Linux 6
   Red Hat Enterprise Linux 7

Linux 64-bit components:
   SuSE Linux Enterprise Server 10 (x86_64)
   SuSE Linux Enterprise Server 11 (x86_64)
   Red Hat Enterprise Linux 5 (x86_64)
   Red Hat Enterprise Linux 6 (x86_64)
   Red Hat Enterprise Linux 7 (x86_64)
   Debian Sarge 64 bit
   Debian Etch (amd64)

   NOTE: For Red Hat Enterprise Linux 7.1 the sg driver must be manually
         added so that it is loaded at boot time. Without the sg driver being
         loaded, devices or controllers may not be discovered.
         Here is a recommended way to do this:

            sudo echo sg > /etc/modules-load.d/sg.conf
            sudo rebo

* Any platform that requires the CCISS driver should use version 3.6.28 or newer.

These drivers are available from http://support.hpe.com.

Supported Client Side Browsers
------------------------------
  Mozilla Firefox 9.0 or later
  Google Chrome
  Microsoft Internet Explorer 9.0 or above
  * Please make sure the following browser options are enabled:
    1. Automatically load images and other data types.
    2. JavaScript.
    3. Style sheets.

Supported Controllers
---------------------
  Dynamic Smart Array B110i SATA RAID
  Smart Array P212 Controller
  Smart Array P410 Controller
  Smart Array P410i Controller
  Smart Array P411 Controller
  Smart Array P711m Controller
  Smart Array P712m Controller
  Smart Array P812 Controller

  Dynamic Smart Array B120i
  Dynamic Smart Array B320i
  Smart Array P220i Controller
  Smart Array P222 Controller
  Smart Array P420 Controller
  Smart Array P420i Controller
  Smart Array P421 Controller
  Smart Array P721m Controller
  Smart Array P822 Controller

  Smart Array P230i Controller
  Smart Array P430 Controller
  Smart Array P431 Controller
  Smart Array P530 Controller
  Smart Array P531 Controller
  Smart Array P731m Controller
  Smart Array P830 Controller
  Smart Array P830i Controller

  Dynamic Smart Array B140i
  Smart HBA H240 Controller
  Smart HBA H240ar Controller
  Smart HBA H240nr Controller
  Smart HBA H241 Controller
  Smart HBA H244br Controller
  Smart Array P240nr Controller
  Smart Array P244br Controller
  Smart Array P246br Controller
  Smart Array P440 Controller
  Smart Array P440ar Controller
  Smart Array P441 Controller
  Smart Array P542D Controller
  Smart Array P741m Controller
  Smart Array P840 Controller
  Smart Array P840ar Controller
  Smart Array P841 Controller

Installing and running Smart Storage Administrator
--------------------------------------------------------------
  Installation:
    SSA is distributed using Red Hat Package Manager (RPM) packages.
    If there is an older version of SSA installed on the system,
      please use "rpm -e ssa" to remove it first. Use "rpm -i <file name>"
      to install the service.
    Please type "man rpm" for other details regarding RPM.
    The software resides in /opt/smartstorageadmin/ssa and the executable
      name is ssa which is located in /usr/sbin.
    SSA can be accessed through the HPE System Management Homepage.  If you
      have not installed "HPE System Management Homepage", please download and
      install it from http://support.hpe.com.

  Run the SSA client on the local server as an application:
    Requirements:
       . You must run ssa as root
       . You must be running on a
       . The background process will create a port on the loopback interface
         which is not visible to external network connections.
    1. Run the ssa command (/usr/sbin/ssa) with the "-local" parameter. The
       background program will start and launch the Firefox browser.
    2. To change the default browser that is started, or to specify the command
       to use to launch the browser, modify the browserstart.sh script
       (under /opt/smartstorageadmin/ssa/bin) with the correct path.
    3. To exit the application, close the main application window.

  Run SSA remotely through the HPE System Management Homepage:
    Requirements:
       . Only run SSA on servers that are on a local intranet
         or a secure network.
       . Secure the management port (port 2301) on your network, or run
         using the secure port (port 2381).
       . Run ssa as root.
    To start the server daemon:
    1. Run the ssa command with the "-start" parameter
       /usr/sbin/ssa -start
    2. If this is the first time that SSA is started in this mode, you must
       restart the SMH server for SSA to appear in the SMH page. To restart
       SMH type (as root):
       /etc/init.d/hpsmhd restart
    3. Access the HPE System Management Homepage from the client browser.
       URL:        http://<server name>:2301/
       Secure URL: https://<server name>:2381/
    4. SSA can be launched from the Storage section by clicking on the
       Smart Storage Administrator link.

    To stop the server daemon:
    1. Run the ssa command with the "-stop" parameter
       /usr/sbin/ssa -stop

Additional Notes
----------------
    1. When running under the HPE System Management Homepage, users will
       automatically be logged out after a predetermined period of inactivity
       when using SSA and will have to re-login.
    2. HPE System Management Homepage login timeouts will not work properly
       while running SSA unless the "Anonymous Access" option is checked on
       the HPE System Management Homepage under "Settings->Options".
       If you decide not to check "Anonymous Access" and a login timeout
       occurs, the HPE System Management Homepage login screen will appear in an
       SSA frame and will not work correctly. If this happens, close the
       SSA browser and go back to the HPE System Management Homepage and re-login
       as administrator.
       Click on the Smart Storage Administrator link to restart the HPESSA
       session.
    3. To properly exit out of the SSA session, click on the Exit (X) link in
       the SSA window.
    4. Please stop the HPE Storage Agents when deleting logical drives
       since HPE Storage Agents keeps all logical drives open.
    5. If all physical drives on a controller fail or are removed, software
       keys will not be saved to the controller.
    6. SSA may appear unresponsive during heavy array controller I/O
       conditions, such as during a partition format or a logical drive
       rebuild.
    7. Some browsers allow pop-ups to be turned off or blocked.  For SSA to
       run, pop-ups must be enabled in the browser.
    8. When using Linux as the host operating system, if a Smart Array
       controller has 16 or more volumes configured, deleting any volume in the
       HPESSA will not update the /proc/partitions to reflect the deletion of
       the device node associated with that volume. Rebooting the server will
       cause the update to happen. Note that there is also a limitation that
       only the first 16 volumes configured will be available to the operating
       system.
    9. When using Internet Explorer 9.0 to run SSA from a server using HPSMH
       it may not be possible to save the diagnostic report. To allow the
       report to be downloaded do the following: Under Internet Options, go to
       the Advanced tab and clear the "Do not save encrypted pages to disk"
       checkbox.
   10. When using Internet Explorer 9.0 or later to run SSA remotely,
       choosing the "Save Report" link to download a copy of the diagnostic
       report may cause the information bar to appear with the following
       message:

         "To help protect your security, Windows Internet Explorer blocked this
          site from downloading files to your computer. Click here for more
          options..."

       Even if the "download file" action is clicked in the information bar,
       the file download is blocked and the report is not downloaded.
       In order to successfully download the file:
       * Choose to view the report first and then save the file, or
       * Disable automatic download blocking by enabling automatic prompting
         for file downloads. To access the setting that controls automatic
         download blocking:
       a) Click Tools, and then click Internet Options. The Internet Options
          dialog box appears.
       b) Click the Security tab. The Internet Options dialog box shows the
          security levels and zones. Select the current security zone for the
          server that is running SSA.
       c) Click Custom Level. The Security Settings dialog box appears.
       d) Scroll down to Downloads, and then select the Enable option for
          Automatic prompting for file downloads.

Support
-------
For support for SSA and Smart RAID/HBA controllers, please visit
http://support.hpe.com.

Acknowledgements
----------------
   Port icon designed by Freepik

   This application uses the following third party components, and reference to
   the licenses used are located in their respective JavaScript files:

   Backbone.js
   (c) 2010-2014 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors

   jQuery
   (c) 2005, 2014 jQuery Foundation, Inc.

   jQuery Migrate
   (c) 2005, 2013 jQuery Foundation, Inc. and other contributors

   jQuery UI
   (c) 2013 jQuery Foundation and other contributors

   jquery.scrollto.js
   (c) 2012 Yannick Albert

   trunk8
   (c) 2012 Rick Viscomi

   Underscore.js
   (c) 2009-2014 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors

   jBox.min.js
   (c) 2014 Stephan Wagner
