Citrix ADC

Behebung von Problemen im Zusammenhang mit den Installations-, Upgrade- und Downgrade-Prozessen

Wenn die Appliance nach Abschluss des Installations-, Upgrade- oder Downgrade-Vorgangs nicht wie erwartet funktioniert, müssen Sie zunächst nach den häufigsten Ursachen des Problems suchen.

Ressourcen für die Fehlerbehebung

Verwenden Sie für beste Ergebnisse die folgenden Ressourcen, um ein Problem im Zusammenhang mit der Installation, dem Upgrade oder dem Downgrade eines Citrix ADC zu beheben:

  • Die Konfigurationsdateien von der Appliance. Im Falle eines Hochverfügbarkeitspaars die Konfigurationsdateien von beiden Appliances.
  • Die folgenden Dateien von den Appliance (s):
    • Die relevanten Newslog-Dateien.
    • Die Datei ns.log.
    • Die Nachrichtendatei.
  • Ein Netzwerktopologie-Diagramm.

Probleme und Lösungen

Im Folgenden finden Sie die häufigsten Installations-, Upgrade- und Downgrade-Probleme sowie Tipps zur Behebung dieser Probleme:

  1. Problem

    Das Aktualisieren einer Citrix ADC MPX-Appliance schlägt aufgrund von Hardware- und Softwareinkompatibilität fehl.

    Lösung

    Sehen Sie sich die Citrix ADC MPX Hardware-Software-Kompatibilitätsmatrix an und prüfen Sie, ob das Software-Release auf der Citrix ADC MPX-Hardware unterstützt wird.

  2. Problem

    Das Aktualisieren einer Citrix ADC VPX-Appliance schlägt aufgrund der Inkompatibilität von Citrix ADC VPX Appliance und Hypervisor fehl.

    Lösung

    Sehen Sie sich die Citrix ADC VPX Appliance und die Hypervisor-Kompatibilitätsmatrix an, und prüfen Sie, ob das Citrix ADC VPX Appliance-Modell auf dem Hypervisor unterstützt wird.

  3. Problem

    Das Aktualisieren einer Citrix ADC-Appliance schlägt aufgrund von Hardwarefehlern fehl.

    Lösung

    Überprüfen Sie die Integrität der Citrix ADC-Appliance. Wenn Sie über eine Citrix ADC Hardware-Appliance verfügen, empfiehlt Citrix, eine Festplattenprüfung durchzuführen und die Integrität der Citrix ADC -Festplatte zu überprüfen. fsck

    Weitere Informationen finden Sie unter Überprüfen der Dateisystemintegrität einer Citrix ADC-Appliance.

  4. Problem

    Aktualisieren einer Citrix ADC-Appliance über die GUI-Stalls.

    Lösung

    Aktualisieren Sie den Browser, um zu überprüfen, ob das Upgrade voranschreitet oder nicht.

  5. Problem

    Das Aktualisieren einer Citrix ADC-Appliance schlägt aufgrund des geringen Speicherplatzes im Verzeichnis /var fehl

    Lösung

    Geben Sie Speicherplatz im /var-Verzeichnis frei. Weitere Informationen finden Sie unter So geben Sie Speicherplatz im /var-Verzeichnis frei.

  6. Problem

    Auf den Citrix ADC kann nach dem Software-Downgrade nicht zugegriffen werden

    Ursache

    Wenn während des Software-Downgrade-Prozesses die Konfigurationsdatei der vorhandenen Version und des Builds nicht mit der Konfigurationsdatei der früheren Version und des früheren Builds übereinstimmt, kann die Appliance die Konfiguration nicht laden, und die Standard-IP-Adresse wird der Appliance zugewiesen.

    Lösung

    • Stellen Sie sicher, dass die Appliance von der Konsole aus zugänglich ist.
    • Überprüfen Sie die NSIP-Adresse und die Routen auf der Appliance.
      • Wenn sich die IP-Adresse auf die standardmäßige 192.168.100.1-IP-Adresse geändert hat, ändern Sie die IP-Adresse nach Bedarf.
      • Stellen Sie sicher, dass die Appliance zugänglich ist.
  7. Problem

    Wenn ich während eines Upgrades den Befehl zur Synchronisierung ausführe, wird die folgende Meldung angezeigt:

    Der Befehl ist auf dem sekundären Knoten fehlgeschlagen, aber auf dem primären Knoten erfolgreich.

    Lösung

    Führen Sie keine abhängigen Befehle aus (set /unset /bind /unbind), wenn die Synchronisierung mit hoher Verfügbarkeit (HA) läuft.

  8. Problem

    Während eines Upgrade-Vorgangs durchläuft der Datenverkehr den neuen primären Knoten nicht, wenn Sie den Befehl Force Failover ausführen.

    Lösung

    • Prüfen Sie auf Probleme mit der Netzwerktopologie und den Switch-Konfigurationen.
    • Führen Sie den Befehl set L2Param -garpreply ENABLED aus, um die GARP-Antwort zu aktivieren.
    • Versuchen Sie es mit virtuellem MAC, falls nicht bereits verwendet.
    • Führen Sie den Befehl sendarp —a vom primären Knoten aus.
  9. Problem

    Nach dem Upgrade oder Downgrade einer Citrix ADC-Appliance schlägt die Verbindung zur Appliance über SSH fehl.

    Lösung

    Führen Sie die folgenden Vorgänge in der Citrix ADC-Appliance aus:

    • Entfernen Sie alte oder unsichere Host-Schlüssel bei /nsconfig/ssh/ssh_host_*.
    • Überprüfen Sie die benutzerdefinierte SSHD-Konfiguration unter /nsconfig/sshd_config und prüfen Sie, ob sie immer noch relevant und kompatibel ist. Benennen Sie die benutzerdefinierte SSHD-Konfiguration entsprechend um oder entfernen Sie sie.
    • Kaltstart der Citrix ADC-Appliance
  10. Problem

    In einem HA-Paar starten die Geräte nach dem Ausführen des Befehls Force HA-Failover weiter neu. Das sekundäre Gerät wird nach einem Upgrade nicht hochgestellt.

    Lösung

    Prüfen Sie, ob das Verzeichnis /var voll ist. Wenn ja, entfernen Sie die alten Installationsdateien. Führen Sie den Befehl df —h aus, um den verfügbaren Speicherplatz anzuzeigen.

  11. Problem

    Nach dem Upgrade eines HA-Paares wird einer der Knoten als Status UNKNOWN aufgeführt.

    Lösung

    • Prüfen Sie, ob beide Knoten denselben Build ausführen. Wenn die Builds nicht identisch sind und HA-Knoten eine Versionsübereinstimmung aufweisen, werden einige der Felder als UNKNOWN angezeigt, wenn Sie den Befehl show ha node ausführen.
    • Prüfen Sie, ob das sekundäre Gerät erreichbar ist.
  12. Problem

    Nach dem Upgrade des Citrix ADC zeigt die Schnittstelle an, dass die meisten virtuellen Lastausgleichsserver und -dienste DOWN sind.

    Lösung

    Stellen Sie sicher, dass die SNIP-Adresse auf der sekundären Appliance aktiv ist. Geben Sie außerdem den Befehl show service ein, um zu sehen, ob der Dienst ausgeführt wird.

  13. Problem

    Nach dem Durchführen eines Upgrades sind alle virtuellen Server auf der sekundären Appliance ausgefallen.

    Lösung

    Aktivieren Sie den HA-Status und die HA-Synchronisierung, indem Sie die folgenden Befehle ausführen:

    • set node hastate enable
    • set node hasync enable

    Das Deaktivieren von HA wird nicht empfohlen.

  14. Problem

    Nach dem Durchführen eines Downgrades startet der Citrix ADC nicht ordnungsgemäß.

    Lösung

    Prüfen Sie, ob die richtige Lizenz installiert wurde.

  15. Problem

    In einem HA-Paar werden einige Funktionen nicht synchronisiert, nachdem ein Upgrade durchgeführt wurde.

    Lösung

    Führen Sie den Befehl sync ha file misc aus, um die Konfigurationsdateien vom primären Knoten zum sekundären Knoten zu synchronisieren.

  16. Problem

    Während des Neustarts wird die folgende Fehlermeldung angezeigt:

    Ein oder mehrere Befehle in ns.conf sind fehlgeschlagen Was soll ich tun?

    Lösung

    Stellen Sie sicher, dass kein Befehl in der Datei ns.conf das 255-Byte-Limit überschreitet. In Befehlen, die Richtlinien erstellen, die für das 255-Byte-Limit zu lang sind, können Sie Mustersätze verwenden, um die Richtlinien zu verkürzen.

    Beispiel:

    add cs policy p11 -rule 'HTTP.REQ.URL.ENDSWITH_ANY("ctx_file_extensions")'
    Done
    <!--NeedCopy-->
    

    ctx_file_extensions ist ein Standard-Patset, das eine große Anzahl von Erweiterungen abdeckt. Zusätzlich zu den Standardmustersätzen können Sie benutzerdefinierte Mustersätze erstellen. Fügen Sie ein Patset hinzu, indem Sie den folgenden Befehl ausführen:

    add patset <name>
    <!--NeedCopy-->
    

    Hinweis: Patsets werden nur in Version 9.3 oder höher unterstützt.

  17. Problem

    Beim Upgrade einer Citrix ADC VPX-Appliance werde ich aufgefordert, Speicherplatz in /var freizugeben. Welche Dateien entferne ich?

    Lösung

    Entfernt die alten Installationsdateien aus dem Verzeichnis /var/tmp/. Entferne auch unerwünschte Dateien aus /flash.

  18. Problem

    Es besteht keine Verbindung zur grafischen Benutzeroberfläche (GUI), wenn Sie den Befehl force HA-Failover auf der sekundären Appliance ausführen.

    Lösung

    Melden Sie sich über die Befehlszeilenschnittstelle bei der sekundären Appliance an und aktivieren Sie den Zugriff auf die GUI, indem Sie den <IP>Befehl set ns ip -gui enabled ausführen.

  19. Problem

    Nach dem Durchführen eines Upgrades und wenn ich auf einen Link auf der GUI klicke, der ein Java-Applet laden muss (Upgrade-Assistent oder Lizenzassistent), wird die folgende Fehlermeldung angezeigt: Die GUI-Version stimmt nicht mit der Kernelversion überein. Bitte schließen Sie diese Instanz, löschen Sie den Java-Plug-In-Cache und öffnen Sie erneut.

    Lösung

    • Melden Sie sich mit der GUI beim Citrix ADC an.
    • Navigieren Sie zu Citrix ADC Gateway > Globale Einstellungen.
    • Klicken Sie unter Einstellungen auf Globale Einstellungen ändern.
    • Wählen Sie im Detailbereich unter Client Experience in der Liste des UI-Themas die Option Standard aus.
    • Klicken Sie auf OK.
  20. Problem

    Wenn das Upgrade einer Citrix ADC-Appliance aus irgendeinem Grund fehlgeschlagen ist, wie kann die Appliance mithilfe der gesicherten Dateien wiederhergestellt werden?

    Lösung

    Wenn das Upgrade nicht erfolgreich ist, stellen Sie die Appliance mithilfe der gesicherten Dateien auf die vorherige Version der Citrix ADC-Appliance wieder her. Weitere Informationen finden Sie unter Backup und Wiederherstellen einer Citrix ADC-Appliance.

    Weitere Informationen zum Backup und Wiederherstellen eines Citrix ADC Clustersetups finden Sie unter Backup und Wiederherstellen eines Clustersetups.

  21. Problem

    Wie kann das Problem behoben werden, wenn nach einem fehlgeschlagenen Upgrade einer Citrix ADC-Appliance Lizenzen fehlen?

    Lösung

    Wenn eine Lizenz fehlt oder Sie die Lizenzen neu zuweisen möchten, lesen Sie das folgende Thema Übersicht über die Lizenzierung.

Hinweis

Diese Schritte zur Fehlerbehebung gelten auch für Probleme mit Konfigurationsverlust beim Downgrade der Software über mehrere Versionen hinweg.

Für jedes andere Problem lesen Sie die Versionshinweise, Artikel des Knowledge Center und FAQs.

Behebung von Problemen im Zusammenhang mit den Installations-, Upgrade- und Downgrade-Prozessen