Install using the RPM file of the Fuel plugins catalog

To install the StackLight Collector Fuel plugin using the RPM file of the Fuel plugins catalog:

  1. Go to the Fuel plugins catalog.

  2. From the Filter drop-down menu, select the Mirantis OpenStack version you are using and the Monitoring category.

  3. Download the RPM file.

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

    [root@home ~]# scp lma_collector-0.10-0.10.2-1.noarch.rpm \
    root@<Fuel Master node IP address>:
    
  5. Install the plugin using the Fuel Plugins CLI:

    [root@fuel ~]# fuel plugins --install lma_collector-0.10-0.10.2-1.noarch.rpm
    
  6. Verify that the plugin is installed correctly:

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

Install from source

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

Note

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

To install the StackLight Collector Plugin from source, first 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 will not have to copy that file later on.

To prepare an environment and build the plugin:

  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. For instructions on how to build the Fuel Plugin Builder, see the Install Fuel Plugin Builder section of the Fuel Plugin SDK Guide.

  4. Clone the plugin repository:

    [root@home ~] git clone https://github.com/openstack/fuel-plugin-lma-collector.git
    
  5. Verify that the plugin is valid:

    [root@home ~] fpb --check ./fuel-plugin-lma-collector
    
  6. Build the plugin:

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

To install the plugin:

  1. Once you create the RPM file, install the plugin:

    [root@fuel ~] fuel plugins --install ./fuel-plugin-lma-collector/*.noarch.rpm
    
  2. Verify that the plugin is installed correctly:

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