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
Storage agent uses the Unisphere as data source, therefore only connection to the Unisphere is necessary to get performance statistic from all VMAX boxes attached there.
Unispheres 1.6.x, 8.x and 9.x are supported.
Read why
TDEVs are not monitored.
Prerequisites
-
Allow access from the STOR2RRD host to the Unisphere on port 8443 (TCP).
Test if port is open:
$ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 8443
Connection to "192.168.1.1" on port "8443" is ok
-
Create user stor2rrd under "PerfMonitor" role on Unisphere.
-
Allow statistics logging on the Unisphere
UI ➡ Performance ➡ Settings ➡ System Registrations ➡ Diagnostics ➡ On (Diagnostics interval 5 minutes)
Unisphere 1.6
|
Unisphere 8
|
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 ➡ Dell EMC VMAX
-
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 VMAX_alias01
===============================
STORAGE: VMAX_alias01: VMAX
===============================
connection ok
Possible errors and solutions:
- Error "Missing LWP::Protocol::https", "Connection reset by peer", "500 SSL negotiation failed": follow this.
- Error "Array keys not found!": attach this VMAX through its local Unisphere
- Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)
$ crontab -l | grep load_vmaxperf.sh
$
Add if it does not exist as above
$ crontab -e
# VMAX storage agent
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_vmaxperf.sh > /home/stor2rrd/stor2rrd/load_vmaxperf.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
VNXe support
STOR2RRD supports these SAN/NAS VNXe storage:
STOR2RRD does not support VNXe series1 models which do not have block implementation:
- VNXe 3100
- VNXe 3150
- VNXe 3300
Such storage do not provide performance data.
Prerequisites
-
Allow access from the STOR2RRD host to the storage service processors on port 443 (TCP).
Test if port is open:
$ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 443
Connection to "192.168.1.1" on port "443" is ok
- VNXe Unisphere UEM CLI download
If you have also EMC Unity in place then use Unity UEM CLI which works also for VNXe.
VNXe UEM CLI does not support Unity.
https://support.emc.com/downloads
VNX/VNXe family ➡ VNXe1/2 series ➡ ADD-ONS ➡ More ➡ VNXe Unisphere CLI ➡ Linux 64-bit
- Supported platforms (unfortunatelly there is no AIX support for UEM CLI as per November 2016 at least)
- Unisphere API installation
# umask 022
# rpm -i UnisphereCLI-Linux-64-x86-en_US-4.0.1.1.3166-1.x86_64.rpm
- Setting security level under root user:
# /opt/emc/uemcli/bin/setlevel.sh low
Setting low verifying level.....
You can even use "medium" level, then you have to accept and store certificate at the first connection.
- under root:
# /opt/emc/uemcli/bin/setlevel.sh medium
Setting medium verifying level.....
- under stor2rrd user:
$ uemcli -d 192.168.1.1 -u Local/admin -p "XXXXXX" /user/account show
Remote certificate:
Issuer: CN=EMC-Unity
Subject: CN=EMC-Unity
Valid from: 2016-07-15 09:54:57 Z
Valid to: 2019-07-15 09:54:57 Z
Serial: 0094aea927526b466e
Id: 2595584890
Would you like to:
[1] Accept the certificate for this session
[2] Reject the certificate
[3] Accept and store
Please input your selection (The default selection is [1]): 3
Storage system address: 192.168.1.1
Storage system port: 443
HTTPS connection
1: ID = user_admin
Name = admin
Role = administrator
Type = local
- create user stor2rrd under operator role on the storage.
You might skip it and use already existing account with minimal rights.
Do not use shell special characters like #!?|.*[]\{} in the password.
Cmd returns "Error code: 0x6000068" if you do not pass them.
Do not use directly /opt/emc/uemcli/bin/uemcli, use always /usr/bin/uemcli.
$ uemcli -d 192.168.1.1 -u Local/admin -p "XXXXXX" /user/account show
Storage system address: 192.168.1.1
Storage system port: 443
HTTPS connection
1: ID = user_admin
Name = admin
Role = administrator
Type = local
...
$ uemcli -d 192.168.1.1 -u Local/admin -p "XXXXXX" /user/account create -name stor2rrd -role operator -type local -passwd "Test2test_"
Storage system address: 192.168.1.1
Storage system port: 443
HTTPS connection
ID = user_stor2rrd
Operation completed successfully.
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 ➡ Dell EMC VNXe
-
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
=====================================
STORAGE: EMC-VNXe_alias01: VNXE
=====================================
connection ok
- Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)
$ crontab -l | grep load_vnxeperf.sh
$
Add if it does not exist as above
$ crontab -e
# EMC VNXe storage agent
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_vnxeperf.sh > /home/stor2rrd/stor2rrd/load_vnxeperf.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
Storage agent uses Data Domain CLI accessed via ssh to get all necessary data from the storage.
DataDomain firmware versions 5.5+ and 6.x are supported.
DataDomain firmware versions 7.x+ is supported since STOR2RRD v2.70.
DataDomain 6.0.2.50+ and 6.1.2.40+ (6.2 is not affected) do not provide disk stats
community.emc.com/docs/DOC-78887
Prerequisites
-
Allow access from the STOR2RRD host to the storage on port 22 (TCP).
Test if port is open:
$ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 22
Connection to "192.168.1.1" on port "22" is ok
- create user stor2rrd under user role on the storage.
- Exchange ssh keys
Print public key:
$ cat .ssh/id_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDPpQlm0Z/x1X4txd2GgZgvg1Fm7QHeusQ6LqBp/Sb1doAoiDmXErk+lNY27aJAqb4YiGnqejioqCJ9N93NiKpffxH+L3
Log on to the storage and add above key:
$ ssh <data domain host> -l stor2rrd
stor2rrd@data_domain_host> adminaccess add ssh-keys
Enter the key and then press Control-D, or press Control-C to cancel.
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDPpQlm0Z/x1X4txd2GgZgvg1Fm7QHeusQ6LqBp/Sb1doAoiDmXErk+lNY27aJAqb4YiGnqejioqCJ9N93NiKpffxH+L3
Test connection:
$ ssh <data domain host> -l stor2rrd
EMC Data Domain Virtual Edition
Welcome to Data Domain OS 6.1.0.11-571028
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 ➡ Dell EMC DataDomain
-
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 EMC-DataDomain01_alias01
=====================================
STORAGE: EMC-DataDomain01_alias01: DATADOMAIN
=====================================
connection ok
- Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)
$ crontab -l | grep load_datadomainperf.sh
$
Add if it does not exist as above
$ crontab -e
# EMC DataDomain storage agent
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_datadomainperf.sh > /home/stor2rrd/stor2rrd/load_datadomainperf.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
Isilon v7.x, v8.x and v9.x firmwares are supported.
When you use Isilon v9.x then just use one Management IP Address from the Cluster (do not use direct Node's IPs).
The product uses REST API interface natively provided by the storage to get all necessary data.
Support of Isilon 8.1.0.3+ firmware where was a major change in storage REST API is in STOR2RRD
2.30+.
Storage connectivity
STOR2RRD storage configuration
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
STOR2RRD uses REST API interface natively provided by the storage to get all necessary data.
All data is downloaded from VDC nodes.
Storage connectivity
-
Allow access from the STOR2RRD host to each VDC node on port 4443
$ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 4443
Connection to "192.168.1.1" on port "4443" is ok
- Create Storage Management user "stor2rrd" with System Monitor role on each monitored VDC.
STOR2RRD storage configuration