Page History

Context

Shinken Entreprise installation

Prerequisites

• Environnement requis Required environment: RHEL/Centos 6.6, 7.2, 7.3, 7.4, 7.5     [ 64bits ]
  
  Shinken Entreprise a choisi les distributions produites par Red HatEnterprise chose Linux distributions produced by RedHat: Red Hat Enterprise Linux (RHEL) et and CentOS  (Community ommunity enterprise erprise Operating perating 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é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 Attention Warning- Enregistrement Redhat registration
  Lors d'une installation de distribution Redhat When installation a RedHat Enterprise Linux (commerciale), il faut rattacher votre souscription Redhat à votre système.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 (-> Nom d'utilisateur / mot de passe )username / password) You also need to attach your subscription to the current OSet 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

• can now be used because the subscription is valid (and Shinken will be able to be installed).

  
  

Package extraction and installation

• Automatic installation:

  • Extract the delivery package

  Installation automatique :

  • « 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 d’installation et les dépendances nécessaires à l’installation.
    • This will create a new directory containing the installation script and dependencies required for the installation.

  • Move to the Déplacez vous à la base du répertoire shinken-entreprise directory (cd shinken-enterprise_V02.05.XXX-LANGUAGE) et exécutez le script  and execute the script :
    
    

./install.sh

• 
  
  • This will automatically install Shinken Enterprise and its components
    • 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
    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.05.XXX-LANGUAGE/tools/install-vmware-sdk.sh
And follow the instructions in order to install it and allow VMWare communication

Vérification du bon fonctionnement

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

Checking your Shinken Enterprise installation

• Check the installation: 
  • To check if Shinken Enterprise has been installed correctly, launch the following command
  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é.

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.

Accès aux interfaces web

Interface Utilisateur (UI) de configuration 

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

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

See the Configuration UI page for more information.

Visualization 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 7767 port (HTTP protocol). For instance

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

See the Visualization UI page for more information.

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

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.
  

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 TODEL Daemons listing/enable/disable page.
• When updating, the update.sh scripts updates all daemons, even if they are disabled. Their enabled/disabled state will be kept intact.

The different addons are automatically enabled during the 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éeEnabled on installations with an Arbiter enabled (more details in the dedicated documentation page: 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éeEnabled on installations with an Broker enabled (more details in the dedicated documentation page: NagVis)

Mise en place automatique du chiffrement

Enabling data encryption

You can enable Vous pouvez mettre en place le Chiffrement des données sensibles de façon automatique au moment de l' automatically when launching the 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.

An encryption key is generated during the installation and the Synchronizer database will be encrypted.

To enable this feature, launch the following commandPour cela, lancez la commande suivante :

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

• The --activate-

• encryption parameter enables the encryption: the key name is optionnal; it will be asked during the installation process if not specified in the parameter.
• The

• --disable-important-notices-user-

• input parameter disables interactive prompts during the installation process.

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

Mise à jour de Shinken Entreprise

Prérequis

The shinken-healthcheck can be used to check the daemons configuration and encryption status.

Updating Shinken Enterprise

Prerequisites

• Environment 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

•  with a previous Shinken Enterprise version installed.
  
  

Package extraction and updates

• Updating:
  • Extract the package archive
  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.
    • This will create a new directory containing the installation script and dependencies required for the installation.
  • Move into the  Déplacez vous dans le répertoire shinken-entreprise folder (cd shinken-enterprise_V02.05.XXX-LANGUAGE) et exécutez le  and execute the script :
    
    

./update.sh

• 
  
  • 
    
    • Il mettra à jour Shinken Entreprise mais n'aura aucune incidence sur le dossier de configuration de This script updates Shinken Enterprise but does not overwrite files in /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.
    • avoiding overwriting configuration defined by the Shinken administrator. Instead of overwriting your configuration files, "*.rpmnew" files are added, that may contain new configuration properties. It is advised to check these files after updating to report possible new features in your existing configuration files.
    • Before updating, a backup of configuration and user data is done and placed into /tmp. These backup follow the following naming conventionAvant 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

Checking your Shinken Enterprise installation

• 
  
  • 
    
    • The shinken-healthcheck tool can be used to check daemons configuration and running statePour vérifier que Shinken Entreprise est bien mis à jour, configuré et fonctionnel, lancez la commande :
      
      

shinken-healthcheck

Updating configuration objects via the cfg-file-shinken

source

During Shinken Enterprise installation, lots of checks (via Lors de l'installation de Shinken, nous incluons de nombreux checks (via des modèles du Pack Shinken, Linux, Windows,.. templates) .Ces éléments de ces packs (checks, modèles, commandes) sont disponibles au travers de la source are imported in the Configuration UI. These elements, grouped into packs, are available and importedusing the "cfg-file-shinken" :source.

Image Removed

When updating, these elements may be updated, but these changes are not automatically integrated into your monitoring configuration to avoid unintentional behaviour or breaking changes. To see the changes, make sure the "cfg-file-shinken" source is enabled and import the source. The changed elements will appear with the "New" of "Difference" status.

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

Shinken Enterprise license key

The 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 :

commercial service should have sent a nominative license allowing you to use the product to its full potential.

The license is a file name user.key, nominative and limite in time.

To install it:

• Copy this file on the Arbiter server to /etc/shinken/user.key

• Restart Shinken Enterprise

• : /etc/init.d/shinken restart

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

command. The error message concerning the license should have disappeared to be replaced with an informative text about your license;

If you don't have a license key or if your license key has expired, contact us: Si vous n'avez pas de clé de licence ou que celle ci a expiré contactez-nous : contact@shinken-solutions.com