Installation de Shinken sur une Debian

Installation par script (depuis v1.0)

http://www.shinken-monitoring.org/wiki/shinken_10min_start

Installation des pré-requis :

useradd --user-group shinken
usermod --lock shinken

Téléchargement de Shinken et des plugins :

mkdir /root/install
cd /root/install
git clone https://github.com/naparuba/shinken

Note : en cas d'erreur SSL :

error: SSL certificate problem, verify that the CA cert is OK. Details:
error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed while accessing https://github.com/naparuba/shinken/info/refs

fatal: HTTP request failed

Ajouter cette variable d'environnement avant git :

env GIT_SSL_NO_VERIFY=true git clone https://github.com/naparuba/shinken

Installation de Shinken :

cd shinken
./install -i && ./install -p nagios-plugins && ./install -p pnp4nagios

• Fichiers de Configuration : /usr/local/shinken/etc/shinken
• Fichier log : /usr/local/shinken/var/lib/shinken/nagios.log
• Plugins Shinken + Nagios : /usr/local/shinken/libexec

A TESTER : on peut installer tous les modules disponibles par

./install -i && ./install -p nagios-plugins && ./install -p check_mem && ./install -p manubulon && ./install -p multisite && ./install -p pnp4nagios && ./install -p nagvis

Démarrage de Shinken :

/etc/init.d/shinken-scheduler start
/etc/init.d/shinken-poller start
/etc/init.d/shinken-broker start
/etc/init.d/shinken-reactionner start
/etc/init.d/shinken-arbiter start
/etc/init.d/shinken-receiver start

Si nécessaire, pour relancer Shinken :

/etc/init.d/shinken restart

Test de l'installation :

https://<hostname>:7767

Pour faciliter la maintenance, créer un lien de la configuration de Shinken, /usr/local/shinken/etc vers /etc/shinken

cd /etc; ln -s /usr/local/shinken/etc

Configuration

Le fichier de mots de passe par défaut est /etc/shinken/htpasswd.users (donc /usr/local/shinken/etc/htpasswd.users). Ajouter un utilisateur admin pour l'accès au WebUI :

htpasswd /etc/shinken/htpasswd.users admin

Vérification des fichiers de configuration de Shinken :

/usr/local/shinken/bin/shinken-arbiter -v -c /etc/shinken/nagios.cfg -c /etc/shinken/shinken-specific.cfg

Plugins

Installation des plugins Nagios :

apt-get install nagios-plugins
cp /usr/lib/nagios/plugins/* /usr/local/shinken/libexec/

Les plugins supplémentaires sont identiques à ceux de Nagios : http://exchange.nagios.org/

---

Pour archive Installation par script Nicolargo

You can use the very good installation script from Nicolargo! Thanks a lot to him :)

   wget https://raw.github.com/nicolargo/shinkenautoinstall/master/shinkenautoinstall-debian.sh
   chmod a+x shinkenautoinstall-debian.sh
   sudo ./shinkenautoinstall-debian.sh

---

Pour archive Procédure manuelle

Installation des pré-requis :

apt-get install build-essential python python-dev python-setuptools pyro libgd2-xpm-dev git-core

Se logguer en tant que root :

su -

Création de l'utilisateur shinken (avec le mot de passe) :

/usr/sbin/useradd -m shinken
passwd shinken

(/usr/sbin/groupadd shinken) : Pas nécessaire.
/usr/sbin/usermod -G shinken shinken

/usr/sbin/usermod -G shinken www-data

Téléchargement de Shinken et des plugins :

mkdir ~/downloads
cd ~/downloads

/*git clone git://shinken.git.sourceforge.net/gitroot/shinken/shinken*/
git clone https://github.com/naparuba/shinken

Installation de Shinken :

cd shinken
python setup.py install --install-scripts=/usr/bin

Installation des plugins Nagios :

apt-get install nagios-plugins
cp libexec/* /usr/lib/nagios/plugins/

Configuration du lancement automatique de Shinken au démarrage du système :

ln -s /etc/init.d/shinken-scheduler /etc/rcS.d/S98shinken-scheduler
ln -s /etc/init.d/shinken-poller /etc/rcS.d/S98shinken-poller
ln -s /etc/init.d/shinken-reactionner /etc/rcS.d/S98shinken-reactionner
ln -s /etc/init.d/shinken-broker /etc/rcS.d/S98shinken-broker
ln -s /etc/init.d/shinken-arbiter /etc/rcS.d/S98shinken-arbiter
ln -s /etc/init.d/shinken-receiver /etc/rcS.d/S98shinken-receiver

Vérification des fichiers de configuration de Shinken :

/usr/local/shinken/bin/shinken-arbiter -v -c /etc/shinken/nagios.cfg -c /etc/shinken/shinken-specific.cfg

Démarrage de Shinken :

/etc/init.d/shinken-scheduler start
/etc/init.d/shinken-poller start
/etc/init.d/shinken-broker start
/etc/init.d/shinken-reactionner start
/etc/init.d/shinken-arbiter start
/etc/init.d/shinken-receiver start

Si nécessaire, pour relancer Shinken :

/etc/init.d/shinken restart

• Fichiers de Configuration : /etc/shinken
• Fichier log : /var/lib/shinken/nagios.log
• Plugins Nagios : /usr/lib/nagios/plugins/