Update doc
This commit is contained in:
Quentin Garnier
parent
1b33d4ad59
commit
ea4183f63f
|
|
@ -10,7 +10,7 @@ Centreon-esxd is a Perl program in charged to get back VMWare indicators. This p
|
|||
By default "centreon-esxd" starts at least two processes (named "handle-client" and "handle-vsphere-xxxx") :
|
||||
|
||||
*« handle-client »*:
|
||||
*Process waiting for requests of "centron-esx-client.pl" clients.*
|
||||
*Process waiting for requests of clients.*
|
||||
|
||||
Steps of operation :
|
||||
|
||||
|
|
@ -38,7 +38,8 @@ The "centreon-esxd" program only works in "daemon" mode (a client is needed).
|
|||
Connector configuration
|
||||
-----------------------
|
||||
|
||||
The « centreon-esxd » daemon is configured with the « centreon_esxd.pm » configuration file ::
|
||||
The « centreon-esxd » daemon is configured with the « centreon_esxd.pm » configuration file:
|
||||
::
|
||||
|
||||
%centreonesxd_config = (
|
||||
vsphere_server => {
|
||||
|
|
@ -49,7 +50,8 @@ The « centreon-esxd » daemon is configured with the « centreon_esxd.pm »
|
|||
);
|
||||
|
||||
« vsphere_server » attribute configures VirtualCenter access.
|
||||
In case you have many VirtualCenters, the configuration is (note the use of "," as a separator) ::
|
||||
In case you have many VirtualCenters, the configuration is (note the use of "," as a separator):
|
||||
::
|
||||
|
||||
%centreonesxd_config = (
|
||||
vsphere_server => {
|
||||
|
|
@ -67,7 +69,8 @@ In case you have many VirtualCenters, the configuration is (note the use of ","
|
|||
Troubleshooting
|
||||
---------------
|
||||
|
||||
It is possible to get this kind of errors in the « logs » of « centreon-esxd » ::
|
||||
It is possible to get this kind of errors in the « logs » of « centreon-esxd »:
|
||||
::
|
||||
|
||||
...SOAP request error - possibly a protocol issue: read failed: error:1408F119:SSL routines:SSL3_GET_RECORD:decryption failed or bad record mac...
|
||||
|
||||
|
|
|
|||
|
|
@ -8,25 +8,29 @@ Prerequisites
|
|||
Software Recommandations
|
||||
````````````````````````
|
||||
|
||||
The "centreon-esxd" connector has been tested on red-hat 5 and 6 with rpms.
|
||||
The "centreon-esxd" connector has been only tested on red-hat 6 with rpms.
|
||||
Installation on other system is possible but is outside the scope of this document (Debian,...).
|
||||
|
||||
==================== =====================
|
||||
====================== =====================
|
||||
Software Version
|
||||
==================== =====================
|
||||
VMWare SDK Perl 5.1
|
||||
====================== =====================
|
||||
VMWare SDK Perl 5.1.0-780721
|
||||
Perl 5.8
|
||||
centreon-esxd 1.4
|
||||
centreon-common-perl 2.5
|
||||
==================== =====================
|
||||
centreon-esxd 1.6.0
|
||||
perl-centreon-base 2.5.0
|
||||
centreon-plugins-base 1.10
|
||||
ZeroMQ 3.x
|
||||
Perl ZMQ::LibZMQ3 1.19
|
||||
Perl ZMQ::Constants 1.04
|
||||
====================== =====================
|
||||
|
||||
.. warning::
|
||||
The "centreon-esxd" RPMS provided by Merethis is designed to work with Centreon 2.5 (CES 2.2 or CES 3), it does not work with Centreon 2.4.
|
||||
The "centreon-esxd" RPMS provided by Merethis is designed to work with Centreon 2.5 (CES 3), it does not work with Centreon 2.4.
|
||||
|
||||
Hardware Recommandations
|
||||
````````````````````````
|
||||
|
||||
Hardware prerequisites will depend of check numbers. Minimal used ressources are :
|
||||
Hardware prerequisites will depend of check numbers. Minimal used resources are :
|
||||
|
||||
* RAM : 512 Mo (May slightly increase with the number of checks).
|
||||
* CPU : same as poller server.
|
||||
|
|
@ -34,61 +38,7 @@ Hardware prerequisites will depend of check numbers. Minimal used ressources are
|
|||
Centreon-esxd Installation - centos/rhel 5 systems
|
||||
==================================================
|
||||
|
||||
SDK Perl VMWare Installation
|
||||
````````````````````````````
|
||||
|
||||
The "centreon-esxd" connector uses SDK Perl VMWare for its operation. So we install it with VMWare recommandation (only tested with version below).
|
||||
|
||||
======================= ===================== ======================
|
||||
Dependency Version Repository
|
||||
======================= ===================== ======================
|
||||
perl-libwww-perl 5.805 redhat/centos base
|
||||
perl-XML-LibXML 1.58 redhat/centos base
|
||||
perl-Class-MethodMaker 2.18 ces base
|
||||
perl-Crypt-SSLeay 0.51 redhat/centos base
|
||||
perl-SOAP-Lite 0.712 ces base
|
||||
perl-UUID 0.04 ces base
|
||||
perl-VMware-vSphere 5.1.0-780721.1 centreon plugin-packs
|
||||
======================= ===================== ======================
|
||||
|
||||
Install following dependency::
|
||||
|
||||
root # yum install perl-VMware-vSphere
|
||||
|
||||
Requirements
|
||||
```````````````````````````````
|
||||
|
||||
« perl-centreon-base » is a prerequisite for « centreon_esxd ». (Module in Centreon 2.5)
|
||||
|
||||
centreon-esxd Installation with rpm
|
||||
```````````````````````````````````
|
||||
|
||||
Install the connector::
|
||||
|
||||
root # yum install ces-plugins-Virtualization-VMWare
|
||||
|
||||
centreon-esxd Installation with source
|
||||
``````````````````````````````````````
|
||||
|
||||
Download « centreon-esxd » archive, then install ::
|
||||
|
||||
root # tar zxvf centreon-esxd-1.5.4.tar.gz
|
||||
root # cd centreon-esxd-1.5.4
|
||||
root # cp centreon_esxd /usr/bin/
|
||||
|
||||
root # mkdir -p /etc/centreon
|
||||
root # cp centreon_esxd-conf.pm /etc/centreon/centreon_esxd.pm
|
||||
root # cp centreon_esxd-init /etc/init.d/centreon_esxd
|
||||
|
||||
root # mkdir -p /usr/lib/perl5/vendor_perl/5.8.8/centreon/esxd/
|
||||
root # cp lib/* /usr/lib/perl5/vendor_perl/5.8.8/centreon/esxd/
|
||||
root # cp centreonesxd.pm /usr/lib/perl5/vendor_perl/5.8.8/centreon/script/
|
||||
|
||||
Configure "centreon-esxd" daemon to start at boot ::
|
||||
|
||||
root # chkconfig --level 2345 centreon_esxd on
|
||||
|
||||
*"centreon_esx_client.pl" is the corresponding nagios plugin.*
|
||||
Not tested on centos/rhel 5. There is a problem with Perl ZMQ::LibZMQ3 module.
|
||||
|
||||
Centreon-esxd Installation - centos/rhel 6 systems
|
||||
==================================================
|
||||
|
|
@ -110,29 +60,41 @@ perl-UUID 0.04 centreon plugin-packs
|
|||
perl-VMware-vSphere 5.1.0-780721.1 centreon plugin-packs
|
||||
======================= ===================== ======================
|
||||
|
||||
Install following dependency::
|
||||
Install following dependency:
|
||||
::
|
||||
|
||||
root # yum install perl-VMware-vSphere
|
||||
|
||||
Requirements
|
||||
```````````````````````````````
|
||||
|
||||
« perl-centreon-base » is a prerequisite for « centreon_esxd ». (Module in Centreon 2.5)
|
||||
Following prerequisites are mandatory for « centreon_esxd »:
|
||||
|
||||
* « perl-centreon-base »: module since Centreon 2.5 (repository ces standard)
|
||||
* « centreon-plugins-base »: in repository centreon plugin-packs
|
||||
* « zeromq » and Perl binding: in repository ces standard or EPEL
|
||||
|
||||
centreon-esxd Installation with rpm
|
||||
```````````````````````````````````
|
||||
|
||||
Install the connector::
|
||||
Install the connector:
|
||||
::
|
||||
|
||||
root # yum install ces-plugins-Virtualization-VMWare
|
||||
|
||||
Install the client:
|
||||
::
|
||||
|
||||
root # yum install ces-plugins-Virtualization-VMWare-client
|
||||
|
||||
centreon-esxd Installation with source
|
||||
``````````````````````````````````````
|
||||
|
||||
Download « centreon-esxd » archive, then install ::
|
||||
Download « centreon-esxd » archive, then install:
|
||||
::
|
||||
|
||||
root # tar zxvf centreon-esxd-1.5.4.tar.gz
|
||||
root # cd centreon-esxd-1.5.4
|
||||
root # tar zxvf centreon-esxd-1.6.0.tar.gz
|
||||
root # cd centreon-esxd-1.6.0
|
||||
root # cp centreon_esxd /usr/bin/
|
||||
|
||||
root # mkdir -p /etc/centreon
|
||||
|
|
@ -140,11 +102,21 @@ Download « centreon-esxd » archive, then install ::
|
|||
root # cp centreon_esxd-init /etc/init.d/centreon_esxd
|
||||
|
||||
root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp lib/* /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/
|
||||
root # cp centreon/esxd/* /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp centreon/script/centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/
|
||||
|
||||
Configure "centreon-esxd" daemon to start at boot ::
|
||||
Configure "centreon-esxd" daemon to start at boot:
|
||||
::
|
||||
|
||||
root # chkconfig --level 2345 centreon_esxd on
|
||||
|
||||
*"centreon_esx_client.pl" is the corresponding nagios plugin.*
|
||||
Install the client:
|
||||
::
|
||||
|
||||
root # git clone http://git.centreon.com/centreon-plugins.git
|
||||
root # cd centreon-plugins
|
||||
root # mkdir -p /usr/lib/nagios/plugins/centreon/plugins/
|
||||
root # cp centreon/plugins/* /usr/lib/nagios/plugins/centreon/plugins/
|
||||
root # mkdir -p /usr/lib/nagios/plugins/apps/vmware/
|
||||
root # cp -R apps/vmware/* /usr/lib/nagios/plugins/apps/vmware/
|
||||
root # cp centreon_plugins.pl /usr/lib/nagios/plugins/
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ Centreon-esxd est un programme Perl chargé de récupérer des indicateurs VMWar
|
|||
Par défaut, « centreon-esxd » lance au moins deux processus (nommé respectivement « handle-client », « handle-vsphere-xxxx ») :
|
||||
|
||||
*« handle-client »*:
|
||||
*Processus en attente des demandes des clients « centreon_esx_client.pl ».*
|
||||
*Processus en attente des demandes clientes.*
|
||||
|
||||
Voici le fonctionnement :
|
||||
|
||||
|
|
@ -39,7 +39,8 @@ Le programme « centreon-esxd » fonctionne uniquement en mode « daemon ».
|
|||
Configuration du connecteur
|
||||
---------------------------
|
||||
|
||||
Le daemon « centreon-esxd » possède un fichier de configuration « centreon_esxd.pm » de la forme suivante ::
|
||||
Le daemon « centreon-esxd » possède un fichier de configuration « centreon_esxd.pm » de la forme suivante :
|
||||
::
|
||||
|
||||
%centreonesxd_config = (
|
||||
vsphere_server => {
|
||||
|
|
@ -50,7 +51,8 @@ Le daemon « centreon-esxd » possède un fichier de configuration « centreo
|
|||
);
|
||||
|
||||
L'attribut « vsphere_server » permet de configurer les accès aux différents VirtualCenter.
|
||||
Dans le cas ou il y a plusieurs VirtualCenters, la configuration devient (noter la "," de séparation) ::
|
||||
Dans le cas ou il y a plusieurs VirtualCenters, la configuration devient (noter la "," de séparation) :
|
||||
::
|
||||
|
||||
%centreonesxd_config = (
|
||||
vsphere_server => {
|
||||
|
|
@ -68,7 +70,8 @@ Dans le cas ou il y a plusieurs VirtualCenters, la configuration devient (noter
|
|||
Troubleshooting
|
||||
---------------
|
||||
|
||||
Il est possible de retrouver des erreurs de ce type dans les « logs » de « centreon-esxd » ::
|
||||
Il est possible de retrouver des erreurs de ce type dans les « logs » de « centreon-esxd » :
|
||||
::
|
||||
|
||||
...SOAP request error - possibly a protocol issue: read failed: error:1408F119:SSL routines:SSL3_GET_RECORD:decryption failed or bad record mac...
|
||||
|
||||
|
|
|
|||
|
|
@ -8,20 +8,24 @@ Pré-Requis
|
|||
Préconisations logicielles
|
||||
``````````````````````````
|
||||
|
||||
Le connecteur "centreon-esxd" est testé et validé sur red-hat 5 et 6 avec des rpms.
|
||||
Le connecteur "centreon-esxd" est testé et validé sur red-hat 6 uniquement avec des rpms.
|
||||
L'installation sur d'autres environnements n'est pas exclu mais non présenté dans ce document (Debian, ...).
|
||||
|
||||
==================== =====================
|
||||
====================== =====================
|
||||
Logiciels Version
|
||||
==================== =====================
|
||||
====================== =====================
|
||||
VMWare SDK Perl 5.1.0-780721
|
||||
Perl 5.8
|
||||
centreon-esxd 1.5.4
|
||||
centreon-esxd 1.6.0
|
||||
perl-centreon-base 2.5.0
|
||||
==================== =====================
|
||||
centreon-plugins-base 1.10
|
||||
ZeroMQ 3.x
|
||||
Perl ZMQ::LibZMQ3 1.19
|
||||
Perl ZMQ::Constants 1.04
|
||||
====================== =====================
|
||||
|
||||
.. warning::
|
||||
Le connecteur "centreon-esxd" fourni par Merethis est conçu pour fonctionner Centreon 2.5 (CES 2.2 ou CES 3), il ne fonctionne pas avec Centreon 2.4.
|
||||
Le connecteur "centreon-esxd" fourni par Merethis est conçu pour fonctionner Centreon 2.5 (CES 3), il ne fonctionne pas avec Centreon 2.4.
|
||||
|
||||
Préconisations matérielles
|
||||
``````````````````````````
|
||||
|
|
@ -34,63 +38,7 @@ Le matériel nécessaire dépend du nombre de demandes de vérifications. Par d
|
|||
Installation de centreon-esxd - Environnement centos/rhel 5
|
||||
===========================================================
|
||||
|
||||
Installation du SDK Perl VMWare
|
||||
```````````````````````````````
|
||||
|
||||
Le connecteur « centreon-esxd » utilise le SDK Perl VMWare pour son fonctionnement. Nous allons donc l'installer en suivant les versions recommandées par VMWare (en dehors de ces versions, le fonctionnement n'est pas garanti).
|
||||
|
||||
======================= ===================== ======================
|
||||
Dépendance Version Dépôt
|
||||
======================= ===================== ======================
|
||||
perl-libwww-perl 5.805 redhat/centos base
|
||||
perl-XML-LibXML 1.58 redhat/centos base
|
||||
perl-Class-MethodMaker 2.18 ces base
|
||||
perl-Crypt-SSLeay 0.51 redhat/centos base
|
||||
perl-SOAP-Lite 0.712 ces base
|
||||
perl-UUID 0.04 ces base
|
||||
perl-VMware-vSphere 5.1.0-780721.1 centreon plugin-packs
|
||||
======================= ===================== ======================
|
||||
|
||||
Installer la dépendance suivante::
|
||||
|
||||
root # yum install perl-VMware-vSphere
|
||||
|
||||
Pré-requis
|
||||
```````````````````````````````````````
|
||||
|
||||
« perl-centreon-base » est nécessaire pour le fonctionnement de « centreon_esxd ». Ce module est présent à partir de Centreon 2.5.
|
||||
|
||||
Installation de centreon-esxd par rpm
|
||||
`````````````````````````````````````
|
||||
|
||||
Installer le connecteur::
|
||||
|
||||
root # yum install ces-plugins-Virtualization-VMWare
|
||||
|
||||
Installation de centreon-esxd par les sources
|
||||
`````````````````````````````````````````````
|
||||
|
||||
Télécharger l'archive de « centreon-esxd ».
|
||||
|
||||
Installer les fichiers::
|
||||
|
||||
root # tar zxvf centreon-esxd-1.5.4.tar.gz
|
||||
root # cd centreon-esxd-1.5.4
|
||||
root # cp centreon_esxd /usr/bin/
|
||||
|
||||
root # mkdir -p /etc/centreon
|
||||
root # cp centreon_esxd-conf.pm /etc/centreon/centreon_esxd.pm
|
||||
root # cp centreon_esxd-init /etc/init.d/centreon_esxd
|
||||
|
||||
root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp lib/* /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/
|
||||
|
||||
Activer le daemon « centreon-esxd » au démarrage::
|
||||
|
||||
root # chkconfig --level 2345 centreon_esxd on
|
||||
|
||||
*Le plugin « nagios » correspond au fichier « centreon_esx_client.pl ».*
|
||||
Le connecteur n'a pas été testé et validé en centos/rhel 5.
|
||||
|
||||
Installation de centreon-esxd - Environnement centos/rhel 6
|
||||
===========================================================
|
||||
|
|
@ -112,31 +60,43 @@ perl-UUID 0.04 centreon plugin-packs
|
|||
perl-VMware-vSphere 5.1.0-780721.1 centreon plugin-packs
|
||||
======================= ===================== ======================
|
||||
|
||||
Installer la dépendance suivante::
|
||||
Installer la dépendance suivante:
|
||||
::
|
||||
|
||||
root # yum install perl-VMware-vSphere
|
||||
|
||||
Pré-requis
|
||||
```````````````````````````````````````
|
||||
|
||||
« perl-centreon-base » est nécessaire pour le fonctionnement de « centreon_esxd ». Ce module est présent à partir de Centreon 2.5.
|
||||
Les dépendances suivantes sont nécessaires pour le fonctionnement de « centreon_esxd »:
|
||||
|
||||
* « perl-centreon-base » : module est présent à partir de Centreon 2.5 (dépôt ces standard)
|
||||
* « centreon-plugins-base » : présent dans le dépôt centreon plugin-packs
|
||||
* « zeromq » et le binding Perl : présent dans le dépôt ces standard ou EPEL
|
||||
|
||||
Installation de centreon-esxd par rpm
|
||||
`````````````````````````````````````
|
||||
|
||||
Installer le connecteur::
|
||||
Installer le connecteur:
|
||||
::
|
||||
|
||||
root # yum install ces-plugins-Virtualization-VMWare
|
||||
|
||||
Installer le client:
|
||||
::
|
||||
|
||||
root # yum install ces-plugins-Virtualization-VMWare-client
|
||||
|
||||
Installation de centreon-esxd par les sources
|
||||
`````````````````````````````````````````````
|
||||
|
||||
Télécharger l'archive de « centreon-esxd ».
|
||||
|
||||
Installer les fichiers::
|
||||
Installer les fichiers:
|
||||
::
|
||||
|
||||
root # tar zxvf centreon-esxd-1.5.4.tar.gz
|
||||
root # cd centreon-esxd-1.5.4
|
||||
root # tar zxvf centreon-esxd-1.6.0.tar.gz
|
||||
root # cd centreon-esxd-1.6.0
|
||||
root # cp centreon_esxd /usr/bin/
|
||||
|
||||
root # mkdir -p /etc/centreon
|
||||
|
|
@ -144,13 +104,24 @@ Installer les fichiers::
|
|||
root # cp centreon_esxd-init /etc/init.d/centreon_esxd
|
||||
|
||||
root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp lib/* /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/
|
||||
root # cp centreon/esxd/* /usr/share/perl5/vendor_perl/centreon/esxd/
|
||||
root # cp centreon/script/centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/
|
||||
|
||||
Activer le daemon « centreon-esxd » au démarrage::
|
||||
Activer le daemon « centreon-esxd » au démarrage:
|
||||
::
|
||||
|
||||
root # chkconfig --level 2345 centreon_esxd on
|
||||
|
||||
*Le plugin « nagios » correspond au fichier « centreon_esx_client.pl ».*
|
||||
Installer le client:
|
||||
::
|
||||
|
||||
root # git clone http://git.centreon.com/centreon-plugins.git
|
||||
root # cd centreon-plugins
|
||||
root # mkdir -p /usr/lib/nagios/plugins/centreon/plugins/
|
||||
root # cp centreon/plugins/* /usr/lib/nagios/plugins/centreon/plugins/
|
||||
root # mkdir -p /usr/lib/nagios/plugins/apps/vmware/
|
||||
root # cp -R apps/vmware/* /usr/lib/nagios/plugins/apps/vmware/
|
||||
root # cp centreon_plugins.pl /usr/lib/nagios/plugins/
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue