Sommaire

Les sentinelles sont des agents exécutés sur des systèmes Windows ou Linux qui, connectés à votre Constellation, permettent de déployer des packages Constellation.

En suivant le guide d’installation vous avez pu installer une sentinelle Service ou UI sur la même machine que le serveur Constellation.

Voyons maintenant comment installer des sentinelles sur vos autres machines (laptops, desktop, serveurs, Raspberry, etc..).

Prérequis

Il existe deux types de sentinelle :

  • La “Sentinel Service” : il s’agit d’un service compatible Windows et Linux qui tourne en arrière plan et permet de déployer des packages Constellation sans interface graphique.
  • La “Sentinel UI” : il s’agit d’une application Windows s’exécutant au sein d’une session Windows et permettant de déployer des packages Constellation avec interface graphique (dit Package UI) ou encore des packages ayant besoin d’interagir avec la session de l’utilisateur.

Les prérequis pour installer une sentinelle sont :

  • Un système Windows avec le .NET Framework 4.0 installé (soit au minimum un Windows XP SP3 ou un Windows 2003 SP2)
  • Un système Linux avec Mono 3.10 au minimum

Note : la sentinelle UI n’est disponible que pour Windows.

Installation d’une sentinelle sur un système Windows

Les installeurs pour la sentinelle Service et UI sont similaires, la procédure d’installation est donc identique.

Note : vous pouvez installer sur la même machine une sentinelle UI et une sentinelle Service.

Pour cela, vous pouvez soit télécharger le programme d’installation spécifique à la Sentinelle UI et/ou Service ou, pour faire plus simple, utiliser le “Web Platform Installer” pour installer et mettre à jour les dernières versions des composants Constellation.

Etape 1 : lancez le “Web Platform Installer

Constellation Web Platform Installer
Constellation Web Platform Installer » Article
Constellation-Web-Platform-Installer-1.9.735.exe
Version: 1.9.735
1.2 MiB
2020 Downloads
Détails

Etape 2 : sélection des composants

Commencez par vous identifier avec votre compte Constellation et acceptez la licence d’utilisation avant de pouvoir sélectionner les composants à installer :

Selection des composants

Dans le cas ci-dessus, nous avons déjà installé la dernière version du SDK Constellation comme vous pouvez le constater !

Dans ce guide nous allons installer les deux sentinelles (UI et Service) que nous connecterons à notre Constellation précédemment installée sur une autre machine.

Etape 3 : type d’installation des sentinelles

Vous avez ensuite le choix entre :

  1. Installer la sentinelle et l’enregistrer dans votre Constellation en utilisant l’API de Management (il vous faudra connaitre une AccessKey qui a les droits de management pour procéder à l’enregistrement).
  2. Installer la sentinelle seulement

Bien entendu pour automatiser le processus, choisissons la première option :

Choix d'installation

Notez que si vous souhaitez ajouter une sentinelle sur un système sur lequel un serveur Constellation est installé, l’assistant vous proposera d’installer et d’enregistrer automatiquement votre sentinelle sur le serveur local.

Etape 4 : sélection du serveur Constellation à joindre

Vous devez indiquer l’URI de votre serveur Constellation ainsi que la clé d’accès avec les droits d’administration pour enregistrer vos sentinelles.

Dans cet exemple le serveur Constellation est accessible sur l’URL “http://pc-seb.ajsinfo.loc:8088/” avec le couple “admin/password” (cliquez sur le bouton “Use Password” pour générer l’AccessKey à partir de ce couple) :

Enregistrement de la sentinelle

Etape 5 : choix de la clé d’accès pour la sentinelle

Vous aurez ensuite à choisir parmi les clé d’accès configurées sur votre serveur, laquelle doit être utilisée pour la connexion de vos sentinelles :

Choix de la clé d'accès pour la sentinelle

Etape 6 : installation

Il ne vous reste plus qu’à confirmer l’installation :

Confirmation de l'installation

L’installeur téléchargera et installera les composants puis réalisera l’enregistrement vos deux nouvelles sentinelles sur votre serveur Constellation avant de lancer le service (pour la Sentinel Service) ou l’application (pour la Sentinel UI).

Depuis la Console Constellation, nous pouvons observer nos deux nouvelles sentinelles (PO-SWARIN et PO-SWARIN_UI) fraichement connectées :

Sentinelles connectées

Installation d’une sentinelle sur un système Linux

Sur un système Linux utilisez le “Web Platform Installer” pour automatiser le processus d’installation et de configuration.

Le WPI se chargera d’installer tous les prérequis (Mono, Python, PIP, etc..) et les dernières versions des composants Constellation.

Etape 1 : lancez le “Web Platform Installer

Pour lancer le WPI entrez la commande suivante :

Le programme d’installation doit être lancé en “root” pour cela, le script se relancera automatiquement en “sudo” si la commande est présente. Autrement il tentera de se relancer automatiquement en “su root”. Si cette commande n’existe pas non plus, il affichera un message d’erreur. Vous aurez alors besoin de relancer manuellement le script “install.sh” en root.

Avec “sudo” ou “su root”, vous aurez dans certain cas besoin de fournir votre mot de passe “root” pour pouvoir autoriser le script d’installation à se lancer  :

Web Platform Installer

Le script va vérifier les prérequis à savoir :

  • Python (2.7 ou 3.x)
  • Python-dev
  • Mono 3.10 sur un ARMv6 ou autrement Mono 3.12 minimum
  • Supervisor

Sur un système Debian ou dérivé, le programme d’installation vous proposera d’installer automatiquement les prérequis si besoin.

Etape 2 : sélection des composants

Une fois les prérequis validés, vous pourrez choisir les composants Constellation à installer :

Selection des composants

Dans ce guide, sélectionnons le composant “Sentinel”. Vous commencerez par accepter la licence d’utilisation :

Licence d'utilisation

Puis vous devrez renseigner vos identifiants de votre compte myConstellation.io :

Identification

Définissez ensuite le répertoire d’installation de la sentinelle sur votre système :

Répertoire d'installation

Etape 3 : sélection du serveur Constellation à rejoindre

Renseignez maintenant l’URI de votre serveur Constellation sur laquelle votre sentinelle doit se connecter :

URI du serveur Constellation

Notez que si vous souhaitez ajouter une sentinelle sur un système sur lequel un serveur Constellation est installé, l’assistant vous proposera d’installer et d’enregistrer automatiquement votre sentinelle sur le serveur local.

Etape 4 : type d’installation de la sentinelle

Comme pour l’installation d’une sentinelle sous Windows, indiquez si vous souhaitez également procéder à son enregistrement :

Choix d'installation

Au quel cas il faudra spécifier un compte avec les droits de management pour pouvoir joindre la sentinelle dans votre Constellation :

Identification sur le serveur ConstellationIdentification sur le serveur Constellation

Etape 5 : choix de la clé d’accès pour la sentinelle

Vous pourrez ensuite choisir parmi les clé d’accès configurées sur votre serveur, laquelle doit être utilisée par votre sentinelle :

Choix de la clé d'accès

Etape 6 : prérequis pour les packages Python

Enfin si vous comptez déployer des packages Constellation Python vous devez installer le runtime Python ainsi que différentes librairies (plus d’informations).

Le WPI vous proposera d’installer ces prérequis pour vous de manière automatique :

Installation des prérequis Python

Etape 7 : installation et démarrage

Le WPI procèdera à l’installation et à la configuration de la sentinelle et des prérequis.

A la fin de ce processus, la sentinelle sera automatiquement démarrée :

Fin de l'installation

En retournant sur la Console de notre Constellation, on pourra constater qu’une nouvelle sentinelle ici nommée “rpi2” s’est bien connectée dans notre Constellation :

Sentinelles connectées

Votre sentinelle Linux est prête, vous pouvez maintenant y déployer des packages ou développer vos propres packages en C# ou en Python.

Ajouter des sentinelles dans votre Constellation
Editer la page sur GitHub
Étiqueté avec :            

Démarrez la discussion sur le forum Constellation