Health Monitor

Der Enterprise Server umfasst ein umfassendes System zur Zustandsüberwachung, mit dem Administratoren den Zustand bzw. die „Health“ eines Enterprise Server schnell feststellen und analysieren können. Der Health Monitor ist im Abschnitt Admin der Workspace-Browseroberfläche verfügbar (die Seite Server Health) oder als eigenständiges ausführbares Tool, das in der Enterprise-Server-Installation auf dem Host-PC enthalten ist (das Tool Server Health Monitor).

Die Health-Funktion liefert eine visuelle Zusammenfassung des Zustands der Konfiguration und Dienste des Enterprise Server, Informationen zu den Systemressourcen des Host-Rechners und bietet außerdem Zugriff auf Statusberichte und Protokolldateien. Dadurch erhalten Administratoren einen sofortigen Überblick über den Status des Enterprise Server und können Probleme, die Workspace-Benutzer beeinträchtigen könnten, frühzeitig erkennen und beheben.

Jeder Ansatz zur Überwachung von Health und Status des Enterprise Server hat seinen eigenen besonderen Vorteil:

• Server Health page – als Teil der Enterprise-Server-Workspace-Browseroberfläche ist die Seite Server Health für Administratoren über das lokale Netzwerk verfügbar, was den Komfort eines Remote-Zugriffs bietet.
• Server Health Monitor tool – die eigenständige ausführbare Datei Health Monitor (avhealth.exe) ist unabhängig vom Zustand des Enterprise Server zugänglich und liefert daher wichtige Daten und Informationen für den unwahrscheinlichen Fall, dass der Enterprise Server nicht vollständig funktionsfähig ist.

Seite „Server Health“

Wählen Sie innerhalb der Browseroberfläche des Workspace im Hauptmenü Admin – Health, um auf die Berichtsseite Server Health zuzugreifen, die den Gesamtstatus der Enterprise-Server-Installation zum Zeitstempel anzeigt, der im oberen Abschnitt Status der Seite dargestellt ist (Updated at: <timestamp>).

Die Seite Server Health bietet eine sofortige Ansicht des Status des Enterprise Server und seiner unterstützenden Infrastruktur.

Die Informationen auf der Seite Server Health werden regelmäßig aktualisiert (wie durch den Status-Zeitstempel angezeigt), eine Aktualisierung kann jedoch bei Bedarf über den zugehörigen Link refresh status ausgelöst werden.

Klicken Sie auf den Aktualisierungslink, um die Health-Informationen des Enterprise Server zu aktualisieren.

Fehler und Warnungen

Als hervorgehobene Übersicht über den Status des Enterprise Server bietet die Seite Server Health eindeutige Warn-/Fehlersymbole und zugehörige Beschreibungen für Statuseinträge, die Anlass zur Sorge geben. Häufige Warnmeldungen umfassen überfällige Datensicherungen, bevorstehende Lizenzabläufe, ein aktives Benutzerkonto admin/admin oder erkannte Fehlereinträge in einer Protokolldatei:

• OK  – die erkannten Messwerte liegen innerhalb eines akzeptablen Bereichs bzw. Zustands.
• Warning  – der Enterprise Server und seine unterstützende Infrastruktur funktionieren korrekt, es wird jedoch eine Änderung empfohlen, um ein potenzielles oder zukünftiges Problem zu beheben.
• Error  – ein Teil des Enterprise Server oder seiner unterstützenden Infrastruktur funktioniert nicht oder ist nicht korrekt konfiguriert und erfordert sofortige Aufmerksamkeit.

Behebung häufiger Probleme

Während Leistungs- und Systemprobleme wahrscheinlich durch eine Verbesserung der verfügbaren Ressourcen und Infrastruktur des Host-PCs des Enterprise Server behoben werden, lassen sich Probleme im Abschnitt Environment and configuration der Seite Server Health im Allgemeinen mit den Funktionen und Tools beheben, die Workspace-Administratoren zur Verfügung stehen:

• Admin password – erstellen Sie auf der Seite Users ein oder mehrere spezifische Administratorkonten, falls Sie dies noch nicht getan haben, und ändern Sie das Passwort (und vorzugsweise auch den Benutzernamen) des Standardkontos admin.
• Log level – ändern Sie bei Bedarf die Protokollierungsebene des Enterprise Server, indem Sie den Eintrag LogLevel= im Abschnitt General der Datei LocalVault.ini bearbeiten, die sich im Installationsordner des Enterprise Server auf dem Host-PC befindet. Zulässige Ebeneneinträge sind Info (Standard) und Warn. Bei letzterer Option werden allgemeine Statusinformationen (API-Aufrufe, Starten und Stoppen von Diensten usw.) nicht in die Protokolldateien aufgenommen – Fehler werden immer aufgenommen.
• Licenses – ein Fehler aufgrund eines bevorstehenden Ablaufs der Enterprise-Server-Lizenz wird über die Seite Licenses der Browseroberfläche behoben (Admin – Licenses). Eine bereits abgelaufene Lizenz kann behoben werden, indem auf die Browseroberfläche auf dem Host-Rechner des Enterprise Server zugegriffen wird.
• Backups – ein Workspace backup kann mit dem Tool avbackup.exe durchgeführt werden, das im Ordner Tools\BackupTool innerhalb der Enterprise-Server-Installation auf dem Host-PC verfügbar ist.

• Project Sharing (gemeldet im Health Monitor tool) – hier kann ein Passwortfehler für bestehende Workspace-Mitglieder gemeldet werden, wenn SVN repositories aktiviert und/oder hinzugefügt wurden – siehe Fehlerbeispiel. Dies verhindert außerdem, dass Sie Aktualisierungen an diesen Benutzerprofilen vornehmen können. Um die bestehenden Benutzer mit dem SVN-Repository zu synchronisieren, bearbeiten Sie jedes Mitgliederprofil, indem Sie das Passwort erneut eingeben und mit der Schaltfläche Update bestätigen. Die Anmeldedaten werden in der SVN-Datei passwd des Systems (typischerweise im Ordner C:\ProgramData\Altium\Altium365Data\Repository) aktualisiert, um diese Benutzer korrekt beim SVN-Repository zu registrieren.

Berichte und Protokolle

Die Leistung sowohl des Enterprise Server als auch des Host-PCs wird getestet und zusammengefasst (in den Abschnitten Performance und System), und Berichtsprotokolle werden zur Erstellung und zum Download bereitgestellt:

• Logs – Enterprise-Server-Protokolle werden als ZIP-Archiv an den Standard-Downloadspeicherort des Browsers heruntergeladen (Download all logs). Dazu gehören Klartextprotokolle für alle vom Enterprise Server gehosteten Dienste, wobei die Protokolldatei jedes Dienstes zeitbasierte Ereignisse (und Fehler) seit der Installation des Enterprise Server oder seit dem Leeren der Protokolle enthält (Clear logs).
• Reports – der Enterprise-Server-Statusbericht wird als ZIP-Archiv an den Standard-Downloadspeicherort des Browsers heruntergeladen (ausgelöst über den Link Generate im oberen Abschnitt Status der Seite). Er berichtet über den Zustandsstatus und die Einrichtung aller zentralen Enterprise-Server-Elemente. Die Berichte sind als wichtige Informationen für die Altium-Supportteams gedacht und enthalten außerdem Status- und Leistungsinformationen zur unterstützenden Infrastruktur des Host-PCs.

Health Monitor tool

Die Enterprise-Server-Installation enthält das umfassende Tool On-Prem Enterprise Server Health Monitor, mit dem Administratoren den Zustand bzw. die „Health“ des Enterprise Server auf lokaler Ebene schnell feststellen und analysieren können. Als eigenständige, unabhängige Anwendung innerhalb der Enterprise-Server-Installation liefert der Health Monitor eine visuelle Zusammenfassung des Zustands des Host-Rechners sowie der Konfiguration und Dienste des Enterprise Server. Seine Oberfläche enthält außerdem kontextbezogene Hinweise sowie Informationen und Pfade zu wichtigen Speicherorten und Protokolldateien.

Der Health Monitor stellt Statusinformationen des Enterprise Server über eine einfache GUI dar und deckt im Allgemeinen die folgenden kritischen Bereiche ab:

• Enterprise Server Environment – den Zustand der Hardware des Host-PCs, wie Festplatten, Arbeitsspeicher, CPU und die Angemessenheit ihrer Leistung.
• Enterprise Server Backend – den Zustand der unterstützenden Datenbank, des Dateispeichers und des Repositorys des Enterprise Server.
• Enterprise Server Services – den Zustand der verschiedenen Dienste des Enterprise Server, die als IIS-Anwendungspools gehostet werden, wie Identity-, Authorization-, License Manager- und Network Installation-Dienste.

Zugriff auf das Tool

In einer Standardinstallation des Enterprise Server befindet sich das Health-Monitor-Tool im Ordner \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor als ausführbare Datei avhealth.exe. Beachten Sie, dass der Ordner auch ein vereinfachtes Befehlszeilentool enthält: avConsoleHealth.exe.

Wenn das GUI-Health-Monitor-Tool (avhealth.exe) ausgeführt wird, prüft das Programm sofort den Enterprise Server und seine Host-Systeme, um den Hauptbildschirm Dashboard des Health Monitor zu füllen – standardmäßig ausgewählt über die oberen Registerkarten. Klicken Sie auf die Schaltfläche Refresh (), um den Vorgang erneut auszulösen und den Bildschirm zu aktualisieren.

Die GUI Dashboard des Health Monitor bietet eine sofortige Ansicht des Status des Enterprise Server und seiner unterstützenden Infrastruktur sowie Links zu weiteren Informationen.

Fehler und Warnungen

Der Status jedes Elements im Dashboard wird durch eine Meldung und ein zugehöriges Symbol angezeigt:

• OK  – die erkannten Messwerte liegen innerhalb eines akzeptablen Bereichs bzw. Zustands.
• Warning  – der Enterprise Server und seine unterstützende Infrastruktur funktionieren korrekt, es wird jedoch eine Änderung empfohlen, um ein potenzielles oder zukünftiges Problem zu beheben.
• Error  – ein Teil des Enterprise Server oder seiner unterstützenden Infrastruktur funktioniert nicht korrekt und erfordert sofortige Aufmerksamkeit.

Bewegen Sie den Mauszeiger über den Status eines Elements, um weitere Informationen anzuzeigen. Für einen im Dashboard angezeigten Fehler oder eine Warnung sind in den meisten Fällen weitere Details verfügbar, wenn Sie auf den Statuseintrag dieses Elements klicken.

Bewegen Sie den Mauszeiger über einen Statuseintrag, um detailliertere Informationen anzuzeigen.

Reaktive Links

Viele der vom Health Monitor erkannten Fehler-/Warnbedingungen bieten Links, die bei der Behebung der Situation helfen sollen. Diese sind in den Detailinformationen des Elements enthalten, die durch Klicken auf dessen Statuseintrag verfügbar sind.

    
Wenn häufige Ereignisprobleme auftreten, liefern die zugehörigen Informationen weitere Details und Links, die bei der Behebung des betreffenden Problems helfen.

Im obigen Beispielbildschirm links hat der Health Monitor erkannt, dass der Enterprise Server nicht gesichert wurde. Die zugehörigen Informationen enthalten einen Link zur Dokumentation, die bei der Behebung der Situation hilft.

Der Beispielbildschirm rechts (oben) zeigt an, dass die Standard-Anmeldedaten admin/admin des Enterprise Server noch vorhanden sind, was ein erhebliches Sicherheitsrisiko darstellt. Der Link Fix It in den zugehörigen Informationen öffnet direkt die Anmeldeseite des Enterprise Server über die Browseroberfläche, wo die Administrator-Benutzerprofile korrigiert werden können.

Log Browser

Der Bildschirm „Log Browser“ des Health Monitor, aufgerufen über die Registerkarte Log Browser, zeigt Fehler- und Warnungseinträge aus allen verfügbaren Protokolldateien des Enterprise Server an – diese befinden sich normalerweise im Ordner C:\ProgramData\Altium\Altium365Data\logs. Um die Protokolldatei anzuzeigen, die den Ereigniseintrag enthält, wählen Sie den zugehörigen Link Open file  oder doppelklicken Sie einfach auf den Eintrag selbst.

Die kumulativen Ereigniseinträge in der Liste sind nach Datum gegliedert und enthalten alle verfügbaren Fehler-/Warnereignisse aus sämtlichen Protokolldateien. Um bestimmte Ereignisse zu finden, wählen Sie im Dropdown-Menü Show logs einen Zeitraum aus und/oder verwenden Sie das dynamische Filterfeld (), um innerhalb der Spalten Subsystem und Message nach Schlüsselwörtern zu suchen.

Die Oberfläche Log Browser ermöglicht es Ihnen, mithilfe eines auswählbaren Zeitraums und einer Schlüsselwortfilterung gezielt interessante Ereignisse zu finden.

Wählen Sie die Schaltfläche , um die gesammelten Protokolleinträge aus der Liste im Log Browser zu entfernen – dadurch werden alle vorhandenen Protokolldateien archiviert und anschließend gelöscht.

Statusbericht

Der Bildschirm „Status Report“ des Health Monitor, der über die Registerkarte Status Report aufgerufen wird, dient zum Erstellen und Anzeigen von Statusberichtdateien des Enterprise Server. Die erzeugten Berichte fassen alle Debug-Informationen zu Ereignissen in einem einzigen Zip-Archiv (*.zip) zusammen, das bei Bedarf an die Altium-Entwickler gesendet werden kann.

Um einen Bericht zu erstellen, wählen Sie im Dropdown-Menü Include Logs einen geeigneten Ereigniszeitraum aus, geben Sie Ihre Kontaktdaten ein und wählen Sie die Freigabevereinbarung aus. Starten Sie den Vorgang dann mit der Schaltfläche .

Verwenden Sie den Bildschirm Status Report, um zusammengefasste Log-Berichtdateien für Debugging-Zwecke zu erzeugen.