Page History

Un Pack additionnel, qu'est-ce que c'est ?

 Un pack de supervision, mis à dispositions par Shinken solutions, est un regroupement de commandes permettant de superviser un type d'équipement particulier.

Dans son état natif, Shinken embarque plusieurs de ces packs pour proposer une base standard de monitoring. Dans cette base, on retrouve notamment :

• Le pack linux
• Le pack Windows
• Le pack cisco

Les packs additionnels permettent d'étendre les capacités de Shinken en ajoutant la possibilité de superviser de nouveaux types d'équipements. Ces packs s'installent de manière unitaire sur les serveurs Shinken, en fonction du besoin.

La structure d'un Pack additionnel

Les packs additionnels sont tous organisés de la même manière. 

On y retrouve :

• un répertoire monitoring-definition, qui contient les différents fichiers de configuration qui vont permettre de créer les nouvelles commandes et modèles dans l'interface de Shinken.
• un répertoire : probe, contient les sondes de supervision sur lequels s'appuirons les commandes pour contacter les équipements.
• un répertoire : shinken-source-module, contient tous les éléments pour créer la source, qui permettra d'importer les nouveaux éléments dans l'interface de configuration de shinken.

Ainsi que :

• un script d'installation, qui permet :
  • de créer la source
  • d'importer les cfg
  • d'importer les sondes
• un script de désinstallation, qui permet :
  • de supprimer la source
  • de supprimer les cfg
  • de supprimer les sondes

Cet ensemble d'élément, complétement autonome, permet l'installation simple et rapide du pack additionnel sur une instance Shinken.

Comment installer un Pack additionnel ?

Pour chaque Pack additionnel, un script d'installation dédié est fourni avec celui-ci. Pour installer le pack, il suffit d'exécuter le script sans arguments.

./install.sh

Le script trace les actions réalisées dans un retour terminal :

=============================================
INSTALL PACK [ shinken-proxmox_by_api ]
=============================================

    -----------------------------
    |   COLLECTOR [ shinken-additional-packs-import ]

        => Collector cfg file already AVAILABLE
              - Path : /etc/shinken/sources/shinken-additional-packs-import.cfg
        => Deleting Collector DATA SPACE 
              - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import
        => CREATING Collector DATA space
              - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import
              - Changing owner ( to "shinken" user )
              - Setting rights

    -----------------------------
    |   MONITORING DEFINITION:

        => Installing definitions file in source-data folder ( Collector => shinken-additional-packs-import )
              - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import
              - Changing owner ( to "shinken" user )
              - Setting rights

        => Installing global data definitions file in SHINKEN directory ( => resource.d )
              - Path : /etc/shinken/resource.d/shinken-additional-packs-import/
              - Changing owner ( to "shinken" user )
              - Setting rights

    -----------------------------
    |   PROBES:

        => Deleting previous probes
        => Installing probes
              - Path : /var/lib/shinken-user/libexec/shinken-additional-packs/proxmox/shinken-proxmox_by_api
              - Setting owner ( to "shinken" user )
              - Setting rights

Application du modèle via l'interface de Configuration

Dans votre fichier de définition de vos éléments à importer via votre collecteur :