Moniteur de santé

Enterprise Server comprend un système complet de surveillance de l’état qui permet aux administrateurs de déterminer et d’analyser rapidement l’état, ou la « santé », d’un Enterprise Server. Le moniteur d’état est disponible depuis la section Admin de l’interface navigateur du Workspace (la page Server Health), ou sous la forme d’un outil exécutable autonome inclus dans l’installation d’Enterprise Server sur son PC hôte (l’outil Server Health Monitor).

La fonctionnalité d’état fournit un résumé visuel de l’état de la configuration et des services d’Enterprise Server, des informations sur les ressources système de la machine hôte, et donne également accès aux rapports d’état et aux fichiers journaux. Cela offre une vue d’ensemble immédiate de l’état d’Enterprise Server, ce qui permet aux administrateurs de détecter et de résoudre de manière proactive tout problème susceptible d’affecter les utilisateurs du Workspace.

Chaque approche de surveillance de l’état et du statut d’Enterprise Server présente son propre avantage distinct :

• Server Health page – dans l’interface navigateur du Workspace d’Enterprise Server, la page Server Health est accessible aux administrateurs sur le réseau local, ce qui offre la commodité d’un accès à distance.
• Server Health Monitor tool – l’exécutable autonome Health Monitor (avhealth.exe) est accessible quel que soit l’état d’Enterprise Server et fournira donc des données et informations cruciales dans le cas peu probable où Enterprise Server ne fonctionnerait pas pleinement.

Page Server Health

Dans l’interface navigateur du Workspace, sélectionnez Admin – Health dans le menu principal pour accéder à la page de rapport Server Health, qui indiquera l’état global de l’installation d’Enterprise Server à l’horodatage indiqué dans la section supérieure Status de la page (Updated at: <timestamp>).

La page Server Health fournit une vue instantanée de l’état d’Enterprise Server et de son infrastructure de support.

Les informations de la page Server Health sont mises à jour périodiquement (comme l’indique l’horodatage Status), mais une mise à jour peut être déclenchée à la demande via le lien refresh status associé.

Cliquez sur le lien d’actualisation pour mettre à jour les informations d’état d’Enterprise Server.

Erreurs et avertissements

En tant que vue d’ensemble mise en évidence de l’état d’Enterprise Server, la page Server Health fournit des icônes d’avertissement/erreur distinctes et les descriptions associées pour les entrées d’état préoccupantes. Les alertes courantes incluent des sauvegardes de données en retard, des expirations de licence imminentes, un compte utilisateur admin/admin actif, ou des entrées d’erreur détectées dans un fichier journal :

• OK  – les métriques détectées se situent dans une plage ou un état acceptable.
• Warning  – Enterprise Server et son infrastructure de support fonctionnent correctement, mais une modification est recommandée pour résoudre un problème potentiel ou futur.
• Error  – une partie d’Enterprise Server ou de son infrastructure de support ne fonctionne pas ou n’est pas correctement configurée et nécessite une attention immédiate.

Correction des problèmes courants

Bien que les problèmes de performances et de système soient susceptibles d’être résolus en améliorant les ressources et l’infrastructure disponibles du PC hôte d’Enterprise Server, les problèmes de la section Environment and configuration de la page Server Health peuvent généralement être résolus à l’aide des fonctionnalités et outils mis à la disposition des administrateurs du Workspace :

• Admin password – créez un ou plusieurs comptes administrateur spécifiques dans la page Users page, si ce n’est pas déjà fait, et modifiez le mot de passe (et de préférence le nom d’utilisateur) du compte par défaut admin.
• Log level – si nécessaire, modifiez le niveau de journalisation d’Enterprise Server en éditant l’entrée LogLevel= dans la section General du fichier LocalVault.ini, situé dans le dossier d’installation d’Enterprise Server sur le PC hôte. Les niveaux autorisés sont Info (par défaut) et Warn. Avec cette dernière option, les informations générales d’état (appels API, démarrage et arrêt des services, etc.) ne seront pas incluses dans les fichiers journaux — les erreurs sont toujours incluses.
• Licenses – une erreur d’expiration imminente de licence Enterprise Server se traite via la page Licenses page de l’interface navigateur (Admin – Licenses). Une licence déjà expirée peut être résolue en accédant à l’interface navigateur sur la machine hôte d’Enterprise Server.
• Backups – une sauvegarde du Workspace peut être effectuée à l’aide de l’outil avbackup.exe, disponible dans le dossier Tools\BackupTool de l’installation d’Enterprise Server sur le PC hôte.

• Project Sharing (signalé dans l’outil Health Monitor tool) – une erreur de mot de passe pour des membres existants du Workspace peut être signalée ici lorsque des dépôts SVN ont été activés et/ou ajoutés – voir un exemple d’erreur. Cela vous empêchera également d’effectuer des mises à jour supplémentaires de ces profils utilisateur. Pour synchroniser les utilisateurs existants avec le dépôt SVN, modifiez chaque profil de membre en ressaisissant son mot de passe et en confirmant avec le bouton Update. Les identifiants seront mis à jour dans le fichier SVN passwd du système (généralement situé dans le dossier C:\ProgramData\Altium\Altium365Data\Repository) afin d’enregistrer correctement ces utilisateurs dans le dépôt SVN.

Rapports et journaux

Les performances d’Enterprise Server et du PC hôte sont testées et résumées (dans les sections Performance et System), et des journaux de rapport sont mis à disposition pour génération et téléchargement :

• Logs – les journaux d’Enterprise Server sont téléchargés sous forme d’archive zip vers l’emplacement de téléchargement par défaut du navigateur (Download all logs). Ils incluent des journaux en texte brut pour tous les services hébergés par Enterprise Server, où le fichier journal de chaque service comprend les événements horodatés (et les erreurs) depuis l’installation d’Enterprise Server, ou depuis l’effacement des journaux (Clear logs).
• Reports – le rapport d’état d’Enterprise Server est téléchargé sous forme d’archive zip vers l’emplacement de téléchargement par défaut du navigateur (via le lien Generate dans la section supérieure Status de la page). Il rend compte de l’état et de la configuration de tous les éléments principaux d’Enterprise Server. Destinés à fournir des informations clés aux équipes de support Altium, les rapports incluent également des informations d’état et de performance sur l’infrastructure de support du PC hôte.

Outil Health Monitor

L’installation d’Enterprise Server inclut l’outil complet On-Prem Enterprise Server Health Monitor qui permet aux administrateurs de déterminer et d’analyser rapidement, au niveau local, l’état ou la « santé » d’Enterprise Server. Fourni comme application autonome et indépendante avec l’installation d’Enterprise Server, Health Monitor offre un résumé visuel de l’état de la machine hôte ainsi que de la configuration et des services d’Enterprise Server. Son interface comprend également des indications contextuelles, ainsi que des informations et chemins vers des emplacements importants et des fichiers journaux.

Health Monitor présente les informations d’état d’Enterprise Server via une interface graphique simple et couvre, de manière générale, les domaines critiques suivants :

• Enterprise Server Environment – l’état du matériel du PC hôte, comme ses disques durs, sa mémoire, son processeur et l’adéquation de ses performances.
• Enterprise Server Backend – l’état de la base de données, du stockage de fichiers et du dépôt qui prennent en charge Enterprise Server.
• Enterprise Server Services – l’état de l’ensemble des services d’Enterprise Server, hébergés sous forme de pools d’applications IIS, tels que les services Identity, Authorization, License Manager et Network Installation.

Accès à l’outil

Dans une installation par défaut d’Enterprise Server, l’outil Health Monitor se trouve dans le dossier \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor sous la forme de l’exécutable avhealth.exe. Notez que le dossier inclut également un outil simplifié en ligne de commande : avConsoleHealth.exe.

Lorsque l’outil GUI Health Monitor (avhealth.exe) est exécuté, le programme interroge immédiatement Enterprise Server et ses systèmes hôtes afin de renseigner l’écran principal Dashboard de Health Monitor — sélectionné (par défaut) dans les onglets supérieurs. Cliquez sur le bouton Refresh () pour relancer le processus et mettre à jour l’écran.

L’interface graphique Dashboard de Health Monitor fournit une vue instantanée de l’état d’Enterprise Server et de son infrastructure de support, ainsi que des liens vers davantage d’informations.

Erreurs et avertissements

L’état de chaque élément du Dashboard est indiqué par un message et une icône associée :

• OK  – les métriques détectées se situent dans une plage ou un état acceptable.
• Warning  – Enterprise Server et son infrastructure de support fonctionnent correctement, mais une modification est recommandée pour résoudre un problème potentiel ou futur.
• Error  – une partie d’Enterprise Server ou de son infrastructure de support ne fonctionne pas correctement et nécessite une attention immédiate.

Survolez l’état d’un élément avec la souris pour obtenir plus d’informations. Pour une erreur ou un avertissement affiché dans le Dashboard, des détails supplémentaires sont disponibles (dans la plupart des cas) en cliquant sur l’entrée d’état de cet élément.

Survolez une entrée d’état pour accéder à des informations plus détaillées.

Liens réactifs

Bon nombre des conditions d’erreur/avertissement détectées par Health Monitor proposent des liens destinés à aider à résoudre la situation. Ceux-ci sont inclus dans les informations détaillées de l’élément, disponibles en cliquant sur son entrée d’état.

    
Lorsque des problèmes d’événements courants surviennent, les informations associées fournissent davantage de détails et des liens pour aider à résoudre la situation préoccupante.

Dans l’exemple d’écran ci-dessus à gauche, Health Monitor a détecté qu’Enterprise Server n’a pas été sauvegardé. Les informations associées fournissent un lien vers une documentation qui aidera à résoudre la situation.

L’exemple d’écran de droite (ci-dessus) indique que les identifiants de connexion par défaut admin/admin d’Enterprise Server existent toujours, ce qui présente un risque de sécurité important. Le lien Fix It dans les informations associées permet d’accéder directement à la page de connexion d’Enterprise Server via l’interface navigateur, où les profils des utilisateurs administrateurs peuvent être corrigés.

Navigateur de journaux

L’écran Log Browser de Health Monitor, accessible via l’onglet Log Browser, présente les entrées Error et Warning de tous les fichiers journaux disponibles d’Enterprise Server — normalement situés dans le dossier C:\ProgramData\Altium\Altium365Data\logs. Pour afficher le fichier journal contenant l’entrée d’événement, sélectionnez le lien associé Open file  ou double-cliquez simplement sur l’entrée elle-même.

Les entrées d’événements cumulées dans la liste sont regroupées par date et incluent tous les événements d’erreur/avertissement disponibles provenant de tous les fichiers journaux. Pour trouver des événements spécifiques, choisissez une période dans le menu déroulant Show logs, et/ou utilisez le champ de filtre dynamique () pour rechercher des mots-clés dans les colonnes Subsystem et Message.

L’interface Log Browser vous permet de cibler précisément les événements qui vous intéressent à l’aide d’une période sélectionnable et d’un filtrage par mots-clés.

Sélectionnez le bouton pour supprimer les entrées de journal accumulées de la liste du navigateur de journaux ; cela archivera puis supprimera tous les fichiers journaux existants.

Rapport d’état

L’écran Rapport d’état du Health Monitor, accessible via l’onglet Status Report, sert à créer et afficher des fichiers de rapport d’état du serveur Enterprise. Les rapports générés rassemblent toutes les informations de débogage des événements dans une seule archive Zip (*.zip) qui peut être envoyée, si nécessaire, aux développeurs d’Altium.

Pour créer un rapport, sélectionnez une période d’événements appropriée dans le menu déroulant Include Logs, saisissez vos coordonnées et sélectionnez l’accord de partage, puis lancez le processus avec le bouton .

Utilisez l’écran Status Report pour générer des fichiers de rapport de journaux consolidés à des fins de débogage.