Contexte

Ce guide vous permettra d'installer ou de mettre à jour Shinken Entreprise sur un serveur Linux. 

Une fois le guide d'installation suivi, vous aurez rapidement accès à l'interface de Configuration et de Visualisation de Shinken dans une architecture par défaut, c'est à dire sur un serveur simple, sur lequel tous les démons seront activés.

Si vous mettez en place une architecture distribuée, après avoir terminé l'installation de Shinken sur vos différents serveurs, il vous faudra passer à la phase de configuration de vos démons (noms et IP des serveurs, royaume, spare, Tag des Pollers, rétention..).

En ce qui concerne la procédure de mise à jour, le script "d'update" vous permettra de mettre à jour votre serveur Shinken de manière complète, même si quelques démons sont seulement activés. La configuration de votre serveur Shinken ne sera pas modifiée.



Installation de Shinken Entreprise

Prérequis

  • Environnement requis : REHL/Centos 6.6, 7.2 et 7.3     [ 64bits ]

    Shinken Entreprise a choisi les distributions produites par Red Hat: Red Hat Enterprise Linux (REHL) et CentOS (Community enterprise Operating System). Ces distributions Linux, principalement destinées aux serveurs, sont stables, performantes et compatibles avec une très grande majorité des environnements professionnels. La distribution CentOS est elle aussi très performante (basée sur une distribution commerciale REHL de qualité) et elle est gratuite !

    Lors d'une installation de distribution Redhat Enterprise Linux (commerciale), il faut rattacher votre souscription Redhat à votre système.

    Voici les commandes à utiliser depuis le serveur:

    1/ subscription-manager register
    (-> Nom d'utilisateur / mot de passe )

    et il faut également l'attacher à l'OS en cours:

    2/ subscription-manager attach

    Yum pourra alors être utilisé correctement car l'abonnement sera valide. (et donc Shinken pourra être installé)


Extraction du package et installation

  • Installation automatique :

    • « Dé-tarez » le package qui vous a été transmis :
      • tar zxvf shinken-enterprise_V02.04.XXX-LANGUAGE.tar.gz
      • Cela vous créera un répertoire shinken-entreprise contenant le script d’installation et les dépendances nécessaires à l’installation.
    • Déplacez vous à la base du répertoire shinken-entreprise (cd shinken-enterprise_V02.04.XXX-LANGUAGE) et exécutez le script :

./install.sh
    • Il installera Shinken Entreprise et ses composants automatiquement.
      • Cependant, le SDK VMWare nécessitera une installation manuelle.
      • Les commandes à exécuter pour lancer l’installation du SDK VMWare sont affichées à la fin du install.sh :

Please launch: 
/tmp/shinken-enterprise_V02.04.XXX-LANGUAGE/tools/install-vmware-sdk.sh
And follow the instructions in order to install it and allow VMWare communication


Nous vous conseillons de les exécuter en suivant, mais elles peuvent aussi être exécutées ultérieurement.


Vérification du bon fonctionnement

  • Vérification
    • Pour vérifier que Shinken Entreprise est bien installé, configuré et fonctionnel, lancez la commande :

shinken-healthcheck

 

L'installation complète fera sur le même serveur :

  • l'installation du moteur Shinken Enterprise, des modules et des dépendances.
  • l'activation de tous les démons (Synchronizer, Arbiter, Scheduler, Poller, Reactionner, Broker, Receiver).

Pour une installation distribuée, voir la page Architecture Distribuée

  

Intégration du guide d'utilisateur dans le package

Le guide d'utilisateur (en français) est maintenant intégré au package d'installation.

Vous pouvez le retrouver dans : shinken-enterprise_V02.04.XXX-LANGUAGE.tar.gz/tools/documentation/ui-visualisation/

Il vous suffira qu'un utilisateur, via son navigateur internet, ouvre le fichier "index.html" afin de pouvoir parcourir le guide d'utilisateur, contenant la documentation liée à l'UI de visualisation.

Installation (Mode avancé)

  • Installation partiellement automatique (active seulement les démons sélectionnés ) :

    • « Dé-tarez » le package qui vous a été transmis :
      • tar zxvf shinken-enterprise_V02.04.XXX-LANGUAGE.tar.gz
      • Cela vous créera un répertoire shinken-entreprise contenant le script d’installation et les dépendances nécessaires à l’installation.

    • Déplacez vous dans le répertoire (cd shinken-enterprise_V02.04.XXX-LANGUAGE) et lancez la commande ./install.sh mais avec des options basées sur les démons que vous souhaitez activer :
      • --pollernode: active le démon Poller (dédié au lancement des checks)

      • --reactionnernode: active le démon Reactionner (dédié au lancement des notifications)

      • --schedulernode: active le démon Scheduler (planificateur des checks)

      • --arbiternode: active le démon Arbiter (rôle de distribution centrale)

      • --receivernode: active le démon Receiver (reçoit les checks passifs)

      • --synchronizernode: active le démon Synchronizer (gère la configuration)

      • --brokernode: active le démon Broker (export des données pour les interfaces de visualisation)

 

Vous pouvez par exemple installer Shinken Enterprise et activer directement le Scheduler et le Poller en même temps en tapant la commande ./install.sh --schedulernode --pollernode

      • Pour vérifier que les démons sélectionnés de Shinken Entreprise sont bien mis à jours, configurés et fonctionnels, lancez la commande :
shinken-healthcheck

Shinken-healthcheck vérifiera alors que Shinken Entreprise est bien configuré et en cours d'exécution (seulement pour les démons installés)


  • Après l'installation initiale, si vous souhaitez activer/désactiver des démons, utilisez la commande d'activation détaillée dans le chapitre Activation/Désactivation des démons.
  • Lors d'une mise à jour, le script update.sh prends en compte les démons qui sont activés ou non.

Mise à jour de Shinken Entreprise

Prérequis


  • Environnement : REHL/Centos 6.6, 7.2 et 7.3     [64bits]     avec d'une version antérieure déjà installée.

Extraction et mise à jour

  • Mise à jour:
    • « Dé-tarez » le package qui vous a été transmis :
      • tar zxvf shinken-enterprise_V02.04.XXX-LANGUAGE.tar.gz
      • Cela vous créera un répertoire shinken-entreprise contenant le script de mise à jour et les dépendances nécessaires à la mise à jour.
    • Déplacez vous dans le répertoire shinken-entreprise (cd shinken-enterprise_V02.04.XXX-LANGUAGE) et exécutez le script :

./update.sh
      • Il mettra à jour Shinken Entreprise mais n'aura aucune incidence sur le dossier de configuration de /etc/shinken, évitant tout risque d’écrasement d'une configuration que vous auriez définie. 
      • Au lieu d'écraser votre paramétrage, des fichiers "*.cfg.rpmnew" seront ajoutés. De nouvelles propriétés pourront figurer dans ces fichiers, il est donc conseiller de parcourir ces fichiers et si besoin, récupérer ces nouvelles propriétés pour les intégrer dans votre architecture.

Vérification du bon fonctionnement

      • Pour vérifier que Shinken Entreprise est bien mis à jour, configuré et fonctionnel, lancez la commande :

shinken-healthcheck