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
|
||||
--------
|
||||
|
||||
The `LMA Infrastructure Alerting` plugin is composed of several services
|
||||
running on a node (base-os role). It provides the alerting functionality for
|
||||
the OpenStack Infrastructure inside the LMA toolchain.
|
||||
The `LMA Infrastructure Alerting Plugin` for Fuel is used to install and
|
||||
configure Nagios™ which provides the alerting and escalation capabilities
|
||||
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:
|
||||
|
||||
* [LMA collector Plugin](https://github.com/openstack/fuel-plugin-lma-collector)
|
||||
* [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.
|
||||
Please check the [LMA Infrastructure Alerting Plugin Overview](
|
||||
http://fuel-plugin-lma-infrastructure-alerting.readthedocs.org/en/latest/overview.html)
|
||||
section of the plugin's documentation for additional details.
|
||||
|
||||
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,
|
||||
emails should be sent to `openstack-dev@lists.openstack.org` with the subject
|
||||
The known issues for this plugin are listed on [Launchpad](
|
||||
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]`.
|
||||
|
||||
Reporting Bugs
|
||||
--------------
|
||||
|
||||
Bugs should be filled on the [Launchpad fuel-plugins project](
|
||||
https://bugs.launchpad.net/fuel-plugins) (not GitHub) with the tag `lma`.
|
||||
|
||||
Bugs should be filed against the [LMA Toolchain project](
|
||||
https://launchpad.net/lma-toolchain) on Launchpad (not Github!).
|
||||
|
||||
Contributing
|
||||
------------
|
||||
|
||||
If you would like to contribute to the development of this Fuel plugin you must
|
||||
follow the [OpenStack development workflow](
|
||||
http://docs.openstack.org/infra/manual/developers.html#development-workflow).
|
||||
If you would like to contribute to the development of this plugin,
|
||||
you must follow the [OpenStack 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)
|
||||
system.
|
||||
|
||||
Contributors
|
||||
------------
|
||||
|
||||
* Swann Croiset <scroiset@mirantis.com>
|
||||
* Simon Pasquier <spasquier@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