Suite à un soucis lors de la création et utilisation de boite e-mail, j’ai décidé de rédiger cette article pour vous transmettre la solution. Cette solution est très simple. Cet article a été rédiger avec EHCP en version 0.30.4 et Postfix en version 2.8.5.

II.  Exposition du problème :

Lors de la création d’une boite e-mail via l’interface d’EHCP, nous n’avions rencontrés aucun problème à ce moment là. Le soucis, c’est lorsque l’utilisateur souhaitait se connecter au webmail avec sa nouvelle adresse. Dans notre cas, nous utilisions Roundcube et il nous répondait « Impossible de se connecter au serveur IMAP ». Ce message est d’autant plus étrange alors que le serveur IMAP a déjà été testé.
En allant dans les logs de Postfix, le fichier « /var/log/mail.log » nous indiquer les lignes suivantes :

Feb 21 10:52:50 web imapd: Connection, ip=[::ffff:127.0.0.1]
Feb 21 10:52:50 web imapd: chdir mondomaine.fr/contact/: No such file or directory
Feb 21 10:52:50 web imapd: contact@mondomaine.fr: No such file or directory

Ces lignes nous disent que le dossier correspondant à la boite e-mail « contact@mondomaine.fr » n’existe pas. La raison de l’absence du dossier est simple comme bonjour !

III.  La solution :

Il vous suffit d’envoyer un e-mail à l’adresse que vous venez de créée et le tour est joué !

Remarque : EHCP possède une fonction lui permettant d’automatiser l’envoi du premier e-mail vers une nouvelle boite e-mail afin que Postfix crée les fichiers.

Il est souvent très utile de connaître la bande passante utilisée sur un serveur. Pour cela, nous aurons besoin du plugin check_iftraffic43.pl disponible ici :

http://exchange.nagios.org/components/com_mtree/attachment.php?link_id=3186&cf_id=24

Et nous utiliserons également SNMP (requis pour le plugin) et NRPE. On peut penser que cette configuration est quelque peu étrange ! Mais en faite, cela nous permet de sécuriser l’accès SNMP de notre serveur. L’idée est d’y accès uniquement en local sur le serveur distant, et on utilisera NRPE pour exécuter la commande. Étant donné que notre serveur NRPE (le serveur distant) doit être configurer pour n’écouter que votre serveur nagios, cela limite les risques d’intrusion et ne pourra que récupérer des informations et non passer des commandes dangereuses !

II.  Préparatifs :

Avant tout, assurez-vous que votre serveur NRPE est configuré pour n’écouter que votre serveur Nagios :

Fichier /etc/nagios/nrpe.cfg

allowed_hosts='adresseDuServeurNagios'

Assurez-vous également que votre serveur NRPE accepte le passage d’argument :

Fichier /etc/nagios/nrpe.cfg

dont_blame_nrpe=1

Et sur votre serveur SNMP (sur le serveur distant), en version 3 ici, vérifiez qu’une communauté sur l’adresse localhost est bien créée :

Fichier /etc/snmp/snmpd.conf

rocommunity public default

Vous pouvez remplacer « public » par un nom de communauté de votre choix. L’option « default » indique au service SNMP que qu’il doit écouter sur le réseau loopback (127.0.0.0).

Si vous avez dû apporter ces modifications, redémarrer le serveur nrpe et le service snmp :

/etc/init.d/nagios-nrpe-serveur restart
 /etc/init.d/snmpd restart

III.  Installation du plugin :

Positionnez-vous dans le répertoire de vos plugins sur le serveur distant, et téléchargez le « check_iftraffic43.pl » :

Télécharger: http://exchange.nagios.org/components/com_mtree/attachment.php?link_id=3186&cf_id=24

N’oubliez pas de donner les droits à l’utilisateur nagios :

chmod 775 check_iftraffic43.pl
 chown -R nagios:nagios check_iftraffic43.pl

Ensuite, il faut ajouter la commande dans la configuration de NRPE. Éditez le fichier « /etc/nagios/nrpe.cfg » et dans la section « COMMAND DEFINITIONS » :

command[check_load]=/usr/local/nagios/libexec/check_load -w 15,10,5 -c 30,25,20
 command[check_hda1]=/usr/local/nagios/libexec/check_disk -w 20% -c 10% -p /dev/hda1
 command[check_procs]=/usr/local/nagios/libexec/check_procs -w 5 -c 10 -s Z
 command[check_total_procs]=/usr/lib/nagios/plugins/check_procs -w 150 -c 200
 command[check_disk]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10% -p

Ajoutez-y la commande suivante :

command[check_iftraffic]=/usr/lib/nagios/plugins/check_iftraffic43.pl -H 127.0.0.1 -C public -w 80 -c 90

Adaptez bien sûr évidemment la commande, notamment le chemin où vous avez mis votre plugin (/usr/lib/nagios/plugins/) et la communauté que vous avez configurés (public). Ici, on met l’option -H avec l’adresse de loopback car la commande doit faire appelle à SNMP et on lui indique ainsi comment contacter son serveur SNMP.

Pensez à redémarrer le service NRPE :

/etc/init.d/nagios-nrpe-server restart

IV.  Configuration dans Centreon :

Commençons par créer la commande dans Centreon, rendez vous dans « Configuration → Commandes → Ajouter ».

Adaptez également ici la commande en fonction de votre configuration.

Il ne vous reste plus qu’à créer le service comme suit dans « Configuration → Services → Ajouter ». Dans le champ « Commande de vérification », choisissez la commande que nous venons de créer et les arguments à indiquer sont le seuil de warning et de critical dans le champ « Arguments » comme suit : «!80!90 ».
Remplissez les autres champs en fonction toujours de votre configuration.

N’oubliez pas de l’associer à un hôte dans l’onglet « Relations » !

 NRPE, ces initiales signifient « Nagios Remote Plugin Executor » s’additionnant à Nagios pour récupérer des informations sur un serveur GNU/Linux distant. Il permet donc de surveiller le serveur sous tout les angles possibles (charge du processeur, utilisation de la mémoire, l’espace disque, etc…) qui ,en temps normal, ne sont pas accessible de l’extérieur.

Afin d’interroger un client NRPE il faut utiliser le greffon « check_nrpe » sur le serveur Nagios.

• Schéma de fonctionnement de NRPE avec Nagios :

Pour débroussailler ce schéma, passons aux explications. Avec NRPE, nous avons un système de Client/Serveur et contrairement à ce qu’on peut penser, c’est Nagios le client NRPE car c’est lui qui va aller à la pêche aux infos ! Donc, sur le serveur distant à superviser, on y installe le serveur NRPE et sur le serveur Nagios, on y mettra le client NRPE !

• Mise en place du service :

Sur le serveur Nagios :

Commençons par installer le plugin NRPE sur notre serveur Nagios. Pour cela, faites un petit coup d’apt-get install !

sudo apt-get install nagios-nrpe-plugin

Une fois installé, allons vérifier que le plugin est bien déclaré dans le fichier de configuration des commandes « /etc/nagios/commands.cfg » : 

######
# NRPE
######

# ‘check_nrpe’ command definition
define command{
command_name check_nrpe
command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$
}

Sur votre serveur Linux à surveiller :

Cette étape est un peu plus longue, donc ne perdons pas de temps et passons à l’installation du daemon NRPE et des différents plugins Nagios qui seront utilisés localement par le daemon NRPE :

sudo apt-get install nagios-nrpe-server

sudo apt-get install nagios-plugins

Dans le fichier /etc/nagios/nrpe.cfg , allez modifier la ligne suivante:

…
allowed_hosts = Mettre ici l’adresse IP de votre serveur Nagios
…

Maintenant, il faut rendre le démarrage du daemon automatique au démarrage du serveur :

chkconfig –add nagios-nrpe-server

Si vous avez Iptable d’installer sur notre serveur distant, ajoutez y cette ligne (à adapter) pour autoriser les requêtes NRPE à passer :

iptables -I INPUT 10 -p tcp –dport 5666 -j ACCEPT

Il ne vous reste plus qu’à démarrer le service NRPE :

/etc/init.d/nagios-nrpe-server start

Avant de pouvoir tester la communication entre les deux serveurs, assurez-vous que le fichier « check_nrpe » est bien présent dans le répertoire « /usr/local/nagios/libexec ». S’il est absent , copiez le à partir du répertoire « /usr/lib/nagios/plugins » :

cp /usr/local/nagios/libexec/check_nrpe /usr/lib/nagios/plugins/

De plus, vérifiez bien que l’utilisateur ‘Nagios’ a bien les droits sur les répertoires suivants :

• /usr/local/nagios/libexec/
• /usr/lib/nagios/plugins/
• /etc/nagios/

Vous devez avoir des droits similaires à celui-ci :

Si le résultat est différent, alors utilisez les commandes chmod 775 /*suivi du répertoire*/, et chown -R nagios:nagios /*suivi du répertoire*/.

 Attention : Cette procédure est a effectuer sur le serveur Nagios, mais également sur le client !

 Remarque : Lors de notre installation finale, nous avons rencontré un problème assez particulier. Normalement, après l’installation des paquets sur le serveur distant, le dossier « /usr/local/nagios/libexec » doit se créer automatiquement avec divers fichiers (notamment le « check_nrpe »). Pour une raison obscure, ce dossier ne sait pas créé ainsi que les fichiers devant être contenu. C’est pour cette raison que nous vous mettons à disposition le fichier « check_nrpe » à aller coller dans le dossier « /usr/lib/nagios/plugins ».

Pour être sûr que ça fonctionne bien, éditez le fichier « /etc/nagios/nrpe.cfg » et vérifiez que les commandes sont bien déclarés dans le dossier « /usr/lib/nagios/plugins » comme ceci :

command[check_users]=/usr/lib/nagios/plugins/check_users -w 5 -c 10

 

command[check_load]=/usr/lib/nagios/plugins/check_load -w 15,10,5 -c 30,25,20

 

command[check_hda1]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10% -p /dev/hda1

 

command[check_procs]=/usr/lib/nagios/plugins/check_procs -w 5 -c 10 -s Z

 

command[check_total_procs]=/usr/lib/nagios/plugins/check_procs -w 150 -c 200

 

command[check_disk]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10% -p

 

 

On teste la communication :

A toute installation, elle a droit à un test pour valider le fonctionnement. Donc c’est parti ! Pour tester la communication entre le serveur Nagios et le serveur distant, rendez-vous dans le dossier des plugins « /usr/lib/nagios/plugins » :

./check_nrpe -H Adresse_IP_du_serveur_Linux_distant

Le résultat doit être :

NRPE v2.7

Si tout est OK, cette commande devrait renvoyer la version du daemon NRPE. Vous pouvez tester directement les plugins avec la commande suivante (exemple donnée pour un check de la charge):

./check_nrpe -H Adresse_IP_du_serveur_Linux -c check_load

Nous obtenons ce résultat :

 OK – load average: 0.06, 0.03, 0.01|load1=0.060;15.000;30.000;0; load5=0.030;10.000;25.000;0; load15=0.010;5.000;20.000;0;

La dernière étape consiste à modifier les fichiers de configuration de Nagios pour intégrer le monitoring du/des serveur Linux. Il faut savoir que vous avez deux manières de procéder, soit vous n’avez pas Centreon d’installer et vous allez ajouter les hôtes et les services à la main dans les fichiers de configuration (procédure qui suit) ou vous avez installer Centreon et à ce moment là, passez à la partie « Ajouter un client à partir de Centreon ».

Pour ajouter un client à partir de Nagios :

Il faut dans un premier temps éditer votre fichier de configuration des hosts (hosts.cfg par défaut) et y ajouter votre machine Linux :

define host {
use generic-host
host_name linus
alias Ma machine Linux
address 192.168.0.7
}

Puis ajouter les services offerts par NRPE (dans le fichier services.cfg), quelques exemples:

# Charge CPU
define service{
use generic-service
host_name remotehost
service_description CPU Load
check_command check_nrpe!check_load
}

# Memoire
define service{
use generic-service
host_name remotehost
service_description Memory
check_command check_nrpe!check_mem
}

Pour ajouter des nouveaux plugins executable par NRPE, il faut éditer le fichier /etc/nagios/nrpe.cfg et ajouter une ligne par service (par exemple pour les commandes ‘check_load’ et check_disk’) :

…

command[check_disk]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10%

command[check_load]=/usr/lib/nagios/plugins/check_load -w 15,10,5 -c 30,25,20
…

Ne pas oublier de relancer le daemon quand on change le fichier de configuration (nrpe.cfg):

service nagios-nrpe-server restart

Source : blog.nicolargo.com

Pour ajouter un client sur Centreon:

L’ajout et la configuration d’un client se fait en trois étapes :

1. Création d’un hôte
2. Création d’une commande (éventuellement)
3. Ajout des service liés

La création d’un hôte se fait assez facilement. Il faut se rendre dans :

Configuration → Hôtes → Ajouter

puis remplir le formulaire :

• Nom de l’hôte
• Alias
• Adresse IP / DNS
• Communauté SNMP(la communauté correspond à celle que vous avez donné auparavant) && Version (pour la version, il faut utiliser la 3 car c’est la version 3 de snmp qui était présent dans les paquets.)
• Modèles multiples de l’hôte (vous pouvez si vous le voulez choisir un modèle d’hôte si vous en avez déjà configuré un).
• Pour les autres informations, c’est selon votre choix.

Puis faites « sauvegarder ».

Ensuite, pour créer une commande, il faut se rendre dans :

Configuration -> Commandes -> Ajouter

Au préalable, il faudra, si ce n’est pas fait, créer la commande check_nrpe. En voici l’exemple de création ci-dessous :

Enfin, pour créer un service, il faut se rendre dans :

Configuration -> Services -> Ajouter

Puis remplir le formulaire :

• Description
• Modèle de service (Utiliser un modèle permet d’éviter de remplir les champs requis)
• Commande de vérification : il faut utiliser la commande ‘check_nrpe‘ car c’est grâce à elle que l’on récupèrera les informations.
• Arguments : pour l’argument à mettre, si par exemple on souhaite connaître l’espace disque, nous allons mettre en argument ‘!check_disk‘ (attention : le ‘!‘ est très important et il ne faut pas l’oublier) , qui est la commande qui va récupérer les informations nécessaires.

Sous l’onglet ‘Relations‘, il faudra sélectionner l’hôte auquel on souhaite associer le service.

A la fin, ne pas oublier d’exporter les données sur Nagios en allant sur :

Configuration → Nagios , cocher toutes les cases et cliquer sur exporter, puis vérifier s’il n’y a pas d’erreur.

En cas de problème avec un hôte, notamment s’il s’affiche en état « Down » alors, qu’il est « Up », il faut se rendre sous  Configuration -> Hôtes puis selectionner l’hôte en erreur. Il faut ensuite lui ajouter une commande de vérification : sélectionnez la commande « Check_centreon_ping » et lui donner les arguments de l’exemple en cliquant sur la flèche bleue : 

C’est un serveur permettant la surveillance des réseaux avec le protocole SNMP (Simple Network Management Protocole). C’est ce protocole qui permet aux administrateurs réseau de gérer les équipements du parc informatique, de superviser et de diagnostiquer des problèmes réseaux et de matériels à distance.

Nagios est un programme modulaire qui se décompose en trois parties :

1. Le moteur de l’application qui vient ordonnancer les tâches de supervision.
2. L’interface web, qui permet d’avoir une vue d’ensemble du système d’information et des possibles anomalies.
3. Les plugins, une centaine de mini programmes que l’on peut compléter en fonction des besoins de chacun pour superviser chaque service ou ressource disponible sur l’ensemble des ordinateurs ou éléments réseaux du SI. 

• Comment mettre en place NAGIOS ?

• Le logiciel fonctionne sur Linux (Ubuntu ou Fedora);
  

• Besoin du logiciel Centreon (interface simplifiée pour utiliser Nagios), et du logiciel NDO (qui fait le lien entre Centreon et Nagios, et permet également a Nagios d’écrire dans une base de données l’état des machines à superviser);
  

• Il faut également installer une base de données (ex : MySQL) , et un logiciel de serveur HTTP (ex : Apache2);
  

• Pour le fonctionnement de Nagios, selon les OS, il faudra installer des plugins sur les machines que l’on souhaite surveiller. Pour une machine Windows, on utilisera le plugin NSClient, et pour une machine Linux, on utilisera le plugin NRPE;
  

• Il faudra également installer quelques paquets supplémentaires sur le serveur Nagios, tels que RRDTool , Perl ,SNMP et des librairies GD.

• Installation de Nagios :

1] Installation des prés requis:

• Package divers:
  apt-get install sudo mailx lsb-release

• Compiler:
  apt-get install build-essential

• Server Web (apache) et PHP5:
  apt-get install apache2 apache2-mpm-prefork
  apt-get install php5 php5-mysql
  apt-get install php-pear php5-ldap php5-snmp php5-gd

• MySQL :
  apt-get install mysql-server-5.1 libmysqlclient15-dev

Pendant l’installation de mysql, vous avez un prompt qui vous demande de saisir le mot de passe du server mysql. Nous mettrons nagios. Ensuite un deuxième prompt apparait, revalider votre mot de passe.

• RRDTool:
  apt-get install rrdtool librrds-perl
• Perl:
  apt-get install libconfig-inifiles-perl libcrypt-des-perl libdigest-hmac-perl libdigest-sha1-perl libgd-gd2-perl
• SNMP:
  apt-get install snmp snmpd libnet-snmp-perl libsnmp-perl
• Les librairies GD:
  apt-get install libgd2-xpm libgd2-xpm-dev libpng12-dev
• Et enfin 2 paquets qui nous servirons pour la suite :
  apt-get install dnsutils fping

2] Création du compte et ajout des droits:

Il nous faut à présent créer un utilisateur nagios, car il est préférable de ne pas utiliser le compte root pour l’installation, mais plutôt le compte nagios qui exécutera les plugins et autres scripts, ce qui nous permettra de voir s’il y a des problèmes de droits ou autre.

Création du compte user et des groupes de Nagios:

/usr/sbin/useradd -m nagios
passwd nagios

Enter new UNIX password: nagios
Retype new UNIX password: nagios

psswd: Password updated successfully

/usr/sbin/groupadd nagcmd
/usr/sbin/usermod -G nagios,nagcmd nagios
/usr/sbin/usermod -G nagios,nagcmd www-data

Pour résumer, nous créons un compte utilisateur, un groupe nagcmd pour exécuter les commandes du poller Nagios et un groupe nagios pour les droits. Le compte utilisateur nagios est ajouté à ces trois groupes (nagmcd, nagios, nagcmd).

A présent, je vous conseiles de vous déconnecter et de vous connecter avec le compte nagios que nous avont crées, puis tester la commande sudo ifconfig pour vérifier que vous pouvez utiliser sudo correctement.

3] Installation de Nagios:

Placer vous dans un répertoire de travail, le répertoire /home/nagios par exemple:

cd /home/nagios

Puis créer un répertoire download et placer vous dans ce répertoire:

mkdir download
cd download

Une fois dans ce répertoire, taper:

wget http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.2.0.tar.gz

Puis décompresser l’archive de nagios:

tar xvzf nagios-3.2.0.tar.gz

Une fois décompressé, nous allons installer le programme:

cd nagios-3.2.0/
./configure –prefix=/usr/local/nagios –with-command-group=nagcmd –enable-nanosleep –enable-event-broker ,

Puis, effectuer les commandes suivantes:

make all
sudo make install
sudo make install-init
sudo make install-commandmode
sudo make install-config

Voilà, Nagios est installé, nous allons maintenant installer le plugin Nagios…

Replacer vous dans le répertoire download avec un « cd .. »
Puis téléchargez « nagios-plugins-1.4.14.tar.gz » :

wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.14.tar.gz

Décompressez le puis placer vous dans le répertoire:
tar xvzf nagios-plugins-1.4.14.tar.gz
cd nagios-plugins-1.4.14/

Ensuite configurez le:

./configure –with-nagios-user=nagios –with-nagios-group=nagios –with-openssl=/usr/bin/openssl
make
sudo make install

Voilà Nagios et son plugin sont installés. Configurons maintenant l’accès Web de Nagios:

Créer le htaccess: (nous prendrons nagios dans le tuto)

htpasswd -c /usr/local/nagios/etc/htpasswd.users nagios
New password:nagios
Re-type new password:nagios
Adding password for user nagios

Ensuite il faut editer httpd.conf comme suis:

sudo vim /etc/apache2/httpd.conf

ScriptAlias /nagios/cgi-bin /usr/local/nagios/sbin

<Directory "/usr/local/nagios/sbin">

Options ExecCGI

AllowOverride None

Order allow,deny

Allow from all

AuthName "Nagios Access"

AuthType Basic

AuthUserFile /usr/local/nagios/etc/htpasswd.users

Require valid-user

</Directory>

Alias /nagios /usr/local/nagios/share

<Directory "/usr/local/nagios/share">

Options None

AllowOverride None

Order allow,deny

Allow from all

AuthName "Nagios Access"

AuthType Basic

AuthUserFile /usr/local/nagios/etc/htpasswd.users

Require valid-user

</Directory>

Puis redémarrez le serveur apache:

sudo service apache2 restart

Maintenant si vous tapez  http://’IP_DU_SERVEUR’/nagios dans votre navigateur un prompt doit apparaitre. Saisissez donc le login et le mot de passe utilisé lors de la création du htaccess (id: nagios, mot de passe : nagios)

4] Installation de NDOutils partie 1 : 

Replacez vous dans le répertoire download puis télécharger NDOutils :

cd ..
wget http://prdownloads.sourceforge.net/sourceforge/nagios/ndoutils-1.4b9.tar.gz

Puis décompresser l’archive pour procéder à une installation manuelle:

tar xvzf ndoutils-1.4b9.tar.gz
cd ndoutils-1.4b9

Configurez NDO:

./configure –prefix=/usr/local/nagios/ –enable-mysql –disable-pgsql \
–with-ndo2db-user=nagios –with-ndo2db-group=nagios
make

Et enfin, procedez à l’installation : 

sudo cp ./src/ndomod-3x.o /usr/local/nagios/bin/ndomod.o
sudo cp ./src/ndo2db-3x /usr/local/nagios/bin/ndo2db
sudo cp ./config/ndo2db.cfg-sample /usr/local/nagios/etc/ndo2db.cfg
sudo cp ./config/ndomod.cfg-sample /usr/local/nagios/etc/ndomod.cfg
sudo chmod 775 /usr/local/nagios/bin/ndo*
sudo chown nagios:nagios /usr/local/nagios/bin/ndo*

Créez ensuite un deamon ndo2db:

sudo vim /etc/init.d/ndo2db

Puis coller le script ci-dessous.

#!/bin/sh

#

#

# chkconfig: 345 99 01

# description: Nagios to mysql

#

# Author : Gaëtan Lucas

# Realase : 07/02/08

# Version : 0.1 b

# File : ndo2db

# Description: Starts and stops the Ndo2db daemon

#              used to provide network services status in a database.

#

status_ndo ()

{

if ps -p $NdoPID > /dev/null 2>&1; then

return 0

else

return 1

fi

return 1

}

printstatus_ndo()

{

if status_ndo $1 $2; then

echo "ndo (pid $NdoPID) is running..."

else

echo "ndo is not running"

fi

}

killproc_ndo ()

{

echo "kill $2 $NdoPID"

kill $2 $NdoPID

}

pid_ndo ()

{

if test ! -f $NdoRunFile; then

echo "No lock file found in $NdoRunFile"

echo -n "         checking runing process..."

NdoPID=`ps h -C ndo2db -o pid`

if [ -z "$NdoPID" ]; then

echo "     No ndo2db process found"

exit 1

else

echo "     found process pid: $NdoPID"

echo -n "         reinit $NdoRunFile ..."

touch $NdoRunFile

hown $NdoUser:$NdoGroup $NdoRunFile

echo "$NdoPID" > $NdoRunFile

echo "     done"

fi

fi

NdoPID=`head $NdoRunFile`

}

# Source function library

# Solaris doesn't have an rc.d directory, so do a test first

if [ -f /etc/rc.d/init.d/functions ]; then

. /etc/rc.d/init.d/functions

elif [ -f /etc/init.d/functions ]; then

. /etc/init.d/functions

fi

prefix=/usr/local/nagios

exec_prefix=${prefix}

NdoBin=${exec_prefix}/bin/ndo2db

NdoCfgFile=${prefix}/etc/ndo2db.cfg

NdoRunFile=${prefix}/var/ndo2db.run

NdoLockDir=/var/lock/subsys

NdoLockFile=ndo2db.lock

NdoUser=nagios

NdoGroup=nagios

# Check that ndo exists.

if [ ! -f $NdoBin ]; then

echo "Executable file $NdoBin not found.  Exiting."

exit 1

fi

# Check that ndo.cfg exists.

if [ ! -f $NdoCfgFile ]; then

echo "Configuration file $NdoCfgFile not found.  Exiting."

exit 1

fi

# See how we were called.

case "$1" in

start)

echo -n "Starting ndo:"

touch $NdoRunFile

chown $NdoUser:$NdoGroup $NdoRunFile

$NdoBin -c $NdoCfgFile

if [ -d $NdoLockDir ]; then

touch $NdoLockDir/$NdoLockFile;

fi

ps h -C ndo2db -o pid > $NdoRunFile

if [ $? -eq 0 ]; then

echo " done."

exit 0

else

echo " failed."

$0 stop

exit 1

fi

;;

stop)

echo -n "Stopping ndo: "

pid_ndo

killproc_ndo

# now we have to wait for ndo to exit and remove its

# own NdoRunFile, otherwise a following "start" could

# happen, and then the exiting ndo will remove the

# new NdoRunFile, allowing multiple ndo daemons

# to (sooner or later) run

#echo -n 'Waiting for ndo to exit .'

for i in 1 2 3 4 5 6 7 8 9 10 ; do

if status_ndo > /dev/null; then

echo -n '.'

sleep 1

else

break

fi

done

if status_ndo > /dev/null; then

echo

echo 'Warning - ndo did not exit in a timely manner'

else

echo 'done.'

fi

rm -f $NdoRunFile $NdoLockDir/$NdoLockFile

;;

status)

pid_ndo

printstatus_ndo ndo

;;

restart)

$0 stop

$0 start

;;

*)

echo "Usage: ndo {start|stop|restart|status}"

exit 1

;;

esac

 # End of this script

 Ajoutez ensuite le daemon au démarrage:

sudo update-rc.d ndo2db defaults
sudo chmod +x /etc/init.d/ndo2db

Voilà le daemon ndo2db est maintenant prêt.

5] Installations de Centreon:

Placez vous dans le répertoire de téléchargement créé plus haut, puis téléchargez Centreon:

cd /home/nagios/download/
wget http://download.centreon.com/centreon/centreon-2.1.3.tar.gz
Décompressez Centreon:

tar xvzf centreon-2.1.3.tar.gz
cd centreon-2.1.3/

Définissez un chemin pour les binaires de nagios, ndomod, etc…

export PATH= »$PATH:/usr/local/nagios/bin/ »

Puis lancez l’installation de Centreon:

sudo ./install.sh -i

Descendez tout en bas du contrat de licence puis accepté en cliquant « Y« .

Répondez « Y » à toutes les questions posées lors du processus d’installation, et validez les chemins par défaut lors de l’installation.

 Arrivé au moment où il vous est proposé:

Where is your NDO ndomod binary ?
default to [/usr/sbin/ndomod.o]
>

Entrez le chemin du fichier que nous avons utilisés lors de l’installation NDO:

> /usr/local/nagios/bin/ndomod.o

Puis continuez en acceptant les chemins par défaut et en mettant « Y » à chaque question.

Lorsque l’installation va vous demander de mettre à jour les librairies PEAR, taper « Y » et validez.
Ceci va lancer les mises à jour des modules pear.

Continuez en validant les chemins par défaut et en mettant « Y » à chaque question.

Voilà Centreon est installé. Il ne reste plus qu’à redémarrer le serveur apache.

 sudo service apache2 restart

Nous allons maintenant finaliser l’installation de Centreon par le WEB.

Ouvrez votre navigateur et lancer l’url suivante : http://’IP_DU_SERVEUR’/centreon 

Cliquer sur « start » :

Cochez accepter les termes puis next.

Laissez la configuration de l’environnement par défaut puis next.

Vérifier que tout est ok puis next :

Configuration de la base de données:
Les mots de passes suivant s’appliquent si vous avez suivi le tuto avec les mots de passe « nagios« .

Root password for MySQL : nagios
Centreon database name : centreon
Centstorage database name : centstorage
NDO database name : centstatus
Database password : nagios
Confirm it : nagios
Database location : (ne rien mettre)
Centreon web interface location : (ne rien mettre)
MySQL client version : 4.1 – PASSWORD

Puis next

Vérifiez que tout est ok puis next : 

Configuration de l’interface:

Administrator login for centreon :
Administrator password :

Confirm password :
First name :
Last name :

Administrator email :

Vous pouvez mettre ce que vous voulez dans les champs

 Puis next

LDAP Authentification:

Enable LDAP Authentification : NO

Important mettez bien ‘NO‘ ici !!! Vous pourrez éventuellement le configurer ultérieurement.

Vérifier ensuite que tout les fichiers de configuration soient ok:

Vérifier que la création de la base de données (database) est ok:

Et enfin accéder à centreon
Cliquez sur « Click here to complete your install« 

Voilà nous allons passer aux configurations de bases post installation.

Installation des LOCALE.

Revenez donc sous le shell :

sudo apt-get install gettext

Vérifier tout d’abord les locale de votre système:

locale

Pour ma part je suis donc en « fr_FR.UTF-8« 

 Créez les répertoires des locales:

sudo mkdir /usr/local/centreon/www/locale/fr_FR.UTF-8/
sudo mkdir /usr/local/centreon/www/locale/fr_FR.UTF-8/LC_MESSAGES/

placez vous dans le répertoire de download et téléchargez le language pack:

cd /home/nagios/download
wget http://download.centreon.com/index.php?id=119

Décompressez l’archive:

tar xvzf index.php?id=119
cd centreon-2.1-fr_FR-1.0/LC_MESSAGES/

Copie du fichier de locale:

sudo cp messages.mo /usr/local/centreon/www/locale/fr_FR.UTF-8/LC_MESSAGES/messages.mo

Pour vérifier que la locale s’est bien installée, connectez vous sur Centreon (http://’IP_DU_SERVER’/centreon), puis allez dans : 

Configuration -> Users , sélectionnez votre utilisateur (admin) et vérifiez que vous pouvez sélectionner fr_FR.UTF-8.

Ensuite redémarrez le server apache.

sudo service apache2 restart

Centreon est maintenant en français.

Donnez ensuite les droits sur les répertoires Nagios:

sudo chown -R nagios:nagios /usr/local/nagios
sudo chmod -R 775 /usr/local/nagios
sudo chown -R nagios:www-data /usr/local/nagios/etc
sudo chmod -R 775 /usr/local/nagios/etc
sudo chown -R nagios:www-data /usr/local/nagios/share
sudo chmod -R 775 /usr/local/nagios/share

 Et centreon:

sudo chown -R nagios:nagios /usr/local/centreon
sudo chmod -R 775 /usr/local/centreon
sudo chown -R nagios:www-data /usr/local/centreon/cron
sudo chmod -R 775 /usr/local/centreon/cron
sudo chown -R nagios:www-data /usr/local/centreon/doc
sudo chmod -R 775 /usr/local/centreon/doc
sudo chown -R www-data:nagios /usr/local/centreon/log
sudo chmod -R 775 /usr/local/centreon/log
sudo chown -R www-data:www-data /usr/local/centreon/www
sudo chmod -R 775 /usr/local/centreon/www
sudo chown -R www-data:www-data /usr/local/centreon/GPL_LIB
sudo chmod -R 775 /usr/local/centreon/GPL_LIB

6] Installation NDO partie 2:

Nous allons maintenant finaliser la configuration NDO.

Création de la base de données NDO : 

mysql -u root -p

Enter password : nagios

CREATE DATABASE `ndo` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

exit

 mysql -u root -pnagios ndo < /home/nagios/download/centreon-2.1.3/www/install/createNDODB.sql

Puis donnez les droits à l’utilisateur sur la base:

mysql -u root -pnagios

GRANT ALL PRIVILEGES ON `ndo` . * TO ‘centreon’@'localhost’IDENTIFIED BY ‘nagios’;
flush privileges;

exit

Vérifiez ensuite la présence du fichier ndo2db.cfg puis éditer le:

ls -l /usr/local/nagios/etc/
sudo vim /usr/local/nagios/etc/ndo2db.cfg

 Puis éditez comme ci-dessous:

#####################################################################
# NDO2DB DAEMON CONFIG FILE
#
# Last Modified: 01-02-2009
#####################################################################

# LOCK FILE
# This is the lockfile that NDO2DB will use to store its PID number
# in when it is running in daemon mode.

lock_file=/usr/local/nagios/var/ndo2db.lock

# USER/GROUP PRIVILIGES
# These options determine the user/group that the daemon should run as.
# You can specify a number (uid/gid) or a name for either option.

ndo2db_user=nagios
ndo2db_group=nagios

# SOCKET TYPE
# This option determines what type of socket the daemon will create
# an accept connections from.
# Value:
# unix = Unix domain socket (default)
# tcp = TCP socket

socket_type=unix
#socket_type=tcp

# SOCKET NAME
# This option determines the name and path of the UNIX domain
# socket that the daemon will create and accept connections from.
# This option is only valid if the socket type specified above
# is « unix ».

socket_name=/usr/local/nagios/var/ndo.sock

# TCP PORT
# This option determines what port the daemon will listen for
# connections on. This option is only vlaid if the socket type
# specified above is « tcp ».

tcp_port=5668

# ENCRYPTION
# This option determines if the ndo2db daemon will accept SSL to encrypt the
# network traffic between module and ndo2db daemon.
# Both sides have to enable this feature which depends on SSL Libraries
# like openssl or kerberos
# This option is only valid if the output type
# option specified above is « tcpsocket ».
#
# A value of ’1′ will enable this feature

use_ssl=0

# DATABASE SERVER TYPE
# This option determines what type of DB server the daemon should
# connect to.
# Values:
# mysql = MySQL
# pgsql = PostgreSQL

db_servertype=mysql

# DATABASE HOST
# This option specifies what host the DB server is running on.

db_host=localhost

# DATABASE PORT
# This option specifies the port that the DB server is running on.
# Values:
# 3306 = Default MySQL port
# 5432 = Default PostgreSQL port

db_port=3306

# DATABASE NAME
# This option specifies the name of the database that should be used.

db_name=nagios

# DATABASE TABLE PREFIX
# Determines the prefix (if any) that should be prepended to table names.
# If you modify the table prefix, you’ll need to modify the SQL script for
# creating the database!

db_prefix=nagios_

# DATABASE USERNAME/PASSWORD
# This is the username/password that will be used to authenticate to the DB.
# The user needs at least SELECT, INSERT, UPDATE, and DELETE privileges on
# the database.

db_user=centreon
db_pass=nagios
db_name=ndo

## TABLE TRIMMING OPTIONS
# Several database tables containing Nagios event data can become quite large
# over time. Most admins will want to trim these tables and keep only a
# certain amount of data in them. The options below are used to specify the
# age (in MINUTES) that data should be allowd to remain in various tables
# before it is deleted. Using a value of zero (0) for any value means that
# that particular table should NOT be automatically trimmed.

# Keep timed events for 24 hours
max_timedevents_age=1440

# Keep system commands for 1 week
max_systemcommands_age=10080

# Keep service checks for 1 week
max_servicechecks_age=10080

# Keep host checks for 1 week
max_hostchecks_age=10080

# Keep event handlers for 31 days
max_eventhandlers_age=44640

# Keep external commands for 31 days
max_externalcommands_age=44640

# DEBUG LEVEL
# This option determines how much (if any) debugging information will
# be written to the debug file.  OR values together to log multiple
# types of information.
# Values: -1 = Everything
# 0 = Nothing
# 1 = Process info
# 2 = SQL queries

debug_level=0

# DEBUG VERBOSITY
# This option determines how verbose the debug log out will be.
# Values: 0 = Brief output
# 1 = More detailed
# 2 = Very detailed

debug_verbosity=1

# DEBUG FILE
# This option determines where the daemon should write debugging information.

debug_file=/usr/local/nagios/var/ndo2db.debug

# MAX DEBUG FILE SIZE
# This option determines the maximum size (in bytes) of the debug file. If
# the file grows larger than this size, it will be renamed with a .old
# extension. If a file already exists with a .old extension it will
# automatically be deleted. This helps ensure your disk space usage doesn’t
# get out of control when debugging.

max_debug_file_size=1000000

Connectez vous ensuite sur Centreon (http://’IP_DU_SERVER’/centreon)
Allez sur :

Configuration -> Nagios -> Nagios.cfg puis cliquez sur « Nagios CFG 1« 

Ensuite, sous l’onglet Données, les champs « Commande de lancement du module« , « Option de lancement du module » et « Fichier de données de performance de service« , configurez comme ci-dessous :

 Commande de lancement du module :

/usr/local/nagios/bin/ndomod.o config_file=/usr/local/nagios/etc/ndomod.cfg

 Option de lancement du module :

-1

 Fichier de données de performance de service :

/usr/local/nagios/var/service-perfdata

 Puis cliquez sur « Sauvegarder« 

Ensuite sous :

Configuration -> Centreon -> ndo2db.cfg -> Principal

Mettre dans « Nom de la socket » :

/usr/local/nagios/var/ndo.sock

 Puis sous:

Configuration -> Centreon -> ndomod.cfg -> Central-mod

Complétez comme suis :

Type d’interface :
unixsocket

Status détailler :
/usr/local/nagios/var/ndo.sock

Fichier tampon :
/usr/local/nagios/var/ndomod.tmp

Puis sauvegarder (en haut a droite)

Testez maintenant de démarrer les services :

sudo service nagios start
sudo service ndo2db start

 Si vous rencontrez des erreurs après le démarrage de ndodb, nous vous conseillons de jeter un coup d’œil ici : http://vip93fr.free.fr/2point0/index.php?post/2009/09/30/Nagios%3A-%22ndomod%3A-Error-writing-to-data-sink!-Some-output-may-get-lost%22.

 Allez ensuite sur :

Configuration -> Nagios

Cochez toute les options présentes puis exporter.

Vérifier qu’il n’y ai pas d’erreur lors de l’export de la configuration :

Puis vérifiez que le lien NDO s’établi correctement:

tail -f /usr/local/nagios/var/nagios.log | grep ndomod

Vous devriez avoir ceci:

[1261436831] ndomod: NDOMOD 1.4b9 (10-27-2009) Copyright (c) 2009 Nagios Core Development Team and Community Contributors
[1261436831] ndomod: Successfully connected to data sink. 0 queued items to flush.
[1261436831] Event broker module ‘/usr/local/nagios/bin/ndomod.o’ initialized successfully.

Une foi que tout est ok, configurez les permissions cgi de Nagios.

Allez sur :

Configuration -> Nagios -> CGI

Editer ‘CGI.cfg’

Remplacez les users nagiosadminpar nagios

Puis remplacez dans « Méthode d’affichage par défaut de la carte des états » en « Circular (Marked Up)« .

Puis sauvegarder.

Aller ensuite dans :

Configuration -> Nagios -> Ressources, puis éditer $USER2$avec le nom de la communauté que vous avez paramétré sur vos hôtes.

Configurer ensuite Centstorage :
Sous :

Administration -> Options -> Centstorage

Editez comme le screenshot ci-dessous

Puis aller sous :

Configuration -> Nagios

Cochez toutes les options, méthode « Redémarrer » puis exporter.

Voilà l’installation de base est à présent terminée.

Par défaut le serveur nagios est ajouté à Nagios/Centreon sous le nom « centreon-server ».

Nous allons maintenant configurer brièvement les services comme snmp par exemple.

Pour configurer snmp, éditer le fichier snmpd.conf :
vim /etc/snmp/snmpd.conf

Pour les versions 1 & 2 de SNMP :

Localisez la ligne :

com2sec paranoid default public

Commentez la ligne avec ‘#’puis décommentez la ligne au dessous et éventuellement éditer la communauté :

#com2sec paranoid default public
com2sec readonly  default /*Nom de la communauté*/
#com2sec readwrite default private

 Pour la version 3 de SNMP :

Localisez la ligne :

rocommunity public default -V systemonly

Commentez la et ajoutez en dessous une ligne sous ce format là :

rocummunity /*Nom de la communauté*/ default

Et commentez également la ligne :

agentaddress udp:127.0.0.1:161

Sinon, le serveur n’écoutera les rêquetes SNMP qu’en local (127.0.0.1)

 Ensuite éditez le fichier snmpd

sudo vim /etc/init.d/snmpd

Trouvez la ligne :

TRAPDRUN=no

et la ligne :

TRAPDOPTS=’-Lsd -p /var/run/snmptrapd.pid’ 

Puis modifiez comme suis :
TRAPDRUN=yes
TRAPDOPTS=’-On -LF d /usr/local/nagios/var/snmptrap.log -c /etc/snmp/snmptrapd.conf -p /var/run/snmpdtrapd.pid’

 Editez ensuite le fichier /etc/default/snmpd

sudo vim /etc/default/snmpd

Configurez :

TRAPDRUN=yes
TRAPDOPTS=’-On -LF d /usr/local/nagios/var/snmptrap.log -c /etc/snmp/snmptrapd.conf -p /var/run/snmpdtrapd.pid’

Enfin redémarrez le service snmpd:

sudo service snmpd restart

Vérifiez la présence des 2 processus snmp :

ps -aux | grep snmp

snmp 11540 0.1 0.4 9540 4160 ? S 03:21 0:00 /usr/sbin/snmpd -Lsd -Lf /dev/null -u snmp -I -smux -p /var/run/snmpd.pid 127.0.0.1
root 11543 0.0 0.1 8796 1652 ? Ss 03:21 0:00 /usr/sbin/snmptrapd -On -LF d /usr/local/nagios/var/snmptrap.log -c /etc/snmp/snmptrapd.conf -p /var/run/snmpdtrapd.pid
nagios 11576 0.0 0.0 3052 812 pts/0 S+ 03:22 0:00 grep –color=auto snmp

Test manuel d’un plugin pour vérifier les droits:

Allez dans /usr/local/nagios/libexec puis tapez :
./check_centreon_snmp_memory -H 127.0.0.1 -C /*nom de la communauté*/ -v 1 -w 80 -c 90

Et vous devriez avoir un retour du genre :

total memory used : 11% ram used : 37%, swap used 0% | used=189804544o size=1643266048o

Si c’est le cas, les droits pour l’exécution des plugins avec le compte nagios sont ok

Ajoutez un hôte sous centreon :

Aller sous

Configuration -> Hôtes

Vous retrouverez ici le serveur local (Centreon-server ajouté lors de l’install)
Nous allons faire le test pour le même serveur.
Complétez les champs : Nom de l’hôte, alias, Adresse IP, nom de communauté SNMP et version.

Ensuite ajouter un modèle :
Cliquer sur le + devant ‘Ajouter un modèle’ et choisissez ‘generic-host‘ puis cocher ‘créer aussi les services lié‘.

 Dans ‘notification’ ajouter les utilisateurs qui doivent recevoir les alertes et les heures où le service doit être vérifié (workour, 24/24, etc…)

 Cliquez ensuite sur ‘Relations’ puis ajoutez l’hôte à un groupe d’hôtes (exemple : Linux-Servers)

Sauvegardez puis allers sous :

Configuration -> Nagios et cochez toutes les cases, puis exporter.

Vérifiez qu’il n’y a pas d’erreur à l’export, puis vérifiez sur Nagios et Centreon que le nouvel hôte est bien la : 

Il est possible que vous ayez un bug d’affichage des hôtes sous Centreon visiblement lié à la version de NDO.

Le problème est que les hôtes apparaissent correctement dans Nagios mais aucun n’apparait dans Centreon.

Voici comment fixer le problème :

cd /home/nagios/download/
sudo apt-get install subversion
svn co http://svn.centreon.com/trunk/Patch-NDOutils/
cd Patch-NDOutils/
./configure –prefix=/usr/local/nagios/ –enable-mysql –disable-pgsql –with-mysql-lib=/usr/lib/mysql

(vous pouvez avoir un problème de permissions non accordée pour le ./configure, si c’est le cas pas de souci un petit :sudo chmod 775 configure règlera votre problème)

make
sudo service nagios stop
sudo cp /home/nagios/download/Patch-NDOutils/src/ndomod-3x.o /usr/local/nagios/bin/ndomod.o
sudo cp /home/nagios/download/Patch-NDOutils/src/ndo2db* /usr/local/nagios/bin/
sudo service nagios start
sudo service ndo2db restart

Puis vérifié que vous avez bien quelque chose du genre :

tail -f /usr/local/nagios/var/nagios.log

[1261447270] ndomod: Successfully connected to data sink. 122 items lost, 5000 queued items to flush.
[1261447277] ndomod: Successfully flushed 5000 queued items to data sink.

Vous pouvez maintenant commencer la configuration de vos hôtes et de vos plugins sérieusement.

[EDIT]
Après avoir appliqué le patch NDO, il est possible que la configuration du socket est changé en TCP.

Vérifiez sous :

Configuration -> Centreon -> ndo2db.cfg -> Principal

Dans les champs doit apparaître :
Type de socket :

Unix
Nom de la socket :

/usr/local/nagios/var/ndo.sock

Et dans :

 Configuration -> Centreon -> ndomod.cfg -> Central-mod

Les champs:
Type d’interface :

unixsocket

status détaillé :

/usr/local/nagios/var/ndo.sock

Si ce n’est pas le cas, remplacez les éléments par ces champs.

Ensuite redémarrez les services centcore et centstorage

sudo service centcore restart
sudo service centstorage restart

Puis sous centreon, retournez dans :

Configuration -> Nagios

Cochez toutes les cases, méthode redémarrerpuis cliquer sur exporter.

Notez bien que cette tâche doit être effectué après chaque manipulation sur centreon (ajout d’hôtes, modification d’un service, …)

Néanmoins, si les informations ne remontent toujours pas sur Centreon, c’est très probable que le problème vient de NDO. Pour résoudre le problème, faites :

sudo rm /usr/local/nagios/var/ndo.sock

sudo service ndo2db restart

Déjà qu’est ce que postfix et mailgraph ? Pour Postfix, je pense que vous savez. En revanche pour mailgraph, il s’agit d’un logiciel permettant de créer des graphiques sur l’activité du serveur e-mail. Ce dernier se base sur le fichier de log de Postfix, à savoir « /var/log/mail.log » (par défaut). Mailgraph propose une interface web pour pouvoir surveiller l’activité du serveur mais nous voulons avoir ces informations sur notre serveur Nagios !

Afin de pouvoir interroger mailgraph depuis un serveur Nagios, il nous faut utiliser NRPE (reportez vous à la procédure d’installation de NRPE).

Dans notre cas, nous ne configurerons pas l’accès à l’interface web car elle ne nous intéresse pas. Pourquoi mettre en place une autre interface web alors que l’on veut tout centraliser sur Nagios ???

• Installation de MailGraph

Pour commencer, faites un petit coup d’apt-get :

Maintenant, nous allons le configurer. Pour cela :

Un « utilitaire » en mode texte apparaît et vous pose des questions :

→Il vous demande si Mailgraph doit être lancé au démarrage, vous répondez oui

→Il vous demande quel est le fichier de journalisation est utiliser par Postfix pour qu’il puisse l’utiliser, par défaut c’est « /var/log/mail.log »

→Ensuite, il vous demande s’il doit compter les courriels entrants comme des courriels sortants, répondez non si vous utilisez Amavis ! (Répondre non si vous installerez Amavis dans un futur proche)

Remarque : Avant d’aller plus loin dans le cas où vous utilisez Amavis, je vous recommande de faire la procédure suivante sinon passez à l’étape suivante :

Dans notre configuration de test, nous avions Postfix avec Amavis pour filtrer les e-mails. Le soucis posé par Amavis, c’est qu’il écrit lui aussi (par défaut) dans « /var/log/mail.log », ce qui risque de comptabilisé des e-mails plusieurs fois ! Pour réglé ce problème, nous allons changer le fichier de journalisation d’Amavis.

Éditez le fichier « /etc/amavis/conf.d/20-debian_defaults » puis effectuez les modifications suivantes :

Mettez la variable « $DO_SYSLOG » à 0 comme suit :

Cela va dire à Amavis de ne pas utiliser le programme syslog pour écrire son fichier de log.

Ajoutez la ligne suivante :

Là, on dit à Amavis d’écrire dans le fichier « /var/log/amavis.log ».

C’est pas tout, il faut le créer ce fichier !

Et il faut y mettre les droits. Alors n’ayant pas bien compris qui devait avoir les droits pour écrire dedans, j’ai défini les droits à 777

• Installation du plugin MailGraph

Positionnez vous dans le répertoire de l’utilisateur nagios pour faire ça propre et télécharger le plugin :

Décompressez le (installer « unzip ») :

Installez « patch » :

Rentrez dans le dossier du plugin :

Et ensuite, patchez MailGraph :

Sur Ubuntu 11.10, la commande patch ne fonctionne pas, voici alors une archive avec le script patché sous Ubuntu 10.04 LTS qui est parfaitement fonctionnel. Nous y avons inclus les fichiers du dossier « /var/tmp » à copier également sur votre serveur en donnant les droits à l’utilisateur Nagios. Télécharger

Ensuite, copiez le plugin « check_mailstat.pl » dans le répertoire des plugins « /usr/lib/nagios/plugins ».

Assurez-vous que l’utilisateur Nagios est le propriétaire du fichier et qu’il ait les droits. Si ce n’est pas le cas, tapez les commandes suivantes :

Ensuite, ouvrez le fichier /etc/nagios/nrpe.cfg et ajoutez la ligne suivante dans la liste des commandes (« COMMANDS DEFINITIONS ») :

Pour autoriser les arguments sur le serveur NRPE, éditez la ligne suivante :

Redémarrez NRPE :

Test en local :

Pour vérifier que le plugin fonction, placez-vous dans le répertoire des plugins (« /usr/lib/nagios/plugins ») et tapez la commande suivante :

Cette commande doit vous renvoyez l’aide du plugin. Si c’est bien le cas, c’est que le plugin fonctionne et que vous avez bien mis les droits à l’utilisateur nagios sur le plugin.

Test sur le serveur de supervision :

Positionnez vous sur dans le dossier des plugins de nagios (« /usr/lib/nagios/plugins ») :

Explication des arguments :

Dans le fichier nrpe.cfg, la commande que nous avons ajouté permet d’indiquer le seuil de warning (l’option -w) et le seuil critical (l’option -c). Et l’argument qui suit les options correspondent au seuil appliquer aux différents types d’e-mails séparés par « : ». Dans l’ordre, voici les types de faire qui correspond : Envoi:Réception:Notification :Rejeté:Virus:Spam, à vous de personnaliser les arguments !

• Configuration sur Centreon :

Commençons par créer la commande sur Centreon, rien de plus simple : « Configuration → Commandes → Ajouter » et remplissez les champs suivants :

→ Nom de la commande : mettez « check_nrpe_mailstat » par exemple.

→ Ligne de commande :

Ensuite , sauvegardez !

Maintenant, nous allons voir comment créé un modèle de service. Mais qu’est ce que c’est ? Cela permet de configurer un service à part entière (la commande à utiliser, les notifications , etc…) et ça permet d’effectuer cette opération qu’une seule fois. Après on a juste à créé le service et de sélectionner le modèle et c’est fini !

Pour cela, direction : « Configuration → Services → Modèles → Ajouter » et vous obtenez une page identique à celle d’une page de configuration d’un service. Remplissez les champs :

→ ALIAS : mettez par exemple « NRPE-MAILSTAT »

→ Nom du modèle de service : mettez y par exemple « NRPE-MAILSTAT »

→ Commande de vérification : Dans la liste dé-roulante, choisissez « check_nrpe_mailstat »

→Modèles de service : Sélectionnez « generic-service »

Et remplissez les autres champs selon vos besoins, puis sauvegardez.

Il faut maintenant créer le service : « Configuration → Services → Ajouter », ensuite remplissez les champs :

→Description : à vous de choisir !

→Modèle de service : choisissez le modèle que l’on vient de créer !

→Arguments : saisissez les deux chaînes en mettant un « ! » devant chacune d’elle comme suit :

!40:0:0:0:0:0!50:0:0:0:0:0

Allez dans l’onglet « Relations » pour associer ce service à un ou plusieurs serveurs.

• Création des graphiques

Le plugin de mailgraph envoie bien des informations mais nous aimerions avoir de jolies graphiques pour suivre l’évolution de l’activité des e-mails !

Pour cela, allez dans le menu « Vues → Graphiques → Modèles », sélectionnez « Default_Graph », ensuite dupliquez le, puis renommez le en MailStat et mettre « Label Vertical » à Nombre ! Sauvegardez.

Là, nous avons créés un type de graphique, en quelque sorte. Il faut y ajouter les courbes pour chaque type de valeur !

Pour cela, allez dans le menu « Vues → Graphiques → Courbes → Ajouter » et remplissez les champs suivants :

→Nom du Modèle de courbe : « MailStat-sent »

→Nom de la source de données : « sent »

→Pour faire afficher les valeur maximun, minimun, la moyenne et la dernière valeur, cochez les cases correspondantes.

Puis sauvegardez. Ensuite dupliquez la courbe que vous venez de créer et remplacer « sent » (dans le nom du modèle et de la source) par « received », dupliquez, remplacez par « bounced », puis dupliquez et remplacez par « rejected » etc… (virus, spam).

Une fois les modèles de courbe créés, une petit modification dans le fichier du plugin est à faire. Cette modification est proposé par Pierre-Yves DUBREUCQ du site blog.admin-linux.org . Ouvrez le fichier « check_mailstat.pl » et remplacez la ligne 97 :

my $perfdata = sprintf "sent=%-6.2f received=%-6.2f bounced=%-6.2f rejected=%-6.2f virus=%-6.2f spam=%-6.2f", @stat_counter;

Par la ligne suivante :

my$perfdata=sprintf"sent=%-6.2f;received=%-6.2f;bounced=%-6.2f;rejected=%-6.2f;virus=%-6.2f;spam=%-6.2f",@stat_counter;

Les points virgules rajoutés ici sont nécessaire au traitement des données par Centreon.

Ce n’est pas encore tout à fait terminer, retournez dans « Configuration → Commandes », éditez la commande que nous avions créée tout à l’heure et pour le paramètre « Modèle Graphique », choisissez « MailStat ». Sauvegardez et exportez la configuration sur Nagios et vous devriez avoir un graphique pour le service mailstat.

• Ajout d’un second service Postfix sur Centreon :

Lors de la mis en place d’un second service Postfix sur centreon en utilisant les modèles de service et de graphique, nous obtenions des graphiques complètement incohérent avec l’activité réelle du serveur Postfix concerné. N’ayant pas tout à fait compris d’où venait ce problème pour le moins curieux, nous avons tout de même réussi à le résoudre et je vais vous indiquer comment procéder en quelques points:

→ Le premier est de supprimer le second service Postfix de centreon si vous l’aviez créé et qu’il ne fonctionne pas correctement.

→ Le second est de créer un modèle de graphique par commande, inutile de dupliquer les courbes, tout les modèles de graphiques utiliseront les mêmes.

→ Le troisième point est de créer une commande par service en y indiquant le modèle de graphique à utiliser !

→ Dernier point, n’utilisez pas le modèle de service lorsque vous ajoutez votre service à centreon.

Nous verrons ici comment installer Amavis pour filtrer les e-mails de Postfix. Pour
information, Amavis n’est pas un anti-virus ni un anti-spam. En faite dans notre cas, il fera appel à
ClamAV pour les virus et à SpamAssassin pour définir si les e-mails sont des spams ou non. En
gros, Amavis ne sert que d’interface entre Postfix et le « couple » ClamAV / SpamAssassin.
Dans cette documentation, le système d’exploitation est Linux Ubuntu 10.04 LTS avec
Postfix en version 2.8.5, SpamAssassin 3.3.1, Amavis 2.6.4 et ClamAV 0.96.5 .

2.   Installation :

Nous partons du principe que votre serveur Postfix est configuré et distribue le courrier sans
problème.

• Pour installer nos amis, on va faire un coup d’apt-get :

apt-get install amavisd-new clamav clamav-daemon spamassassin gzip bzip2 unzip unrar cpio rpm nomarch cabextract arj arc zoo lzop pax

Remarque : Ici, je vous fais installer divers décompacteurs pour que Amavis puisse ouvrir les
différents types d’archives.

• Après l’installation, Amavis crée un utilisateur et un groupe « Amavis » et ClamAV crée le sien.

Pour que ce dernier puisse accéder aux pièces jointes décompressées par Amavis, il faut le rajouter
au groupe « Amavis ».

addgroup clamav amavis

3.   Configuration :

• Configuration Générale :

➢ Pour permettre à Amavis de décompresser certains types d’archives, il vous faut éditer le
fichier « /etc/amavis/conf.d/01-debian » et dé-commenter les lignes suivantes :

#$unfreeze = ['unfreeze', 'freeze -d', 'melt', 'fcat']; #disabled (non-free, no security support)

Et commenter la ligne du dessous :

$unfreeze = undef;
#$unrar     = ['rar', 'unrar']; #disabled (non-free, no security support)

Et commenter la ligne suivante :

$unrar       = ['unrar-free'];

#$lha = ‘lha’; #disabled (non-free, no security support)

Et commenter la ligne qui suit :

$lha = undef;

➢ Maintenant, il faut autoriser le filtrage de ClamAV et de SpamAssassin. Il faut éditer
« /etc/amavis/conf.d/15-content_filter_mode » et dé-commenter les lignes suivantes :

#@bypass_virus_checks_maps = (
# \%bypass_virus_checks, \@bypass_virus_checks_acl, \$bypass_virus_checks_re);
#@bypass_spam_checks_maps = (
# \%bypass_spam_checks, \@bypass_spam_checks_acl, \$bypass_spam_checks_re);

Maintenant, Amavis est configuré pour utilise ClamAV et SpamAssassin mais aucun e-mail ne lui
arrive pour le moment.
➢ Il est temps que Amavis reçoit des e-mails. Pour cela, éditez le fichier /etc/postfix/main.cf et
ajoutez y cette ligne :

content_filter = smtp-amavis:[127.0.0.1]:10024

➢ Et ajoutez les lignes suivantes dans le fichier master.cf :

smtp-amavis unix - - y - 2 smtp
  -o smtp_data_done_timeout=1200
  -o disable_dns_lookups=yes
 127.0.0.1:10025 inet              n          -          y           -         -         smtpd
  -o content_filter=
  -o local_recipient_maps=
  -o relay_recipient_maps=
  -o smtpd_restriction_classes=
  -o smtpd_client_restrictions=
  -o smtpd_helo_restrictions=
  -o smtpd_sender_restrictions=
  -o smtpd_recipient_restrictions=permit_mynetworks,reject
  -o mynetworks=127.0.0.0/8
  -o strict_rfc821_envelopes=yes

Faites bien attention à conserver un espace avant chaque « -o ».

Pour bénéficier de toutes les fonctionnalités d’Amavis, il est possible de lui indiquer les domaines locaux gérant des boites e-mails sur le serveur. Je vous le recommande vivement car Amavis ne tague pas les sujets d’e-mail vers des domaines qu’il ne connaît pas!

➢ Pour cela, éditez le fichier « /etc/amavis/conf.d/05-domain_id » et modifier la ligne :

@local_domains_maps = ( [ '.domain1.com', '.domain2.com', '.domain3.com' ] );

Exemple :

@local_domains_maps = ( ['.infos-reseau.com', '.grominet.cheztiti.com'] ) ;

Dans le cas où votre serveur gère plusieurs domaines, vous pouvez déclarer seulement  la partie que j’appelle « commune », exemple :

Admet-on que tout mes domaines se termine en « .fr » et d’autres en « .com » et que je ne souhaite pas tous les saisir, je vais donc déclarer les domaines suivants:

@local_domains_maps = ( ['.fr', '.com'] ) ;

Ce genre de paramètre n’est pas gênant vu qu’il concerne les domaines de destinations, vos domaines. C’est sans doute plus « propre » de tous les déclarer mais quand on héberge plusieurs dizaines de domaines, c’est pas pratique de tous les saisir !

Nous devons modifier le fichier « /etc/default/spamassassin » pour que notre ami SpamAssassin se
lance au démarrage du système. Donc ouvrez le fichier et mettez la valeur de « ENABLED » à 1.

ENABLED = 1

Et ajouter cette ligne pour régler le nombre de processus de SpamAssassin :

OPTIONS="--max-children 5 --helper-home-dir"

À présent, relancez Postfix, Amavis, ClamAV et SpamAssassin :

/etc/init.d/amavis restart
/etc/init.d/clamav-daemon restart
/etc/init.d/spamassassin restart
/etc/init.d/postfix restart (ou postfix reload)

➢ Test :
Pour vérifier qu’Amavis a bien pris en compte ClamAV et SpamAssassin, allez voir les logs
(/var/log/mail.info) et vous devriez y trouver les lignes suivantes :

Jan 20 12:40:08 hostname amavis[13676]: ANTI-VIRUS code loaded
Jan 20 12:40:08 hostname amavis[13676]: ANTI-SPAM-SA code loaded
Jan 20 12:40:08 hostname amavis[13676]: Using internal av scanner code for (primary)
ClamAV-clamd
Jan 20 12:40:08 hostname amavis[13676]: Found secondary av scanner ClamAV-clamscan at
/usr/bin/clamscan

Nous allons tester avec la configuration par défaut d’Amavis. Notez bien que nous ne sommes pas
rentrés dans la configuration personnalisé d’Amavis, nous allons d’abord tester si ça marche bien.
➢ Pour tester ClamAV, créez un fichier .bat avec la chaîne de test « Eicar » suivante :

X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*

Envoyez vous un e-mail avec en pièce jointe ce fichier .bat . Puis allez vérifier dans les logs, vous
devriez avoir ceci :

hostname amavis[13251]: (13251-01) Blocked INFECTED (Eicar-Test-Signature), [...]

Cela signifie que ClamAV a analysé votre pièce jointe et que ça fonctionne.
➢ Nous allons faire la même chose pour SpamAssassin, envoyez-vous un e-mail avec la chaîne
de test suivante :

XJS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X

Dans les logs, vous devrez obtenir ceci :

hostname amavis[6446]: (06446-02) Blocked SPAM, [...]

Parfait, notre configuration de base fonctionne.

• Configuration un peu plus avancée :

Nous allons désormais passer à la configuration plus poussée d’Amavis. Dans le cas actuel,
les spams sont tout simplement bloqué mais il peut arriver qu’un e-mail passe pour un spam alors
qu’il ne l’est pas, on appelle ça un faux-positif. Alors pour éviter de perdre des e-mails importants,
nous les laisserons passés avec des tags « X-Spam ». En ce qui concerne les e-mails infectés par des
virus, par défaut ils vont stockés sur le serveur. Chez nous, personne ne les réclame donc nous les
rejetterons.
Passons à l’action maintenant ! Vous l’aurez sans doute compris, les fichiers de configuration
d’Amavis se trouve dans « /etc/amavis/conf.d ». Ici nous allons parler de deux fichiers « 20-
debian_defaults » et de « 21-ubuntu_defaults ».
➢ La gestion des fichiers d’Amavis est assez particulière pour être expliqué. Amavis va en
faite lire tout les fichiers contenus dans ce répertoire par ordre alpha-numérique. Là où il
faut prêter attention, c’est quand deux paramètres se trouvent dans deux fichiers car c’est
le dernier paramètre rencontré qui sera pris en compte. Par conséquent, avant toute
modification, allez commenter toutes les lignes dans le fichier 21-ubuntu_defaults, ça
devrait donner ceci :

use strict;
#
# These are Ubuntu specific defaults for amavisd-new configuration
#
# DOMAIN KEYS IDENTIFIED MAIL (DKIM)
#$enable_dkim_verification = 1;
# Don’t be verbose about sending mail:
#@whitelist_sender_acl = qw( .$mydomain );
#$final_virus_destiny          = D_DISCARD; # (defaults to D_BOUNCE)
#$final_banned_destiny = D_DISCARD; # (defaults to D_BOUNCE)
#$final_spam_destiny            = D_DISCARD; # (defaults to D_REJECT)
#$final_bad_header_destiny = D_PASS; # (defaults to D_PASS), D_BOUNCE suggested
#$virus_admin = undef;
#$spam_admin = undef;
#———— Do not modify anything below this line ————-
1; # insure a defined return

➢ Ensuite, ouvrez le fichier « 20-debian_defaults » pour commencer la configuration d’amavis.
Nous allons nous intéresser aux variables suivantes :

Vous l’aurez constater que les variables « $final_virus_destiny », « $final_banned_destiny »,
« $final_spam_destiny » et « $final_bad_header_destiny » utilisent des paramètres tel que
« D_REJECT » et etc… Nous allons voir leur signification :

D_DISCARD    Détruit les données sauf pour les virus, ils sont mis en quarantaine
D_BOUNCE      Génère un e-mail de notification par Amavis (Ne jamais utiliser sur « $final_spam_destiny »)
D_REJECT        Rejette tout simplement l’email.
D_PASS             Laisse passer l’e-mail

Ce sont les paramètres que vous êtes susceptible de modifier en premier lieu.

➢ Ensuite on a les white-lists et les blacklists. Plus bas dans le fichier, vous devez avoir ceci :

# This are some examples for whitelists, since envelope senders can be forged
# they are not enabled by default.
{ # a hash-type lookup table (associative array)
#’nobody@cert.org’                   => -3.0,
#’cert-advisory@us-cert.gov’           => -3.0,
#’owner-alert@iss.net’               => -3.0,
#’slashdot@slashdot.org’              => -3.0,
#’securityfocus.com’                => -3.0,
#’ntbugtraq@listserv.ntbugtraq.com’         => -3.0,
#’security-alerts@linuxsecurity.com’       => -3.0,
#’mailman-announce-admin@python.org’             => -3.0,
#’amavis-user-admin@lists.sourceforge.net’=> -3.0,
#’amavis-user-bounces@lists.sourceforge.net’ => -3.0,
#’spamassassin.apache.org’             => -3.0,
#’notification-return@lists.sophos.com’ => -3.0,
#’owner-postfix-users@postfix.org’         => -3.0,
#’owner-postfix-announce@postfix.org’ => -3.0,
#’owner-sendmail-announce@lists.sendmail.org’ => -3.0,
#’sendmail-announce-request@lists.sendmail.org’ => -3.0,
#’donotreply@sendmail.org’              => -3.0,
#’ca+envelope@sendmail.org’               => -3.0,
#’noreply@freshmeat.net’               => -3.0,
#’owner-technews@postel.acm.org’             => -3.0,
#’ietf-123-owner@loki.ietf.org’         => -3.0,
#’cvs-commits-list-admin@gnome.org’            => -3.0,
#’rt-users-admin@lists.fsck.com’         => -3.0,
#’clp-request@comp.nus.edu.sg’            => -3.0,
#’surveys-errors@lists.nua.ie’         => -3.0,
#’emailnews@genomeweb.com’                    => -5.0,
#’yahoo-dev-null@yahoo-inc.com’              => -3.0,
#’returns.groups.yahoo.com’            => -3.0,
#’clusternews@linuxnetworx.com’              => -3.0,
#lc(‘lvs-users-admin@LinuxVirtualServer.org’) => -3.0,
#lc(‘owner-textbreakingnews@CNNIMAIL12.CNN.COM’) => -5.0,
# soft-blacklisting (positive score)
#’sender@example.net’                 => 3.0,
#’.example.net’                  => 1.0,
},

Par défaut, tout est désactivé (commenté). Ici on procède par domaine et le fonctionnement est
assez simple. Pour ajouter un domaine dans la white-list, créez une ligne de la forme suivante (entre
les deux crochets) :

‘infos-reseau.com’               => -3.0,

Dans Amavis, le score doit être négatif pour être considéré comme faisant partit de la white-list.
Pour la black-list, c’est l’inverse ! Exemple :

‘truc.fr’                       => 4.0,

Après avoir modifier les fichiers de configuration d’Amavis et de Postfix, il faut redémarrer ces
derniers :

/etc/init.d/amavis restart
/etc/init.d/postfix restart (ou postfix reload)

/!\ ATTENTION /!\ : Cette configuration envoie deux e-mails de DSN (Delivery Status
Notification) lors de l’envoie d’un e-mail avec une adresse incorrect. L’un des e-mails vient
d’Amavis et l’autre de Postfix.

• Configuration de Freshclam de ClamAV :

Ici, nous allons voir comment utiliser freshclam de ClamAV. Avant d’aller plus loin, qu’est ce
que freshclam ? Pour la petite histoire, c’est bien beau d’installer ClamAV mais si on ne met pas à
jour sa base virale, on va avoir des virus qui vont passer à travers les mailles du filet. Pas de
panique, freshclam est le programme de la situation ! Il permet justement de mettre à jour
automatiquement ou manuellement la base virale de notre ami ClamAV. Si vous installez pour la
première fois de votre vie, vous aurez sans doute remarqué dans vos recherches google qu’aucun
tutoriel ne parle de la mise à jour de cette base virale (ou très peu! Ou alors il est bien caché).
Pour la configuration de freshclam rien de bien difficile en soit pour qu’il fonctionne, vous
aurez remarqués que je n’ai pas parlé de l’installation. Tout simplement parce qu’il vient d’office
avec ClamAV lorsque vous l’installez. Bon passons à la configuration de ce dernier !
➢ Freshclam avec sa configuration par défaut est fonctionnel et il fonctionne. Nous allons juste
l’ajuster.
Ce qui nous intéresse, c’est que freshclam se lance automatique au démarrage du système
pour qu’il puisse travailler tout seul. Et par défaut, c’est déjà le cas. Vous pouvez le vérifier par la
seule présence d’un fichier « clamav-freshclam » dans le dossier /etc/init.d .
D’ailleurs pour démarrer ou arrêter freshclam, voici les commandes à saisir :

/etc/init.d/clamav-freshclam start
/etc/init.d/clamav-freshclam stop
/etc/init.d/clamav-freshclam restart

Ensuite, nous allons voir deux paramètres dans le fichier de configuration de freshclam qui nous
intéresse. Pour commencer, ouvrez le fichier /etc/clamav/freshclam.conf . Vous devez obtenir un
contenu similaire à celui-ci :

# Automatically created by the clamav-freshclam postinst
# Comments will get lost when you reconfigure the clamav-freshclam package
DatabaseOwner clamav
UpdateLogFile /var/log/clamav/freshclam.log
LogVerbose false
LogSyslog false
LogFacility LOG_LOCAL6
LogFileMaxSize 0
LogTime true
Foreground false
Debug false
MaxAttempts 5
DatabaseDirectory /var/lib/clamav
DNSDatabaseInfo current.cvd.clamav.net
AllowSupplementaryGroups false
PidFile /var/run/clamav/freshclam.pid
ConnectTimeout 30
ReceiveTimeout 30
TestDatabases yes
ScriptedUpdates yes
CompressLocalDatabase no
Bytecode true
# Check for new database 24 times a day
Checks 24
DatabaseMirror db.local.clamav.net
DatabaseMirror database.clamav.net

Les deux paramètres intéressant sont les suivants :
– « UpdateLogFile » : il permet d’indiquer où freshclam doit dire ce qu’il se passe. Vous êtes
libre de le changer de répertoire. Après la modification, pensez à redémarrer freshclam.
– Le second paramètre intéressant, c’est le « Checks 24 ». Ce paramètre indique à freshclam
de vérifier 24 fois par jour s’il y a une nouvelle version de la base virale. Donc vous pouvez
l’ajuster selon vos besoins.
Après toute modification de ce fichier, n’oubliez pas de redémarrer freshclam.

• Conclusion :

Nous venons de mettre en place une solution de filtrage gratuit, libre et efficace sur un
serveur mail Postfix !

Voici une petit procédure toute simple pour changer le mot de passe de votre IOS. Attention la méthode peut varier en fonction du matériel utilisé.

En premier lieu connectez vous via le port console de votre machine puis ouvrez une connection via votre port COM. Si vous êtes sur Seven je vous invite à utiliser Xshell.

Ca y est vous êtes connectez; débranchez la prise electrique à l’arrière puis rebanchez la et maintenez la touche PAUSE sur votre clavier ou sur certains switch maintenez le bouton MODE

Vous devriez vous retrouver à rommon> 

tapez maintenant confreg

répondez non à toutes les option sauf pour :

enable « ignore system config info y/n [y]:y

répondez non à toutes les autres options.

Vous voilà revenu au prompt du départ, tapez alors reset  Votre appareil redémarre.

Le système redémarre et vous allez savoir si la manipulation précédente a fonctionné puisque  vous allez devoir répondre à cette question:

would you like to enter the initial configuration dialof [yes/no]: et vous répondez no

Faites un show version et la réponse doit être 0×2142

Maintenant faites un show startup-config pour voir le mot de passe enable

Si vous avez un mot de passe enable configuré, vous pouvez le remplacez en faisant copy start run puis en recréer un mot de passe en faisant enable secret cisco et copier le sur la config en cours en faisant copy run start

Désormais vous voulez repasser en configuration normale faites config-register 0×2102

Enregistrez votre configuration en faisant wr ou copy run start

cet article est une traduction modifiée issue de l’article de David Davis sur le site de Petri IP Knowledgebase.

Le fichier bounce.cf permet à Postfix d’envoyer des messages d’erreur personnalisés. Pour
être plus précis, bounce.cf contient ces messages, ici on indiquera un exemple de contenu, à vous de
les personnaliser. Cette procédure a été faite avec Postfix version 2.8.5 .

• Configuration du fichier :

Dans un premier temps, il faut créer le fichier /etc/postfix/bounce.cf ,libre à vous de choisir
la manière pour créer le fichier (via la console, ou transfert par sftp, etc…)
Exemple :

nano  /etc/postfix/bounce.cf

Voici un exemple de contenu :

#
 # The failure template is used when mail is returned to the sender;
 # either the destination rejected the message, or the destination
 # could not be reached before the message expired in the queue.
 #
 failure_template = < Charset: iso-8859-1
 From: MAILER-DAEMON TELETECHNO (Mail Delivery System)
 Subject: Courriel non delivre Retourne a l'expediteur - Undelivered Mail Returned to Sender
 Postmaster-Subject: Postmaster Copy: Courriel non delivre - Undelivered Mail
 This is the mail system at host $myhostname.
 I'm sorry to have to inform you that your message could not
 be delivered to one or more recipients. It's attached below.
 For further assistance, please send mail to If you do so, please include this problem report. You can
 delete your own text from the attached returned message.
 The mail system
 EOF
 #
 # The delay template is used when mail is delayed. Note a neat trick:
 # the default template displays the delay_warning_time value as hours
 # by appending the _hours suffix to the parameter name; it displays
 # the maximal_queue_lifetime value as days by appending the _days
 # suffix.
 #
 # Other suffixes are: _seconds, _minutes, _weeks. There are no other
 # main.cf parameters that have this special behavior.
 #
 # You need to adjust these suffixes (and the surrounding text) if
 # you have very different settings for these time parameters.
 #
 delay_template = < Charset: iso-8859-1
 From: MAILER-DAEMON TELETECHNO (Mail Delivery System)
 Subject: Courriel Retarde - Delayed Mail (still being retried)
 Postmaster-Subject: Postmaster Warning: Courriel Retarde - Delayed Mail
 This is the mail system at host $myhostname.
 ################################################
 # CECI EST UN AVERTISSEMENT. VOUS N'AVEZ PAS BESOIN DE RENVOYER VOTRE MESSAGE.#
 ################################################
 ######################################
 # THIS IS A WARNING ONLY. YOU DO NOT NEED TO RESEND YOUR MESSAGE.#
 ######################################
 Your message could not be delivered for more than $delay_warning_time_hours hour(s).
 It will be retried until it is $maximal_queue_lifetime_days day(s) old.
 For further assistance, please send mail to If you do so, please include this problem report. You can
 delete your own text from the attached returned message.
 The mail system
 EOF
 #
 # The success template is used when mail is delivered to mailbox,
 # when an alias or list is expanded, or when mail is delivered to a
 # system that does not announce DSN support. It is an error to specify
 # a Postmaster-Subject: here.
 #
 success_template = < Charset: iso-8859-1
 From: MAILER-DAEMON TELETECHNO (Mail Delivery System)
 Subject: Rapport de Livraison du Courriel : Succes - Successful Mail Delivery Report
 This is the mail system at host $myhostname.
 Your message was successfully delivered to the destination(s)
 listed below. If the message was delivered to mailbox you will
 receive no further notifications. Otherwise you may still receive
 notifications of mail delivery errors from other systems.
 The mail system
 EOF
 #
 # The verify template is used for address verification (sendmail -bv
 # address...). or for verbose mail delivery (sendmail -v address...).
 # It is an error to specify a Postmaster-Subject: here.
 #
 verify_template = < Charset: iso-8859-1
 From: MAILER-DAEMON (Mail Delivery System)
 Subject: Status livraison du courriel - Mail Delivery Status Report
 This is the mail system at host $myhostname.
 Enclosed is the mail delivery report that you requested.
 The mail system
 EOF

Ces 4 messages seront utilisés par postfix pour 4 cas différents. Le premier est destiné à
prévenir l’expéditeur dans le cas où son message n’a pas pu être délivré et etc… Il est important de
respecter l’ordre des messages dans ce fichier. Postfix se fit à cette ordre pour les utiliser.

Nous avons traduit les termes importants pour que n’importe qui puisse comprendre le sujet
du message. Nous avons mis également le « Charset » à « iso-8859-1 ». Faites attention à ne pas
mettre d’accent dans les « subject » des messages. Postfix veut absolument lire les « subject » en
code ascii et non en iso-8859-1 ! En revanche, dans le corps du message vous pouvez mettre
autant d’accent que vous le souhaitez !
Ensuite enregistrez votre fichier dans /etc/postfix.

Maintenant, nous devons dire à Postfix d’utiliser le fichier, pour cela faites :

postconf -e ‘bounce_template_file = /etc/postfix/bounce.cf’

Si vous êtes observateur, vous aurez remarqués qu’une variable est présente dans le fichier,
la variable $myhostname. Pour vérifier que Postfix remplace bien cette variable, on fait :

postconf -b /etc/postfix/bounce.cf

Normalement, $myhostname sera remplacé par le nom de votre serveur et vous ne devez pas
avoir d’erreur dans ce style là :

warning: /etc/postfix/bounce.cf: non-ASCII [...]

Si vous l’avez, c ‘est qu’un accent traîne quelque part. Il ne reste plus qu’à redémarrer Postfix
pour qu’il prend en compte les changements. Faites tout simplement :

/etc/init.d/postfix restart

Il ne vous reste plus qu’à tester.

Sur un serveur en plus de laisser un accès console, on va pouvoir faire du tunneling  et même transférer des fichiers

Sous Debian, Ubuntu on utilisera open-ssh, passons à l’installation sur le serveur:

Comme toujours on fait:

apt-get update

puis

apt-get install openssh-server

Plusieurs bibliothèques complémentaires sont nécessaires en fonction de ce que vous avez installez, on vous demande de confirmer donc dites ok

L’installation est faites et le serveur génère les clefs. vous pouvez désormais modifier les options du fichiers de config, celuis ci se trouve dans

/etc/ssh/

Je ne peux que vous inviter à lire la documentation du site ubuntu.fr.

Pour vous connecter il faut un client, sur linux en mode console (ou graphique), openssh-client est installé par défaut. Il ne vous reste plus qu’à taper ssh utilisateur@nom ou adresse ip du serveur, vous pouvez mettre -p pour le mot de passe

Sur un client Linux en mode graphique, ouvrez un terminal ,tapez la commande qu’on vient de voir et vous serez connectés pour passer des commandes consoles. Pour ouvrir une liaison sftp avec le serveur, c’est relativement simple. Sous Debian et Ubuntu (Gnome 2), allez dans le menu Raccourcis et choisissez « Se connecter à un serveur ».

La fenêtre ci-dessous apparaît, choisissez le service ssh et remplissez les champs.

Ici, seul un paramètre peut vous paraître un peu obscur. Je veux parler de l’option « Ajouter un signet ». Cette option permet de créer un icône (ou signet sous gnome2) dans le panneau latéral de Nautilus avec le nom que vous souhaitez.

Si vous êtes sur windows plusieurs logiciels client existent:

PUTTY:

Le plus léger et le plus rapide que j’utilise depuis plusieurs années est Putty je l’utilise encore souvent car le simple exe suffit et il peut donc être éxécuter à partit de la clef USB. Il a aussi un coté très pratique au niveau du copier/coller: Le simple fait de sélectionner le texte dans la console le copie et à l’inverse, un clic droit dans la console et  le presee papier est collé à l’emplacement du curseur.  Vous pouvez y associer Winscp pour le transfert de fichier.

XSHELL & XFTP:

Ces deux outils gratuits pour une utilisation étudiante ou à usage personnel sont le pendant des deux précédents outils avec quelques fonctionnalités complémentaires. Précision importante si vous utilisez windows seven, Xshell gère les connections SERIAL sur port COM cela remplace à merveille le manquant Hyperterminal.

EHCP signifie en Easy Hosting Control Panel, en d’autres termes EHCP est un panneau de contrôle d’hébergement simplifié. Il permet donc à un utilisateur de gérer facilement son nom de domaine avec tout ce qui en suit (accès via FTP à son espace dédié, ses boites e-mail, etc …)

Dans cette documentation, nous ne reverrons pas certains points qui sont déjà documentés sur internet. Toutefois, nous allons indiquer quelques liens.
L’installation d’EHCP est documenté sur le site officiel qui est par ailleurs assez complet, voici le lien vers la procédure d’installation : http://ehcp.net/?q=node/153
Dans cette documentation, nous utilisons un serveur DNS secondaire sous Bind9, voici la documentation complète du DNS sur le site ubuntu-fr.org : http://doc.ubuntu-fr.org/bind9
Par ailleurs, si vous rencontrez des problèmes avec EHCP, nous vous invitons à consulter le site ehcp.net. Vous y trouverez les réponses à vos questions.

Nous remercions tout les auteurs qui ont écrit ces documentations !

Pour cette documentation, nous avons utilisé Ubuntu Server 10.04.2 LTS. C’est d’ailleurs Ubuntu qui est recommandé par les développeurs d’EHCP, bien qu’il soit possible d’installer EHCP sur debian ou sur une dérivé d’ubuntu ou de debian. Ici, EHCP est en version 0.30.4 .

I.  Le DNS sur EHCP :

•  Utilisation du DNS par EHCP :

EHCP utilise Bind9 pour gérer les domaines. Le fonctionnement de Bind9 est identique à un serveur DNS configuré manuellement à l’exception de quelques fichiers.
Par défaut, les zones que l’on déclare dans Bind9 se trouve dans le fichier named.local.conf. EHCP va mettre ses zones et ses enregistrements ailleurs. Ses zones vont se trouver dans le fichier named_ehcp.conf et les enregistrements se trouve dans un fichier portant le nom du domaine auquel ils appartiennent.

Si l’on veut ajouter des zones DNS sur le serveur EHCP, il ne faut pas les mettre dans le fichier named_ehcp.conf car à chaque ajout ou suppression de domaine depuis l’interface Web, le fichier est ré-écrit avec les informations stockées dans la base de donnée !

• Voici un exemple du contenu de ces fichiers :

/*
domain id:1
domainname:teletechno.local
panelusername:teletechno
reseller:admin
aciklama-explanation:{aciklama}
*/
zone « teletechno.local » {
type master;
file « /etc/bind/teletechno.local »;
};

Fichier named_ehcp.conf

Notez bien que la zone de recherche inverse ne se crée pas automatiquement !

$TTL    86400
@       IN      SOA     ns.teletechno.local. your.email.here (
83     ; Serial, this is www.ehcp.net dns zone template file..
10800   ; Refresh
1200     ; Retry
86400  ; Expire
86400 ) ; Minimum

teletechno.local.           IN NS   ns.teletechno.local.
ns.teletechno.local.        IN A    192.168.16.251
ns1.teletechno.local.       IN A    192.168.16.251
ns2.teletechno.local.       IN A    192.168.16.251
dns.teletechno.local.       IN A    192.168.16.251
dns1.teletechno.local.       IN A    192.168.16.251
dns2.teletechno.local.       IN A    192.168.16.251
teletechno.local.           IN A    192.168.16.251
mail.teletechno.local.      IN A    192.168.16.251
smtp.teletechno.local.   IN A    192.168.16.251
imap.teletechno.local.   IN A    192.168.16.251
webmail.teletechno.local.   IN A    192.168.16.251
ftp.teletechno.local.       IN CNAME        teletechno.local.
www.teletechno.local.       IN CNAME        teletechno.local.
teletechno.local.           IN MX  10 mail.teletechno.local.
teletechno.local.           IN TXT « v=spf1 a mx »

*                       IN A    192.168.16.251

Fichier « teletechno.local » qui contient les enregistrements du domaine « teletechno.local »

• Synchronisation de deux serveurs DNS (avec ou sans EHCP)

Nous partons du principe qu’au moins un serveur DNS est configuré et qu’il sera le serveur maître de la zone ou des zones DNS.

Avant de configurer le serveur DNS secondaire (esclave), une modification doit être faite sur le serveur maître. Il faut en faite configurer le transfert de zone! Dans les zones DNS configurées dans le fichier /etc/bind/named.conf.local ou named_ehcp.conf, l’option allow-transfer doit être rajouté comme suit :

zone « teletechno.exemple » {
type master;
file « /etc/bind/db.teletechno.exemple »;
allow-transfer { @ip_esclave; };
};
[...]
zone « 1.168.192.in-addr.arpa » {
type master;
notify no;
file « /etc/bind/db.192″;
allow-transfer { @ip_esclave; };
};

Remplacez @ip_esclave par l’ip du serveur DNS secondaire et à adapter
selon le cas de figure.

Avertissement : si vous modifiez le fichier named_ehcp.conf, faites en une sauvegarde avec votre modification. Car à chaque ajout ou suppression d’un domaine, le fichier est ré-écrit avec les informations stockées dans la base de donnée !
Sur le serveur secondaire, installez le paquet bind9 si ce n’est pas déjà fait. Ensuite éditez le fichier /etc/bind/named.conf.local (ou named_ehcp.conf pour EHCP, faire une sauvegarde aprés la modification !) et ajoutez y ces lignes :

zone « teletechno.exemple » {
type slave;
file « /var/cache/bind/db.teletechno.exemple »;
masters { @ip_maitre; };
};

[...]

zone « 1.168.192.in-addr.arpa » {
type slave;
file « /var/cache/bind/db.192″;
masters { @ip_maitre; };
};

Remplacez @ip_maitre par l’ip du serveur DNS maître et à adapter selon le cas de figure.

Test :
Redémarrez sur les deux serveurs le service Bind9. Dans /var/log/syslog sur le serveur DNS esclave, vous devriez avoir les lignes suivantes :

syslog.5.gz:Dec 27 23:33:53 ubuntu named[5064]: zone teletechno.exemple/IN: transferred serial 2010122701

syslog.5.gz:Dec 27 23:33:53 ubuntu named[5064]: transfer of ‘teletechno.exemple/IN’ from 192.168.16.202#53: end of transfer

syslog.5.gz:Dec 27 23:33:35 ubuntu named[5064]: slave zone « 1.168.192.in-addr.arpa » (IN) loaded (serial 2010122701)

Pour vérifier le bon fonctionnement du serveur DNS secondaire, configurez un poste pour qu’il utilise le serveur DNS secondaire puis essayez de résoudre le domaine teletechno.exemple en faisant un ping.

II. La fonctionnalité de sauvegarde et de restauration

La fonction de sauvegarde et de restauration permet de faire des sauvegardes régulières de l’ensemble du serveur EHCP.

•  La sauvegarde :

Pour effectuer une sauvegarde de l’ensemble du serveur EHCP, cela se passe dans le menu « System → Generate Backup » sans sélectionner un domaine !

Aperçu de la « section system » de la page principale. (Thème Sky)

Ensuite, cette page apparaît. Remplissez les champs. L’option « Backup ehcp files itseft » permet de sauvegarder tout les fichiers contenu dans /var/www/new/ehcp

Aperçu de la page « Generate-backup ». (Thème Sky)

La sauvegarde se fera sous la forme d’une archive avec le nom formaté de la maniére suivante :
backup-‘annee‘-‘mois‘-‘jour’-‘heure‘-‘minute‘-‘seconde’.tgz
Les sauvegardes sont stockées dans /var/backup.

• La restauration :

Pour effectuer une restauration, il vous faut une sauvegarde sinon on ne va pas très loin. Une fois muni de votre sauvegarde, rendez vous dans le menu « System → Restore Backup »

Aperçu de la « section system » de la page principale. (Thème Sky)

Ensuite, cette page apparaît. Vous devez y indiquer le nom de la sauvegarde que vous souhaitez utiliser (la sauvegarde doit être stockée dans le répertoire /var/backup).

Aperçu de la page « restore backup ». (Thème Sky)

Une fois le nom saisi, cliquez sur le bouton « envoyer ». Pour surveiller l’état de la restauration, cliquez sur le lien « List Backups » et allez à la fin de la liste.

Aperçu du message dans « List Backup » lors d’une restauration en cours. (Thème Sky)

Cliquez sur le lien « Refresh List » afin de voir apparaître le message disant que la restauration s’est bien passée.

Aperçu du message dans « List Backup » lorsque la sauvegarde est terminé avec succès . (Thème Sky)

• Contenu de la sauvegarde :

L’archive de sauvegarde est architecturée de cette façon :
→ Une archive avec les fichiers de l’interface de EHCP (si l’option « Backup ehcp files itseft » a été cochée.
→ Une archive contenant le(s) domaine(s) avec les fichiers contenu dans « /var/www/vhosts/ »
→ Un fichier « mysql.sql » contenant la base de donnée SQL.

III. Personnalisation du thème

Cette documentation est valable pour le thème « Sky » qui n’est pas le thème par défaut d’EHCP ! Seul la partie concernant le nom des pages est applicable à l’ensemble des thèmes !

•  Étape : Ajouter une bannière et modifier le nom des pages.

Dans le thème « Sky », le nom « EHCP » est présent sur toutes les pages dans un encadrer bleu en haut à gauche.

Pour y mettre votre logo, commencez par uploader sur le serveur EHCP le logo avec les dimensions suivantes de préférence : 110px * 27px.
Uploadez dans le dossier du thème : /var/www/new/ehcp/templates/sky/’langue’ (en ou fr si le thème a été traduit). Vous trouverez également dans ce dossier les images « favicon.ico » et favicon-large.png ».
Ensuite, il faut éditer le fichier « template_en.html » dans le dossier templates/sky/en (‘en’ si le thème n’a pas été traduit, sinon ça serait fr).

Avant d’aller y insérer le code html pour mettre notre image, nous allons donner un nom au page. Ajoutez ce code aprés la balise <head> :

<title>Teletechno – EHCP</title>

Ensuite rendez-vous à la ligne 174, vous devriez voir :

<h1>EHCP</h1>

Remplacez EHCP par le code suivant pour y mettre le logo :

<img src= »templates/sky/en/NomLogo.Extension » Border=0>

Remplacez « NomLogo.Extension » par le nom du fichier image.

• Étape : remplacer EHCP par le nom de votre société sur la page de login

Pour changer le nom de la page de login et y remplacer « EHCP » par Teletechno de l’encadrer bleu, éditez le fichier loginpage_en.html dans le répertoire du thème (/var/www/new/ehcp/templates/sky/’langue’ (en ou fr si le thème a été traduit))
A la ligne 5, vous devriez avoir cette balise :

<title>EHCP Control Panel Login</title>

Remplacez le par ce que vous voulez, exemple :

<title>Teletechno – EHCP – Login</title>

Ensuite, allez à la ligne 5 et remplacez « EHCP » par ce que vous voulez.

Ici, on ne met pas le logo car l’espace ,qui peut y être consacré, est insuffisant.

IV. Les utilisateurs EHCP
Dans EHCP, il y a deux types d’utilisateurs. On a d’un côté les utilisateurs qui peuvent modérer des domaines, que l’on appellera « utilisateur », et de l’autre des « utilisateurs-domaines » dont leurs droits sont limités à leur domaine.

•   Les « utilisateurs »

Les « utilisateurs » peuvent seulement modérer leur(s) domaine(s) qu’ils créent eux même. L’administrateur est le seul à pouvoir modérer l’ensemble des domaines présents sur le serveur EHCP.
Pour créer ce type d’utilisateur, rendez-vous dans le menu « Panel Users → Add Panel User ».

Aperçu de la « section Panel Users ». (Thème Sky)

Ensuite, un formulaire apparaît dans lequel, on rentre toutes les informations nécessaire à la création de l’utilisateur . On peut définir :
→  le nombre de domaine que cet utilisateur peut créer,
→  le quota en MégaByte qui correspond à la taille de son espace dédié,
→  le nombre d’utilisateur qu’il peut créer et donc gérer,
→  le nombre d’utilisateur FTP,
→  le nombre de base de donnée qu’il peut utiliser.

Aperçu de la page « create Panel Users ». (Thème Sky)

• Les « utilisateurs-domaines » et les domaines

Un « utilisateur-domaine » est un compte utilisateur lié à un domaine donné et n’a de droit que sur ce dernier. En conséquence, les droits en sont réduit et ne permet pas certaines actions.
La création d’un « utilisateur-domaine » est indissociable de la création un domaine sur EHCP. Donc la création d’un domaine et d’un « utilisateur-domaine » se fait en même temps. Mais étant donné qu’un utilisateur classique permet de faire la même chose qu’un « utilisateur-domaine », ce dernier n’est pas obligatoire. Il est intéressant si on veut donner les droits à une personne sur un seul domaine.
Donc la création d’un domaine peut se faire sans « utilisateur-domaine » en utilisant le menu « Domain → Easy add domain » ou avec un « utilisateur-domaine » via le menu « Domain → Add domain ».

Aperçu de la « section Domain ». (Thème Sky)

Aperçu du menu « Add Domain ». (Thème Sky)

Il est préférable de créer un utilisateur avec le domaine car nous pouvons paramétrer notamment l’upload, le download sur l’espace dédié à ce domaine, et un utilisateur FTP.

Aperçu du menu « Easy Add Domain ». (Thème Sky)

Ce menu permet une création d’un domaine avec une configuration minimun.