Installation

Huawei monitoring: OceanStor, Dorado, Scale-Out NAS

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

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

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

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