Free SAN and storage performance and capacity monitoring

DataCore SANsymphony 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 DataCore REST API package to get all necessary data.

Storage connectivity

  • You can use 2 ways of setup. DataCore REST API is installed
    1. on the proxy Windows machine
    2. on a node of the storage

  • Download and install Datacore REST API on whatever Windows Server 2012+ or DataCore node.
    You can download it from DataCore download page.
    Installation requires Windows reboot.
    Use REST API 1.07 for DataCore 10.0 PSP7 and newer.
    Use REST API 1.06 for olders.

  • Storage provide data through HTTP (port 80) by default.
    You might change that to HTTPS as per following vendor manual.

  • Allow access from the STOR2RRD host to the storage on port 80 (http), use 443 in case of HTTPS.
    If you use REST API on the Windows proxy machine then use IP of that Windows.
    $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 80
      Connection to "192.168.1.1" on port "80" is ok
    
  • Create user stor2rrd in Windows hosted server on 1 DataCore node
    DataCore SANsymphony Windows user

  • Assign that user on the storage role View
    DataCore SANsymphony storage user


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
    
    #
    # DataCore Storage
    #
    # Storage Alias:DATACORE:Node IP/hostname:Proxy REST API IP/hostname (leave blank if not used):[http|https]:storage user:encrypted password:VOLUME_AGG_DATA_LIM:VOLUME_AGG_IO_LIM:SAMPLE_RATE_MINS
    # to encrypt password use: perl ./bin/spasswd.pl
    #datacore-alias01:DATACORE:datacore_node.example.com:datacore_proxy_rest-api.example.com:http:stor2rrd:KT4mXVI9N0BUPjZdVQo=:1024:10:
    #datacore-alias01:DATACORE:datacore_node.example.com::http:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    
    datacore-alias01:DATACORE:192.168.1.1:192.168.1.2:http:stor2rrd:KT4mXVI9N0BUPjZdVQo=
    
    Above shows the storage with IP 192.168.1.1, available through REST API proxy running on 192.168.1.2, which will be visible in the GUI as datacore-alias01
    If REST API is running directly on the storage node then leave proxy field empty.

    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 datacore-alias01
      =====================
      STORAGE: datacore-alias01 : DATACORE
      =====================
      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_datacoreperf.sh
    $
    
    Add if it does not exist as above
    $ crontab -e
    
    # DataCore agent
    0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_datacoreperf.sh > /home/stor2rrd/stor2rrd/load_datacoreperf.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.