Outils personnels

Installation de Shinken sur une Debian : Différence entre versions

De wikiGite
 
(58 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
−
Source : Nicolargo
+
= Installation par script (depuis v1.0) =
 +
Doc officielle : http://www.shinken-monitoring.org/wiki/shinken_10min_start
  
−
La version 0.4 du script va installer:
+
Installation des pré-requis :
−
*Shinken 0.6
+
<!-- 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 -->
−
*Thruk 1.0.2
+
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 <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 :
 +
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: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*
 +
<!-- python setup.py install --install-scripts=/usr/bin -->
 +
./install -i && ./install -p nagios-plugins && ./install -a pnp4nagios
  
−
La procédure pour installer ou mettre à jour votre serveur de supervision Shinken est toujours la même:
+
* Fichiers de Configuration :  /usr/local/shinken/etc/shinken
−
  cd ~
+
* Fichier log : /usr/local/shinken/var/lib/shinken/nagios.log
−
rm -f shinkenautoinstall-debian.sh
+
* Plugins Shinken + Nagios : /usr/local/shinken/libexec
−
wget http://svn.nicolargo.com/shinkenautoinstall/trunk/shinkenautoinstall-debian.sh
 
−
chmod a+x shinkenautoinstall-debian.sh
 
−
sudo ./shinkenautoinstall-debian.sh
 
  
−
Si tout se passe comme prévu, le script devrait afficher:
+
'''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
−
Installation is finished
+
Attention multisite et pnp4nagios sont des add-ons ("-a") pas des plugins ("-p"). Si quelqu'un sait la différence...
−
----------------------------------------------------
 
−
Backup configuration file : /tmp/shinken-backup-20110513073545.tgz
 
−
Configuration file folder : /etc/shinken
 
−
Log file : /var/lib/shinken/nagios.log
 
−
Shinken startup script : /etc/init.d/shinken
 
−
Thruk startup script : /etc/init.d/thruk
 
−
Thruk web interface URL : http://sam:3000
 
  
−
Dans certain cas, notamment lors d'une mise à jour, il faut ensuite relancer Shinken:
+
<!-- Démarrage de Shinken :
−
  sudo /etc/init.d/shinken restart
+
/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
  
−
Pour remonter les éventuels bugs / nouvelles fonctions, merci d'utiliser le site officiel du script qui se trouve sur GitHub à l'adresse suivante: https://github.com/nicolargo/shinkenautoinstall.
+
Test de l'installation :
 +
<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
  
−
------------------------------------------------------------------------
+
Si PNP4NAGIOS a été installé, penser à lancer le démon NPCD
 +
/etc/init.d/npcd restart
  
−
Manuel :
+
= 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
  
−
If you follow these instructions, here's what you'll end up with:
+
= 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
  
−
Shinken and the plugins will be installed underneath
+
Vérification des fichiers de configuration de Shinken :
−
  ”/usr/local/shinken”
+
  /usr/local/shinken/bin/shinken-arbiter -v -c /etc/shinken/nagios.cfg -c /etc/shinken/shinken-specific.cfg
  
−
Required Packages
+
= Plugins =
  
−
Make sure you've installed the following packages on your Ubuntu installation before continuing.
+
Installation des plugins Nagios :
−
  Python >= 2.4
+
  apt-get install nagios-plugins
−
Pyro (Python module for distributed objects)
+
  cp /usr/lib/nagios/plugins/* /usr/local/shinken/libexec/
−
  Git (If you want the lastest code)
 
−
python-setuptools
 
  
−
On a debian based system (like Ubuntu) you can use apt-get to install these packages by running the following commands:
+
Les plugins supplémentaires sont identiques à ceux de Nagios : http://exchange.nagios.org/
  
−
sudo apt-get install python pyro git-core python-setuptools
+
= 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.
  
−
Create Account Information
+
Pour plus de détails, voir [[Installation_de_PNP4Nagios]]
  
−
Become the root user.
 
  
−
sudo su -
+
-------------------------------------------------
  
−
Create a new shinken user account and give it a password.
+
= ''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
 
  /usr/sbin/useradd -m shinken
 
  passwd shinken
 
  passwd shinken
  
−
On Ubuntu server edition (9.10 and possible newer versions), you will need to also add a shinken group (it's not created by default). You should be able to skip this step on desktop editions of Ubuntu.
+
(/usr/sbin/groupadd shinken) : Pas nécessaire.
−
 
 
−
/usr/sbin/groupadd shinken
 
 
  /usr/sbin/usermod -G shinken shinken
 
  /usr/sbin/usermod -G shinken shinken
  
−
Add the apache user to this group to allow external commands to be send from the web interface.
 
 
  /usr/sbin/usermod -G shinken www-data
 
  /usr/sbin/usermod -G shinken www-data
  
−
Download Shinken and the Plugins
+
Téléchargement de Shinken et des plugins :
−
 
 
−
Create a directory for storing the downloads.
 
−
 
 
 
  mkdir ~/downloads
 
  mkdir ~/downloads
 
  cd ~/downloads
 
  cd ~/downloads
  
−
Download the source code of Shinken and the Shinken plugins (visit http://www.nagios.org/download/ for links to the latest versions of the plugins). At the time of writing, the latest versions plugins were 1.4.13.
+
/*git clone git://shinken.git.sourceforge.net/gitroot/shinken/shinken*/
−
git clone git://shinken.git.sourceforge.net/gitroot/shinken/shinken
+
git clone https://github.com/naparuba/shinken
−
 
 
−
Install Shinken (repasser en utilisateur normal)
 
  
 +
Installation de Shinken :
 
  cd shinken
 
  cd shinken
−
  sudo python setup.py install --install-scripts=/usr/bin
+
  python setup.py install --install-scripts=/usr/bin
−
 
 
−
Don't start Shinken yet - there's still more that needs to be done…
 
−
Customize Configuration
 
−
 
 
−
Sample configuration files have now been installed in the ”/etc/shinken/” directory. These sample files should work fine for getting started with Shinken. You'll need to make just one change before you proceed…
 
−
Install the Nagios Plugins to use with Shinken
 
−
 
 
−
You can download plugins from source, but your debian-like administrator will just will you :
 
−
 
 
−
sudo apt-get install nagios-plugins
 
−
 
 
−
Start Shinken
 
−
 
 
−
Configure Shinken to automatically start when the system boots.
 
−
 
 
−
sudo ln -s /etc/init.d/shinken-scheduler /etc/rcS.d/S98shinken-scheduler
 
−
sudo ln -s /etc/init.d/shinken-poller /etc/rcS.d/S98shinken-poller
 
−
sudo ln -s /etc/init.d/shinken-reactionner /etc/rcS.d/S98shinken-reactionner
 
−
sudo ln -s /etc/init.d/shinken-broker /etc/rcS.d/S98shinken-broker
 
−
sudo ln -s /etc/init.d/shinken-arbiter /etc/rcS.d/S98shinken-arbiter
 
−
 
 
−
Verify the sample Shinken configuration files.
 
−
 
 
−
/usr/bin/shinken-arbiter -v -c /etc/shinken/nagios.cfg -c /etc/shinken/shinken-specific.cfg
 
−
 
 
−
If there are no errors, start Shinken.
 
−
 
 
−
sudo /etc/init.d/shinken-scheduler start
 
−
sudo /etc/init.d/shinken-poller start
 
−
sudo /etc/init.d/shinken-broker start
 
−
sudo /etc/init.d/shinken-reactionner start
 
−
sudo /etc/init.d/shinken-arbiter start
 
−
 
 
−
--------------------------------------
 
−
 
 
−
Thruk  FastCGI
 
−
 
 
−
créer un répertoire thruk dans /opt
 
−
 
 
−
wget http://www.thruk.org/files/Thruk-1.0.4-x86_64-linux-gnu-thread-multi-5.10.0.tar.gz
 
−
 
 
−
tar -xzf Thruk-1.0.4-x86_64-linux-gnu-thread-multi-5.10.0.tar.gz
 
−
 
 
−
apt-get install libapache2-mod-fcgid libfile-copy-recursive-perl libmodule-install-perl apache2 libgd2-xpm-dev
 
−
 
 
−
Attention :
 
−
use this apache example configuration:
 
−
replace /home/thruk/Thruk with your installation path
 
−
replace your-web-host.local with your hostname
 
−
create a /home/thruk/Thruk/htpasswd.users with htpasswd2
 
−
make sure the /home/thruk/Thruk/logs/ directory exists
 
−
 
 
−
Lancement script Fastcgi :
 
−
./script/thruk_fastcgi.pl -n 5 -l /tmp/thruk_fastcgi.socket -p /tmp/thruk_fastcgi.pid
 
−
 
 
−
Paramétrage du démarrage automatique :
 
−
cp ./script/thruk_fastcgi_server.sh /etc/init.d/thruk_fastcgi_server
 
−
vi /etc/init.d/thruk_fastcgi_server
 
−
sudo chown root: /etc/init.d/thruk_fastcgi_server
 
−
 
 
−
Modifier le execuser par shinken (thruk par défaut)
 
−
et le execdir
 
−
 
 
−
attention aux droits sur /tmp
 
−
 
 
−
Apache :
 
−
 
 
−
/etc/apache2/sites-available
 
−
vi thruk
 
−
mettre le contenu du fichier
 
−
 
 
−
[[Thruk Apache Configuration]]
 
−
 
 
−
ports.conf
 
−
 
 
−
thruk
 
−
Supprimer l'ancien lien symbolique de la configuration d'origine
 
−
 
 
−
sudo a2dissite default
 
−
 
 
−
Il faut maintenant activer le vhost. Pour cela il faut créer un lien symbolique du fichier de sites-available/ vers sites-enabled/.
 
−
En utilisant:
 
−
 
 
−
sudo a2ensite thruk
 
−
 
 
−
/etc/init.d/apache2 restart / reload
 
−
 
 
−
git clone http://github.com/sni/Thruk.git
 
−
cd Thruk
 
−
perl Makefile.PL && make
 
−
 
 
−
cp thruk.conf thruk_local.conf
 
  
−
  htpasswd -c /opt/thruk/htpasswd.users admin
+
Installation des plugins Nagios :
−
+
  apt-get install nagios-plugins
−
chown -R shinken:shinken /opt/thruk
+
cp libexec/* /usr/lib/nagios/plugins/
  
−
  Editer thruk_local.conf
+
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
  
−
  libcatalyst-perl libcatalyst-engine-apache-perl libcatalyst-model-cdbi-perl libcatalyst-modules-extra-perl libcatalyst-modules-perl libcatalyst-view-tt-perl libhtml-prototype-perl
+
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
  
−
A virer :
+
*Fichiers de Configuration :  /etc/shinken
−
  a2enmod suexec
+
*Fichier log : /var/lib/shinken/nagios.log
−
SuexecUserGroup shinken shinken
+
*Plugins Nagios : /usr/lib/nagios/plugins/
−
apt-get install apache2-suexec
 
−
/usr/lib/apache2/suexec -V
 

Version actuelle datée du 27 septembre 2012 à 08:48

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/
Récupérée de « https://wiki.kogite.fr/index.php?title=Installation_de_Shinken_sur_une_Debian&oldid=5333 »