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 » Article
Constellation-Web-Platform-Installer-1.9.735.exe
Version: 1.9.735

1.2 MiB
2136 Downloads
Détails

Constellation Web Platform Installer pour Windows

Auteur:	MyConstellation.io
Plateformes:	Windows
Catégorie:	Web Platform Installers
Licence:	Constellation License Agreement
Date:	juin 15, 2020

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 :

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 :

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

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 :

Etape 6 : installation

Il ne vous reste plus qu’à confirmer 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 :

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 :

wget -O install.sh https://developer.myconstellation.io/download/installers/install-linux.sh && chmod +x install.sh && ./install.sh

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  :

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 :

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

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

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

Etape 3 : sélection du serveur Constellation à rejoindre

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

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 :

Au quel cas il faudra spécifier un compte avec les droits de management pour pouvoir joindre la sentinelle dans votre 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 :

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 :

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 :

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 :

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.

The post Ajouter des sentinelles dans votre Constellation appeared first on Constellation.

• L’URI de la Constellation sur laquelle elle doit se connecter
• La clé d’accès (AccessKey) qu’elle doit utiliser pour s’authentifier sur la Constellation

Bien entendu pour fonctionner, il faudra que cette sentinelle soit correctement déclarée dans la configuration de votre Constellation (nom de sentinelle et credential associé).

Ces deux paramètres  de configuration sont définis dans le fichier “Constellation.Sentinel.exe.config” dans le cas de la sentinelle “Service” ou “Constellation.Sentinel.UI.exe.config” pour une sentinelle “UI”.

<add key="ConstellationServerURI" value="http://myconstellationserver.mylocalNetwork.lan:8088/" />
<add key="ConstellationAccessKey" value="123456789" />

Dans ce fichier vous avez également la possibilité de personnaliser d’autres paramètres de façon facultative.

Chemin local des packages déployés

Clé de configuration : “LocalPackagesDirectory”.

Il s’agit du répertoire local dans lequel les packages Constellation seront déployés. Ce chemin peut être relatif au répertoire d’installation de la sentinelle ou absolu.

Par défaut, il s’agit du sous-répertoire “Packages”.

Nom de la sentinelle

Clé de configuration : “SentinelName”.

Par défaut le nom de la sentinelle est le nom de la machine mais vous avez la possibilité de personnaliser ce nom en définissant ce paramètre de configuration.

Dans le cas par exemple où vous avez deux machines différentes sur des réseaux différents (ou non) mais ayant le même nom (hostname), vous pouvez personnaliser le nom de la sentinelle sur une des deux machines pour pouvoir les différencier au niveau de votre Constellation.

Attention : le nom de la sentinelle doit être unique sur une Constellation. Il ne peut pas y avoir deux sentinelles (ou plus) connectées sur une même Constellation avec le même nom.

Cas particulier : sur une sentinelle UI (pour Windows seulement), le nom de la sentinelle (que ce soit le nom de la machine ou un nom personnalisé dans le fichier de configuration) est toujours concaténé avec le suffixe “_UI”.

Temps d’arrêt maximum d’un package

Clé de configuration : “ShutdownPackageTimeout”.

Il s’agit du temps maximal d’arrêt d’un package au delà duquel le processus du package est tué par la sentinelle.

En effet, lorsque vous ordonnez l’arrêt d’un package via le hub de contrôle (par exemple à partir de la Console Constellation ou votre propre application connectée au hub de contrôle), l’ordre d’arrêt du package est envoyé au package ainsi qu’à la sentinelle.

Lorsque le package reçoit l’ordre de s’arrêter, il invoque les méthodes OnPreShutdown puis OnShutdown (plus d’information ici) définissant sa propre procédure d’arrêt, avant de fermer son processus. Le package est alors correctement arrêté.

La sentinelle, quant à elle, surveille le bon arrêt du package. Pour cela elle déclenche un chronomètre pour contrôler que le package se ferme bien dans le temps imparti.

Si le package dépasse ce temps imparti (quelque soit la raison), la sentinelle tuera le processus du package afin de garantir l’arrêt du package.

Ce temps maximal d’arrêt d’un package est défini par le paramètre “ShutdownPackageTimeout” qui est par défaut fixé à 10 secondes. C’est à dire qu’un package à 10 secondes pour s’arrêter avant d’être tué par sa sentinelle.

Intervalle de temps pour le report de la consommation des packages (PackageUsage)

Clé de configuration : “ReportPackageUsageInterval”.

Par défaut, chaque seconde (1000 ms) la sentinelle envoie un rapport contenant la consommation CPU et RAM de chaque package qu’elle héberge.

Vous pouvez personnaliser cette valeur en ajoutant le paramètre « ReportPackageUsageInterval » dans la configuration. La valeur est exprimée en milliseconde.

Sur un système faible en ressource (un Raspberry par exemple), il peut être intéressant d’espacer l’envoi de ce report.

Utilisation du moteur Mono

Clé de configuration : “UseMonoRuntime”.

Lorsqu’une sentinelle tourne sur un environnement Linux, elle utilise le moteur d’exécution Mono pour démarrer le package. Si la sentinelle tourne sur un environnement Windows, elle utilise le moteur .NET de Microsoft.

Vous pouvez cependant forcer l’utilisation du moteur Mono sur un environnement Windows en définissant le paramètre “UseMonoRuntime” à true.

The post Personnalisation de la sentinelle appeared first on Constellation.