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.

Pour chaque package (réel) vous avez en temps réel :

• Le statut :
  • Starting : package en cours de démarrage
  • Started : package démarré et en cours de fonctionnement
  • Stopping : package en cours d’arrêt
  • Stopped : package arrêté
• L’état de connexion qui indique si le package est bien connecté au serveur
• La date de la dernière activité (il s’agit de la date de la dernière modification du statut)
• La consommation en CPU et RAM sur la sentinelle sur lequel le package est démarré
• Des informations quant à la version du package et de la librairie Constellation utilisée par le package

En fonction de l’état du package le bouton d’action permettra de démarrer le package (Start) et de l’arrêter (Stop).

Comme sur les autres pages de la Console, vous avez un menu contextuel pour chaque package vous permettant de contrôler le package, d’éditer sa configuration ou ses settings, etc.

La fenêtre d’information permet de retrouver toutes les informations sur le statut du package :

Notez également que vous avez la possibilité de filtrer dans la liste des packages soit avec la zone de texte ou soit en cliquant sur le bouton “Show filters” afin de filtrer le type de package (réel ou virtuel), l’état de connexion (connecté ou non) et l’état activé/désactivé. Par défaut tous les packages sont affichés à l’exception des packages marqués “Désactivé” (Enable=false).

Contrôler un package

Pour pouvez pour chaque package le démarrer ou l’arrêter avec le bouton d’action sur la droite ou depuis le menu contextuel.

Vous pouvez également redémarrer le package (restart) c’est à dire demander à la sentinelle de stopper le package (si il est “Started”)  puis de le démarrer.

Vous pouvez aussi faire un rechargement du package : “reload”. Cette action fonctionne comme un “restart” mais force la sentinelle à (re)télécharger le package du “Package Repository” du serveur. Cela permet de déployer les mises à jours de vos packages : vous envoyez la nouvelle version de votre package sur votre serveur Constellation puis vous faites un “reload” afin de reforcer les sentinelles à redémarrer le package avec sa nouvelle version.

Pour finir vous pouvez également “pousser” les settings vers un package en cas de modification (sans avoir à redémarrer le package).

Editer la configuration d’un package

Pour chaque package (réel ou virtuel) vous pouvez saisir le nom de l’instance (seulement lors de la création) et le credential utilisé pour la connexion du package. Vous pouvez également définir si le package est activé ou non.

S’il s’agit d’un package réel, vous pouvez définir si le package doit démarré automatiquement lorsque la sentinelle se démarre et vous pouvez également redéfinir les options de récupération :

Editer les settings d’un package

Il s’agit des paramètres propre au package (voir ici).

Pour chaque package vous définir autant de variable de configuration (= une clé et une valeur) que vous désirez en cliquant sur le bouton “Add new setting” :

Dans le cas d’un package dit “réel” il est grandement recommandé de déclarer les settings utilisés par le package dans son manifeste : voir ici.

Cette déclaration permet à la Console Constellation de connaitre les settings obligatoires ou non, le type de chaque setting, la description et valeur par défaut.

Editer les groupes d’un package

Pour rappel, un message peut être envoyé à un (ou plusieurs) groupe qui regroupe des packages ou des consommateurs. Chaque package ou consommateur peut joindre un groupe depuis les API mais vous pouvez également définir ces liens d’appartenance au niveau de la configuration du serveur.

Pour cela, cliquez sur “Group membership” dans le menu contextuel d’un page et définissez les groupes dont fait partie votre package :

Déployer un package

Pour déployer un package, vous avez plusieurs solutions :

• Cliquez sur le bouton “Deploy new package” depuis la page “Packages”
• Cliquez sur le bouton “Deploy new package” dans le menu contextuel d’une sentinelle sur la page « Sentinels »
• Utiliser la page “Package Repository”

Depuis la page des Packages, cliquez sur le bouton “Deploy new package” en haut à gauche  :

Vous obtiendrez alors une pop-in vous permettant de sélectionner la sentinelle sur laquelle déployer et le package à déployer :

S’il s’agit d’un page virtuel, sélectionnez “Virtual package” (voir ci-dessous) sinon sélectionner un package présent dans votre “Package repository”.

Vous serez alors guidé dans les étapes de configuration du package.

Note : par défaut le champ “Package file” est nul, c’est à dire que le fichier à utiliser pour votre instance sera déterminé dynamiquement (lire ici).

Dans le cas où une instance est déjà présente sur la sentinelle vous serez obligé de définir un autre nom et donc de spécifier le “Package file”.

Par exemple, ici je pourrais nommer cette nouvelle instance “HWMonitor2” en utilisant le fichier “HWMonitor”.

Veuillez lire ceci pour bien comprendre le mécanisme de résolution.

Les packages virtuels

Comme expliqué ici, un package virtuel n’est pas réel dans le sens où ce n’est pas un processus lancé et supervisé par une sentinelle.

De ce fait, dans la Console, vous n’aurez aucun information remontée à son sujet.

Vous pouvez seulement les déclarer ou supprimer, les associer à des credenitals, gérer l’appartenance aux groupes ou bien sûr gérer les settings.

The post Gérer les packages avec la Console Constellation appeared first on Constellation.

Vous obtiendrez sur la page la liste des credentials déclarés sur votre Constellation avec leurs clés d’accès associées, utilisées pour authentifier toutes requêtes vers votre Constellation.

N’hésitez pas à lire ou relire la page dédiée aux concepts de Credential / AccessKey et Authorization avant de poursuivre !

Pour chaque credential vous avez la possibilité d’activer ou désactiver la clé d’accès en cliquant sur le bouton “Disable” ou “Enable” :

Attention ces actions sont immédiates. Si vous désactivez une clé d’accès actuellement utilisée par un ou plusieurs packages, leurs accès seront immédiatement révoqués.

Vous pouvez également accéder au menu contextuel pour éditer le crédential, ses autorisation ou le supprimer.

Ajouter ou éditer un credential

Si vous cliquez sur le bouton “Add credential” ou “Edit” du menu contextuel d’une sentinelle, vous obtiendrez la fenêtre suivante :

Note : dans le cas d’une édition vous ne pourrez pas éditer le nom du credential.

Vous pouvez cependant éditer en toute circonstance la clé d’accès et même utiliser un générateur login/password comme expliqué ici.

Pour rappel, chaque credential porte les propriétés suivantes :

• Enable : indique si le credential est activé ou désactivé
• EnableControlHub : indique si le credential peut se connecter sur le hub de contrôle (pour l’administration de la Constellation)
• EnableManagementAPI : indique si le credential peut se connecter à l’API de Management (pour l’édition de la configuration)
• EnableDeveloperAccess : indique si le credential peut utiliser la sentinelle virtuelle “Developer” pour debugger des packages (utilisé par le SDK Visual Studio)

Gérer les autorisations

En cliquant sur “Edit Authorizations” vous pourrez gérer les autorisations d’un credential pour limiter l’envoi de message, les StateObjects autorisés à consommer et les groupes.

The post Gérer les credentials avec la Console Constellation appeared first on Constellation.

Vous pouvez filtrer les logs en cliquant sur le bouton “Show filters” de façon à ajouter des filtres sur la sentinelle, le package ou encore le type de log :

Lorsque des erreurs (Error) ou avertissements (Warning) apparaissent dans la Console Log alors que vous n’êtes pas sur cette page, des notifications apparaîtront dans la barre du haut :

Le fait d’afficher la Console Log vide automatiquement ces notifications.

The post La Console Log appeared first on Constellation.

Un moteur de recherche vous permet de rechercher très rapidement les StateObjects souhaités :

En cliquant sur le bouton “View” vous pouvez visualiser l’ensemble des informations d’un StateObject dont sa valeur :

La valeur du StateObject est automatiquement coloriée et formatée pour faciliter la lecture.

Vous avez la possibilité de supprimer ce StateObject, de copier sa valeur dans votre presse-papier, de rafraîchir le StateObject ou même vous abonner en temps réel à sa mise à jour.

La StateObject Explorer se désabonne automatiquement de vos StateObjects lorsque vous fermez la fenêtre de détail.

Vous pouvez également supprimer des StateObjects en cliquant sur le bouton “Purge” :

Vous serez alors amené à sélectionner l’instance du package pour laquelle supprimer ses StateObjects ou encore supprimer tous les StateObjects marqués comme “expirés”.

Notez qu’à tout moment vous pouvez cliquer sur le bouton “Refresh” ou Ctrl+R pour rafraîchir la liste des StateObjects.

The post Le StateObjects Explorer appeared first on Constellation.

Pour chaque MessageCallback déclaré vous retrouverez une description, la liste des paramètres du MessageCallback avec un formulaire de test et un bouton d’envoi.

Il est ainsi possible de tester directement les MC de vos packages depuis la Console Constellation.

Vous disposez également d’un moteur de recherche :

Si le package est déployé sur plusieurs sentinelle le bouton “Invoke” vous proposera d’envoyer votre message à une instance en particulier ou à toutes les instances du package dans votre Constellation :

Aussi le MessageCallbacks Explorer dispose d’un générateur de code permettant d’afficher des “code snippets” d’invocation du MC pour chaque API Constellation.

Vous pouvez ouvrir ce générateur de code en cliquant sur le bouton à côté du nom de chaque MessageCallback.

Les types personnalisés sont affichés sous forme de lien sur lesquels vous pouvez cliquer pour ouvrir la fenêtre de description de type :

Enfin pour les MessageCallbacks avec message de réponse, vous pouvez les invoquer en envoyant le message dans une saga en cochant la case “With Saga” :

Les messages de réponse des sagas apparaissent sous forme de notification dans la barre du haut :

En cliquant dessus vous pourrez consulter le message de réponse ainsi que l’ensemble des informations liées à la saga :

The post Le MessageCallbacks Explorer appeared first on Constellation.

La page “Package Repository” de la Console Constellation permet d’administrer votre repository : uploader des packages de votre poste local ou télécharger des packages du catalogue en ligne, les supprimer, les renommer, etc..

Comme pour les autres pages de la Console, vous disposez d’un moteur de recherche pour filtrer les packages de votre repository :

Pour chaque package de votre repository vous pourrez le déployer sur une sentinelle, le renommer, le supprimer ou afficher les détails du package :

Par exemple affichons les détails du package Nest ici en version 2.2 installé le 20/07/2016 sur cette Constellation:

En cliquant le bouton “Deploy” vous pourrez sélectionner la sentinelle sur laquelle déployer ce package :

En haut de la page vous pouvez afficher le catalogue en ligne, rafraîchir la liste ou encore uploader des packages depuis votre navigateur.

Pour uploader un ou plusieurs packages, il suffit de “drag & dropper” les packages dans la fenêtre :

Depuis la version 1.8.1 de la Console Constellation, vous pouvez parcourir la liste des packages disponible sur le catalogue Constellation en ligne :

Vous pouvez alors cliquer sur le bouton “Deploy” pour télécharger automatiquement des packages dans le Package Repository de votre serveur Constellation et lancer l’assistant de déploiement.

Pour les packages installés et à jour, vous avez l’icone à côté du nom. Si le package est installé mais qu’une version plus récente est disponible sur le catalogue vous aurez l’icone suivante  .

Vous pouvez alors cliquer sur le bouton “Update” pour télécharger la nouvelle version dans votre Package Repository.

Notez également que des notifications de mise à jour des packages (et des composants Constellation) sont affichées sous forme de notification dans la barre du haut :

Une fois le package correctement téléchargé, vous obtiendriez une notification dans la Console Constellation :

Ensuite une nouvelle fenêtre s’ouvrera automatiquement pour vous proposer de recharger directement le ou les packages sur les sentinelles de votre Constellation où ils sont déployés :

The post Le Package Repository appeared first on Constellation.

Pour plus d’information sur le fichier de configuration, n’hésitez pas à lire ou relire cet article.

Vous pouvez mettre l’éditeur en plein écran avec le bouton F11.

L’éditeur dispose d’un système d’auto-complétion assez simple sur base du schéma du fichier de configuration :

Vous trouverez sur l’éditeur trois boutons :

• Get Config : permettant d’ouvrir la dernière version du serveur
• Save Config : permettant d’enregistrer la configuration en cours d’édition sur le serveur (raccourci : Ctrl+S)
• Save & Deploy : permettant d’enregistrer la configuration en cours d’édition sur le serveur puis d’appliquer (déployer) la configuration dans la Constellation

Le fait de déployer la configuration informe tous les packages et les sentinelles de votre Constellation de la nouvelle configuration. C’est en déployant la configuration que les sentinelles vont déployer les nouveaux packages ajoutés ou au contraire fermer les packages supprimés, etc.

The post Le Configuration Editor appeared first on Constellation.