Normalize the Readme file with other plugins
Change-Id: Ib4f46d952afe7643ed5c84279092037e40619d5f
This commit is contained in:
parent
98b352edbe
commit
9b6ddbeeb8
249
README.md
249
README.md
|
@ -4,216 +4,91 @@ Logging, Monitoring and Alerting (LMA) Infrastructure Alerting Plugin for Fuel
|
||||||
Overview
|
Overview
|
||||||
--------
|
--------
|
||||||
|
|
||||||
The `LMA Infrastructure Alerting` plugin is composed of several services
|
The `LMA Infrastructure Alerting Plugin` for Fuel is used to install and
|
||||||
running on a node (base-os role). It provides the alerting functionality for
|
configure Nagios™ which provides the alerting and escalation capabilities
|
||||||
the OpenStack Infrastructure inside the LMA toolchain.
|
of the LMA Toolchain. The LMA Infrastructure Alerting Plugin is
|
||||||
|
deployed by [Fuel](https://wiki.openstack.org/wiki/Fuel).
|
||||||
|
|
||||||
The LMA toolchain is currently composed of these Fuel plugins:
|
Please check the [LMA Infrastructure Alerting Plugin Overview](
|
||||||
|
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/overview.html)
|
||||||
* [LMA collector Plugin](https://github.com/openstack/fuel-plugin-lma-collector)
|
section of the plugin's documentation for additional details.
|
||||||
* [InfluxDB-Grafana Plugin](https://github.com/openstack/fuel-plugin-influxdb-grafana)
|
|
||||||
* [Elasticsearch-Kibana Plugin](https://github.com/openstack/fuel-plugin-elasticsearch-kibana)
|
|
||||||
|
|
||||||
Requirements
|
|
||||||
------------
|
|
||||||
|
|
||||||
| Requirement | Version/Comment |
|
|
||||||
| ----------------------------------------- | -----------------|
|
|
||||||
| Mirantis OpenStack compatility | 7.0 or higher |
|
|
||||||
| LMA Collector Fuel plugin | 0.8 or higher |
|
|
||||||
| InfluxDB-Grafana Fuel plugin (optional) | 0.8 or higher |
|
|
||||||
|
|
||||||
Recommendations
|
|
||||||
---------------
|
|
||||||
|
|
||||||
None.
|
|
||||||
|
|
||||||
Limitations
|
|
||||||
-----------
|
|
||||||
|
|
||||||
Adding and removing node to/from an environment won't reconfigure the Nagios
|
|
||||||
server.
|
|
||||||
This limitation is due to the missing ability of Fuel Plugin Framework to apply
|
|
||||||
plugin tasks (puppet apply) when these operations occur.
|
|
||||||
|
|
||||||
|
|
||||||
Installation Guide
|
|
||||||
==================
|
|
||||||
|
|
||||||
LMA Infrastructure Alerting Plugin install from the RPM file
|
|
||||||
------------------------------------------------------------
|
|
||||||
|
|
||||||
To install the LMA Infrastructure Alerting Plugin from the RPM file of the plugin, follow these steps:
|
|
||||||
|
|
||||||
1. Download the plugin from the [Fuel Plugins
|
|
||||||
Catalog](https://software.mirantis.com/download-mirantis-openstack-fuel-plug-ins/).
|
|
||||||
|
|
||||||
2. Copy the plugin file to the Fuel Master node. Follow the [Quick start
|
|
||||||
guide](https://software.mirantis.com/quick-start/) if you don't have a running
|
|
||||||
Fuel Master node yet.
|
|
||||||
|
|
||||||
```
|
|
||||||
scp lma_infrastructure_alerting-0.8-0.8.0-0.noarch.rpm root@<the Fuel Master node IP address>:
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Install the plugin using the `fuel` command line:
|
|
||||||
|
|
||||||
```
|
|
||||||
fuel plugins --install lma_infrastructure_alerting-0.8-0.8.0-0.noarch.rpm
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Verify that the plugin is installed correctly:
|
|
||||||
|
|
||||||
```
|
|
||||||
fuel plugins
|
|
||||||
```
|
|
||||||
|
|
||||||
LMA Infrastructure Alerting Plugin install from source
|
|
||||||
------------------------------------------------------
|
|
||||||
|
|
||||||
To install the LMA Infrastructure Alerting Plugin from source, you first need to prepare an
|
|
||||||
environement to build the RPM file of the plugin.
|
|
||||||
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.
|
|
||||||
|
|
||||||
**Prepare an environment for building the plugin on the Fuel Master Node**
|
|
||||||
|
|
||||||
* 1. Install the standard Linux development tools:
|
|
||||||
|
|
||||||
```
|
|
||||||
# yum install createrepo rpm rpm-build dpkg-devel
|
|
||||||
```
|
|
||||||
|
|
||||||
* 2. Install the Fuel Plugin Builder. To do that, you should first get pip:
|
|
||||||
|
|
||||||
```
|
|
||||||
# easy_install pip
|
|
||||||
```
|
|
||||||
|
|
||||||
* 3. Then install the Fuel Plugin Builder (the `fpb` command line) with `pip:
|
|
||||||
|
|
||||||
```
|
|
||||||
# pip install fuel-plugin-builder
|
|
||||||
```
|
|
||||||
|
|
||||||
*Note: You may also have 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](https://wiki.openstack.org/wiki/Fuel/Plugins) if you
|
|
||||||
need further instructions about how to build the Fuel Plugin Builder.*
|
|
||||||
|
|
||||||
* 4. Clone the LMA Infrastructure Alerting Plugin git repository:
|
|
||||||
|
|
||||||
```
|
|
||||||
# git clone git@github.com:openstack/fuel-plugin-lma-infrastructure-alerting.git
|
|
||||||
```
|
|
||||||
|
|
||||||
* 5. Check that the plugin is valid:
|
|
||||||
|
|
||||||
```
|
|
||||||
# fpb --check ./fuel-plugin-lma-infrastructure-alerting
|
|
||||||
```
|
|
||||||
|
|
||||||
* 6. And finally, build the plugin:
|
|
||||||
|
|
||||||
```
|
|
||||||
# fpb --build ./fuel-plugin-lma-infrastructure-alerting
|
|
||||||
```
|
|
||||||
|
|
||||||
* 7. Now you have created an RPM file that you can install using the steps described above:
|
|
||||||
|
|
||||||
```
|
|
||||||
# ls ./fuel-plugin-lma-infrastructure-alerting/lma_infrastructure_alerting-0.8-0.8.0-1.noarch.rpm
|
|
||||||
./fuel-plugin-lma-infrastructure-alerting/lma_infrastructure_alerting-0.8-0.8.0-1.noarch.rpm
|
|
||||||
```
|
|
||||||
|
|
||||||
User Guide
|
|
||||||
==========
|
|
||||||
|
|
||||||
**LMA-Infrastructure-Alerting** plugin configuration
|
|
||||||
----------------------------------------------------
|
|
||||||
|
|
||||||
1. Create a new environment with the Fuel UI wizard.
|
|
||||||
2. Click on the Settings tab of the Fuel web UI.
|
|
||||||
3. Scroll down the page, enable the "LMA Infrastructure Alerting Server plugin"
|
|
||||||
and fill-in the required fields.
|
|
||||||
- The password to access Nagios web interface.
|
|
||||||
- The recipient email address
|
|
||||||
- The sender email address
|
|
||||||
- The SMTP server IP and port
|
|
||||||
- Fill-in autentication parameters if enabled.
|
|
||||||
|
|
||||||
4. Add one node with the "Infrastructure Alerting" role.
|
|
||||||
|
|
||||||
### Disks partitioning
|
|
||||||
The plugin uses:
|
|
||||||
|
|
||||||
- 20% of the first disk for the operating system by honoring the range of
|
|
||||||
15GB minimum and 50GB maximum.
|
|
||||||
- 20GB for Nagios data and logs (/var/nagios).
|
|
||||||
- 10GB for /var/log.
|
|
||||||
|
|
||||||
It is recommended to review the partitioning done by Fuel before the deployment
|
|
||||||
and adapt it to your requirements.
|
|
||||||
|
|
||||||
Testing
|
|
||||||
-------
|
|
||||||
|
|
||||||
### Nagios
|
|
||||||
|
|
||||||
Once installed, you can check that Nagios is working by pointing your browser
|
|
||||||
to this URL:
|
|
||||||
|
|
||||||
```
|
|
||||||
http://<HOST>:8001
|
|
||||||
```
|
|
||||||
|
|
||||||
Where `HOST` is the IP address or the name of the node that runs the server.
|
|
||||||
|
|
||||||
You should be able to login using the username *nagiosadmin* and password
|
|
||||||
entered for the configuration of the plugin.
|
|
||||||
|
|
||||||
Known issues
|
|
||||||
------------
|
|
||||||
|
|
||||||
None.
|
|
||||||
|
|
||||||
Release Notes
|
Release Notes
|
||||||
-------------
|
-------------
|
||||||
|
|
||||||
**0.8.0**
|
The release notes for this plugin are provided in the
|
||||||
|
[Release Notes](
|
||||||
|
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/releases.html)
|
||||||
|
section of the plugin's documentation.
|
||||||
|
|
||||||
* Initial release of the plugin. This is a beta version.
|
Requirements
|
||||||
|
------------
|
||||||
|
|
||||||
|
The requirements for this plugin are provided in the
|
||||||
|
[Requirements](
|
||||||
|
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/overview.html#requirements)
|
||||||
|
section of the plugin's documentation.
|
||||||
|
|
||||||
Development
|
Known issues
|
||||||
===========
|
------------
|
||||||
|
|
||||||
The *OpenStack Development Mailing List* is the preferred way to communicate,
|
The known issues for this plugin are listed on [Launchpad](
|
||||||
emails should be sent to `openstack-dev@lists.openstack.org` with the subject
|
https://bugs.launchpad.net/lma-toolchain/+bugs?field.tag=nagios)
|
||||||
|
|
||||||
|
Limitations
|
||||||
|
-----------
|
||||||
|
|
||||||
|
The known limitations for this plugin are listed in the
|
||||||
|
[Limitations](
|
||||||
|
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/overview.html#limitations)
|
||||||
|
section of the plugin's documentation.
|
||||||
|
|
||||||
|
Installation
|
||||||
|
------------
|
||||||
|
|
||||||
|
The installation instructions for this plugin are provided in the
|
||||||
|
[Installation](
|
||||||
|
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/installation.html)
|
||||||
|
section of the plugin's documentation.
|
||||||
|
|
||||||
|
User Guide
|
||||||
|
----------
|
||||||
|
|
||||||
|
Instructions for how to configure and use the plugin are provided in the
|
||||||
|
[User Guide](
|
||||||
|
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/user.html)
|
||||||
|
section of the plugin's documentation.
|
||||||
|
|
||||||
|
Communication
|
||||||
|
-------------
|
||||||
|
|
||||||
|
The *OpenStack Development Mailing List* is the preferred way to communicate
|
||||||
|
with the members of the project.
|
||||||
|
Emails should be sent to `openstack-dev@lists.openstack.org` with the subject
|
||||||
prefixed by `[fuel][plugins][lma]`.
|
prefixed by `[fuel][plugins][lma]`.
|
||||||
|
|
||||||
Reporting Bugs
|
Reporting Bugs
|
||||||
--------------
|
--------------
|
||||||
|
|
||||||
Bugs should be filled on the [Launchpad fuel-plugins project](
|
Bugs should be filed against the [LMA Toolchain project](
|
||||||
https://bugs.launchpad.net/fuel-plugins) (not GitHub) with the tag `lma`.
|
https://launchpad.net/lma-toolchain) on Launchpad (not Github!).
|
||||||
|
|
||||||
|
|
||||||
Contributing
|
Contributing
|
||||||
------------
|
------------
|
||||||
|
|
||||||
If you would like to contribute to the development of this Fuel plugin you must
|
If you would like to contribute to the development of this plugin,
|
||||||
follow the [OpenStack development workflow](
|
you must follow the [OpenStack development workflow](
|
||||||
http://docs.openstack.org/infra/manual/developers.html#development-workflow).
|
http://docs.openstack.org/infra/manual/developers.html#development-workflow)
|
||||||
|
instructions.
|
||||||
|
|
||||||
Patch reviews take place on the [OpenStack gerrit](
|
Patch reviews take place on the [OpenStack Gerrit](
|
||||||
https://review.openstack.org/#/q/status:open+project:openstack/fuel-plugin-lma-infrastructure-alerting,n,z)
|
https://review.openstack.org/#/q/status:open+project:openstack/fuel-plugin-lma-infrastructure-alerting,n,z)
|
||||||
system.
|
system.
|
||||||
|
|
||||||
Contributors
|
Contributors
|
||||||
------------
|
------------
|
||||||
|
|
||||||
* Swann Croiset <scroiset@mirantis.com>
|
|
||||||
* Simon Pasquier <spasquier@mirantis.com>
|
|
||||||
* Guillaume Thouvenin <gthouvenin@mirantis.com>
|
* Guillaume Thouvenin <gthouvenin@mirantis.com>
|
||||||
|
* Patrick Petit <ppetit@mirantis.com>
|
||||||
|
* Simon Pasquier <spasquier@mirantis.com>
|
||||||
|
* Swann Croiset <scroiset@mirantis.com>
|
||||||
|
|
Loading…
Reference in New Issue