====== Shinken - Activité : Installation de Shinken ======

Shinken peut s'installer sur n'importe quel système disposant d'un interpréteur **Python**, y compris Windows ou Androïd.

===== Vérification de l'OS en version 64 bits =====

Pour Linux, il faut impérativement utiliser une distribution Linux Debian 64 bits. On peut vérifier cela ainsi.
<code shell>
root@ctShinken:~# uname -a
Linux ctShinken 4.4.6-1-pve #1 SMP Thu Apr 21 11:25:40 CEST 2016 x86_64 GNU/Linux
</code>
La commande **uname -a** affiche toutes les informations disponibles sur la version du système d'exploitation et le type de la machine.

Si on fait une recherche sur le paquet  4.4.6-1-pve vous trouverez des informations montrant qu'il s'agit d'une image 64 bits. En effet, les conteneurs LXC sont basés sur le noyau Linux Debian de Proxmox qui est en 64 bits.

Pour connaître la version de votre distribution Debian utilisez la commande suivante :
<code shell>
root@ctShinken:~# cat /etc/debian_version
8.6
</code>

===== Installation du gestionnaire de paquets python pip =====

La suite de l'installation se base sur la procédure décrite sur le site (avec quelques ajouts cependant) : 
  * http://shinken.readthedocs.org/en/latest/02_gettingstarted/installations/shinken-installation.html

On choisit la méthode basée sur des **packages pip**.

  * Mise à jour du système : 
<code shell>
root@ctShinken:~# apt update && apt upgrade
</code>
  * Installation des **prerequis** :
<code shell>
root@ctShinken:~# apt install python-pycurl  python-setuptools python-cherrypy3 
</code>

===== Création du compte utilisateur shinken =====
Créez un compte **shinken** avec le mot de passe **shinken** sans plus d'information.
<code shell>
root@ctShinken:~# adduser shinken
</code>

===== Installation de Shinken =====

==== Installation avec les sources ====
  * télécharger la dernière version : https://pypi.org/project/Shinken/
<code shell>
# wget https://github.com/naparuba/shinken/archive/2.4.3.tar.gz
</code>
  * décompressez le fichier et lancez l'installation
<code shell>
# tar -xvzf 2.4.3.tar.gz
# cd shinken-2.4.3
# python setup.py install 
</code>

===== Lancement de shinken =====
Il faut systématiquement se connecter avec l**'utilisateur shinken** dès lors qu'on ajoute des éléments à shinken. Car les différents exécutables de shinken utilisent l'uid shinken. Il faut donc que les nouveaux fichiers installés bénéficient des droits shinken et non root.

On va donc ouvrir une session terminal et se connecter avec l'utilisateur shinken :


Lien vers uns page web avec une explication succincte de l'outil client shinken :
  * http://www.shinken-monitoring.org/wiki/shinken.io/start

L'outil client shinken permet de** rechercher et d'installer facilement** des modules et des **packs** shinken à partir de l'url http://shinken.io 

===== Initialisation de l'outil client shinken =====
Il faut **systématiquement se connecter** avec l'utilisateur **shinken** pour **gérer** le service shinken et dès que l'on **ajoute** des éléments à shinken. Car les différents exécutables de shinken utilisent l'**uid shinken**. Il faut donc que les nouveaux fichiers installés bénéficient des droits **shinken** et non root.

On va donc ouvrir une session terminal et se connecter avec l'utilisateur shinken :
<code shell>
root@ctShinken:~# su - shinken
shinken@ctShinken:~$
</code>

Lien vers uns page web avec une explication succincte de l'outil client shinken :
  * http://www.shinken-monitoring.org/wiki/shinken.io/start

L'outil client shinken permet de** rechercher et d'installer facilement** des modules et des **packs** shinken à partir de l'url http://shinken.io 

===== Initialisation de l'outil client shinken =====
Il faut tout d'abord initialiser l'outil client shinken.
<code shell>
shinken@ctShinken:~$ shinken --init
Creating ini section paths
Creating ini section shinken.io
Saving the new configuration file /home/shinken/.shinken.ini
</code>

Ce qui crée le fichier **.shinken.ini** dans le répertoire **/home/shinken** :
==== Démarrer le service Shinken ====
<code shell>
shinken@ctShinken:~$ /etc/init.d/shinken start
Starting scheduler: 
. OK
Starting poller: 
. OK
Starting reactionner: 
. OK
Starting broker: 
. OK
Starting receiver: 
. OK
Starting arbiter: 
. OK
</code>

Les modules présents après l'installation sont les modules obligatoires :
<code shell>
shinken@ctShinken:~$ ls /var/lib/shinken/modules/
dummy_arbiter  dummy_broker_external  dummy_scheduler
dummy_broker   dummy_poller	      __init__.py
</code>

Dans le répertoire de configuration des modules optionnels on ne trouve qu'un exemple :
<code shell>
shinken@ctShinken:~$ ls /etc/shinken/modules/
sample.cfg
</code>
A ce stade shinken est opérationnel mais il nous manque un outil pour visualiser notre supervision.


==== Je reviens au menu Shinken ====
<WRAP center round info >
  * [[reseau:supervision:shinken_00|Supervision des services avec Shinken]]
</WRAP>