inlinetoc

GLPI (Gestionnaire Libre de Parc Informatique)2 est un logiciel libre de gestion des services informatiques (ITSM) et de gestion des services d'assistance (issue tracking system et ServiceDesk). Il dispose également d'un système de plugins, qui permettent l'intégration de :

1. la supervison Shinken qui consiste en une refonte complète du cœur de Nagios en Python (plugin monitoring)
2. l'inventaire automatisé avec FusionInventory

Le serveur mis en oeuvre embarque:

1. GLPI et son frontend http://xx.xx.xxx.xx/glpi
2. SHINKEN et son frontend http://xx.xx.xxx.xx:7767
3. SNMPTT
4. FUSION INVENTORY (avec un agent)
5. Collectd et son frontend

Apache, MYSQL et PHP sont requis

Certains prérequis ne sont disponibles que sur les dépôts EPEL. Vérifier la présence de ceux-ci par yum update

Si EPEL n’apparaît pas activer les dépôts d'EPEL

Normalement MySQLet apache sont installés par défaut mais il faut installer PHP 5 de EPEL

yum install php php-gd php-mysql php-imap php-ldap php-soap

Se connecter avec l'utilisateur root

  mysql -u root

Créer la base de donnée glpi

  MariaDB [(none)]>CREATE DATABASE glpi;
  MariaDB [(none)]> CREATE USER 'glpi'@'localhost';
  MariaDB [(none)]> GRANT ALL PRIVILEGES ON glpi.* TO 'glpi'@'localhost' IDENTIFIED BY 'your_password';
  MariaDB [(none)]>FLUSH PRIVILEGES;\\ MariaDB [glpi]>exit

Récupérer l'archive de GLPI

wget https://github.com/glpi-project/glpi/releases/download/0.90.5/glpi-0.90.5.tar.gz

Décompresser l'archive et déplacer le dossier glpi à la racine du serveur http

  tar xzf glpi-0.90.5.tar.gz
  mv glpi /var/www/html/
  chown apache :apache ∕var/www/html/glpi/ -R

Récupérer le plugins compatibles avec la version de GLPI

• Sur http://plugins.glpi-project.org/#/ Pour les versions récentes de GLPI
• Sur https://forge.glpi-project.org/ pour les autres versions

Liste des plugins compatibles avec glpi 0.9.1.0

  - glpi-accounts-2.1.1.tar.gz
  - glpi-appliances-2.2.tar.gz
  - glpi-archires-2.3.tar.gz
  - glpi-datainjection-2.4.1.tar.gz
  - glpi-racks-1.6.2.tar.gz
  - glpi-shellcommands-1.9.1.tar.gz

Modifier les attributs du répertoire plugins

chown apache :apache /var/www/html/glpi/plugins/ -R

Dans le menu Configuration => Plugins on doit voir apparaître les nouveaux plugins, clliquer sur les boutons Installer

Après l'installation cliquer sur le bouton “Activer”.

Les plugins sont opérationnels

Une fois l'installation terminée il est possible d'utiliser GLPI

Sur un navigateur à l'adresse http://addresse-ip-server/glpi

Python, python-curl , python-setuptools et MySQL-pyhton sont requis :

  yum install python python-curl python-setuptools MySQL-python python-pip redhat-lsb-core

  cd ~
  git clone https://github.com/naparuba/shinken.git
  cd shinken
  # Vous pouvez voir les différentes release en tapant "git tag -l"
  git checkout 2.4.2

Créer l'utilisateur shinken

  adduser shinken

Lancer l'installation

  cd ~/shinken
  sudo python setup.py install

Activer et lancer le démon shinken

  sudo update-rc.d shinken defaults
  sudo service shinken start

Dans le répertoire home de l'utilisateur shinken renseigner le proxy dans ~/.shinken.ini

  [root] # su shinken\\ [shinken] $ vi ~/.shinken.ini
  [shinken.io]
  # options for connection to the shinken.io website. 
  # proxy: curl style, should look as http://user:password@server:3128 
  # api_key: useful for publishing packages or earn xp after each install. create an account at http://shinken.io and go to http://shinken.io/~
  proxy = http://proxy.infra.dgfip:3128

Se connecter en tant qu'utilisateur shinken :

  su -l shinken

Et initialiser la CLI de Shinken pour générer le fichier .ini contenant les chemins vers les différents répertoires de configuration :

  shinken --init

En tant qu'utilisateur Shinken, installer Webui2 :

  shinken install webui2
  exit

Installer les dépendances

  sudo pip install pymongo>=3.0.3 requests arrow bottle==0.12.8

Indiquer à Shinken le module webui2 dans le broker (vi /etc/shinken/brokers/broker-master.cfg) :

  [...]
  modules webui2
  [...]

Une fois toutes ces manipulations effectuées, on peut changer le mot de passe par défaut du compte admin dans le fichier /etc/shinken/contacts/admin.cfg :

  define contact{
    use generic-contact
    contact_name admin
    email your@email.com
    pager 0600000000 ; contact phone number
    password your_password
    is_admin 1
    expert 1
    }

Redémarrer SHINKEN

  service shinken check
  service shinken restart
  service httpd.restart

A ce stade SHINKEN n'affichera rien car il lui manque les plugins NAGIOS.

Récupérer les plugins

  wget http://www.nagios-plugins.org/download/nagios-plugins-2.1.1.tar.gz
  tar -xzvf nagios-plugins-2.1.1.tar.gz

Installer les plugins

  cd nagios-plugins-2.1.1/
  ./configure --with-nagios-user=shinken --with-nagios-group=shinken
  make install

Vérifier l'installation des plugins, les plugins doivent figurer dans le répertoire /usr/local/nagios/libexec

  # ls /usr/local/nagios/libexec
  check_apt 
  check_file_age 
  check_log 
  check_oracle 
  check_tcp
  check_breeze 
  check_flexlm 
  check_mailq 
  check_overcr 
  check_time
  check_by_ssh 
  check_ftp 
  check_mrtg 
  check_ping 
  ...
  check_swap

• Un serveur GLPI
• Un serveur Shinken

Récupérer les plugins compatible glpi_monitoring et glpi-webservices compatibles avec la version de GLPI

  wget https://github.com/ddurieux/glpi_monitoring/releases/download/0.90%2B1.0/glpi_monitoring_0.90.1.0.tar.gz
  tar xzf glpi_monitoring_0.90.1.0.tar.gz
  wget https://forge.glpi-project.org/attachments/download/2099/glpi-webservices-1.6.0.tar.gz
  tar xzf glpi-webservices-1.6.0.tar.gz |

Dans le menu Configuration ⇒ Plugins installer puis activer les plugins Monitoring et Web services.

Cliquer sur les boutons Installer de chaque plugin et ensuite sur le bouton Activer.

• Pour GLPI: aller dans Administration ⇒ Utilisateurs et ajoutez un compte shinken.
• Pour MySQL: Définir le nouvel utilisateur en root

  mysql -u root -p 
  use glpi ;
  GRANT select,update ON glpi_plugin_monitoring_services TO shinkenbroker IDENTIFIED BY 'shinken';
  GRANT insert ON glpi_plugin_monitoring_serviceevents TO shinkenbroker;
  GRANT select,update ON glpi_plugin_monitoring_servicescatalogs TO shinkenbroker;
  exit ;

Sur l'interface GLPI aller dans Configuration ⇒ Webservices, ajouter un service avec les paramètres suivants :

  - Nom : Shinken
  - Services actifs : Oui
  - Activez la compression : Non (Pas testé cette fonctionnalité jusqu'à présent)
  - Tracer les connexions : Non (activez le si vous voulez garder une trace des connexions)
  - Debug : Non (Activez-le en cas de debugging)
  - Motif SQL des services : .*
  - Plage d'adresse IPv4 : mettez l'adresse de votre serveur Shinken dans les 2 cases.
  - Adresse IPv6 : au cas où vous avez l'IPv6 d'activée.
  - Identifiant utilisateur : laissez vide dans ce cas.
  - Mot de passe : laissez vide dans ce cas.

Puis cliquer sur le bouton Ajouter pour valider.

  su -l shinken
  shinken install import-glpi
  shinken install glpidb
  shinken install ws-arbiter
  exit

Editer et adapater le fichier /etc/shinken/modules/import-glpi.cfg :

  define module {
  module_name import-glpi
  module_type import-glpi
  # L'URI de Web service pour GLPI\\ uri http://ip_serveur/glpi/plugins/webservices/xmlrpc.php
  # Si vous avez un nom de domaine, faites pointer sur la bonne adresse :
  # uri http://domaine.com/plugins/webservices/xmlrpc.php
  # Les identifiants que vous avez créés dans GLPI juste avant
  login_name shinken
  login_password shinken
  }

Editer et adpater le fichier /etc/shinken/modules/glpidb.cfg

  define module {
  module_name glpidb
  module_type glpidb
  host ip_serveur # Le nom du serveur GLPI ou son IP
  port 3306
  database glpi # Le nom de la base GLPI
  user shinkenbroker # L'utilisateur créé dans MySQL
  password shinken # le mot de passe de l'utilisateur
  [...]
  }

Ajouter dans le fichier /etc/shinken/brokers/broker-master.cfg les modules webui2 et glpidb

  [...]
  modules webui2,glpidb
  [...]

Editer et adapter le fichier /etc/shinken/arbiters/arbiter-master.cfg

  [...]
  address 0.0.0.0 # Changez localhost en 0.0.0.0 affichera l'Etat du système dans GLPI.
  modules import-glpi,ws-arbiter
  [...]

Redémarrer SHINKEN et APACHE

  service shinken restart
  service httpd restart

SNMP et Nmap doivent être installés :

  yum install net-snmp perl-Net-SNMPl net-snmp-utils

  wget https://github.com/fusioninventory/fusioninventory-for-glpi/releases/download/glpi090%2B1.0/fusioninventory-for-glpi_0.90.1.0.tar.gz
  tar xzf fusioninventory-for-glpi_0.90.1.0.tar.gz 

Dans le menu Configuration ⇒ Plugins Installer puis activer le nouveau plugin .

Les tâches suivantes sont disponibles:

• Inventaire local découverte du réseau

  1. Inventaire réseau
  2. Esx inventaire
  3. Réveil sur lan
  4. Déploiement logiciel

  Installer l'agent fusioninventory avec la commande suivante:

  yum install fusioninventory-agent fusioninventory-agent-task-inventory

Configurer le fichier agent.cfg

Renseigner l'adresse du serveur dans le fichier /etc/fusioninventory/agent.cfg:

  # send tasks results to a FusionInventory for GLPI server
  server = http://xx.xx.xxx.xx:8080/glpi/plugins/fusioninventory/

Exécuter l'agent fusioninventory

 fusioninventory-agent

Normalement l'agent retourne les infos suivantes

  [info] sending prolog request to server server0
  [info] running task ESX
  [info] ESX support disabled server side.
  [info] running task Inventory
  [info] running task Collect
  [info] running task Deploy|

Editer le fichier /etc/sysconfig/fusioninventory-agent, pour y faire figurer au minimum les lignes suivantes :

  OCSMODE[0]=daemon
  OCSSERVER[0]=http/xx.xx.xxx.xx:8080/glpi/plugins/fusioninventory/

Démarrer le démon

  service fusioninventory-agent start

Contrôler le démarrage du démon sur le port 62354

Modifier les droits de l'utilisateur Plugin_Fusioninventory

Modifier le profil de l'entité Root entitity :

1. Dans Administration»Utilisateurs cliquer sur l'utilisateur Plugin_Fusioninventory
2. Dans profils sélectionner le profil Super Admin puis Cliquer sur Ajouter
3. Sélectionner l'entité avec le profil Self service puis Action»Supprimer définitivement

Le plugin est maintenant configuré et disponible

SNMPTT - SNMP Trap Translator - (traducteur des traps SNMP) est un logiciel permettant de capturer et de traduire de manière humainement compréhensible les messages trap remontés par les agents SNMP.

Ecrit en Perl, ce logiciel s'interface avec le daemon snmptrapd de la suite de logiciel Net-SNMP.

Le processus de traitement des TRAPs SNMP dans un serveur NAGIOS utiliset NET-SNMP et SNMPTT:

• (1) SNMPTRAPD est appelé via le gestionnaire de traps défini dans le fichier de configuration snmptrapd.conf défini dans la section «Configuration et exécution du démon snmptrapd».
  • (2) Ce gestionnaire de traps appelle le script /usr/sbin/snmptthandler.
  • (3) Le script lit le trap, puis l'écrit dans le répertoire spool défini dans la directive spool_directory défini dans le fichier de configuration snmptt.ini. Le script se termine alors.
• (4) De là, SNMPTT prend le relais. Il lit le trap dans le fichier spool et recherche une correspondance (5) dans ses définitions de trap.
  • (6) S'il trouve une correspondance, il exécute l'instruction EXEC dans la définition d'interruption correspondante.
  • (7) Cette instruction EXEC envoie le résultat du contrôle passif au serveur Shinken en utilisant le script submit_check_result.
  • (8) Le démon se met alors en veille pendant la période spécifiée dans la directive sleep du fichier snmptt.ini et vérifie dans le répertoire spool des traps supplémentaires; s'il trouve des correspondances, il les traite et envoie les résultats de la vérification à Shiken.

Le serveur Shinken doit avoir des objets hôte définis pour chaque hôte qui génère des traps SNMP. En outre, il faut définir des objets de service pour que ces hôtes reçoivent les résultats de la vérification de service. Il faut les configurer pour recevoir des résultats de contrôle passifs et en tant que services volatils.

Le package Net-SNMP est disponible sous la forme d'une série de packages installables sur de nombreuses distributions. Installer les packages requis sont appelés net-snmp, net-snmp-libs et net-snmp-utils.

yum install net-snmp net-snmp-libs net-snmp-utils net-snmp-perl perl-Net-SNMP net-snmp-devel

Editer le fichier /etc/sysconfig/snmptrapd pour y faire figurer les options suivantes:

OPTIONS="-t -On -Lsd -p /var/run/snmptrapd.pid"

Modifier le fichier /etc/snmp/snmptrapd.conf ainsi:

# disableAuthorization yes
# donotlogtraps yes
createUser -e 0x800063A280943FC2D286F100000001 o145
authUser log,execute,net o145 noauth
traphandle default /usr/sbin/snmptthandler

le service SNMPTT dépend de perl-config-inifiles (module de lecture des fichiers de configuration de style .ini), ce module doit être installé:

yum install perl-config-inifiles

Télécharger l'outil SNMPTT de Sourceforge à http://snmptt.sourceforge.net/.

wget https://sourceforge.net/projects/snmptt/files/snmptt/snmptt_1.4.2/snmptt_1.4.2.tgz/download -O snmptt_1.4.2.tgz
tar -zxvf snmptt_1.4.2.tgz

Le package SNMPTT n'a pas de script d'installation, donc un certain nombre d'étapes d'installation manuelles doivent avoir lieu:

• copier les binaires SNMPTT dans un répertoire /usr/sbin/ et les rendre exécutables.

cp snmptt snmptthandler /usr/sbin/
chmod +x /usr/sbin/snmptt /usr/sbin/snmptthandler

• copier le fichier de configuration SNMPTT, snmptt.ini, dans le répertoire /etc/snmp et l'utilitaire snmpttconvertmib

cp snmptt.ini /etc/snmp/
cp snmpttconvertmib /usr/sbin/

• Créer l'utilisateur et le groupe nécessaires pour exécuter le démon SNMPTT.

groupadd snmptt
adduser -g snmptt snmptt
chown snmptt:snmptt /etc/snmp/snmptt.ini

• créer le répertoire de spool /var/spool/snmptt pour contenir les traps entrantes et le répertoire pour les logs /var/log/snmptt (Il doivent appartenir à l'utilisateur et au groupe qui exécuteront SNMPTT.

mkdir -pv /var/log/snmptt
mkdir -pv /var/spool/snmptt
chown snmptt:snmptt /var/spool/snmptt

• copier le script d'initialisation fourni avec le package, pour l'ajouter au processus de démarrage.

cp snmptt-init.d /etc/init.d/snmptt

Pour démarrer/arrêter/recharger, on peut faire avec ..

/etc/init.d/snmptt start/stop/reload

Cette étape consiste à configurer le fichier /etc/snmp/snmptt.ini. Le fichier contient un assez grand nombre de directives, mais il faut s'occuper en priorité de celles qui concernent le processus de traduction et de transmission des traps:

mode = daemon
daemon_fork = 1
daemon_uid = snmptt
spool_directory = /var/spool/snmptt/
sleep = 5
dns_enable = 1
strip_domain = 1
log_enable = 1
syslog_enable = 0
exec_enable = 1
snmptt_conf_files = <
/etc/snmp/snmptt.conf
END

Le fichier d'exemple snmptt.ini contenu dans le package SNMPTT contient des explications détaillées sur toutes les directives et options que l'on peut spécifier.

Sur le switch fédérateur Sf034_A5500_013SNS1 un trigger a été programmé pour surveillé l'objet ipCidrRouteDest - 1.3.6.1.2.1.4.24.4.1.1. Comme indiqué dans hpe-trigger-snmp-traps, il faut utiliser le MIB DISMAN-EVENT-MIB pour récupérer les traps envoyés. On doit donc compiler la MIB qui gère cet objet pour récupérer les traps produites par celui-ci.

Télécharger la MIB DISMAN-EVENT-MIB sur le site http://www.net-snmp.org/docs/mibs/dismanEventMIB.html

Compiler la MIB en utilisant la commande snmpttconvertmib:

snmpttconvertmib --in=DISMAN-EVENT-MIB.txt --out=/etc/snmp/snmptt.conf --exec='/var/lib/shinken/libexec/eventhandlers/submit_check_result  glpi2012 snmp-traps 1'

Arguments:

• glpi2012 = nom court de l'hôte auquel le service est associé tel que déclaré dans GLPI
• snmp-traps = Nom du service tel que déclaré dans GLPI
• 1 = return_code qui détermine l'état du contrôle de service, 1=AVERTISSEMENT

Une fois terminé, ajouter au fichier de configuration SNMPTT /etc/snmp/snmptt.ini le chemin d'accès aux fichiers de configuration compilés:

[...]
snmptt_conf_files = <<END
/etc/snmp/snmptt.conf
END

Shinken permet (comme son ancêtre Nagios) de recevoir des données de l'extérieur de manière “passive”, c'est à dire sans aucune action exécutée par lui même. Shinken “écoute” simplement les données arrivant dans un pipe et les traite comme ceux venant d'un plugin de check “actif”.

Télécharger le module mod-named-pipe sur https://github.com/shinken-monitoring/mod-named-pipe et extraire le fichier mod-named-pipe.zip

unzip mod-named-pipe.zip 

Créer le répertoire du module dans /var/lib/shinken/modules/ et placer le contenu du dossier module dans ce dossier:

mkdir -pv /var/lib/shinken/modules/named-pipe 
cp -a mod-named-pipe/module/* /var/lib/shinken/modules/named-pipe

Placer le fichier named_pipe.cfg dans /etc/shinken/modules

cp -a mod-named-pipe/etc/modules/named_pipe.cfg /etc/shinken/modules/named_pipe.cfg

Le module “named-pipe” de Shinken doit être référencé dans les fichiers “.cfg” de shinken suivants :

• arbiter
• poller
• receiver

La mise en place des tests passifs nécessite d'ajouter un paramètre supplémentaire dans le fichier “shinken.cfg” :

accept_passive_service_checks=1

• Créer un composant sur le modèle suivant:

Nom* :	snmp-traps	
Définition d'un contrôle* : Instantané	
Contrôle actif* : Non
Contrôle passif* : Oui
Freshness/fraîcheur (pour le mode passif) : 1 seconde	
Commande*: Check host alive (ping)
Période de contrôle* :	24x7

• Associer le composant à un hôte statique dans le Catalogue de composants.
• Créer un service snmp-traps ayant pour ressource (onglet groups) l'entrée du catalogue créée ci-dessus.

Collectd est un démon qui collecte à intervalles réguliers des statistiques sur les performances d'un système et qui offre les mécanismes pour stocker les valeurs récupérées de plusieurs façons, comme par exemple des fichiers Fichiers RRD (Reduced Resolution Dataset).

Il est fourni avec :

• un frontend web qui permet une présentation graphique des fichiers RRD.
• le plugin collect-nagios qui permet de mettre en forme les données collectées à destination de NAGIOS

Récupérer le module mod-collectd pour SHINKEN

  shinken install mod-collectd-master --local

Installer le plugin de confection des graphes rrdtool

  yum install collectd-rrdtool

Editer le fichier /etc/collectd.conf pour vérifier/renseigner les Directory utilisées lors de l'installation :

  #
  # Config file for collectd(1). # Please read collectd.conf(5) for a list of options.
  # http://collectd.org/
  #
  ##############################################################################
  # Global #
  #----------------------------------------------------------------------------#
  # Global settings for the daemon. #
  ##############################################################################
  Hostname "localhost"
  FQDNLookup true
  BaseDir "/var/lib/collectd"
  PIDFile "/var/run/collectd.pid"
  #PluginDir "/usr/lib/collectd"
  TypesDB "/usr/share/collectd/types.db"|

Copier coller le répertoire /collection3 à la racine du serveur web

cp /usr/share/collectd/collection3 /var/www/html/ -r

Editer le fichier /var/www/html/etc/collection.conf pour renseigner DataDir (emplacement des fichiers rrd produits par collectd)

  DataDir "/var/lib/collectd/"
  GraphWidth 400
  #UnixSockAddr "/var/run/collectd-unixsock"

  service collectd start

Dés lors il est possible d'intégrer le plugin collectd-nagios dans le module MONITORING pour afficher les données collectées dans GLPI

• Installer le plugin collectd-nagios: télécharger le module puis l'extraire dans la bibliothèque des plugins de SHINKEN pour pouvoir l'utiliser dans le plugin MONITORING de GLPI.
• Créer un modèle graphique adapté aux données collected

Nom :		check_dd_replication	
Exemple de perfdata pour ce contrôle :  PreCompBytesSent=302719200000000.000000;;;; PostCompBytesSent=187767000000.000000;;;; PreCompBytesRemain=0.000000;;;; PostCompBytesRecv=16139660000000.000000;;;; 	
Nom :		PreCompBytesSent
Nom dynamique ?	Non
Position	1	
Valeur 1 	PreCompBytesSent
Valeur 2 	value1.2
Valeur 3 	value1.3
Valeur 4 	value1.4

• Activer l'affichage des données collectées: Dans la vue Métriques cliquer sur la prévisualisation attachée au composant testé