Contexte

 

Le site http://shinken.io/ référence un certain nombre de packages et modules.

Il se peut vous vous soyez amenés à utiliser un ces packs pour un besoin particulier.

 

Attention, des packs peuvent provenir de la communauté Shinken, et donc nous ne pouvons pas garantir leur bon fonctionnement.

Mise en place du pack

 

Création d'une source

 

Avant tout, il est nécessaire de créer une source qui permettra d'accueillir le pack. 

Voici le lien de la documentation à ce sujet : Importer ses propres fichiers CFG

Une fois la source faite, il suffira d'intégrer les cfg dans le dossier.

 

Téléchargement du pack

 

Pour installer le pack de supervision (qui contient les cfg et sondes) depuis shinken.io, via la page http://shinken.io/package/linux-snmp par exemple, il faut donc tout d'abord télécharger le pack à proprement parler et pousser les fichiers sur le serveur Shinken.

Pour cela, il faut aller sur le lien "Repository".

La commande "shinken install linux-snmp" n'est pas disponible depuis Shinken Entreprise

 

Ici on peut télécharger les sources avec le bouton "Clone or download":

 

Décompresser l'archive et le mettre sur le serveur Shinken.

Les répertoires intéressants dans un pack seront les suivants:

  • pack : contient les cfg des templates, checks et commands
  • libexec: [attention peu de packs sur shinken.io ont ce répertoire] contient la sonde utilisée 

installation du pack

Pour installer le pack il faut:

  • placer les fichiers dans le répertoire "Packs" dans le dossier de la source /etc/shinken-user/source-data/source-data-cfg-ma-source/packs/
  • donner la possession de ce répertoire ainsi que ses fils à l'utilisateur système Shinken via la commande

 

chown -R shinken:shinken source-data-cfg-ma-source/

 

  • copier le contenu du répertoire libexec dans le répertoire libexec dédié aux utilisateurs, donc dans /var/lib/shinken-user/libexec sur le synchronizer et les pollers

ATTENTION: il faut bien vérifier que la sonde posée dans libexec ait les droits d'exécutions pour l'utilisateur shinken, et ceci sur le synchronizer et TOUS les pollers de l'installation. ( commande : chmod +x masonde )

  • éditer si besoin les DATA globales présentes dans le pack et/ou sur les commandes afin de mettre le répertoire d'appel de la sonde en accord avec là où il a été placé physiquement. Les débuts des lignes commandes avec $NAGIOSPLUGINSDIR$ sont à remplacer par $USERPLUGINSDIR$ qui correspond à /var/lib/shinken-user/libexec. (vous pouvez vérifier les variables globales dans /etc/shinken/resource.d/paths.cfg et /etc/shinken-user/configuration/global-data/ )
  • lancer l'import de la source et vérifier avec un try check que l'appel de la sonde est bien opérationnel.