NetScaler Application Delivery Management Service

Behebung von Problemen mithilfe des Diagnosetools oder der ADM-GUI

Hinweis

Das Diagnosetool gilt nur für die ADC-Instanzen, die mit dem NetScaler ADM Connect-basierten Low-Touch-Onboarding integriert wurden oder integriert werden sollen.

Weitere Informationen finden Sie unter Low-Touch-Onboarding von NetScaler-Instanzen mithilfe von NetScaler ADM Connect.

Wenn Sie eine ADC-Instanz in NetScaler ADM integrieren, treten möglicherweise einige Probleme auf, die das erfolgreiche Onboarding der ADC-Instanz verhindern. Als Administrator müssen Sie den Grund für den Fehler beim Onboarding kennen. Sie können Diagnoseprüfungen mit dem Diagnosetool durchführen, wenn Sie:

  • Probleme beim Auto-Onboarding oder beim skriptbasierten Onboarding

  • Sie möchten sicherstellen, dass die ADC-Instanz bereit für das Onboard ist

  • Möchten Sie Probleme für die bereits integrierten ADC-Instanzen analysieren, die in der NetScaler ADM-GUI den Status “Heruntergefahren” anzeigen

Wenn die ADM-Dienstverbindung auf der ADC-Instanz aktiviert ist, werden die Diagnosedetails automatisch an Citrix gesendet, und Sie können Details in der ADM-GUIanzeigen. Wenn ADM Service Connect nicht aktiviert ist, können Sie das Diagnosetool manuell verwenden.

Verwenden Sie das Diagnosetool manuell

Das Diagnosetool ist im Rahmen des mastools-Upgrades (13.1-2.x oder höher) verfügbar und kann unter /var/mastools/scripts abgerufen werden. Sie können die mastools-Version überprüfen, indem Sie den Befehl cat /var/mastools/version.txt in der ADC-Instanz ausführen.

So führen Sie das Diagnosetool aus:

  1. Melden Sie sich mit einem SSH-Client bei der ADC-Instanz an.

  2. Geben Sie shell ein und drücken Sie die Eingabetaste, um in den Bash-Modus zu wechseln.

  3. Geben Sie cd /var/mastools/scripts ein.

  4. Geben Sie sh mastools_diag ein.

Das Tool wird gestartet und zeigt die Ergebnisse für die folgenden Diagnoseprüfungen an:

  • nscli

  • DNS-Konfiguration

  • Internetverbindung

  • Verbindung zwischen Instanz und ADM

  • Benutzerberechtigung

Wenn die Probleme auch nach der Fehlerbehebung weiterhin bestehen, können Sie sich an den NetScaler-Support wenden. Wenn Sie den NetScaler-Support kontaktieren, müssen Sie die ADM-Verbindungskonfigurationsinformationen angeben, die angezeigt werden, nachdem Sie das Diagnosetool ausgeführt haben.

Im Folgenden finden Sie ein Beispiel für Diagnoseergebnisse für eine ADC-Instanz, die keine Probleme aufweist:

Diagnoseergebnisse für ADC-Instanz ohne Probleme

  • 1 — Zeigt die Art der Diagnoseprüfung an

  • 2 — Zeigt die Ergebnisse der Diagnoseprüfung entweder grün oder rot an. Grün bedeutet, dass das Ergebnis erfolgreich ist, und Rot zeigt an, dass das Ergebnis nicht erfolgreich ist.

  • 3 — Zeigt die NetScaler ADM-Konfigurationsinformationen bei jeder Ausführung des Diagnosetools gelb an. Wenn Sie den NetScaler-Support kontaktieren möchten, müssen Sie diese Informationen angeben.

Überprüfen Sie die Bereitschaft der ADC-Instanz für das Onboarding mithilfe des Diagnosetools

Bevor Sie die ADC-Instanz in NetScaler ADM integrieren, können Sie die Bereitschaft der ADC-Instanz überprüfen, indem Sie das Diagnosetool auf der ADC-Instanz ausführen. Wenn die ADC-Instanz keine Probleme hat und bereit zum Onboarding ist, zeigt das Tool die Meldung an, dass das Gerät in ADM nicht beansprucht wurde .

Gerät wird auf NetScaler ADM nicht beansprucht

Anzeigen von ADC-Diagnoseinformationen in der ADM-GUI

Navigieren Sie zu Infrastruktur > Instanzen > NetScaler, und klicken Sie auf Bestandsinventar, um die neu hinzugefügte Onboarding Readiness Option anzuzeigen, die den Onboarding-Bereitschaftsstatus der ADC-Instanz wie Needs Review oder OKbereitstellt

  • Muss überprüft werden. Die ADC-Instanz weist Probleme auf, die behoben werden müssen.

  • OKAY. Die ADC-Instanz ist bereit für das Onboarding.

Hinweis

Wenn Onboarding Readiness leer angezeigt wird, bedeutet dies, dass die ADC-Instanz nicht mit dem neuesten Image ausgeführt wird, das Diagnoseunterstützung bietet.

Wenn die ADC-Instanz Probleme hat, wird die Option Needs Review angezeigt, und Sie können auf klicken, um weitere Details anzuzeigen.

Automatische Diagnosemeldung

Nachdem Sie auf Überprüfung erforderlichgeklickt haben, werden auf der Seite ADC Diagnostics Details die Problemdetails angezeigt.

Details zum Problem der automatischen Diagnose

  • Kategorie. Stellt die Problemkategorie bereit.

  • Status. Zeigt den Problemstatus an, z. B. Überprüfung erforderlich, OKoder Nicht zutreffend.

  • Empfehlung. Stellt die erforderliche Empfehlung zur Behebung des Problems bereit.

Nachdem Sie das Problem behoben haben, wird der Status in der Onboarding-Bereitschaft auf OKgeändert.

Problembehandlung

Im Folgenden sind einige der ADC-Instanzprobleme und ihre Schritte zur Fehlerbehebung aufgeführt:

Ungültiger Benutzername oder Kennwort

Ungültige Anmeldeinformationen

Problemumgehung: Stellen Sie sicher, dass der im Admin-Profil angegebene Benutzername und das Kennwort korrekt sind. Wenn Sie das ADC-Instanzkennwort geändert haben, müssen Sie die Admin-Profile der Instanzen ändern. Weitere Informationen finden Sie unter Ändern des Admin-Profils.

DNS-Konfigurationsfehler

DNS-Konfigurationsfehler

Problemumgehung: Stellen Sie sicher, dass der DNS konfiguriert ist oder die DNS-IP-Adresse gültig ist. Weitere Informationen finden Sie unter DNS-Konfiguration.

Keine Internetverbindung

Problemumgehung: Stellen Sie sicher, dass die Firewalleinstellung den Internetzugang nicht blockiert und der erforderliche Proxy konfiguriert ist.

Keine Verbindung zum NetScaler ADM-Endpoint

Problemumgehung: Stellen Sie sicher, dass die Firewalleinstellungen überprüft werden und die folgenden NetScaler ADM-Endpunkte nicht in der Firewall blockiert sind:

ADM_GRP_EP = "adm.cloud.com"

ADM_AGENT_EP = "agent.adm.cloud.com"

ADM_TRUST_EP = "trust.citrixnetworkapi.net"

ADM_DOWNLOAD_EP = "download.citrixnetworkapi.net"
<!--NeedCopy-->

Wenn bei den Diagnoseprüfungen kein Problem gefunden wurde und das Problem ohne Verbindung weiterhin besteht, notieren Sie sich die NetScaler ADM-Konfigurationsinformationen (gelb markiert) und wenden Sie sich an den NetScaler-Support.

Wenn Sie einen Testlauf durchführen, um sicherzustellen, dass die ADC-Instanz bereit für das Onboarding ist, können die folgenden Probleme auftreten:

Integrierte Zeitüberschreitung für den Trockenlauf

Wenn die Ergebnisse des Probelaufs nicht innerhalb von 5 Minuten abgerufen werden, wird eine Timeout-Meldung angezeigt.

Timeout

Empfehlung: Es wird empfohlen, dass Sie überprüfen, ob die ADC-Instanz mit dem neuesten Image ausgeführt wird, das Diagnoseunterstützung bietet. Außerdem wird in der Tabelle Asset-Auswahl die Spalte Onboarding Readiness leer angezeigt.

Roter Umriss im Dropdownmenü des Geräteprofils

Die ADC-Authentifizierung schlägt während des Testlaufs fehl und ein roter Umriss wird in der Dropdown-Liste des Geräteprofils angezeigt.

Profil-Fehler

Empfehlung: Geben Sie die ADC-Benutzeradministrator-Anmeldeinformationen erneut ein, erstellen Sie das Geräteprofil und klicken Sie auf Test, um den Probelauf erneut auszuführen.

Behebung von Problemen mithilfe des Diagnosetools oder der ADM-GUI