Blog Inforeseau.com – GNU Linux, technologie et autres geekeries

Installer nagios sur Fedora 11 depuis les sources

On considère que le serveur tourne, que apache est déjà installé et que le port 80 est ouvert, http://votre_serveur affiche une page web. Je pars sur une Fedora 11, car c’est un serveur que j’ai disponible et son rôle actuel me permet d’y ajouter Nagios pour une tâche de monitoring.

Je suis root sur le serveur, connecté en SSH.

1 – télécharger et décompresser les sources

wget http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.2.3.tar.gz
tar xvzf nagios-3.2.3.tar.gz
cd nagios-3.2.3

2 – ajouter le user nagios sur le serveur

adduser nagios
groupadd nagios

3 – installer les dépendances

yum install gd gd-devel mod_perl jpeg-devel rrdtools-devel rrd rrdtool-devel fping net-snmp-perl perl-Net-ARP openldap-devel mysql-devel gnutls-devel radiusclient-ng-devel

4 – Configurer et compiler Nagios

./configure --with-nagios-user=nagios --with-nagios-group=nagios
make all

Le résultat doit afficher :

If the main program and CGIs compiled without any errors, you
can continue with installing Nagios as follows (type 'make'
without any arguments for a list of all possible options):

  make install
     - This installs the main program, CGIs, and HTML files

  make install-init
     - This installs the init script in /etc/rc.d/init.d

  make install-commandmode
     - This installs and configures permissions on the
       directory for holding the external command file

  make install-config
     - This installs *SAMPLE* config files in /usr/local/nagios/etc
       You'll have to modify these sample files before you can
       use Nagios.  Read the HTML documentation for more info
       on doing this.  Pay particular attention to the docs on
       object configuration files, as they determine what/how
       things get monitored!

  make install-webconf
     - This installs the Apache config file for the Nagios
       web interface


*** Support Notes *******************************************

If you have questions about configuring or running Nagios,
please make sure that you:

     - Look at the sample config files
     - Read the HTML documentation
     - Read the FAQs online at http://www.nagios.org/faqs

before you post a question to one of the mailing lists.
Also make sure to include pertinent information that could
help others help you.  This might include:

     - What version of Nagios you are using
     - What version of the plugins you are using
     - Relevant snippets from your config files
     - Relevant error messages from the Nagios log file

For more information on obtaining support for Nagios, visit:

       http://www.nagios.org/support/

*************************************************************

Enjoy.

5 – Installer chaque élément en détail :

make install
make install-init
make install-commandmode
make install-config
make install-webconf
make install-html
make install-cgis

Configurer le mot de passe pour l’accès à l’interface :

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

(Saisir le mot de passe de votre choix pour l’utilisateur nagiosadmin)

Note : s’assurer que le dossier /usr/local/nagios/sbin existe et contient bien les fichier .cgi
Note 2 : S’assurer que le dossier /usr/local/nagios/share existe et contient bien les fichiers php et dossiers images etc.

6 – faire le test de la configuration de Nagios :

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

7 – Activer le lancement automatique des services au boot

chkconfig --add nagios; chkconfig nagios

(vérifier que ça se lance bien au démarrage).

8 – Téléchargement, configuration et installation des plugins

cd ..
wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.15.tar.gz
tar xvzf nagios-plugins-1.4.15.tar.gz
cd nagios-plugins-1.4.15
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install

9 – Lancer Nagios et relancer apache et se connecter sur http://votre_serveur/nagios

/etc/rc.d/init.d/nagios restart
/etc/rc.d/init.d/httpd restat

#########################
# CONFIGURATION DU CLIENT NRPE #
#########################
10 – Pour monitorer d’autres machines on passera par NRPE (SNMP est aussi possible, mais je ne le traite pas ici)
Les autres machines sont considérées comme « clientes », sur chacune d’elle on doit installer Nagios-plugins et NRPE.

Les plugins fournissent les scripts permettant de monitorer les services, et NRPE permet de remonter l’information au serveur Nagios précédemment installée en exécutant ces scripts.

10.1 – Création de l’utilisateur et du groupe nagios sur la machine cliente qui va être équipée de NRPE

adduser nagios
groupadd nagios

10.2 Installation des dépendances, comme pour le serveur (en root également, ici aussi une fedora):

yum install gd gd-devel mod_perl jpeg-devel rrdtools-devel rrd rrdtool-devel fping net-snmp-perl perl-Net-ARP openldap-devel mysql-devel gnutls-devel radiusclient-ng-devel net-snmp-devel

10.3 – Téléchargement et installation des plugins nagios depuis http://www.nagios.org/download/plugins

wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.15.tar.gz
tar xvzf nagios-plugins-1.4.15.tar.gz
cd nagios-plugins-1.4.15
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install

Les plugins doivent être installés dans /usr/local/nagios/libexec/

On attribue les bon droits :

chown nagios:nagios /usr/local/nagios
chown -R nagios:nagios /usr/local/nagios/libexec

10.4 Téléchargement et installation de NRPE depuis http://exchange.nagios.org/directory/Addons/Monitoring-Agents/NRPE-%252D-Nagios-Remote-Plugin-Executor/details

Pour les détails, l’archive contient un dossier docs avec un document PDF très bien fait 🙂

wget http://prdownloads.sourceforge.net/sourceforge/nagios/nrpe-2.12.tar.gz
tar xvzf nrpe-2.12.tar.gz
cd nrpe-2.12
./configure
make all
make install-plugin
make install-daemon
make install-daemon-config
cp init-script /etc/rc.d/init.d/nrpe
chmod 755 /etc/rc.d/init.d/nrpe
chkconfig --add nrpe;chkconfig nrpe

(vérifier que le lancement soit bien actif)

On ajoute le service dans /etc/service en ajoutant au fichier dans l’ordre des ports la ligne suivante :

nrpe            5666/tcp                # NRPE remote nagios

On teste l’installation :

/usr/local/nagios/libexec/check_nrpe -H localhost

ça doit renvoyer la version de NRPE 🙂

Ouvrir le firewall pour permettre au demon d’être joignable depuis une autre machine :

iptables -I RH-Firewall-1-INPUT -p tcp -m tcp –dport 5666 -j ACCEPT

ou (selon la configuration de votre iptables)

iptables -I INPUT -p tcp -m tcp --dport 5666 -j ACCEPT

On sauve la règle :

cp /etc/sysconfig/iptables /etc/sysconfig/iptables-avant-nrpe;iptables-save > /etc/sysconfig/iptables

On édite la configuratoin de NRPE sur le client toujours dans le fichier /usr/local/nagios/etc/nrpe.cfg.
Le fichier est plutôt bien documenté, je suggère de le lire en entier. La ligne qui nous intéresse est :

allowed_hosts=127.0.0.1

à laquelle il faut ajouter « ,ip_du_serveur_nagios » pour l’autoriser à communiquer avec NRPE sur cette machine.
Par défaut on va utiliser les plugins codés en dur, en bas du fichier vous pouvez en ajouter sur le modèle des plugins utilisés dans nagios habituellement (corriger le disque hda1 en sda1, ajouter une commande par copier/coller pour sda2 etc.).

Puis on relance NRPE.

/etc/rc.d/init.d/nrpe restart

10.5 Configuration de NRPE sur la machine Nagios
On télécharge l’archive sur la machine où nous avons installé nagios :

wget http://prdownloads.sourceforge.net/sourceforge/nagios/nrpe-2.12.tar.gz
tar xvzf nrpe-2.12.tar.gz
cd nrpe-2.12
./configure
make all
make install-plugin

On teste l’installation en local (attention à l’ouverture de port dans le firewall au besoin pour ce test)

/usr/local/nagios/libexec/check_nrpe -H localhost

et surtout on teste l’hote distant :

/usr/local/nagios/libexec/check_nrpe -H votre_hote_distant -t 100

Vous devez voir la version de NRPE installée en retour. En cas d’erreur, regarder les syslog sur l’autre machine et vérifier le firewall !

On peut ensuite tester les commandes spécifiques installées par défaut depuis la machine nagios sur la machine monitorée :

/usr/local/nagios/libexec/check_nrpe -H votre_hote_distant -c check_users
/usr/local/nagios/libexec/check_nrpe -H votre_hote_distant -c check_load
/usr/local/nagios/libexec/check_nrpe -H votre_hote_distant -c check_sda1
/usr/local/nagios/libexec/check_nrpe -H votre_hote_distant -c check_total_procs
/usr/local/nagios/libexec/check_nrpe -H votre_hote_distant -c check_zombie_procs

Ceci soit renvoyer les valeurs de la machine distante.

10.6 Configuration de Nagios pour utiliser NRPE
Par défaut, l’installation de Nagios comporte une seule machine à monitorer configurée (localhost) dans un seul fichier de configuration.
Ceci est défini dans /usr/local/nagios/etc/nagios.cfg avec une ligne qui contient :

# Definitions for monitoring the local (Linux) host
cfg_file=/usr/local/nagios/etc/objects/localhost.cfg

Un peu plus bas dans le fichier on peut définir suivant l’exemple un dossier qui sera parcouru par nagios à la recherche de tous les fichiers .cfg qui s’y trouvent, afin de pouvoir ajouter un fichier de configuration par hote.
On peut aussi définir un chemin par hote en dur comme indiqué pour la machine locale, libre choix !

On crée donc un dossier pour les machines dans lequel on placera toutes les configurations :

mkdir /usr/local/nagios/etc/machines
chown nagios:nagios /usr/local/nagios/etc/machines

Puis on ajoute dans le fichier de configuration /usr/local/nagios/etc/nagios.cfg la ligne suivante :

cfg_dir=/usr/local/nagios/etc/machines

Ainsi à chaque rechargement de nagios, tous les fichiers de configuration .cfg dans le dossier défini seront pris en compte.

On va maintenant ajouter la commande qui permet d’utiliser NRPE dans nagios.
Il faut ajouter ce qui suit dans le fichier /usr/local/nagios/etc/objects/commands.cfg :

#Commande utilisée pour interroger les hotes distants équipés de NRPE
define command{
command_name	check_nrpe
command_line	$USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$
}

On apprend à Nagios la commande check_nrpe ! 😀

On va ensuite créer un template (modèle) de machine type, ici un modèle de machine linux que nous souhaitons surveiller.
On va ajouter ce template dans le fichier /usr/local/nagios/etc/objects/templates.cfg sous les hosts templates existant (donc juste au dessus de « SERVICE TEMPLATES » :

# Defini un modèle d'hotes que l'on va utiliser pour nos machines distantes avec nrpe.
define host{
name				linux-box-distant	; Name of this template
use				generic-host		; Inherit default values
check_period			24x7
check_interval			5
retry_interval			1
max_check_attempts		10
check_command			check-host-alive
notification_period		24x7
notification_interval		30
notification_options		d,r
contact_groups			admins
register			0			; DONT REGISTER THIS - ITS A TEMPLATE
}

(Voir les templates existant pour adapter les valeurs à vos besoins)

On va maintenant créer un fichier de configuration machine-distante1.cfg pour notre nouvel hote dans /usr/local/nagios/etc/machines/ que nous avons créé un peu avant 🙂

On va mettre dans ce fichier « machine la définition de la machine :

#Definition machine à surveiller
define host{
use			linux-box-distant	; Inherit default values from a template
host_name		machine-distante1	; The name we're giving to this server
alias			Serveur archives 1	; A longer name for the server
address			192.168.0.1		; IP address of the server
}

Dans ce même fichier machine-distante1.cfg on va ajouter les services que l’on souhaite surveiller.
On dispore des services définis dans le fichier nrpe.cfg sur le serveur distant que l’on souhaite surveiller (les command[check…) :

#Definition des services surveillés dans la machine :
#Surveillance CPU LOAD
define service{
use			generic-service		;basé sur le template qui défini generic-service
host_name		machine-distante1	;le nom du serveur distant
service_description	CPU Load
check_command		check_nrpe!check_load
}

#Suveillance du nombre d'utilisateurs
define service{
use			generic-service
host_name		machine-distante1
service_description	Current Users
check_command		check_nrpe!check_users
}

#Espace libre sur sda1
define service{
use			generic-service
host_name		machine-distante1
service_description	/dev/sda1 Free Space
check_command		check_nrpe!check_sda1
}

#Nombre total de processus
define service{
use			generic-service
host_name		machine-distante1
service_description	Total Processes
check_command		check_nrpe!check_total_procs
}

#Processus Zombie
define service{
use			generic-service
host_name		machine-distante1
service_description	Zombie Processes
check_command		check_nrpe!check_zombie_procs
}

Voilà pour la configuration du base, on comprend vite les possibilités avec ça, de personnaliser la configuration selon nos propres souhaits 😀 Même si cette version de base est déjà très intéressante.

Pour prendre en compte les modifications, il suffit de redémarrer nagios :

/etc/rc.d/init.d/nagios restart

La machine ajoutée doit être présente dans l’interface web de Nagios sur la page « Hosts ».

Vous pouvez maintenant ajouter autant de fichiers .cfg que voulu par machine dans le dossier « machines » de votre serveur nagios, et redémarrer nagios pour prendre en compte chaque nouvelle machine (en ayant installé et configuré NRPE sur la machine concernée) !

Vous êtes maintenant capable de démarrer l’utilisation de la solution nagios de manière efficace 😀 Bien sur lire les commentaires dans les fichiers de configuration exemple pour en savoir plus sur les possibilités, notamment les alertes etc. 😀 !

Liens et références utilisées pour la réalisation de cet article :

http://blog.lolo.org/?p=11
http://www.it-sudparis.eu/s2ia/user/procacci/Doc/nagios/nagios.html#htoc15
http://michauko.org/blog/2010/01/06/nrpe-monitorer-des-linux-avec-nagios/
http://michauko.org/blog/2009/10/07/mise-en-place-de-nagios/
http://www.nagios.org/download/addons
http://www.nagios.org/download/
Et une référence immanquables, avec des sujets toujours bien traités et lisibles (contrairement à moi j’avoue :p ) :
http://blog.nicolargo.com/nagios-tutoriels-et-documentations

Tags: explications, guide, monitoring, nagios, nrpe, tutoriel