Installation¶

Prior to installing the LMA Collector Plugin, you may want to install its dependencies:

Elasticsearch and Kibana for log analytics
InfluxDB and Grafana for metrics analytics
Nagios for alerting

To install them automatically you can refer to the:

You can install Elasticsearch/Kibana, InfluxDB/Grafana and Nagios outside of the Fuel Plugin framework as long as your installation meets the LMA Collector plugin’s requirements.

LMA Collector Fuel Plugin install using the RPM file of the Fuel Plugins Catalog¶

To install the LMA Collector Fuel Plugin using the RPM file of the Fuel Plugins Catalog, you need to follow these steps:

Download the RPM file from the Fuel Plugins Catalog.

Copy the RPM file to the Fuel Master node:

[root@home ~]# scp lma_collector-0.8-0.8.0-1.noarch.rpm \
root@<Fuel Master node IP address>:

Install the plugin using the Fuel CLI:

[root@fuel ~]# fuel plugins --install lma_collector-0.8-0.8.0-1.noarch.rpm

Verify that the plugin is installed correctly:

[root@fuel ~]# fuel plugins --list
id | name                 | version | package_version
---|----------------------|---------|----------------
1  | lma_collector        | 0.8.0   | 2.0.0

LMA Collector Fuel Plugin install 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, modify some built-in configuration or implement your own customization. But note that running a Fuel plugin that you have built yourself is at your own risk.

To install LMA Collector Plugin from source, you first need to prepare an environement 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.

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

Install the standard Linux development tools:

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

Install the Fuel Plugin Builder. To do that, you should first get pip:
```
[root@home ~] easy_install pip
```
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 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.

Clone the plugin git repository:

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

Check that the plugin is valid:

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

And finally, build the plugin:

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

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-lma_collector/*.noarch.rpm
```