Smart Storage Administrator (SSA)
Version 6.15-11.0
11/1/2022

Description
-----------
Smart Storage Administrator (SSA) is the storage configuration, diagnostics, and
management utility for SmartRAID and SmartHBA adapters.

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

Supported Operating Systems and Platforms
-----------------------------------------
Linux 64-bit components:
   SuSE Linux Enterprise Server 10 (x86_64)
   SuSE Linux Enterprise Server 11 (x86_64)
   SuSE Linux Enterprise Server 12 (x86_64)
   SuSE Linux Enterprise Server 15 (x86_64)
   Red Hat Enterprise Linux 5 (x86_64)
   Red Hat Enterprise Linux 6 (x86_64)
   Red Hat Enterprise Linux 7 (x86_64)
   Red Hat Enterprise Linux 8 (x86_64)

   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 reboot

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

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.

Current list of supported controllers/devices for this application can be found on the HPE website.

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.

  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.

Additional Notes
----------------
    1. To properly exit out of the SSA session, click on the Exit (X) link in
       the SSA window.
    2. If all physical drives on a controller fail or are removed, software
       keys will not be saved to the controller.
    3. SSA may appear unresponsive during heavy array controller I/O
       conditions, such as during a partition format or a logical drive
       rebuild.
    4. Some browsers allow pop-ups to be turned off or blocked.  For SSA to
       run, pop-ups must be enabled in the browser.
    5. When using Linux as the host operating system, if a Smart RAID/HBA
       controller has 16 or more volumes configured, deleting any volume in the
       SSA 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.
    6. 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 PSA and Microchip/Adaptec RAID controllers and HBAs,
please visit https://www.microchip.com

Acknowledgements
----------------
   The following icons were designed by Freepik from www.flaticon.com
   - Port
   - None

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

   Node.js
   (c) Node.js contributors

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

   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

   gulp
   (c) 2013-2016 Fractal contact@wearefractal.com

   gulp-sass
   (c) 2013 David Manning

   gulp-autoprefixer
   (c) Sindre Sorhus sindresorhus@gmail.com (sindresorhus.com)

   gulp-clean-css
   (c) 2017 scniro scniro@outlook.com

   zlib
   (c) 1995-2005 Jean-loup Gailly and Mark Adler

   zip/unzip
   (c) 1998-2005 Gilles Vollant

