DataCore SANsymphony installation

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/ 80
      Connection to "" 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

  • When you configure all and you see big data gaps in graphs then you have to adjust RequestExpirationTime especially on DataCore SANsymphony 10, PSP 11, Update 1 and newer.
    Open "C:\Program Files\DataCore\Rest\Web.config" file and chang the sixth line:
    From: <add key="RequestExpirationTime" value="30"/>
    To: <add key="RequestExpirationTime" value="1800"/>
    You do not have to restart the DataCore node

STOR2RRD storage configuration

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

  • STOR2RRD v2.60+:
    Add storage into configuration from the UI:
    Settings icon ➡ Storage ➡ New ➡ Vendor:device ➡ DataCore
    Storage management

  • STOR2RRD v2.50 and olders:
    • 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/
      Above shows the storage with IP, available through REST API proxy running on, which will be visible in the UI 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:
      $ cd /home/stor2rrd/stor2rrd
      $ perl bin/ 
        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:
    • 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/ 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
    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/ > /home/stor2rrd/stor2rrd/load_datacoreperf.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 must be there)
    5 * * * * /home/stor2rrd/stor2rrd/ > /home/stor2rrd/stor2rrd/load.out 2>&1
  • Let run the storage agent for 15 - 20 minutes to get data, then:
    $ cd /home/stor2rrd/stor2rrd
    $ ./
  • Go to the web UI: http://<your web server>/stor2rrd/
    Use Ctrl-F5 to refresh the web browser cache.