Installation

Prérequis

Note

Centreon recommande l’installation du serveur Selenium sur un collecteur dédié à la supervision des scénarios web et non sur un collecteur de supervision déjà existant car la charge d’exécution des scénarios web impactera fortement la supervision des hôtes et des services.

Prérequis physiques du serveur :

  • 6 vCPU à 3 GHz
  • 8 GO de RAM
  • au minimum 30 GO d’espace disque

Prérequis logiciels :

Depuis les paquets

Serveur Selenium

Si vous utilisez les dépôts CES, utilisez la commande suivante pour installer votre serveur

# yum install centreon-selenium-server

Pour démarrer les services Selenium et xorg-x11-server-Xvfb exécutez les commandes suivantes

# /etc/init.d/xvfb start
# chkconfig --add xfvb
# chkconfig --level 2345 xfvb on
# /etc/init.d/selenium start
# chkconfig --add selenium
# chkconfig --level 2345 selenium on

Sonde de supervision

Si vous bénéficiez de l’offre Plugins Packs, vous pouvez installer facilement la sonde de supervision et les modèles d’hôtes et de services associés via les commandes suivantes :

# yum install ces-packs-applications-selenium
# yum install ces-plugins-applications-selenium

Note

Si vous n’avez pas accès aux Plugins Packs, l’installation du plugin peut être réalisée en suivante la procédure décrite dans la partie Depuis les sources.

Depuis les sources

Les scripts de démarrage et fichiers de variables nécessaires au serveur Selenium sont fournis dans ce repository : https://github.com/centreon/centreon-web-application-analytics Ils ne sont PAS nécessaires lorsqu’on utilise le paquet RPM.

Installation de l’outil de scénario

Cette partie concerne le déploiement de l’IDE Selenium afin de réaliser vos scénarios.

Installation :

  • Lancer Firefox
  • Télécharger Selenium depuis la page du projet<http://seleniumhq.org/download/>
  • Dans la section Selenium IDE, télécharger la dernière version
  • Redémarrer Firefox

Vous avez désormais accès au Selenium IDE via le menu “Outils”.

Installation du serveur Selenium

Ce serveur abrite l’outil Selenium RC qui permet d’automatiser l’exécution de vos scénarios dans Firefox.

Warning

Vérifier la compatibilité de Selenium avec votre version de Firefox Changelog. Par exemple, si vous utilisez une version de Firefox =< 10, vous devez utiliser une version de Selenium <= 2.20.0

Installation de Java

La version Java minimum est la v1.6. (validée avec la v1.7)

Sur Debian:

# apt-get install sun-java6-jre sun-java6-bin

Sur CentOS/RHEL:

# yum install java-1.6.0-openjdk

Pour les autres OS, reporter-vous au site officiel de java <http://www.java.com> et télécharger le JRE correspondant.

Installation du serveur X virtuel

Le serveur Selenium doit lancer un navigateur pour exécuter ses scénarios, un serveur X doit donc être installé.

Pour une installation plus légère, utilisez Xvfb.

Sur Debian:

# apt-get install xvfb

Sur CentOS/RHEL:

# yum install xorg-x11-server-Xvfb

Pour lancer le serveur X au démarrage, un script est disponible sur le Git.

Pour l’installer, copiez le init-xvfb idepuis Git dans le répertoire /etc/init.d et le fichier default-xvfb dans /etc/default

Pour activer son lancement :

Sur Debian:

# chmod a+x /etc/init.d/xvfb
# update-rc.d xvfb defaults
# mkdir -p /usr/local/labkey/

Sur CentOS/RHEL:

# chmod a+x /etc/init.d/xvfb
# chkconfig --add xvfb
# mkdir -p /usr/local/labkey/

Les variables à configurer sont les suivantes :

  • X_SERVER_NUMBER : Le port X Display
  • FBDIR : Répertoire de cache du démon

Installation du navigateur

Le navigateur utilisé est Firefox ou Iceweasel.

Sur Debian:

# apt-get install iceweasel

Sur CentOS:

# yum install firefox

Installation du serveur Selenium

Le serveur Selenium est une archive JAR téléchargeable depuis cette page dans la section Serveur Selenium.

Copier l’archive dans un répertoire et créer un lien symbolique (facultatif, facilite une éventuelle mise à jour).

Exemple :

# mkdir /opt/selenium
# cd /opt/selenium
# cp ~/selenium-server-standalone-version.jar /opt/selenium
# ln -sf selenium-server-standalone-version.jar selenium-server-standalone.jar

Pour lancer le serveur au démarrage, un script est disponible sur le git.

Pour l’installer, copier le init-selenium depuis Git dans le repertoire /etc/init.d et le fichier default-selenium dans /etc/default

Pour activer son lancement:

Sur Debian:

# useradd -r -s /bin/bash -d /var/run/selenium -m selenium
# mkdir -p /var/log/selenium
# chown selenium: /var/log/selenium
# chmod a+x /etc/init.d/selenium
# update-rc.d selenium defaults

Sur CentOS/RHEL:

# useradd -r -s /bin/bash -d /var/run/selenium -m selenium
# mkdir -p /var/log/selenium
# chown selenium: /var/log/selenium
# chmod a+x /etc/init.d/selenium
# chkconfig --add selenium

Les variables de configuration sont les suivantes :

  • SELENIUM_LIB : Chemin vers l’archive JAR du serveur Selenium
  • SELENIUM_PORT : Port d’écoute du serveur Selenium
  • SELENIUM_LOGDIR : Répertoire des logs
  • SELENIUM_PID : Chemin vers le fichier PID
  • SELENIUM_FFPROFILE : Profil Firefox à utiliser lors de l’exécution de vos scénarios
  • X_DISPLAY : Le port X Display

Sonde Centreon WAA

Le plugin doit être installé sur un de vos collecteurs de supervision (serveur Central ou collecteur distant).

Prérequis Perl

Liste des librairies nécessaires :

  • Getopt::Long
  • Time::HiRes
  • XML::XPath
  • WWW::Selenium

Sur Debian:

# apt-get install libtest-www-selenium-perl

Sur CentOS/RHEL

# yum install perl-Test-WWW-Selenium perl-XML-XPath

Pour une installation via CPAN (non-recommandé!):

# cpan -i Getopt::Long Time::HiRes XML::XPath WWW::Selenium

Installation de la sonde

Pour installer la sonde, il est nécessaire de récupérer le projet Centreon Plugins.

# cd /tmp
# git clone http://git.centreon.com/centreon-plugins.git
# mv centreon-plugins/* /usr/lib/nagios/plugins/

Scenario directory

Le plugin utilise des scénarios Selenium au format HTML, ces scénarios doivent être copiés en local sur le serveur de supervision exécutant la sonde :

# mkdir /var/lib/centreon_waa
# chown centreon-engine:centreon-engine /var/lib/centreon_waa