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/