Migration von Citrix Ready KVM VPX zu offiziell unterstütztem NetScaler VPX™ auf Nutanix AHV
Der Citrix Ready® KVM-basierte NetScaler VPX auf Nutanix AHV wurde von vielen Kunden verwendet, verfügt jedoch nicht über offiziellen Citrix®-Support und erweiterte Automatisierungsfunktionen. Daher empfehlen wir unseren Kunden, von Citrix Ready KVM VPX zu offiziell unterstütztem NetScaler VPX auf Nutanix AHV zu migrieren.
Voraussetzung
Überprüfen Sie vor der Migration die Einschränkungen des Nutanix AHV-spezifischen VPX-Images, um sicherzustellen, dass Ihre Umgebung nicht von ausgeschlossenen Funktionen abhängt. Weitere Informationen finden Sie unter Nicht unterstützte Funktionen und Einschränkungen.
Sie können mit einer der folgenden Methoden von Citrix Ready KVM VPX zu offiziell unterstütztem NetScaler VPX auf Nutanix AHV migrieren:
-
Direktes Upgrade von Citrix Ready KVM VPX zu offiziell unterstütztem NetScaler VPX auf Nutanix AHV
-
Migration mithilfe des Node-by-Node-Hochverfügbarkeits-(HA)-Ersatzes
Direktes Upgrade von Citrix Ready KVM VPX zu offiziell unterstütztem NetScaler VPX auf Nutanix AHV
Ab NetScaler Release 14.1 Build 66.x können Sie ein direktes Upgrade von Citrix Ready KVM-basierten VPX-Instanzen auf den offiziell unterstützten NetScaler VPX auf Nutanix AHV durchführen.
Wichtig:
Citrix Ready VPX-Instanzen, die auf Version 14.1-66.x oder höher aktualisiert werden, müssen das offiziell unterstützte Nutanix-spezifische Upgrade-Bundle verwenden. Das Standard-Upgrade-Bundle wird für diese Migration nicht unterstützt.
Voraussetzungen
-
Mindestversion von NetScaler: Stellen Sie sicher, dass die aktuelle NetScaler-Version 14.1–56.74 oder höher ist. Wenn die aktuelle Version älter ist, aktualisieren Sie die Appliance vor dem Fortfahren mit dem Standard-Upgrade-Bundle.
-
Hardwareanforderungen: Für jede vCPU sind mindestens 2 GB RAM erforderlich. Zum Beispiel muss eine VM mit 4 vCPUs mindestens 8 GB RAM zugewiesen haben.
-
Einschränkungen prüfen: Prüfen Sie die Nutanix AHV-spezifischen VPX-Einschränkungen, bevor Sie fortfahren.
Wichtige Überlegungen vor dem Upgrade
-
VM-Snapshot (obligatorisch): Sie müssen einen Snapshot der laufenden VM erstellen, bevor Sie mit dem Upgrade fortfahren. Dies ermöglicht Ihnen, die VM wiederherzustellen, falls Konfigurationsverluste auftreten. Weitere Informationen finden Sie unter Manuelles Erstellen eines VM-Snapshots.
-
Externe Sicherung (empfohlen): Wir empfehlen Ihnen, eine externe Sicherung kritischer Konfigurationen und benutzerdefinierter Daten zu erstellen, insbesondere für Dateien, die sich außerhalb der geschützten Verzeichnisse befinden. Dieser Schritt ist optional, wenn bereits ein VM-Snapshot erstellt wurde.
-
Datensicherung und -erhaltung: Lesen Sie den Abschnitt Datensicherung und -erhaltung während des Upgrades.
Datensicherung und -erhaltung während des Upgrades
-
Das Upgrade bewahrt benutzerdefinierte Dateien, Zertifikate und Signaturdateien in bestimmten Verzeichnissen automatisch auf. Daten, die sich außerhalb dieser Pfade befinden, werden nicht beibehalten und erfordern eine manuelle Sicherung und Wiederherstellung.
Geschützte Verzeichnisse:
/flash/nsconfig/flash/boot/flash/configdb/var/tmp/*.csv/var/AAA/var/analytics_conf/var/download/var/krb/var/learnt_data/var/metrics_conf/var/netscaler/gui/var/netscaler/locdb/var/netscaler/logon/var/netscaler/ssl/var/nstemplates/var/vpn/var/vpns/var/clusterd/nsclusterd.conf
-
Wenn Sie angepasste Konfigurationsdateien im
/etcVerzeichnis haben, lesen Sie Überlegungen zum Upgrade für angepasste Konfigurationsdateien im Verzeichnis /etc, bevor Sie mit der Migration fortfahren. -
Anpassungen, die an den folgenden Dateien vorgenommen wurden, bleiben während des Migrationsprozesses erhalten, funktionieren aber möglicherweise nicht mehr wie vor der Migration:
rc.netscalernsbefore.shnsafter.shcrontab
Sie müssen diese Anpassungsdateien überprüfen und aktualisieren, um die Kompatibilität mit dem aktualisierten NetScaler sicherzustellen.
Upgrade-Verfahren
-
Laden Sie das mit Nutanix AHV kompatible NetScaler VPX-Upgrade-Bundle (Format:
build-<version-build>_lx_64.tgz) von der Citrix Downloads-Seite herunter. -
Navigieren Sie zu Citrix.com > Downloads > NetScaler > Virtual Appliances, und laden Sie das mit Nutanix AHV kompatible NetScaler VPX-Upgrade-Bundle von der Citrix Downloads-Seite herunter.
-
Kopieren Sie die heruntergeladene Datei
build-<version-build>_lx_64.tgzin das Verzeichnis/var/nsinstall/auf der NetScaler VPX Shell und entpacken Sie sie. -
Führen Sie
./installnsaus und starten Sie die Appliance neu, wenn Sie dazu aufgefordert werden. Schalten Sie die VM während der für den Vorgang erforderlichen mehreren Neustarts nicht aus.
Validierung nach dem Upgrade
-
Melden Sie sich bei der NetScaler VPX GUI/CLI an und überprüfen Sie, ob die laufende Version mit der Ziel-Upgrade-Bundle-Version übereinstimmt.
-
Validieren Sie alle virtuellen Dienste, SSL-Zertifikate und Richtlinien, um die korrekte Funktionalität sicherzustellen.
Migration mithilfe der Node-by-Node-Hochverfügbarkeits-(HA)-Ersatzmethode
Die HA-Node-by-Node-Ersatzmethode ermöglicht ein Upgrade ohne Ausfallzeiten und mit vollständiger Unterstützung vom Citrix Ready KVM VPX auf das offiziell unterstützte Nutanix AHV VPX-Image. Dieser Übergang erschließt erweiterte Automatisierungsfunktionen, vollständigen offiziellen Support und eine modernisierte Bereitstellungsplattform für NetScaler.
Schritt 1: Sperren Sie den HA-Status Ihres älteren primären Knotens.
-
Melden Sie sich bei Ihrem Citrix Ready KVM VPX-Primärknoten an und führen Sie den folgenden Befehl aus:
set ha node -hastatus STAYPRIMARY <!--NeedCopy--> -
Entfernen Sie auf dem sekundären Legacy-Knoten dessen HA-Kopplung mit dem primären Knoten mithilfe des folgenden Befehls:
rm ha node <primary-nsip> <!--NeedCopy--> -
Vergewissern Sie sich, dass der primäre Knoten den Datenverkehr ohne Unterbrechung weiterleitet, während Sie mit den Migrations- oder Ersetzungsaufgaben fortfahren.
Schritt 2: Stellen Sie einen neuen sekundären Knoten bereit.
- Stellen Sie eine neue NetScaler VPX-Instanz mithilfe des offiziellen Nutanix AHV 14.1-51.x-Images bereit.
- Weisen Sie die Verwaltungs-IP-Adresse zu, die zuvor von Ihrem sekundären Legacy-Knoten verwendet wurde.
- Schließen Sie die Ersteinrichtung ab, wenden Sie die Lizenz an und überprüfen Sie, ob die Netzwerkkonfiguration korrekt ist.
-
Verbinden Sie die HA-Knoten, indem Sie den folgenden Befehl ausführen:
add ha node <primary-nsip> <!--NeedCopy--> -
Überprüfen Sie mithilfe des folgenden Befehls, ob der HA-Status UP ist und die Synchronisierung erfolgreich war:
show ha node status <!--NeedCopy-->
Schritt 3: Befördern Sie den neuen sekundären Knoten zum primären Knoten.
-
Heben Sie auf dem alten primären Knoten (dem Legacy KVM VPX) den Status „stay primary“ mithilfe des folgenden Befehls auf:
unset ha node -stayprimary <!--NeedCopy--> -
Erzwingen Sie ein Failover mithilfe des folgenden Befehls:
force ha failover <!--NeedCopy--> -
Vergewissern Sie sich, dass der neu bereitgestellte sekundäre Knoten erfolgreich zum primären Knoten geworden und voll funktionsfähig ist.
show ha node status <!--NeedCopy--> -
Legen Sie den neuen primären Knoten mithilfe des folgenden Befehls als „stay primary“ fest:
set ha node -hastatus STAYPRIMARY <!--NeedCopy-->Hinweis:
Wenn die HA-Synchronisierung fehlschlägt, synchronisieren Sie die RPC-Passwörter auf beiden Knoten manuell mit dem Befehl
set rpcNode <peer-ip> -password <password>. -
Sollten bei diesem Schritt Probleme auftreten, wechseln Sie zurück zum alten primären Knoten und stellen Sie den alten sekundären Knoten wieder her. Für Unterstützung kontaktieren Sie das Citrix Support-Team.
Schritt 4: Ersetzen Sie den alten sekundären Knoten durch eine neue VPX.
-
Entfernen Sie den alten sekundären Knoten aus der HA-Konfiguration mit dem folgenden Befehl:
rm ha node <legacy-secondary-nsip> <!--NeedCopy--> - Stellen Sie eine weitere neue VPX-Instanz mit dem offiziellen Nutanix AHV 14.1-51.x Image bereit.
- Weisen Sie der neuen VPX-Instanz die Management-IP-Adresse des alten sekundären Knotens zu.
-
Schließen Sie die Einrichtung und Lizenzaktivierung ab.
-
Fügen Sie diese neue VPX mit dem folgenden Befehl dem HA-Paar hinzu:
add ha node <new-primary-nsip> <!--NeedCopy--> -
Überprüfen Sie mit dem folgenden Befehl, ob der HA-Status stabil, „UP“ und synchronisiert ist.
show ha node status <!--NeedCopy-->
Schritt 5: Validieren und abschließen.
- Überprüfen Sie die HA-Rollen und den Synchronisierungsstatus auf beiden neuen Knoten.
- Validieren Sie alle virtuellen Dienste, SSL-Zertifikate und Richtlinien, um die korrekte Funktionalität sicherzustellen.
- Führen Sie Failover- und Failback-Tests durch, um die Redundanz zu überprüfen.
- Sichern Sie alle Konfigurationen und erstellen Sie einen Snapshot der neuen Umgebung.
- Löschen Sie nach erfolgreicher Validierung die alten VPX-Instanzen, um Ressourcen freizugeben.
Wichtige Überlegungen
-
Sicherung: Es ist unerlässlich, Sicherungen Ihrer älteren Knoten beizubehalten, bis die neue VPX-Umgebung vollständig validiert und stabil ist.
-
Nicht unterstützte Funktionen: Eine Migration wird nicht empfohlen, wenn Ihre aktuelle Bereitstellung auf Funktionen basiert, die im neuen Nutanix AHV VPX-Image nicht unterstützt werden. Weitere Informationen finden Sie unter Nicht unterstützte Funktionen und Einschränkungen.