Installation

Huawei monitoring: OceanStor, Dorado, Scale-Out NAS


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 Huawei OceanStor Pacific REST API interface natively provided by the storage to get all necessary data.
Supported is only the block storage, no object, file, and HDFS.

Storage connectivity

  • Allow access from the STOR2RRD host to the Huawei OceanStor Pacific 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.

STOR2RRD storage configuration

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

  • Add storage into configuration from the UI:
    Settings icon ➡ Storage ➡ New ➡ Vendor:device ➡ Huawei OceanStor Pacific
    Storage management

  • Make sure 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
  • Test storage connectivity, either from the UI or from the command line: 
    $ 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_oceanstorpacificperf.sh
$
    Add if it does not exist as above 
    $ crontab -e

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

Supported models with their minimal firmware version:
  • Huawei OceanStor V3 series: V3R3C10
  • Huawei OceanStor V5 series: V500R007
  • Huawei OceanStor Dorado V3 series: V3R3C10
  • Huawei OceanStor Dorado All-Flash Storage: 6.0.0
  • Huawei OceanStor Hybrid Flash Storage: 6.1.3
The product uses Huawei OceanStor REST API interface natively provided by the storage to get all necessary data.

Storage connectivity

  • Allow access from the STOR2RRD host to the Huawei OceanStor / Dorado 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

    Huawei OceanStor monitoring setup

    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)

  • Add storage into configuration from the UI:
    Settings icon ➡ Storage ➡ New ➡ Vendor:device ➡ Huawei OceanStor / Dorado
    Storage management

  • Make sure 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
  • Test storage connectivity, either from the UI or from the command line: 
    $ 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.
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
Supported models with their minimal firmware version:
  • Huawei OceanStor 9000 V5 Scale-Out NAS: 7.0

It will be released in next STOR2RRD version 7.60, in case you want to test it before let us know

The product uses Huawei OceanStor REST API interface natively provided by the storage to get all necessary data.

Storage connectivity

  • Allow access from the STOR2RRD host to the Huawei OceanStor Scale-Out NAS storage on port 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

    Huawei OceanStor monitoring setup

    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)

  • Add storage into configuration from the UI:
    Settings icon ➡ Storage ➡ New ➡ Vendor:device ➡ Huawei OceanStor NAS
    Storage management

  • Make sure 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
  • Test storage connectivity, either from the UI or from the command line: 
    $ cd /home/stor2rrd/stor2rrd
$ ./bin/config_check.sh OceanStorNAS01
  =====================
  STORAGE: OceanStorNAS01 : OCEANSTOR NAS
  =====================
  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_oceanstornasperf.sh
$
    Add if it does not exist as above 
    $ crontab -e

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