ADC

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

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

Ressourcen für die Fehlerbehebung

Verwenden Sie die folgenden Ressourcen, um ein Problem im Zusammenhang mit der Installation, Aktualisierung oder Herabstufung eines Citrix ADC zu beheben:

  • Die Konfigurationsdateien der Appliance. Im Falle eines Hochverfügbarkeitspaars die Konfigurationsdateien beider Appliances.
  • Die folgenden Dateien der Appliance(s):
    • Die relevanten newnslog-Dateien.
    • Die Datei ns.log.
    • Die Meldungsdatei.
  • Ein Netzwerktopologie-Diagramm.

Probleme und Lösungen

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

  1. Problem

    Das Upgrade einer Citrix ADC MPX Appliance schlägt aufgrund von Hardware- und Softwareintolerierbarkeit 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 Upgrade einer Citrix ADC VPX Appliance schlägt aufgrund von Citrix ADC VPX Appliance und Hypervisor-Inkompatibilität 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 Upgrade 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

    Upgrade einer Citrix ADC Appliance über die GUI Stalls.

    Lösung

    Aktualisieren Sie den Browser, um zu prüfen, ob das Upgrade fortschreitet oder nicht.

  5. Problem

    Das Upgrade einer Citrix ADC Appliance schlägt aufgrund von geringem Platzangebot im /var-Verzeichnis 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 das Citrix ADC ist nach dem Software-Downgrade nicht zugegriffen

    Ursache

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

    Lösung

    • Stellen Sie sicher, dass auf die Appliance über die Konsole zugegriffen werden kann.
    • Überprüfen Sie die NSIP-Adresse und die Routen auf der Appliance.
      • Wenn sich die IP-Adresse auf die Standard-IP-Adresse 192.168.100.1 geändert hat, ändern Sie die IP-Adresse nach Bedarf.
      • Stellen Sie sicher, dass auf die Appliance zugegriffen werden kann.
  7. Problem

    Wenn ich während eines Upgrades den Befehl zum Synchronisieren 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 High Availability (HA) synchronisiert wird.

  8. Problem

    Während eines Upgradevorgangs wird der Datenverkehr nicht durch den neuen primären Knoten geleitet, wenn Sie den Befehl erzwingen Failover ausführen.

    Lösung

    • Überprü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, virtuellen MAC zu verwenden, wenn 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 mit der Appliance über SSH fehl.

    Lösung

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

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

    In einem HA-Paar werden die Geräte nach dem Ausführen des Befehls Force HA-Failover weiterhin neu gestartet. Das sekundäre Gerät wird nach einem Upgrade nicht angezeigt.

    Lösung

    Überprü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

    • Überprüfen Sie, ob beide Knoten denselben Build ausführen. Wenn die Builds nicht identisch sind und HA-Knoten unterschiedliche Versionen haben, werden einige der Felder als UNKNOWN angezeigt, wenn Sie den Befehl show ha node ausführen.
    • Überprüfen Sie, ob die sekundäre Appliance erreichbar ist.
  12. Problem

    Nach dem Upgrade des Citrix ADC zeigt die Schnittstelle, dass die meisten der virtuellen Server und Dienste für den Lastausgleich 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 Ausführen eines Upgrades befinden sich alle virtuellen Server auf der sekundären Appliance.

    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 einem Downgrade startet Citrix ADC nicht ordnungsgemäß.

    Lösung

    Überprüfen Sie, ob die richtige Lizenz installiert wurde.

  15. Problem

    Bei 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

    Beim Neustart 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 die 255 Byte Grenze überschreitet. In Befehlen, die Richtlinien erstellen, die für die 255-Byte-Grenze 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 ab Version 9.3 unterstützt.

  17. Problem

    Beim Upgrade einer Citrix ADC VPX Appliance wird mir gesagt, dass ich Speicherplatz in /var freigeben soll. Welche Dateien kann ich entfernen?

    Lösung

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

  18. Problem

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

    Lösung

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

  19. Problem

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

    Lösung

    • Melden Sie sich mit der GUI am 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 die Option Standard aus der Liste des Benutzeroberflächendesigns 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 Sichern und Wiederherstellen einer Citrix ADC Appliance.

    Weitere Informationen zum Backup und Wiederherstellen eines Citrix ADC Cluster-Setups finden Sie unter Sichern und Wiederherstellen eines Cluster-Setups.

  21. Problem

    Wenn nach einem fehlgeschlagenen Upgrade einer Citrix ADC Appliance Lizenzen fehlen, wie kann das Problem behoben werden?

    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 Herabstufen der Software über mehrere Versionen hinweg.

Weitere Probleme finden Sie in den Versionshinweisen, Knowledge Center-Artikeln und häufig gestellten Fragen.

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