Page History

Context

Shinken Entreprise installation

Prerequisites

• Required environment: RHEL/Centos 6.6, 7.2, 7.3, 7.4, 7.5     [ 64bits ]
  
  Shinken Enterprise chose Linux distributions produced by RedHat: Red Hat Enterprise Linux (RHEL) and CentOS (Community enterprise Operating System). These linux distributions, mainly designed for servers are stable, performant and compatible with a vast majority of professional environments. The CentOS is also very performant (based on the commercially distributed RHEL).
  

  Info
  title Warning- Redhat registration
  When installation a RedHat Enterprise Linux (commercial distribution, you must attach your RedHat subscription to your system. Here are the commands to use on your server: Voici les commandes à utiliser depuis le serveur: 1/ subscription-manager register (-> username / password) You also need to attach your subscription to the current OS: 2/ subscription-manager attach Yum can now be used because the subscription is valid (and Shinken will be able to be installed).

  
  

Package extraction et installation

• Automatic installation:

  • Extract the delivery package :
    • tar zxvf shinken-enterprise_V02.05.XXX-LANGUAGE.tar.gz
    • This will create a new directory containing the installation script and dependencies required for the installation.

  • Move to the shinken-entreprise directory (cd shinken-enterprise_V02.05.XXX-LANGUAGE) and execute the script :
    
    

./install.sh

• 
  
  • This will automatically install Shinken Enterprise and its component
    • However, the VMWare SDK will require a manual install.
    • The commands to type to launch the VMWare DSK installation are displayed at the end of the installation process:.sh :
      
      

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

We advise to execute these commands directly, but they can also be performed later if needed.

Checking your Shinken installation

• Check the installation: 
  • To check if Shinken Enterprise has been installed correctly, launch the following command :
    
    

shinken-healthcheck

A warning is issued as expected to say the Shinken Enterprise license key is not installed. Head over to the License key section further down on this page to install your license key.

Web interfaces access

Configuration UI 

Once Shinken Enterprise installed, the Configuration UI can be accessed via a web browser at the address displayed during the installation:

• By default, the Configuration UI is available via the 7766 port (HTTP protocol). For instance: http://192.168.0.1:7766

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

See the [ConfigSee the Configuration UI page for more information.

Visualization UI

Une fois Once Shinken Enterprise installé, pour accéder à l'UI de visualisation, vous devez pointer votre navigateur Web vers l'adresse affichée durant l'installation.installed, the Configuration UI can be accessed via a web browser at the address displayed during the installation:

• By default, the Configuration UI is available via the 7767 port (HTTP protocol). For instancePar 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

See the Visualization UI page for more information.

Intégration du guide d'utilisateur dans le package

The User Guide (in French) is now integrated  in the installation package.

it can be found in: shinken

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

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

Il vous suffira qu'un utilisateur, via son navigateur internet, ouvre le fichier A user can access this guide by opening the "index.html" afin de pouvoir parcourir le guide d'utilisateur, contenant la documentation liée à l'UI de visualisationfile found in this folder.

Installation (

advanced mode)

• Automatic partial installation (only enables selected daemons):
  • Extract the package archive
    • tar zxvf shinken-enterprise_V02.05.XXX-LANGUAGE.tar.gz

• • • This will create a new directory containing the installation script and dependencies required for the installation.

  • Move to the shinken-entreprise directory (cd shinken-enterprise_V02.05.XXX-LANGUAGE)

• •  and execute the install.sh

• • script, passing the following options based on the daemons you want to enable:

    • --pollernode:

• • • Enables the Poller

• • • daemon (responsible for check execution)

    • --reactionnernode:

• • • Enables the Reactionner

• • • daemon (responsible for notifications and event handlers)

    • --schedulernode:

• • • Enables the Scheduler

• • • daemon (responsible for the planification of the checks execution)

    • --arbiternode:

• • • Enables the Arbiter

• • • daemon (responsible for the central distribution of configuration and informations)

    • --receivernode:

• • • Enables the Receiver

• • • daemon (responsible for receiving results for passive checks)

    • --synchronizernode:

• • • Enables the Synchronizer daemon (

• • • responsible for configuration management)

    • --brokernode:

• • • Enables the Broker

• • • daemon (responsible for presenting the checks results and data the the world: Visualization UI, SLA)

./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 To check that the selected daemons are up to date, correctly configured and running, launch the following command:

shinken-healthcheck

The shinken-healthcheck checks that Shinken Enterprise configuration is correct and coherent, and is running (only for enabled daemons)

• After the initial installation, if you want to enable/disable daemons, use the activation commands detailed in the 

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)

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 optionel ; 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 à jour de Shinken Entreprise

Prérequis

• Environnement : RHEL/Centos 6.6, 7.2, 7.3, 7.4 et 7.5    [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.05.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.05.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.
    • 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".

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 Pack 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, 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