update documentation
Change-Id: I7c35dcc221b5629238a7311b4a8326a3a547243c
This commit is contained in:
parent
fe8470e7d7
commit
6ebf473f2f
12
README.md
12
README.md
|
@ -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
|
||||
|
||||
|
|
|
@ -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
|
||||
================================== ===============
|
||||
|
||||
|
|
|
@ -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 don’t 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 event’s
|
||||
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 hardware’s 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 don’t 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%
|
||||
|
||||
|
|
|
@ -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 |
Loading…
Reference in New Issue