fuel-plugin-influxdb-grafana/doc/source/installation.rst

Installation Guide

InfluxDB-Grafana Fuel Plugin installation using the RPM file of the Fuel Plugins Catalog

To install the StackLight InfluxDB-Grafana Fuel Plugin using the RPM file of the Fuel Plugins Catalog, you need to follow these steps:

1. Select, using the MONITORING category and the Mirantis OpenStack version you are using, the RPM file you want to download from the Fuel Plugins Catalog.

2. Copy the RPM file to the Fuel Master node:

   [root@home ~]# scp influxdb_grafana-0.10-0.10.0-1.noarch.rpm \
   root@<Fuel Master node IP address>:

3. Install the plugin using the Fuel CLI:

   [root@fuel ~]# fuel plugins --install influxdb_grafana-0.10-0.10.0-1.noarch.rpm

4. Verify that the plugin is installed correctly:

   [root@fuel ~]# fuel plugins --list
   id | name                 | version  | package_version
   ---|----------------------|----------|----------------
   1  | influxdb_grafana     | 0.10.0   | 4.0.0

StackLight InfluxDB-Grafana Fuel Plugin installtion from source

Alternatively, you may want to build the RPM file of the plugin from source if, for example, you want to test the latest features of the master branch or customize the plugin.

Note

Be aware that running a Fuel plugin that you built yourself is at your own risk and will not be supported.

To install the StackLight InfluxDB-Grafana Plugin from source, you first need to prepare an environment to build the RPM file. The recommended approach is to build the RPM file directly onto the Fuel Master node so that you won't have to copy that file later on.

Preparing an environment for building the plugin on the Fuel Master Node

1. Install the standard Linux development tools:

   [root@home ~] yum install createrepo rpm rpm-build dpkg-devel

2. Install the Fuel Plugin Builder. To do that, you should first get pip:

   [root@home ~] easy_install pip

3. Then install the Fuel Plugin Builder (the fpb command line) with `pip`:

   [root@home ~] pip install fuel-plugin-builder

   Note

   You may also need to build the Fuel Plugin Builder if the package version of the plugin is higher than the package version supported by the Fuel Plugin Builder you get from pypi. In this case, please refer to the section "Preparing an environment for plugin development" of the Fuel Plugins wiki if you need further instructions about how to build the Fuel Plugin Builder.

4. Clone the plugin git repository:

   [root@home ~] git clone https://github.com/openstack/fuel-plugin-influxdb-grafana.git

5. Check that the plugin is valid:

   [root@home ~] fpb --check ./fuel-plugin-influxdb-grafana

6. And finally, build the plugin:

   [root@home ~] fpb --build ./fuel-plugin-influxdb-grafana

7. Now that you have created the RPM file, you can install the plugin using the fuel plugins --install command:

   [root@fuel ~] fuel plugins --install ./fuel-plugin-influxdb-grafana/*.noarch.rpm

StackLight InfluxDB-Grafana Fuel plugin software components

Components	Version
InfluxDB	v0.11.1 for Ubuntu (64-bit)
Grafana	v3.0.4 for Ubuntu (64-bit)