Chapitre 8. Guide de démarrage rapide Ubuntu

Ce guide est prévu pour vous fournir les instructions simples sur la façon d'installer Nagios depuis le code source sur Ubuntu 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 6.10 (desktop). Elles devraient fonctionner également pour Ubuntu 7.10.

Ce que vous allez obtenir

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

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

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

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

Paquetages requis

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

  1. Apache 2

  2. Compilateur GCC et librairies de développement

  3. librairies de développement GD

Vous pouvez utiliser apt-get pour installer ces paquets en exécutant la commande suivante:

            $ sudo apt-get install apache2
            $ sudo apt-get install build-essential
        

Sur Ubuntu 6.10, installez la librairie gd2 avec cette commande:

            $ sudo apt-get install libgd2-dev
        

Sur Ubuntu 7.10, le nom de la librairie gd2 a changé, vous devez donc utiliser ce qui suit:

            $ sudo apt-get install libgd2-xpm-dev
        

Créez un compte utilisateur

Passez sur le compte root.

            $ sudo -s
        

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

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

Sur la version Ubuntu server (6.01 et peut-être versions plus récentes), vous devrez également ajouter un groupe nagios (il n'est pas créé par défaut). Vous devriez pouvoir éviter cette manipulation sur la version desktop de Ubuntu.

            # /usr/sbin/groupadd nagios
            # /usr/sbin/usermod -G nagios 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 www-data
        

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.2 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 y a encore beaucoup à faire avant…

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. Retenez le mot de passe que vous attribuez à 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.

            # /etc/init.d/apache2 reload
        

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

Configurez Nagios pour qu'il s'exécute automatiquement au démarrage du système.

            # ln -s /etc/init.d/nagios /etc/rcS.d/S99nagios
        

Vérifiez 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émarrez Nagios.

            # /etc/init.d/nagios start
        

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

Si vous souhaitez recevoir des notifications par courrier électronique des alertes Nagios, vous devez installer le paquet mailx (Postfix).

            $ sudo apt-get install mailx
        

Vous devez éditer les commandes de courrier électronique Nagios qui peuvent être trouvées dans /usr/local/nagios/etc/objects/commands.cfg et remplacer toutes les références à /bin/mail en /usr/bin/mail. Une fois ceci fait, vous devez redémarrer Nagios pour prendre en compte ces mofdifications.

            $ sudo /etc/init.d/nagios restart
        

La configuration des notifications par courrier électronique est en dehors du champ de cettte documentation. 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 Ubuntu pour qu'il envoie des courriers électroniques vers des adresses extérieures.