Installation

INFINIDAT Infinibox installation

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 REST API interface natively provided by the storage to get all necessary data.

Infinidat has changed the API framework for collecting InfiniBox performance metrics making some of the original methods depreciated as of version 5.0.X.
Therefore, some performance data will be no longer available in STOR2RRD for InfiniBox storage systems running software version 5.0.X and higher.
This will affect mainly IOPS, Data and response time metrics for individual NODEs.
Use at least STOR2RRD v2.61-6 to have support for Infinibox v5.X.

Storage connectivity

  • Allow access from the STOR2RRD host to the storage on port 443 (https).
    $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 443
      Connection to "192.168.1.1" on port "443" is ok
    
  • Create user stor2rrd on the storage with read_only role.

STOR2RRD storage configuration

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

  • STOR2RRD v2.60+:
    Add storage into configuration from the UI:
    Settings icon ➡ Storages ➡ New ➡ Vendor:device ➡ INFINIDAT Infinibox
    Storage management

  • STOR2RRD v2.50 and olders:
    • Uncomment (remove the hash) example line and adjust it:
      $ vi /home/stor2rrd/stor2rrd/etc/storage-list.cfg
      
      #
      # INFINIDAT Infinibox
      #
      # Storage Alias:INFINIBOX:IP or hostname:storage user:encrypted password:VOLUME_AGG_DATA_LIM:VOLUME_AGG_IO_LIM:SAMPLE_RATE_MINS
      # to encrypt password use: perl ./bin/spasswd.pl
      #Infinibox_alias01:INFINIBOX:infinibox_host.example.com:stor2rrd:KT4mXVI9N0BUPjZdVQo=:1024:10:
      #Infinibox_alias01:INFINIBOX:infinibox_host.example.com:stor2rrd:KT4mXVI9N0BUPjZdVQo=
      
      Infinibox_alias01:INFINIBOX:192.168.1.1:stor2rrd:KT4mXVI9N0BUPjZdVQo=
      
      
      Above shows the storage with IP 192.168.1.1 which will be visible in the UI as Infinibox_alias01

      Use encrypted password in storage line above, encrypt it like this:
      $ 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 Infinibox_alias01
        =====================
        STORAGE: Infinibox_alias01 : INFINIBOX
        =====================
        connection ok
      
      If you get an errors like "Missing LWP::Protocol::https", "Connection reset by peer" or "500 SSL negotiation failed" then follow this.

  • Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)
    $ crontab -l | grep load_infiniboxperf.sh
    $
    
    Add if it does not exist as above
    $ crontab -e
    
    # Infinibox Storage agent
    0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_infiniboxperf.sh > /home/stor2rrd/stor2rrd/load_infiniboxperf.out 2>&1
    
    Assure there is already an entry with the UI creation running once an hour in crontab
    $ crontab -e
    
    # STOR2RRD UI (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 UI: http://<your web server>/stor2rrd/
    Use Ctrl-F5 to refresh the web browser cache.