Huawei OceanStor storage 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

Huawei OceanStor V3, V5 and Dorado V3 and newer storage systems are supported.
The product uses REST API interface natively provided by the storage to get all necessary data.
Your storage must run at least this firmware version V300R003C10. Check suported storage models

Storage connectivity

• Allow access from the STOR2RRD host to the storage on ports 8088.
  

  $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 8088
    Connection to "192.168.1.1" on port "8088" is ok
  

• Create user stor2rrd on the storage with read-only role.
  To activate the account you have to log in to the storage UI with stor2rrd credentials and change password.
  
  
• Assure that performance monitoring collection is enabled on the storage and historical collection is set to 300 secs. It must be set to 300 seconds to work correctly!
  New storage firmwares have that at : Monitor ➡ SystemReporter ➡ (pop up window) ➡ System ➡ System Configuration ➡ Registration and Configuration ➡ Storage name ➡ Collection policy ➡ Historical monitoring
  
  
  
  Some models do not allow such change from the storage UI, use storage CLI instead:

  admin:/>change performance statistic_enabled enabled=no
  admin:/>change performance strategy archive_time=300s
  admin:/>change performance statistic_enabled enabled=yes
  admin:/>show performance strategy
    Sampling Interval(s) : 5
    Archive Enabled      : Yes
    Archive Time(s)      : 300
    Auto Stop            : No
    Duration(days)       : --
  

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 ➡ Storage ➡ New ➡ Vendor:device ➡ Huawei OceanStor / Dorado
  
  
• STOR2RRD v2.50 and olders:
  
  • Uncomment (remove the hash) example line and adjust it:

    $ vi /home/stor2rrd/stor2rrd/etc/storage-list.cfg
    
    #
    # Huawei OceanStor, Dorado
    #
    # Use :OCEANSTOR: even in case of Dorado configuration
    # Storage Alias:OCEANSTOR:Controller_A IP address or hostname:Controller_B IP address 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
    #huawei-alias01:OCEANSTOR:ctla_host.example.com:ctlb_host.example.com:stor2rrd:KT4mXVI9N0BUPjZdVQo=:1024:10:
    
    huawei-alias01:OCEANSTOR:192.168.1.1:192.168.1.2:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    

    Above shows the storage with IP 192.168.1.1 which will be visible in the UI as huawei-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 huawei-alias01
      =====================
      STORAGE: huawei-alias01 : OCEANSTOR
      =====================
      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_oceanstorperf.sh
  $
  

  Add if it does not exist as above

  $ crontab -e
  
  # Huawei OceanStor
  0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_oceanstorperf.sh > /home/stor2rrd/stor2rrd/load_oceanstorperf.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.