Installation de Shinken sur une Debian : Différence entre versions
De wikiGite
(15 révisions intermédiaires par 2 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
= Installation par script (depuis v1.0) = | = Installation par script (depuis v1.0) = | ||
− | http://www.shinken-monitoring.org/wiki/shinken_10min_start | + | Doc officielle : http://www.shinken-monitoring.org/wiki/shinken_10min_start |
Installation des pré-requis : | Installation des pré-requis : | ||
<!-- apt-get install build-essential python python-dev python-setuptools pyro libgd2-xpm-dev git-core lsb-release ---- peut-être pas nécessaire ? A vérifier --> | <!-- apt-get install build-essential python python-dev python-setuptools pyro libgd2-xpm-dev git-core lsb-release ---- peut-être pas nécessaire ? A vérifier --> | ||
+ | apt-get install lsb-release pyro | ||
useradd --user-group shinken | useradd --user-group shinken | ||
usermod --lock shinken | usermod --lock shinken | ||
Ligne 9 : | Ligne 10 : | ||
mkdir /root/install | mkdir /root/install | ||
cd /root/install | cd /root/install | ||
− | wget http://shinken-monitoring.org/pub/shinken-1. | + | * Version stable : |
− | tar -xvzf shinken-1. | + | wget <nowiki>http://shinken-monitoring.org/pub/shinken-1.2.tar.gz</nowiki> |
− | + | tar -xvzf shinken-1.2.tar.gz | |
− | + | * ou version en cours de développement, pour tests : | |
− | ''Note : en cas d'erreur SSL : | + | git clone <nowiki>https://github.com/naparuba/shinken</nowiki> |
+ | <!-- ''Note : en cas d'erreur SSL : | ||
error: SSL certificate problem, verify that the CA cert is OK. Details: | 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 | error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed while accessing https://github.com/naparuba/shinken/info/refs | ||
− | |||
fatal: HTTP request failed | fatal: HTTP request failed | ||
Ajouter cette variable d'environnement avant git : | Ajouter cette variable d'environnement avant git : | ||
env GIT_SSL_NO_VERIFY=true git clone https://github.com/naparuba/shinken --> | env GIT_SSL_NO_VERIFY=true git clone https://github.com/naparuba/shinken --> | ||
− | |||
Installation de Shinken : | Installation de Shinken : | ||
− | cd shinken | + | cd shinken* |
<!-- python setup.py install --install-scripts=/usr/bin --> | <!-- python setup.py install --install-scripts=/usr/bin --> | ||
− | ./install -i && ./install -p nagios-plugins && ./install - | + | ./install -i && ./install -p nagios-plugins && ./install -a pnp4nagios |
* Fichiers de Configuration : /usr/local/shinken/etc/shinken | * Fichiers de Configuration : /usr/local/shinken/etc/shinken | ||
Ligne 30 : | Ligne 30 : | ||
* Plugins Shinken + Nagios : /usr/local/shinken/libexec | * Plugins Shinken + Nagios : /usr/local/shinken/libexec | ||
− | ''' | + | '''NOTE''' : on peut installer tous les modules disponibles par : |
− | ./install -i && ./install -p nagios-plugins && ./install -p check_mem && ./install -p manubulon && ./install - | + | ./install -i && ./install -p nagios-plugins && ./install -p check_mem && ./install -p manubulon && ./install -a multisite && ./install -a pnp4nagios |
+ | Attention multisite et pnp4nagios sont des add-ons ("-a") pas des plugins ("-p"). Si quelqu'un sait la différence... | ||
− | Démarrage de Shinken : | + | <!-- Démarrage de Shinken : |
/etc/init.d/shinken-scheduler start | /etc/init.d/shinken-scheduler start | ||
/etc/init.d/shinken-poller start | /etc/init.d/shinken-poller start | ||
Ligne 39 : | Ligne 40 : | ||
/etc/init.d/shinken-reactionner start | /etc/init.d/shinken-reactionner start | ||
/etc/init.d/shinken-arbiter start | /etc/init.d/shinken-arbiter start | ||
− | /etc/init.d/shinken-receiver start | + | /etc/init.d/shinken-receiver start --> |
− | |||
Si nécessaire, pour relancer Shinken : | Si nécessaire, pour relancer Shinken : | ||
/etc/init.d/shinken restart | /etc/init.d/shinken restart | ||
Ligne 46 : | Ligne 46 : | ||
Test de l'installation : | Test de l'installation : | ||
<nowiki>https://<hostname>:7767</nowiki> | <nowiki>https://<hostname>:7767</nowiki> | ||
− | + | Si ça n'a pas déjà été fait par le script d'installation, créer un lien de la configuration de Shinken, /usr/local/shinken/etc vers /etc/shinken | |
− | + | ln -s /usr/local/shinken/etc /etc/shinken | |
− | == Configuration | + | Si PNP4NAGIOS a été installé, penser à lancer le démon NPCD |
+ | /etc/init.d/npcd restart | ||
+ | |||
+ | = Mise à jour = | ||
+ | Comme pour l'installation, charger la dernière version de Shinken par wget. Puis dans le répertoire de l'archive décompressée : | ||
+ | ./install -b # Backup configuration | ||
+ | ./install -u # Uninstall Shinken | ||
+ | ./install -i # Install new version | ||
+ | ./install -l # List backups | ||
+ | ./install -r <backup_id> # Restore last backup | ||
+ | |||
+ | = 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 : | 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 | htpasswd /etc/shinken/htpasswd.users admin | ||
Ligne 64 : | Ligne 75 : | ||
Les plugins supplémentaires sont identiques à ceux de Nagios : http://exchange.nagios.org/ | Les plugins supplémentaires sont identiques à ceux de Nagios : http://exchange.nagios.org/ | ||
+ | = pnp4nagios = | ||
+ | Cet add-on permet d'avoir des graphes de performances calculés à partir des informations récoltées par Shinken. Il est désormais installé par le script "install" de Shinken. | ||
+ | Pour plus de détails, voir [[Installation_de_PNP4Nagios]] | ||
+ | ------------------------------------------------- | ||
− | |||
= ''Pour archive'' Installation par script Nicolargo = | = ''Pour archive'' Installation par script Nicolargo = | ||
You can use the very good installation script from Nicolargo! Thanks a lot to him :) | You can use the very good installation script from Nicolargo! Thanks a lot to him :) |
Version actuelle datée du 27 septembre 2012 à 08:48
Sommaire
Installation par script (depuis v1.0)
Doc officielle : http://www.shinken-monitoring.org/wiki/shinken_10min_start
Installation des pré-requis :
apt-get install lsb-release pyro useradd --user-group shinken usermod --lock shinken
Téléchargement de Shinken et des plugins :
mkdir /root/install cd /root/install
- Version stable :
wget http://shinken-monitoring.org/pub/shinken-1.2.tar.gz tar -xvzf shinken-1.2.tar.gz
- ou version en cours de développement, pour tests :
git clone https://github.com/naparuba/shinken
Installation de Shinken :
cd shinken* ./install -i && ./install -p nagios-plugins && ./install -a 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
NOTE : on peut installer tous les modules disponibles par :
./install -i && ./install -p nagios-plugins && ./install -p check_mem && ./install -p manubulon && ./install -a multisite && ./install -a pnp4nagios
Attention multisite et pnp4nagios sont des add-ons ("-a") pas des plugins ("-p"). Si quelqu'un sait la différence...
Si nécessaire, pour relancer Shinken :
/etc/init.d/shinken restart
Test de l'installation :
https://<hostname>:7767
Si ça n'a pas déjà été fait par le script d'installation, créer un lien de la configuration de Shinken, /usr/local/shinken/etc vers /etc/shinken
ln -s /usr/local/shinken/etc /etc/shinken
Si PNP4NAGIOS a été installé, penser à lancer le démon NPCD
/etc/init.d/npcd restart
Mise à jour
Comme pour l'installation, charger la dernière version de Shinken par wget. Puis dans le répertoire de l'archive décompressée :
./install -b # Backup configuration ./install -u # Uninstall Shinken ./install -i # Install new version ./install -l # List backups ./install -r <backup_id> # Restore last backup
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/
pnp4nagios
Cet add-on permet d'avoir des graphes de performances calculés à partir des informations récoltées par Shinken. Il est désormais installé par le script "install" de Shinken.
Pour plus de détails, voir Installation_de_PNP4Nagios
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/