Page History

Contexte

Cette page a pour objectif de décrire la mise en place du pack windows-by-WinRM__shinken :

• Le déploiement du pack sur la plateforme (sur le Synchroniser et sur le ou les Pollers),

• La configuration des prérequis nécessaires à l’exécution des checks.

Procédure de mise en place du pack

En préambule, il faut :

1. récupérer la dernière version du pack auprès de l'équipe Shinken,
2. Transférer le pack sur le Synchronizer et le ou les Pollers.

En utilisant l'installeur "install.sh" ( sur Poller / Synchronizer )

Commun à tout Poller / Synchronizer

Que ce soit sur un Synchronizer où sur un Pollers :

1. Désarchiver le pack :

   Code Block
   language text theme Emacs
   tar --no-same-owner -xf NOM_DU_PACK.tar.xz

2. Entrée dans le répertoire extrait de l'archive et lancer le "install.sh"

   Code Block
   language text theme Emacs
   cd NOM_DU_PACK/ ./install.sh

3. L'installeur dépose les éléments suivants :

   • Le fichier de configuration de la source "shinken-additional-packs-import" qui servira à importer la définition du pack dans le Synchronizer.
   • Les fichiers de définitions des éléments du pack, à importer dans le Synchronizer.

   • Les sondes du pack.
     
     Exemple de mise en place :
     
     

     Code Block
     language text theme Emacs
     ======================================================== INSTALL PACK [ windows-by-WinRM__shinken v01.00.00 ] ======================================================== ----------------------------- | COLLECTOR [ shinken-additional-packs-import ] => Collector cfg file already AVAILABLE - Path : /etc/shinken/sources/shinken-additional-packs-import.cfg => Collector DATA space already AVAILABLE - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import => Definition File already AVAILABLE [ definition_shinken-additional-packs-import.cfg ] - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import/definition_shinken-additional-packs-import.cfg => Applying permissions - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import - Setting 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 - Setting 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/ - Setting owner ( to "shinken" user ) - Setting rights ----------------------------- | PROBES: => Deleting previous probes - Path : /var/lib/shinken-user/libexec/shinken-additional-packs/windows-by-WinRM__shinken => Installing probes - Path : /var/lib/shinken-user/libexec/shinken-additional-packs/windows-by-WinRM__shinken - Setting owner ( to "shinken" user ) - Setting rights

En suivant, spécifiquement sur le Synchronizer

1. Si le collecteur "shinken-additional-packs-import" n'est pas présent dans votre Synchronizer ( par exemple : lors de la première utilisation d'un installeur de pack Shinken ) :
   
   Ajouter le nom de la nouvelle source au Synchronizer en modifiant le paramètre sources du fichier  /etc/shinken/synchronizers/synchronizer-master.cfg.
   

   Code Block
   language text theme Emacs
   define synchronizer { [...] sources Source 1, Source 2, Source 3, shinken-additional-packs-import [...] }

   et en suivant, redémarrez le Synchronizer pour que le collecteur soit pris en compte :

   Code Block
   language text theme Emacs
   service shinken-synchronizer restart

   
   
   

2. Lancer l'import du collecteur "shinken-additional-packs-import":
   
   

   Panel

   
   

   • Ensuite, certaines nouveautés ou différences liées à l'évolution du pack peuvent nécessiter une validation.

Ou manuellement (si

l'utilisation du script install.

sh n’est pas souhaitée) :

Commun à tout Poller / Synchronizer

Si le pack est déjà installé

Il est recommandé de supprimer les anciens dossiers contenant le pack afin de garantir l'utilisation de la dernière version des fichiers livrés.

Pour effectuer cette suppression ( si la procédure d'installation manuelle a été suivie telle quelle ), la commande suivante peut être utilisée :

rm -rf /var/lib/shinken-user/libexec/shinken-additional-packs/windows-by-WinRM__shinken

Extraire le pack

Transférer le fichier du pack sur la machine et décompresser le fichier contenant le pack à l'aide de la ligne de commande ci-dessous ( remplacer "PACK__shinken__NON-DU-PACK__VERSION__OS.tar.gz" par le nom exact du pack livré) :

• Pour Linux  ( le paramètre --no-same-owner permet de ne pas conserver les attributs d'utilisateurs/roles présent de la création du pack ) :

tar -xjfv --no-same-owner PACK__shinken__NON-DU-PACK__VERSION__linux.tar.xz -C ./

• Pour Windows ( Rôle de Poller ) :

tar -xvzf PACK__shinken__NOM-DU-PACK__VERSION__windows.tar.gz -C ./

Entrez dans le répertoire créér :

cd NOM_DU_PACK/

Les sondes ( mises en place )

On place les sondes :

probe_path="/var/lib/shinken-user/libexec/shinken-additional-packs/windows-by-WinRM__shinken"
mkdir --parents $probe_path
cp -r ./probes/* $probe_path
chown -R shinken:shinken $probe_path
chmod -R 750 $probe_path

Sur le Synchronizer

Ensuite, plaçons maintenant la définition il est nécessaire de placer les définitions des éléments de supervision du pack au bon endroit :.

• Les fichiers de configuration :
  • Nous vous conseillons

    • Il est recommandé de créer un

    Collecteur

    • collecteur de type

    (

    • cfg-file-import

    )

    • , qui permet d'importer des définitions d'éléments Shinken

    depuis les fichiers de définitions présents dans ce

    • à partir des fichiers .cfg fournis dans le pack.

    • Vous trouverez la

      La procédure de mise en place

      dans la page de documentation suivante

      de ce type de collecteur est disponible dans la documentation à la page  : ( Collecteur de type ( cfg-file-import ) - Import depuis des fichiers au format .cfg )

    • Pour Dans la suite des explications, nous considérerons que ce collecteur s'appelle de cette documentation, ce collecteur sera nommé "shinken-additional-packs-import"

  • Une fois le collecteur mis en place, nous allons déployer le pack au bon endroit peut être déployé à l’emplacement attendu :

    • En premier, les fichiers de définition des éléments ( modèles d'hôtes, checks, commandes, ... )  du pack :

      Code Block
      language text theme Emacs
      shinken_collector_data_path="/etc/shinken-user/source-data/source-data-shinken-additional-packs-import" cp -r ./monitoring-definitions/packs/* $shinken_collector_data_path chown -R shinken:shinken $shinken_collector_data_path chmod -R 744 $shinken_collector_data_path

    • Ensuite, les données globales

      Code Block
      language text theme Emacs
      shinken_pack_globaldata_path="/etc/shinken/resource.d/shinken-additional-packs-import" mkdir --parents $shinken_pack_globaldata_path cp -r "./monitoring-definitions/global-data" "$shinken_pack_globaldata_path" chown -R shinken:shinken "$shinken_pack_globaldata_path" chmod -R 744 "$shinken_pack_globaldata_path"

• Redémarrer shinken

  Code Block
  language text theme Emacs
  service shinken-synchronizer restart

• Lancer l'import du collecteur "shinken-additional-packs-import",

  Panel

  
  

  • En suivantEnsuite, vous devrez il peut - être accepter les nouveautés / différences qui seraient liés à ce pack ( en fonction de l'évolution du pack ).nécessaire d’accepter certaines nouveautés ou différences introduites par le pack, selon son évolution.

Le dossier extrait lors de la décompression du pack peut également être supprimé à l’aide de Vous pouvez également supprimer le dossier qui a été créé suite à la décompression du pack en utilisant la commande suivante :

rm -rf ./PACK__windows-by-WinRM__shinken__V02.00.00__Linux

Si vous avez déjà installé Si une version précédente de ce pack, il vous faudra du pack a déjà été installée, il est recommandé de supprimer les anciens dossiers dans lesquels le pack était présent ( afin d'éviter de garder d'ancien fichier en cas d'évolution pour éviter de conserver des fichiers obsolètes, notamment en cas de modification de la structure du pack ).

Pour supprimer ces dossiers, utilisez Utiliser la commande suivante pour effectuer cette suppression :

rm /etc/shinken/sources/shinken-additional-packs-import.cfg
rm -rf /etc/shinken-user/source-data/source-data-shinken-additional-packs-import/
rm -rf /var/lib/shinken-user/libexec/shinken-additional-packs/windows-by-WinRM__shinken

Installation des dépendances sur le Poller

Sur un Poller Linux

Pour les connexions NTLM

L'authentification NTLM nécessite l'installation de la librairie suivante :

gssntlmssp

Sur un Poller Windows

Desinstaller le pack avec "uninstall.sh"

Entrée dans le répertoire extrait de l'archive et lancer le "uninstall.sh"

cd PACK__windows-by-WinRM__shinken__VX.X.X-RCXXX__Linux
./uninstall.sh

Ce mécanisme va seulement enlever les fichiers mis en place lors de l'installation ( Fichier du collecteur d'import, définition des éléments de supervision, et les sondes proposées ), mais ne touchent pas aux éléments que vous avez absorbés dans le Synchronizer.

==========================================================
UNINSTALL PACK [ windows-by-WinRM__shinken v02.00.00 ]
==========================================================

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

        => Deleting pack monitoring definition folder
              - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import/packs/windows-by-WinRM__shinken

        => Deleting pack monitoring definition file
              - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import/packs/windows-by-WinRM__shinken.pack

        => Deleting pack monitoring globaldata folder
              - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import/global-data/windows-by-WinRM__shinken

        => Deleting shinken pack globaldata folder
              - Path : /etc/shinken/resource.d/shinken-additional-packs-import/global-data/windows-by-WinRM__shinken/


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

        => Deleting probes
              - Path : /var/lib/shinken-user/libexec/shinken-additional-packs/windows-by-WinRM__shinken


==========================================================
PACK [ windows-by-WinRM__shinken v01.00.00 ] SUCCESSFULLY UNINSTALLED
==========================================================

Pré-requis pour l'exécution des checks

Les accès côté Windows

Les sondes de ce pack utilisent le protocole de communication WinRM ( Windows Remote Management ) de Microsoft, afin de collecter les informations sur les serveurs.

Cette méthode utilise une connexion via login/password pour accéder aux ressources à collecter et nécessite une configuration sur l'hôte supervisé ( voir la page NEW_PAGE - SPAC-27 - Configuration de WinRM sur poste Windows supervisé ).