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
It is already implemented. It will be released in Sep 2020.
Anyone willing to test it? Contact us at support@stor2rrd.com.


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.