Page système
La page /system est la console de supervision de l'instance. Elle est désactivée par défaut :
tant qu'aucun compte système n'est défini, personne ne peut s'y connecter.
Activation
La page est protégée par un compte dédié, indépendant des utilisateurs d'Any. Dans le fichier
shiro.ini (ou shiro-cas.ini, shiro-saml.ini, shiro-oidc.ini selon le mode
d'authentification), décommenter les deux lignes du systemAuthenticator et leur donner une
valeur :
systemAuthenticator = eu.c6.gibraltar.auth.authenticator.C6SystemAuthenticator
systemAuthenticator.username = admin-system
systemAuthenticator.password = <mot de passe>
Le mot de passe peut être fourni en clair ou chiffré. Redémarrer ensuite Tomcat, puis ouvrir
https://<serveur>/any/system : le navigateur demande l'identifiant et le mot de passe du compte
système (authentification HTTP Basic).
Voir Fichiers de configuration pour externaliser shiro.ini.
Contenu de la page
La page /system affiche l'état de chaque instance du cluster : Any, MessagingServer,
conversionServer et thumbnailServer.
Le menu Instances liste les serveurs qui répondent ; cinq onglets détaillent le serveur sélectionné :
- Fournisseurs : informations de monitoring de chaque provider chargé, dont les membres et les verrous Hazelcast
- Propriétés Java : les propriétés système de la JVM
- Environnement système : les variables d'environnement du serveur
- Classpath : les JAR réellement chargés par le classloader
- Espace disque : volumes total, libre et utilisable de
java.io.tmpdir, avec un statut vert / jaune / rouge et le détail des fichiers
Actions
Le menu Actions agit sur l'instance sélectionnée ou, pour la plupart, sur tout le cluster via le topic Hazelcast :
- vider les caches, en totalité ou seulement ceux dont le nom commence par un préfixe donné ;
- redémarrer le cache et vider les sessions : les utilisateurs connectés sont déconnectés ;
- recharger les fournisseurs pour reprendre un
settings.jsonmodifié sans redémarrer Tomcat ; - activer ou désactiver le mode maintenance, qui bascule les méthodes sur une file dédiée ;
- envoyer un message global affiché sur tous les postes clients connectés ;
- redémarrer une instance, en offre SaaS AWS, via le provider système.
Toutes ces actions exigent le rôle super administrateur.
Journaux
Le menu Journaux donne accès aux logs de chaque instance :
- lister et télécharger les fichiers de journalisation sans accès au serveur ;
- changer le niveau de log racine à chaud, de ERROR à TRACE ;
- recharger le
logback.xmlsans redémarrer Tomcat.
Le niveau de log et le rechargement s'appliquent à toutes les instances.
Si le logback.xml est configuré pour se recharger automatiquement toutes les x secondes
(scan="true" scanPeriod="…"), le niveau de log changé depuis la page est écrasé au prochain
rechargement : le changement ne dure pas. Voir Journalisation (logback).