Update doc

This commit is contained in:
Quentin Garnier 2015-01-22 10:50:32 +01:00
parent 1b33d4ad59
commit ea4183f63f
4 changed files with 110 additions and 161 deletions

View File

@ -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") : By default "centreon-esxd" starts at least two processes (named "handle-client" and "handle-vsphere-xxxx") :
 handle-client »*:  handle-client »*:
*Process waiting for requests of "centron-esx-client.pl" clients.* *Process waiting for requests of clients.*
Steps of operation : Steps of operation :
@ -38,7 +38,8 @@ The "centreon-esxd" program only works in "daemon" mode (a client is needed).
Connector configuration 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 = ( %centreonesxd_config = (
vsphere_server => { vsphere_server => {
@ -49,7 +50,8 @@ The « centreon-esxd » daemon is configured with the « centreon_esxd.pm »
); );
« vsphere_server » attribute configures VirtualCenter access. « 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 = ( %centreonesxd_config = (
vsphere_server => { vsphere_server => {
@ -67,7 +69,8 @@ In case you have many VirtualCenters, the configuration is (note the use of ","
Troubleshooting 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... ...SOAP request error - possibly a protocol issue: read failed: error:1408F119:SSL routines:SSL3_GET_RECORD:decryption failed or bad record mac...

View File

@ -8,25 +8,29 @@ Prerequisites
Software Recommandations 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,...). Installation on other system is possible but is outside the scope of this document (Debian,...).
==================== ===================== ====================== =====================
Software Version Software Version
==================== ===================== ====================== =====================
VMWare SDK Perl 5.1 VMWare SDK Perl 5.1.0-780721
Perl 5.8 Perl 5.8
centreon-esxd 1.4 centreon-esxd 1.6.0
centreon-common-perl 2.5 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:: .. 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 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). * RAM : 512 Mo (May slightly increase with the number of checks).
* CPU : same as poller server. * 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 Centreon-esxd Installation - centos/rhel 5 systems
================================================== ==================================================
SDK Perl VMWare Installation Not tested on centos/rhel 5. There is a problem with Perl ZMQ::LibZMQ3 module.
````````````````````````````
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.*
Centreon-esxd Installation - centos/rhel 6 systems 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 perl-VMware-vSphere 5.1.0-780721.1 centreon plugin-packs
======================= ===================== ====================== ======================= ===================== ======================
Install following dependency:: Install following dependency:
::
root # yum install perl-VMware-vSphere root # yum install perl-VMware-vSphere
Requirements 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 centreon-esxd Installation with rpm
``````````````````````````````````` ```````````````````````````````````
Install the connector:: Install the connector:
::
root # yum install ces-plugins-Virtualization-VMWare root # yum install ces-plugins-Virtualization-VMWare
Install the client:
::
root # yum install ces-plugins-Virtualization-VMWare-client
centreon-esxd Installation with source 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 # tar zxvf centreon-esxd-1.6.0.tar.gz
root # cd centreon-esxd-1.5.4 root # cd centreon-esxd-1.6.0
root # cp centreon_esxd /usr/bin/ root # cp centreon_esxd /usr/bin/
root # mkdir -p /etc/centreon 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 # cp centreon_esxd-init /etc/init.d/centreon_esxd
root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/ root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/
root # cp lib/* /usr/share/perl5/vendor_perl/centreon/esxd/ root # cp centreon/esxd/* /usr/share/perl5/vendor_perl/centreon/esxd/
root # cp centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/ 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 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/

View File

@ -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 ») : Par défaut, « centreon-esxd » lance au moins deux processus (nommé respectivement « handle-client », « handle-vsphere-xxxx ») :
 handle-client »*:  handle-client »*:
*Processus en attente des demandes des clients « centreon_esx_client.pl ».* *Processus en attente des demandes clientes.*
Voici le fonctionnement : Voici le fonctionnement :
@ -39,8 +39,9 @@ Le programme « centreon-esxd » fonctionne uniquement en mode « daemon ».
Configuration du connecteur 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 = ( %centreonesxd_config = (
vsphere_server => { vsphere_server => {
'default' => {'url' => 'https://vcenter/sdk', 'default' => {'url' => 'https://vcenter/sdk',
@ -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. 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 = ( %centreonesxd_config = (
vsphere_server => { vsphere_server => {
@ -68,7 +70,8 @@ Dans le cas ou il y a plusieurs VirtualCenters, la configuration devient (noter
Troubleshooting 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... ...SOAP request error - possibly a protocol issue: read failed: error:1408F119:SSL routines:SSL3_GET_RECORD:decryption failed or bad record mac...

View File

@ -8,20 +8,24 @@ Pré-Requis
Préconisations logicielles 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, ...). L'installation sur d'autres environnements n'est pas exclu mais non présenté dans ce document (Debian, ...).
==================== ===================== ====================== =====================
Logiciels Version Logiciels Version
==================== ===================== ====================== =====================
VMWare SDK Perl 5.1.0-780721 VMWare SDK Perl 5.1.0-780721
Perl 5.8 Perl 5.8
centreon-esxd 1.5.4 centreon-esxd 1.6.0
perl-centreon-base 2.5.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:: .. 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 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 de centreon-esxd - Environnement centos/rhel 5
=========================================================== ===========================================================
Installation du SDK Perl VMWare Le connecteur n'a pas été testé et validé en centos/rhel 5.
```````````````````````````````
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 ».*
Installation de centreon-esxd - Environnement centos/rhel 6 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 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 root # yum install perl-VMware-vSphere
Pré-requis 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 Installation de centreon-esxd par rpm
````````````````````````````````````` `````````````````````````````````````
Installer le connecteur:: Installer le connecteur:
::
root # yum install ces-plugins-Virtualization-VMWare 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 Installation de centreon-esxd par les sources
````````````````````````````````````````````` `````````````````````````````````````````````
Télécharger l'archive de « centreon-esxd ». 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 # cp centreon_esxd /usr/bin/
root # mkdir -p /etc/centreon root # mkdir -p /etc/centreon
@ -144,13 +104,24 @@ Installer les fichiers::
root # cp centreon_esxd-init /etc/init.d/centreon_esxd root # cp centreon_esxd-init /etc/init.d/centreon_esxd
root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/ root # mkdir -p /usr/share/perl5/vendor_perl/centreon/esxd/
root # cp lib/* /usr/share/perl5/vendor_perl/centreon/esxd/ root # cp centreon/esxd/* /usr/share/perl5/vendor_perl/centreon/esxd/
root # cp centreonesxd.pm /usr/share/perl5/vendor_perl/centreon/script/ 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 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/