Free SAN and storage performance and capacity monitoring

Pure Storage installation

Back to storage installation home.


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.

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 in read-only group .
    You have to create stor2rrd user in Active Directory as there cannot be created new users on the storage and then map it to read-only group on the storage.
    You might even use pureuser which is available on the storage locally, but it has admin rights.
    Integrating Active Directory with the Pure Storage FlashArray.

STOR2RRD storage configuration

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

  • Uncomment (remove the hash) example line and adjust it: 
    $ vi /home/stor2rrd/stor2rrd/etc/storage-list.cfg

#
# Pure Storage
#
# Storage Alias:PURE: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
#purestorage-alias01:PURE:pure_host.example.com:stor2rrd:KT4mXVI9N0BUPjZdVQo=:1024:10:
#purestorage-alias01:PURE:pure_host.example.com:stor2rrd:KT4mXVI9N0BUPjZdVQo=

purestorage-alias01:PURE:192.168.1.1:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    Above shows the storage with IP 192.168.1.1 which will be visible in the GUI as purestorage-alias01

    Use encrypted password in storage line above, encrypt it like this:
    $ 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 purestorage-alias01
  =====================
  STORAGE: purestorage-alias01 : PURE
  =====================
  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_pureperf.sh
$
    Add if it does not exist as above 
    $ crontab -e

# Pure Storage agent
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_pureperf.sh > /home/stor2rrd/stor2rrd/load_pureperf.out 2>&1
    Assure there is already an entry with the GUI creation running once an hour in crontab 
    $ crontab -e

# STOR2RRD GUI (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 GUI: 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
It is already implemented. It will be released in Q3 2018.
Anyone willing to test it? Contact us at support@stor2rrd.com.

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

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 in read-only group .

  • Generate an API Token on the storage:
    Generate an API token through the Purity GUI (System > Users > Create API Token) or through the CLI : 
    pureadmin create --api-token
  T-e7e551be-fe5d-4669-baf5-670cd8ea0560
    Do not set an expiration period when creating API token!
    Use the key in storage configuration below.

STOR2RRD storage configuration

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

  • Uncomment (remove the hash) example line and adjust it: 
    $ vi /home/stor2rrd/stor2rrd/etc/storage-list.cfg

#
# Pure Storage FlashBlade
#
# Storage Alias:PUREBLADE:IP or hostname:API token:VOLUME_AGG_DATA_LIM:VOLUME_AGG_IO_LIM:SAMPLE_RATE_MINS
#purestorageblade-alias01:PUREBLADE:pureblade_host.example.com:T-e7e551be-fe5d-4669-baf5-670cd8ea0560:1024:10:
#purestorageblade-alias01:PUREBLADE:pureblade_host.example.com:T-e7e551be-fe5d-4669-baf5-670cd8ea0560

purestorageblade-alias01:PUREBLADE:192.168.1.1:T-e7e551be-fe5d-4669-baf5-670cd8ea0560
    Above shows the storage with IP 192.168.1.1 which will be visible in the GUI as purestorage-alias01

  • 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 purestorage-alias01
  =====================
  STORAGE: purestorageblade-alias01 : PUREBLADE
  =====================
  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_purebladeperf.sh
$
    Add if it does not exist as above 
    $ crontab -e

# Pure Storage FlashBlade
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_purebladeperf.sh > /home/stor2rrd/stor2rrd/load_purebladeperf.out 2>&1
    Assure there is already an entry with the GUI creation running once an hour in crontab 
    $ crontab -e

# STOR2RRD GUI (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 GUI: http://<your web server>/stor2rrd/
    Use Ctrl-F5 to refresh the web browser cache.