Smart Storage Administrator (SSA)
Version 5.20-8.0
7/20/2021

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 rebo

* 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.

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

  Adaptec SmartHBA-SA
  Adaptec SmartHBA-SA 8i
  Adaptec SmartHBA-SA 8i8e
  Adaptec SmartHBA-SA 8e
  Adaptec SmartHBA-SA 16i
  Adaptec SmartHBA-SA 4i4e

  Microsemi Adaptec HBA 1000-16i
  Microsemi Adaptec HBA 1000-16e
  Microsemi Adaptec HBA 1000-8i8e
  Microsemi Adaptec HBA 1000-8i
  Microsemi Adaptec HBA 1000-8e

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 Microsemi/Adaptec RAID controllers and HBAs,
please visit http://www.microsemi.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

