Oracle ZFS monitoring

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 Oracle ZFS REST API interface natively provided by the storage to get all necessary data.
Note that very old firmwares like 2013.06.05.3.0,1-1.14 are not supported.

Oracle ZFS Storage is collecting only a limited set of storage metrics by default.
STOR2RRD needs to create additional datasets necessary to get more detailed performance data from the storage.
Datasets are grouped into several Worksheets named STOR2RRD_*, all are created automatically during the first run.
Worksheets and datasets used by STOR2RRD

Storage connectivity

• Allow access from the STOR2RRD host to the Oracle ZFS storage on port 215 on both storage controllers (nodes)
  

  $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl 192.168.1.1 215
    Connection to "192.168.1.1" on port "215" is ok
  

• Create user "stor2rrd" with Analytics create and access role on ZFS Storage nodes
  • Login to ZFS management GUI
  • Go to Configuration -> Users
  • Add new role
    • Name: "STOR2RRD"
    • Description: "STOR2RRD Monitoring"
    • Scope: "Analytics"
    • List of drilldowns: "*"
    • Select: create and read
      
    
    
  • Create user
    • Type: "local"
    • Username: "stor2rrd"
    • User ID: any
    • Full Name: "STOR2RRD Monitoring"
    • Password: any
    • Leave "Kiosk" and "session annotation" options unchecked.
    • Select "STOR2RRD" role for the user
      

STOR2RRD storage configuration

• Add storage into configuration from the UI:
  Settings icon ➡ Storage ➡ New ➡ Vendor:device ➡ Oracle ZFS
  
  
• 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
  

• Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)

  $ crontab -l | grep load_oraclezfsperf.sh
  $
  

  Add if it does not exist as above

  $ crontab -e
  
  # Oracle ZFS agent
  0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_oraclezfsperf.sh > /home/stor2rrd/stor2rrd/load_oraclezfsperf.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.