Free storage, SAN and LAN performance and capacity monitoring

Quantum StorNex storage installation


Back to storage installation home.

In case of usage of Virtual Appliance
  • Use local account lpar2rrd for hosting of STOR2RRD on the virtual appliance
  • Use /home/stor2rrd/stor2rrd as the product home
The product uses SMI-S and XML API interfaces natively provided by the storage.
Quantum StorNex is re-branded Dot Hill/Seagate AssuredSAN therefore install procedure is same as for it.

Storage connectivity

  • Allow access from the STOR2RRD host to the storage on ports 80 (HTTP) and 5988 (SMI-S).
    If you use storage cmd line configuration like in examples below (you can use the storage GUI instead) then port 22 (ssh) must be open.
    If you use https and secure SMI-S then test ports 443 and 5989 instead below ones.
    $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 80
      Connection to "192.168.1.1" on port "80" is ok
    $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 5988
      Connection to "192.168.1.1" on port "5988" is ok
    
  • Assure that SMI-S 5988 and HTTP protocols are enabled on the storage
    $ ssh -l manage <storage_hostname>
    # show protocols                     
      Service and Security Protocols
      ------------------------------
      Web Browser Interface (HTTP): Enabled 
      Secure Web Browser Interface (HTTPS): Enabled
      Command Line Interface (Telnet): Disabled
      Secure Command Line Interface (SSH): Enabled
      Storage Management Initiative Specification (SMI-S): Disabled
      Unsecure Storage Management Initiative Specification (SMI-S 5988): Enabled
      ...
    
    If SMI-S 5988 or HTTP is not enabled:
    # set protocols usmis enabled
    # set protocols http enabled
    
  • Create user stor2rrd on the storage with monitor role and allow SMI-S and XML API.
    Adjust password to your prefered one from used Test1234.
    $ ssh -l manage <storage_hostname>
    # create user interfaces smis,wbi locale English password Test1234 roles monitor stor2rrd
    
  • In case you want to use SSL access to the storage
    enable ports 5989 and 443 and start up SSL services on the storage instead of non SSL ones
    # set protocols smis enabled
    # set protocols https enabled
    
    Use this fix to enable SSL communication if you run STOR2RRD v2.00 or v2.01: dothill-ssl.tar.gz.
    $ gunzip dothill-ssl.tar.gz
    $ ls -l dothill-ssl.tar
      -rw-rw-r-- 1 lpar2rrd lpar2rrd 92160 Jun  5 14:41 dothill-ssl.tar
    $ cd /home/stor2rrd/stor2rrd
    $ tar xvf dothill-ssl.tar
      -rwxr-xr-x lpar2rrd/lpar2rrd 4081  2017-06-01 13:34 bin/dothill_apitest.pl
      -rwxr-xr-x lpar2rrd/lpar2rrd 81664 2017-06-05 11:59 bin/dothillperf.pl
    
    kill all running  dothillperf.pl processes
    

Install prerequisites

Skip that in case of Virtual Appliance
  • Linux:
    Install sblim-wbemcli package:
    # yum list |grep sblim-wbemcli
      sblim-wbemcli.x86_64                       1.6.2-9.el7                 base
    # yum install sblim-wbemcli     # RedHat
    # apt-get install sblim-wbemcli # Debian based (Ubuntu etc)
    # /usr/bin/wbemcli -noverify -nl ei https://<storage_hostname>:5988/root/smis:cim_computersystem
      *
      * ./wbemcli: Http Exception: Username/password required.
      *
    
    If you prefere to use https on port 5989 then you must use wbemcli with this patch 0002742
    Download the package from:
    Test the package:
    # rpm -q sblim-wbemcli
      sblim-wbemcli-1.6.3-31.1.x86_64
    # /usr/bin/wbemcli -v
      * wbemcli Version 1.6.3
    # /usr/bin/wbemcli -noverify -nl ei http://<storage_hostname>:5988/root/smis:cim_computersystem
      *
      * ./wbemcli: Http Exception: Username/password required.
      *
    
  • AIX:
    Download and install
    # rpm -Uvh libffi-3.1-1.aix5.1.ppc.rpm --nodeps
    # rpm -Uvh libiconv-1.14-2.aix5.1.ppc.rpm --nodeps
    # rpm -Uvh libidn-1.29-1.aix5.1.ppc.rpm --nodeps
    # rpm -Uvh libssh2-1.4.3-2.aix5.1.ppc.rpm --nodeps
    # rpm -Uvh openssl-1.0.1j-1.aix5.1.ppc.rpm
    # rpm -Uvh openldap-2.4.23-0.3.aix5.1.ppc.rpm
    # rpm -Uvh curl-7.27.0-1.aix5.1.ppc.rpm
    # rpm -Uvh wbemcli-1.6.3-1.aix5.1.ppc.rpm
    
    # LIBPATH=/opt/freeware/lib; export LIBPATH
    # /opt/freeware/bin/wbemcli -noverify -nl ei http://<storage_hostname>:5988/root/smis:cim_computersystem
      *
      * ./wbemcli: Http Exception: Username/password required.
      *
    

STOR2RRD storage configuration

  • All actions below under stor2rrd user (lpar2rrd on Virtual Appliance)

  • Uncomment (remove the hash) example line and adjust it:
    $ vi /home/stor2rrd/stor2rrd/etc/storage-list.cfg
    
    #
    # Dot Hill AssuredSAN and its rebrands like Lenovo S2200 or HPE MSA2000/P2000, Quantum StorNex
    #
    # Storage Alias:DOTHILL:Controller_A IP address or hostname:Controller_B IP address or hostname:[http|https]:storage user:encrypted password:VOLUME_AGG_DATA_LIM:VOLUME_AGG_IO_LIM:SAMPLE_RATE_MINS
    # to encrypt password use: perl ./bin/spasswd.pl
    #DOTHILL_AssuredSAN-alias01:DOTHILL:ctla_host.example.com:ctlb_host.example.com:http:stor2rrd:KT4mXVI9N0BUPjZdVQo=:1024:10:
    #LENOVO_S2000-alias01:DOTHILL:ctla_host.example.com:ctlb_host.example.com:http:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    #HPE_MSA2000-alias01:DOTHILL:ctla_host.example.com:ctlb_host.example.com:http:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    
    Quantum-alias01:DOTHILL:192.168.1.1:192.168.1.2:http:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    
    Above shows the storage with IP 192.168.1.1 which will be visible in the GUI as Quantum-alias01

    Use encrypted password in storage line above, encrypt it like this:
    (Do not use shell special characters like @#$|[]\{} in the password)
    $ cd /home/stor2rrd/stor2rrd
    $ perl bin/spasswd.pl 
    
      Encode password for storage authentication:
      -------------------------------------------
      Enter password: 
      Re-enter password: 
    
      Copy the following string to the password field of the corresponding line in etc/storage-list.cfg:
    
      KT4mXVI9N0BUPjZdVQo= 
    
  • Assure you have enough of disk space on the filesystem where is STOR2RRD installed
    Roughly you might count 2 - 30 GB per a storage (it depends on number of volumes, 30GB for 5000 volumes)
    $ df -g /home   # AIX
    $ df -h /home   # Linux
    
  • Check storage connectivity
    $ cd /home/stor2rrd/stor2rrd
    $ ./bin/config_check.sh Quantum-alias01
      =====================
      STORAGE: Quantum-alias01 : DOTHILL
      =====================
      connection ok
    
    If you use HTTPS and do not have installed Perl SSL support then you get an error:
    "Missing LWP::Protocol::https", "Connection reset by peer" or "500 SSL negotiation failed"
    Follow this or switch to HTTP on the storage line in etc/storage-list.cfg.

  • Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)
    $ crontab -l | grep load_dothillperf.sh
    $
    
    Add if it does not exist as above
    $ crontab -e
    
    # DotHill AssuredSAN and its rebrands like Lenovo S2200 or HPE MSA2000/P2000, Quantum StorNex
    0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_dothillperf.sh > /home/stor2rrd/stor2rrd/load_dothillperf.out 2>&1
    
    Assure there is already an entry with the GUI creation running once an hour in crontab
    $ crontab -e
    
    # STOR2RRD GUI (just ONE entry of load.sh must be there)
    5 * * * * /home/stor2rrd/stor2rrd/load.sh > /home/stor2rrd/stor2rrd/load.out 2>&1
    
  • Let run the storage agent for 15 - 20 minutes to get data, then:
    $ cd /home/stor2rrd/stor2rrd
    $ ./load.sh
    
  • Go to the web GUI: http://<your web server>/stor2rrd/
    Use Ctrl-F5 to refresh the web browser cache.

Troubleshooting

  • Assure SMI-S is working for user stor2rrd. Adjust password and storage_hostname in example below:
    $ /usr/bin/wbemcli -nl -t -noverify ein 'http://stor2rrd:<password>@<storage_hostnamew>:5988/root/smis:SMI_Controller'
      192.168.1.1:5988/root/smis:SMI_Controller.Name="208000c0ff261f53:A",CreationClassName="SMI_Controller"
      192.168.1.2:5988/root/smis:SMI_Controller.Name="208000c0ff261f53:B",CreationClassName="SMI_Controller"
    
    When it does not work then check user rights of stor2rrd user (must have "smis"), network visibility (firewall), user/password combination.