Aller au contenu principal
Version: Any 26

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.json modifié 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.xml sans 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).