Chapitre 6. Guide de démarrage rapide Fedora

Ce guide est prévu pour vous fournir les instructions simples sur la façon d'installer Nagios depuis le code source sur Fedora et d'avoir la supervision de votre machine locale prête en moins de 20 minutes. Aucune option d'installation avancée n'est abordée ici - juste les notions basiques qui fonctionneront pour 95% des utilisateurs qui veulent démarrer.

Ces instructions ont été écrites en se basant sur une installation standard de la distribution Fedora Core 6.

Ce que vous allez obtenir

Si vous suivez ces instructions, voici ce que vous obtiendrez à la fin:

  • Nagios et les plugins seront installés dans l'arborescence du répertoire /usr/local/nagios

  • Nagios sera configuré pour superviser quelques aspects du système local (charge CPU, occupation disque, etc.)

  • L'interface web de Nagios sera accessible à http://localhost/nagios/

Pré-requis

Vous aurez besoin d'un accès root sur la machine pour quelques passages de l'installation

Assurez-vous d'avoir installé les paquets suivants sur votre installation Fedora avant de continuer.

  • Apache

  • Compilateur GCC

  • librairies de développement GD

Vous pouvez utiliser yum pour installer ces paquets en utilisant les commandes suivantes (en tant que root):

            # yum install httpd
            # yum install gcc
            # yum install glibc glibc-common
            # yum install gd gd-devel
        

Créez un compte utilisateur

Passez sur le compte root.

            $ su -l
        

Créez un utilisateur nagios et attribuez lui un mot de passe.

            # /usr/sbin/useradd -m nagios
            # passwd nagios
        

Créez un groupe nagcmd pour autoriser la soumission de commandes externes depuis l'interface web. Ajoutez à la fois l'utilisateur nagios et l'utilisateur apache à ce groupe.

            # /usr/sbin/groupadd nagcmd
            # /usr/sbin/usermod -G nagcmd nagios
            # /usr/sbin/usermod -G nagcmd apache
        

Téléchargez Nagios et les Plugins.

Créez un répertoire pour stocker les téléchargements.

            # mkdir ~/downloads
            # cd ~/downloads
        

Téléchargez à la fois l'archive du code source de Nagios et des plugins Nagios (visitez http://www.nagios.org/download/ pour les liens vers les dernières versions). Au moment de la rédaction, les dernières versions de Nagios et des plugins Nagios étaient respectivement la 3.0.3 et la 1.4.11.

            # wget http://osdn.dl.sourceforge.net/sourceforge/nagios/nagios-3.0.2.tar.gz
            # wget http://osdn.dl.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.11.tar.gz
        

Compilez et installez Nagios

Extraire le code source de Nagios de l'archive.

            # cd ~/downloads
            # tar xzf nagios-3.0.2.tar.gz
            # cd nagios-3.0.2
        

Exécutez le script de configuration de Nagios en lui passant le nom du groupe que vous venez juste de créer comme suit:

            # ./configure --with-command-group=nagcmd
        

Compilez le code source de Nagios.

            # make all
        

Installez les binaires, les scripts de démarrage, les fichiers de configuration fournis en exemple et réglez les permissions sur le dossier des commandes externes.

            # make install
            # make install-init
            # make install-config
            # make install-commandmode
        

Ne démarrez pas Nagios maintenant - Il reste quelques manipulations à faire…

Personnalisation de la configuration

Les exemples de fichiers de configuration ont été installés dans le répertoire /usr/local/nagios/etc. Ces fichiers d'exemple devraient suffire pour commencer avec Nagios. Vous n'aurez qu'une chose à modifier avant de pouvoir commencer…

Éditez le fichier de configuration /usr/local/nagios/etc/objects/contacts.cfg avec votre éditeur de texte préféré et changez l'adresse de courrier électronique associée avec la définition de contact nagiosadmin par celle que vous souhaitez utiliser pour recevoir les alertes.

            # vi /usr/local/nagios/etc/objects/contacts.cfg
        

Configuration de l'interface web

Installez le fichier de configuration web Nagios dans le répertoire Apache conf.d.

            # make install-webconf
        

Créez un compte nagiosadmin pour la connexion à l'interface web de Nagios. Souvenez-vous du mot de passe que vous avez attribué à ce compte - Vous en aurez besoin plus tard.

            # htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
        

Redémarrez Apache pour que les nouveaux réglages prennent effet.

            # service httpd restart
        

Compilation et installation des Plugins Nagios

Extraire le code source des plugins Nagios de l'archive.

            # cd ~/downloads
            # tar xzf nagios-plugins-1.4.11.tar.gz
            # cd nagios-plugins-1.4.11
        

Compilation et installation des plugins.

            # ./configure --with-nagios-user=nagios --with-nagios-group=nagios
            # make
            # make install
        

Démarrage de Nagios

Ajouter Nagios à la liste des services système et démarrer le automatiquement au démarrage du système.

            # chkconfig --add nagios
            # chkconfig nagios on
        

Vérifier les exemples de fichiers de configuration de Nagios.

            # /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
        

S'il n'y a pas d'erreur, démarrer Nagios.

            # service nagios start
        

Modifiez les réglages SELinux

Fedora est fourni avec SELinux (Security Enhanced Linux) installé et en mode Enforcing par défaut. Cela peut engendrer des messages Internal Server Error quand vous essayez d'accéder aux CGIs de Nagios.

Vérifiez si SELinux est en mode Enforcing.

            # getenforce
        

Réglez SELinux sur le mode Permissif.

            # setenforce 0
        

Pour rendre le changement permanent, vous allez devoir modifier ces réglages dans /etc/selinux/config et redémarrer.

Plutôt que de passer SELinux en mode permissif ou de le désactiver, vous pouvez utiliser la commande suivante pour exécuter les CGIs en mode SELinux enforcing/targeted:

            # chcon -R -t httpd_sys_content_t /usr/local/nagios/sbin/
            # chcon -R -t httpd_sys_content_t /usr/local/nagios/share/
        

Pour des informations sur la façon d'utiliser les CGIs Nagios en mode Enforcing avec une police adaptée, allez sur le wiki de NagiosCommunity.org à l'adresse http://wiki.nagios.org.

Connexion à l'interface Web

Vous devriez maintenant pouvoir vous connecter à l'interface web de Nagios à l'adresse ci-dessous. Il vous sera demandé un nom d'utilisateur (nagiosadmin) et le mot de passe que vous avez spécifié plus tôt.

http://localhost/nagios/

Cliquez sur le lien Service Detail de la barre de navigation pour voir les détails de ce que vous supervisez sur votre machine locale. Nagios va prendre quelques minutes pour contrôler l'ensemble des services de votre machine du fait que les contrôles sont répartis dans le temps.

Autres Modifications

Assurez-vous que les règles du pare-feu de la machine sont configurées pour autoriser l'accès au serveur web si vous souhaitez accéder à distance à l'interface de Nagios.

La configuration des notifications par courrier électronique est en dehors du champ de cettte documentation. Même si Nagios est déjà configuré pour envoyer des notifications par courrier électronique, votre système peut très bien ne pas avoir de système de messagerie correctement installé ou configuré. Référez-vous à la documentation de votre système, recherchez sur le web, ou regardez sur le wiki NagiosCommunity.org pour des instructions spécifiques sur la façon de configurer votre système pour qu'il envoie des courriers électroniques vers des adresses extérieures. Plus d'informations sur les notifications ici.

Terminé

Félicitations! Vous avez installé Nagios avec succès. Votre voyage dans l'univers de la supervisoin ne fait que commencer. Vous aurez sans nul doute envie de superviser plus que votre seule machine locale, alors jetez un œil aux documentations suivantes…