Installation

Ceph storage 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
STOR2RRD collects data from Prometheus export module.
Integration was developped using Ceph version 14.2.9.
However, Ceph version 14.2.x (Nautilus) should be genrally supported.

Enable Prometheus export module

    Prometheus online docu
    [user@ceph-mgr]$ sudo ceph mgr module enable prometheus
    
    Enable access to Prometheus export module from LPAR2RRD appliance, by default module accepts HTTP requests on port 9283.
    Check connectivity:
    $ perl /home/stor2rrd/stor2rrd/bin/conntest.pl <CEPH MGR IP> 9283
      Connection to "<CEPH MGR IP>" on port "9283" is ok
    

STOR2RRD configuration

  • Create new storage in STOR2RRD
    Settings icon -> Storage -> New -> Vendor:device -> CEPH : Ceph

    Configure hostnames/IPs
    If you are using a load balancer translating hostname to an active manager node, then you can fill in only the load balanced hostname.
    Otherwise, fill in IP addresses/hostnames of all CEPH manager nodes which can host the Prometheus module.
    You cen get a list of manager nodes from "ceph -s" command.
    Storage management

    Storage management

  • Schedule to run storage agent from stor2rrd crontab (lpar2rrd on Virtual Appliance, it might already exist there)
    $ crontab -l | grep load_cephperf.sh
    $
    
    Add if it does not exist as above
    $ crontab -e
    
    # Ceph 
    0,5,10,15,20,25,30,35,40,45,50,55 * * * * /home/stor2rrd/stor2rrd/load_cephperf.sh > /home/stor2rrd/stor2rrd/load_cephperf.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.