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.

Il permet l’exécution de plusieurs variantes du système d’exploitation libre Linux et même de Windows 10 IoT.

Les différents modèles et versions du Raspberry Pi

A ce jour, on distingue trois types de modèle :

• Le modèle A : Raspberry “light” sans interface réseau
• Le modèle B : la version la plus répandue du Raspberry (avec interface réseau)
• Le modèle Zero : version minimaliste et low-cost  du Raspberry

Les Raspberry Pi A et B sont animés par un ARM11 (ARMv6) à 700Mhz avec 256 Mo de mémoire vive pour le modèle d’origine (512 Mo sur les dernières versions du modèle B/B+).

En 2015 le Raspberry Pi B version 2 (B2) est équipé d’un processeur Broadcom BCM2836, quatre cœurs ARM Cortex-A7 (ARMv7) à 900 MHz, accompagné de 1 Go de RAM.

Puis en début 2016, pour le quatrième anniversaire de la commercialisation du premier modèle, la fondation Raspberry Pi annonce la sortie du Raspberry Pi B version 3 (B3). Comparé au B2, il dispose d’un processeur Broadcom BCM2837 64 bit à quatre cœurs ARM Cortex-A53 (ARMv8) à 1,2 GHz et d’une puce Wifi 802.11n et Bluetooth 4.1 intégrée.

Le modèle A n’a qu’en a lui pas évolué.

De son côté le Raspberry Zero sorti fin 2015 reprend les spécifications du modèle A/B version 1 avec un processeur ARM11 (ARMv6) cadencé à 1 GHz au lieu de 700 MHz. Il est par contre plus petit, disposant d’une connectique minimale. Début 2017, pour le cinquième anniversaire du Raspberry Pi, le Raspberry Pi Zero est maintenant doté de Wi-fi et de Bluetooth en conservant les mêmes spécifications.

Retrouvez ici toutes les spécifications du Rapsberry sur cette page ainsi qu’un tableau comparatif.

Ce qui est important de retenir ici :

• Tous les modèles B intègrent nativement une interface Ethernet et les version B3 et Zero-W intègrent une interface Wifi. Sur les autres versions, en particulier les modèles A, il faudra connecter une clé USB Wifi pour disposer d’une interface réseau.
• Les modèles A/A+, B/B+ (v1) et Zero/ZeroW sont tous animés par des processeurs ARMv6 à la différence des RPi B2 et B3, respectivement équipés d’un ARMv7 et ARMv8.

Raspberry Pi et Constellation

Comme le Raspberry Pi est un véritable (nano) ordinateur basé sur une architecture ARM et sur lequel on peut installer un système Linux, il est à la fois possible  :

• de l’utiliser pour héberger une Constellation, c’est à dire déployer le serveur Constellation
• de l’utiliser comme Sentinelle pour pouvoir déployer des packages

Par exemple, la solution de monitoring des ressources énergétiques de la maison S-Energy ou encore S-Opener, la porte de garage intelligente sont deux solutions basées sur des Raspberry Pi exploités comme sentinelles d’une Constellation.

Ceci dit il est important de se rappeler des prérequis pour ces deux composants Constellation :

• Le serveur Constellation nécessite au minimum Mono 3.12
• La sentinelle Constellation nécessite au minimum Mono 3.10

Or Mono 3.12 et + n’est pas stable sur une architecture ARMv6. Le Web Platform Installer Linux installera automatiquement la dernière version de Mono à l’exception des architectures ARMv6 pour lequel il installera la version 3.10, la seule stable (à ce jour du moins) sur ce type d’architecture.

Autrement dit :

• La sentinelle Constellation peut être installée sur tous les Raspberry Pi
• Le serveur Constellation ne peut être installé que sur un Raspberry Pi B version 2 ou version 3

Autre information très importante, le fait d’être sur un ARMv6 (modèles A/A+, B/B+ et Zero/ZeroW) restreint Mono à la version 3.10 ce qui restreint l’usage de package utilisant le framework .NET 4.0 !

Autrement dit, les packages Constellation développés pour .NET 4.5 (et plus) peuvent être instables sur un ARMv6.

De ce fait si vous développez des packages C# ou des packages Python que vous souhaitez déployer sur une sentinelle Raspberry A/A+, B/B+ ou Zero/ZeroW, n’oubliez pas de définir le “Target” de votre projet à “.NET Framework 4” et pas au delà lors de la création de votre projet ou dans les propriétés de celui-ci.

En résumé :

• Les Raspberry Pi A/A+, B/B+ et Zero/ZeroW sont équipés d’un ARMv6, donc Mono 3.10 au maximum, donc “Sentinelle Constellation” seulement pour déployer des packages .NET 4.0 au maximum.
• Les Raspberry Pi B2 ou B3 sont équipés d’ARM V7 ou V8 permettant l’installation des dernières versions de Mono, permettant donc l’installation du serveur Constellation et/ou de la sentinelle pour déployer des packages .NET 4.0, 4.5 ou plus.

Installer Constellation sur un Raspberry

Etape 1 : installer Raspbian

A l’aide d’un outil comme “Win32 Disk Imager” sous Windows, copiez la dernière version en date de l’image du système Raspbian sur une carte MicroSD.

Je vous recommande l’image “Lite” du système, c’est à dire sans interface graphique car inutile pour Constellation, nous exploitons le Raspberry à travers la plateforme Constellation et SSH pour l’installation initiale.

Une fois l’image de Raspbian copiée sur votre carte MicroSD, créez un fichier nommé “ssh” (sans extension et sans contenu) à la racine de votre carte SD de façon à activer le service SSH lors du premier boot.

Vous pouvez maintenant insérer votre carte MicroSD dans votre Raspberry puis l’alimenter sans oublier de le connecter au réseau via l’interface Ethernet.

Après quelques secondes, connectez-vous dessus à l’aide d’un client SSH comme Putty. Le nom d’utilisateur est “pi” et le mot de passe par défaut est “raspberry” :

Voilà votre Raspberry Pi est prêt et connecté !

Etape 2 : configurer son Raspberry Pi

Avant de démarrer l’installation de Constellation, je vous recommande vivement de configurer certain élément de base sur ce système fraichement installé.

Pour cela lancez l’utilitaire “raspi-config” par la commande :

sudo rapsi-config

Les actions de base à réaliser :

1. Change User Password : changez le mot de passe par défaut de l’utilisateur “pi”
2. Hostname : changez le nom du système (par défaut “raspberry”) pour l’identifier plus facilement. N’oubliez pas que le nom du système sert pour identifier une sentinelle dans une Constellation
3. Localisation Options > Change Timezone : spécifiez votre fuseau horaire pour définir correctement l’heure locale du système
4. Interfacing Options > SSH : activez le service SSH
5. Advanced Options > Expand Filesystem : si nécessaire redimensionne la partition pour exploiter pleinement la capacité de votre carte SD

Optionnellement si vous avez une interface Wifi (native sur les B3 et Zero-W ou externe) configurez le réseau à joindre.

Pour finir, n’hésitez pas à mettre à jour les sources APT avant de lancer le WPI surtout si vous utilisez une ancienne image.

sudo apt-get update

Etape 3 : lancer le Web Platform Installer

Pour télécharger et démarrer Web Platform Installer, rien de plus simple ! Lancez simplement la commande suivante :

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

Le WPI se chargera de vérifier et installer l’ensemble des prérequis puis lancera le programme d’installation de Constellation.

Vous pourrez alors installer une sentinelle sur votre Raspberry ou le serveur Constellation si vous êtes sur un RPi B2 ou B3.

Next steps

Que souhaitez-vous souhaitez installer maintenant sur votre Raspberry ?

• le serveur Constellation
• la sentinelle Constellation

The post Constellation sur un Raspberry Pi appeared first on Constellation.

Dans le menu principal de gauche, cliquez sur “Sentinels” :

Vous retrouverez sur cette page l’ensemble des sentinelles de votre Constellation.

Le statut peut être :

• Unknow : une sentinelle qui ne sait jamais connectée ou une sentinelle virtuelle
• Disconnected : une sentinelle qui est déconnectée après avoir été connecté
• Connected : la sentinelle est connectée

Dans le cadre d’une sentinelle réelle (connectée ou déconnectée) vous obtiendrez également la version de la sentinelle, du système d’exploitation et autres informations sur le moteur d’execution .NET.

Le bouton “Détails” permet d’afficher l’ensemble des informations d’une sentinelle :

Il s’agit d’un menu contextuel qui vous permettra également d’éditer les informations de connexion de la sentinelle, de la supprimer ou encore de voir ou ajouter des packages sur cette sentinelle :

Ajouter une sentinelle

Pour déclarer une sentinelle réelle ou virtuelle, cliquez sur le bouton “Add sentinel” :

Dans la fenêtre d’ajout saisissez le nom de votre sentinelle ainsi que le credential à utiliser pour la connexion :

Pour ajouter et gérer vos credentials, rendez-vous sur la page “Server Management > Credentials”.

Note : dans le cas d’une sentinelle Service, le nom par défaut est le nom de la machine (hostname Linux ou Windows) et dans le cas d’une sentinelle UI (pour Windows seulement), il s’agit du nom de la machine suivi du suffixe “_UI”. Notez toutefois que vous pouvez modifier le nom de la sentinelle dans la configuration de celle-ci. De plus les installeurs Windows et Linux des sentinelles utilisent l’API de Management pour enregistrer automatiquement la sentinelle au serveur, vous n’avez donc pas à l’ajouter manuellement. Cet écran servira surtout pour l’ajout de sentinelle virtuelle.

The post Gérer les sentinelles avec la Console 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.