Installation de Shinken Entreprise

Prérequis

• Environnement requis : RHEL/Centos 6.6, 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8     [ 64bits ]
  
  Shinken Entreprise a choisi les distributions produites par Red Hat: Red Hat Enterprise Linux (RHEL) 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 RHEL de qualité).
  

  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é)

  
  

Prérequis CPU

La langage de programmation python n'ayant actuellement pas la possibilité d'utiliser plusieurs processus (multithreading), chaque daemon utilise un ou plusieurs processus :

• Synchronizer
  • 1 pour l'UI de configuration
  • 1 pour le daemon
• Broker
  • 1 / Web UI
  • 1 pour le daemon
• Arbiter
• Receiver
• Reactionner
• Scheduler
• Poller

Extraction du package et installation

• Installation automatique :

  • « Dé-tarez » le package qui vous a été transmis :
    • tar zxvf shinken-enterprise_V02.07.XX-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.07.XX-LANGUAGE) et exécutez le script :
    
    

./install.sh

• 
  
  • Il installera Shinken Entreprise et ses composants automatiquement.
    • Le SDK VMWare qui nécessitait une installation manuelle dans les versions précédentes est maintenant installé automatiquement.
    • Pour obtenir plus d'informations sur la consommation des démons et améliorer le fonctionnement de Shinken lorsqu'il est installé sur une machine virtuelle VMWare, le paquet "open-vm-tools" doit être installé manuellement:
      
      

yum install open-vm-tools

Vérification du bon fonctionnement

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

shinken-healthcheck

 Votre licence Shinken Enterprise n'est pas installé, c'est normal, dirigez-vous dans la section Clé de licence plus bas sur cette page afin d'installer votre clé.

Accès aux interfaces web

Interface Utilisateur (UI) de configuration 

Une fois Shinken Enterprise installé, pour accéder à l'UI de configuration, vous devez pointer votre navigateur Web vers l'adresse affichée durant l'installation.

• Par défaut, l'interface de configuration est accessible sur le port dédié 7766 (via le protocole HTTP). Par exemple : http://192.168.0.1:7766
  
  

Voir la page Paramétrage de l'interface de Configuration pour plus d'information.

Interface Utilisateur (UI) de visualisation

Une fois Shinken Enterprise installé, pour accéder à l'UI de visualisation, vous devez pointer votre navigateur Web vers l'adresse affichée durant l'installation.

• Par défaut, l'interface de configuration est accessible sur le port dédié 7767 (via le protocole HTTP). Par exemple : http://192.168.0.1:7767
  
  

Voir la page Paramétrage de l'interface de Visualisation pour plus d'information.

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.07.XX-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.07.XX-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.07.XX-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)

./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.
  

Les différents addons sont automatiquement activés lors de l'installation:

• nagvis-shinken-architecture: Activé lors d'une installation d'un Arbiter (plus de détails dans la page de documentation dédiée: Activation et configuration de la fonctionnalité)
• nagvis: Activé lors d'une installation d'un Broker (plus de détails dans la page de documentation dédiée: NagVis ( Addon ))

Mise en place automatique du chiffrement

Vous pouvez mettre en place le Chiffrement des données sensibles de façon automatique au moment de l'installation.

Une clé de chiffrement sera alors générée lors du processus d'installation et la base de données du Synchronizer sera chiffrée.

Pour cela, lancez la commande suivante :

./install.sh --activate-encryption <nom de clé>  --disable-important-notices-user-input

• Le paramètre --activate-encryption permet d'activer le chiffrement. Le nom de la clé est optionnel toutefois il vous sera demandé lors de l'exécution du programme d'installation si vous ne le précisez pas.
• Le paramètre --disable-important-notices-user-input permet de désactiver les prompts vous demandant confirmation avant de continuer le processus.
   Il vous est cependant fortement conseillé de lire les informations fournies lors de l'installation.

Shinken-healthcheck vous permettra dé vérifier la bonne configuration des démons et du chiffrement.

Mise en place d'un serveur sans connexion internet

Dans le cas d'un serveur qui n'a pas de connexion internet, il faut lancer l'installeur avec le paramètre suivant:

• --disable-epel : permet de ne pas installer le repository epel sur le serveur
  
  

Mise en place d'un serveur avec des repository internes (non publics)

Dans le cas d'un serveur qui n'a accès qu'à des répository internes qui ne sont pas forcément à jour par rapport aux repository centos/redhat officiel, il faut lancer avec:

• --package-update-only-on-conflict : permet de ne pas chercher à mettre à jour les paquets déjà installés et ainsi tente d'éviter d'installer des paquets trop à jour par rapport au repository interne qui n'est pas à jour
  
  

Mise à jour de Shinken Entreprise

Prérequis

• Environnement : RHEL/Centos 6.6, 7.2, 7.3, 7.4, 7.5, 7.6, 7.7 et 7.8    [64bits]     avec d'une version antérieure déjà installée.
  

  
  

  Pour mettre à jour d'une version mineure à la majeure suivante, il faut faire attention de bien avoir la dernière itération de cette version. - Par exemple, pour la mise à jour en V02.07.XX, il faut s'assurer d'avoir installé la V02.05.03 (dernière V02.05) avant d'effectuer la mise à jour. - N'hésitez pas à vérifier ce point avec votre revendeur ou Shinken Solutions.

  
  

Extraction et mise à jour

• Mise à jour:
  • « Dé-tarez » le package qui vous a été transmis :
    • tar zxvf shinken-enterprise_V02.07.XX-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.07.XX-LANGUAGE) et exécutez le script :
    
    

./update.sh

• Tout comme dans le cas de l'installation, si le serveur n'a accès qu'à des répository internes (qui ne sont pas forcément à jour par rapport aux repository centos/redhat officiels), il faut lancer avec:

  • --package-update-only-on-conflict : permet de ne pas chercher à mettre à jour les paquets déjà installés et ainsi tente d'éviter d'installer des paquets trop à jour par rapport au repository interne qui n'est pas à jour

  
  
  • Ainsi, la mise à jour:
• 
  
  • • 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.
    • Avant la mise à jour, une sauvegarde de la configuration et des données utilisateur est effectuée et placée dans /tmp. Ces sauvegardes sont nommées de la manière suivante: "backup-preupdate-version-NUMERO_VERSION".

Options disponibles

Erreurs courants lors d'une mise à jour

Ajout du bac à événements

Lors d'une nouvelle installation, le bac à événements est automatiquement mis en place.

Lors d'une mise à jour depuis une version antérieure, avec une architecture complexe, le script de mise à jour ne peut pas toujours déterminer avec certitude sur quels brokers et quelles Web-UI le bac à événements doit être installé. C'est pourquoi vous devez vous-même effectuer la configuration manuellement.

Il est nécessaire d'ajouter les modules :

• le module event-manager-writer sur vos brokers ( cela permettra d'enregistrer les données aux nécessaires événements )
• le module event-manager-reader sur vos WebUI ( cela permettra aux WebUI de pouvoir accéder aux données enregistrés pour les événements )

Pour le paramétrage spécifique de ces modules, consulter les pages Module event-manager-writer et Module event-manager-reader.

Vérification du bon fonctionnement

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

shinken-healthcheck

Mise à jour des checks via la source cfg-file-shinken

Lors de l'installation de Shinken, nous incluons de nombreux checks (via des modèles du Packs Shinken, Linux, Windows,..).

Ces éléments de ces packs (checks, modèles, commandes) sont disponibles au travers de la source "cfg-file-shinken" :

Lors d'une update, nous vous fournissons également toutes les mises à jour de ces packs, nous vous conseillons donc d'activer la source et de bien regarder les mises à jour possibles, via les éléments qui apparaîtront en "nouveau" et en "différence".

Clé de licence Shinken Enterprise

Le service Commercial de Shinken Enterprise a dû vous envoyer une licence nominative vous permettant d'utiliser pleinement le produit.

La licence est un fichier qui a le nom suivant : user.key et cette licence est nominative et limitée dans le temps.

Pour l'installer, rien de plus simple, il suffit de :

• Placer ce fichier sur le serveur hébergeant l'arbiter et sur les serveurs hébergeant le ou les UIs de Visualisation , dans le chemin suivant : /etc/shinken/user.key
• Redémarrez alors Shinken Enterprise via la commande : service shinken restart

Relancez alors la commande shinken-healthcheck le message d'erreur de licence doit avoir disparu et voici un exemple d'information de licence valide :

Si vous n'avez pas de clé de licence ou que celle ci a expiré contactez-nous : contact@shinken-solutions.com

Résolution des problèmes liés à l'installation/mise à jour

Cas spécifique de la mise à jour d'un cluster Mongo

Dans la version V02.07.00, la base Mongodb est mise à jour. Lorsque Mongodb a été configuré pour fonctionner en tant que cluster, le comportement du script de mise à jour de Shinken Entreprise a été modifié pour prendre en compte cette configuration particulière. Des explication détaillées sont présentes dans la page de documentation dédiée: Mise à jour d'un cluster Mongodb