update documentation

Change-Id: I7c35dcc221b5629238a7311b4a8326a3a547243c
This commit is contained in:
Piotr Misiak 2015-08-13 16:07:41 +02:00
parent fe8470e7d7
commit 6ebf473f2f
5 changed files with 43 additions and 24 deletions

View File

@ -16,8 +16,8 @@ Requirements
| Requirement | Version/Comment |
|:-----------------------------------|:----------------|
| Mirantis OpenStack compatibility | 6.1 |
| Zabbix plugin for Fuel | 1.0.0 |
| Mirantis OpenStack compatibility | 7.0 |
| Zabbix plugin for Fuel | 2.0.0 |
| SNMP trap daemon for Zabbix plugin | 1.0.0 |
Installation Guide
@ -42,19 +42,21 @@ follow these steps:
that. If you do not have the Fuel Master node yet, see
[Quick Start Guide](https://software.mirantis.com/quick-start/) :
# scp zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm root@<Fuel_Master_ip>:/tmp
# scp zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm \
root@<Fuel_Master_ip>:/tmp
5. Install the plugin:
# cd /tmp
# fuel plugins --install zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm
# fuel plugins --install \
zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm
6. Check if the plugin was installed successfully:
# fuel plugins
id | name | version | package_version
---|------------------------------------|---------|----------------
1 | zabbix_monitoring | 1.0.0 | 2.0.0
1 | zabbix_monitoring | 2.0.0 | 3.0.0
2 | zabbix_snmptrapd | 1.0.0 | 2.0.0
3 | zabbix_monitoring_extreme_networks | 1.0.0 | 2.0.0

View File

@ -4,9 +4,9 @@ Extreme Networks hardware monitoring extension for Zabbix plugin
Extreme Networks hardware monitoring extension plugin extends Zabbix plugin
functionality by adding monitoring of incoming SNMP traps sent from Extreme
Networks hardware via management network to management VIP address. For more
Networks hardware via management network to Zabbix VIP address. For more
information about networks, see the `Logical Networks <https://docs.mirantis
.com/openstack/fuel/fuel-6.1/reference-architecture.html#logical-networks>`_
.com/openstack/fuel/fuel-7.0/reference-architecture.html#logical-networks>`_
section of MOS documentation. The plugin configures snmptt to parse and pass
Extreme Networks specific traps to Zabbix. It also configures Zabbix by adding
Template with appropriate items and triggers and by creating Hosts for each
@ -18,8 +18,8 @@ Requirements
================================== ===============
Requirement Version/Comment
================================== ===============
Fuel 6.1
Zabbix plugin for Fuel 1.0.0
Fuel 7.0
Zabbix plugin for Fuel 2.0.0
SNMP trap daemon for Zabbix plugin 1.0.0
================================== ===============

View File

@ -7,18 +7,20 @@ Environment configuration
1. Create an environment. For more information about environment creation, see
`Mirantis OpenStack User Guide <http://docs.mirantis.com/openstack/fuel
/fuel-6.1/user-guide.html#create-a-new-openstack-environment>`_.
/fuel-7.0/user-guide.html#create-a-new-openstack-environment>`_.
2. Enable and configure Zabbix plugin for Fuel. For instructions, see Zabbix
Plugin Guide in the `Fuel Plugins Catalog <https://www.mirantis.com
/products/openstack-drivers-and-plugins/fuel-plugins/>`_.
3. Enable and configure SNMP trap daemon for Zabbix plugin. For instructions,
see Zabbix Plugin Guide in the `Fuel Plugins Catalog <https://www.mirantis
.com/products/openstack-drivers-and-plugins/fuel-plugins/>`_.
4. Open *Settings* tab of the Fuel web UI and scroll the page down. Select the
plugin checkbox and optionally fill in *Extreme Networks hardware to
monitor* parameter:
4. Open *Settings* tab of the Fuel web UI and scroll the page down. On the left
choose *Extreme Networks hardware monitoring extension for Zabbix plugin*,
select the plugin checkbox and optionally fill in *Extreme Networks hardware
to monitor* parameter:
.. image:: images/settings.png
:width: 100%
When you add your hardware to the *Extreme Networks hardware to monitor*
comma separated list, then the plugin will automatically configure
@ -32,7 +34,7 @@ Environment configuration
5. Adjust other environment settings to your requirements and deploy the
environment. For more information, see
`Mirantis OpenStack User Guide <http://docs.mirantis.com/openstack/fuel
/fuel-6.1/user-guide.html#create-a-new-openstack-environment>`_.
/fuel-7.0/user-guide.html#create-a-new-openstack-environment>`_.
User Guide
==========
@ -42,7 +44,10 @@ To test if everything is configured properly, follow these steps:
1. Generate an example SNMP trap by running the following command from any
node::
[root@node-46 ~]# snmptrap -v 1 -c <SNMP_community> <management_VIP_address> '.1.3.6.1.4.1.1916' <host_ip_address> 6 10 '10' .1.3.6.1.4.1.1916 s "null" .1.3.6.1.4.1.1916 s "null" .1.3.6.1.4.1.1916 s "2"
[root@node-46 ~]# snmptrap -v 1 -c <SNMP_community> \
<zabbix_VIP_address> '.1.3.6.1.4.1.1916' <host_ip_address> 6 10 '10' \
.1.3.6.1.4.1.1916 s "null" .1.3.6.1.4.1.1916 s "null" \
.1.3.6.1.4.1.1916 s "2"
where:
@ -51,16 +56,19 @@ To test if everything is configured properly, follow these steps:
It is set in the SNMP trap daemon for Zabbix plugin Settings in Fuel UI:
.. image:: images/snmptrapd_settings.png
:width: 100%
*<management_VIP_address>*
*<zabbix_VIP_address>*
If you dont know the address, run the following command on any node::
[root@node-46 ~]# grep management_vip /etc/astute.yaml
[root@node-46 ~]# grep -A2 ^zabbix_vip_management /etc/astute.yaml
You should get the required VIP in the output::
management_vip: 192.168.0.1
zabbix_vip_management:
network_role: zabbix
ipaddr: 192.168.0.1
*<host_IP_address>*
@ -75,17 +83,20 @@ To test if everything is configured properly, follow these steps:
openstack-drivers-and-plugins/fuel-plugins/>`_):
.. image:: images/issues.png
:width: 100%
When you click on a date in the *Last change* column of one of the issues,
you will see the **Events** page with list of events with the same type:
.. image:: images/events.png
:width: 100%
To see a full description of the event, you have to click on events
description and choose *History*, then you will see a **History** page with
a full event description:
.. image:: images/history.png
:width: 100%
3. After clicking *Configuration* tab and selecting *Hosts* option, you will
see a list of hosts with linked monitoring templates. There should be one
@ -93,6 +104,7 @@ To test if everything is configured properly, follow these steps:
plugin parameter:
.. image:: images/hosts.png
:width: 100%
Hardware setup
==============
@ -101,18 +113,21 @@ You have to configure your hardware to enable SNMP traps sending. To do this,
refer to your hardwares manual. Generally, you have to set these two
parameters on your hardware:
1. SNMP manager - set to management VIP address of your environment
1. SNMP manager - set to Zabbix VIP address of your environment
If you dont know the address, run the following command on any node::
[root@node-46 ~]# grep management_vip /etc/astute.yaml
[root@node-46 ~]# grep -A2 ^zabbix_vip_management /etc/astute.yaml
You should get the required VIP in the output::
management_vip: 192.168.0.1
zabbix_vip_management:
network_role: zabbix
ipaddr: 192.168.0.1
2. SNMP community - set the same value as in the *SNMP community* parameter
from the SNMP trap daemon for Zabbix plugin settings:
.. image:: images/snmptrapd_settings.png
:width: 100%

View File

@ -21,19 +21,21 @@ follow these steps:
that. If you do not have the Fuel Master node yet, see `Quick Start Guide
<https://software.mirantis.com/quick-start/>`_::
# scp zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm root@<The_Fuel_Master_node_IP>:/tmp
# scp zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm \
root@<The_Fuel_Master_node_IP>:/tmp
5. Log into the Fuel Master node. Install the plugin::
# cd /tmp
# fuel plugins --install zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm
# fuel plugins --install \
zabbix_monitoring_extreme_networks-1.0-1.0.0-1.noarch.rpm
6. Check if the plugin was installed successfully::
# fuel plugins
id | name | version | package_version
---|------------------------------------|----------|----------------
1 | zabbix_monitoring | 1.0.0 | 2.0.0
1 | zabbix_monitoring | 2.0.0 | 3.0.0
2 | zabbix_snmptrapd | 1.0.0 | 2.0.0
3 | zabbix_monitoring_extreme_networks | 1.0.0 | 2.0.0

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 16 KiB