Upgrade
Jede NetScaler ADM-Version bietet neue und aktualisierte Funktionen mit erweiterter Funktionalität. Citrix empfiehlt, NetScaler ADM auf die neueste Version zu aktualisieren, um die neuen Funktionen und Fehlerbehebungen in Anspruch zu nehmen. Eine umfassende Liste von Verbesserungen, bekannten Problemen und Bugfixes ist in den Versionshinweisen enthalten, die jeder Versionsankündigung beiliegen. Es ist auch wichtig, den Lizenzierungsrahmen und die Arten von Lizenzen zu verstehen, die verwendet werden können, bevor Sie mit dem Upgrade beginnen. Informationen zur NetScaler ADM-Lizenzierung finden Sie unter Lizenzierung.
Die Informationen zum Upgrade-Pfad sind auch im Citrix Upgrade Guideverfügbar.
Upgradevorbereitung
Laden Sie das Upgrade-Paket von der NetScaler ADM Downloads-Seite herunter und folgen Sie den Anweisungen in diesem Artikel, um Ihr System auf den neuesten 13.1-Build zu aktualisieren. Nach Beginn des Upgradevorgangs wird ADM neu gestartet, und die vorhandenen Verbindungen werden beendet und wieder verbunden, wenn das Upgrade abgeschlossen ist. Die vorhandene Konfiguration wird beibehalten, aber NetScaler ADM verarbeitet keine Daten, bis das Upgrade abgeschlossen ist.
Wichtig!
Die NetScaler ADM-Version und der Build sollten gleich oder höher als Ihre NetScaler-Version und Ihr Build sein. Wenn Sie beispielsweise NetScaler ADM 12.1 Build 50.39 installiert haben, stellen Sie sicher, dass Sie NetScaler 12.1 Build 50.28/50.31 oder früher installiert haben.
Punkte, die vor dem Upgrade auf 13.1 zu beachtensind:
-
Wenn Sie ein Upgrade von Version 11.1 oder Version 12.0 56.x und früheren Builds durchführen, führen Sie die folgenden Schritte aus:
-
Upgrade von der bestehenden Version auf 12.0 Build 57,24.
-
Führen Sie ein Upgrade auf den neuesten Build der Version 12.1 durch.
-
Aktualisieren Sie auf Version 13.1.
-
-
Wenn Sie von 12.0 Build 57.24 und höher aktualisieren, aktualisieren Sie zuerst auf 12.1 und dann auf 13.1.
-
Wenn Sie von 12.1 aktualisieren, können Sie direkt auf 13.1 upgraden.
-
Wenn Sie von Versionen unter 13.0 64.xx upgraden, sollten Sie für eine bessere Benutzererfahrung zuerst auf 13.0 64.xx und dann auf 13.1 aktualisieren.
Wichtige Punkte, die Sie vor dem Upgrade auf 13.1 xx.xx und höher beachten sollten
Wenn Sie die ADM-Software auf Version 13.1 xx.xx aktualisieren, wird Ihre ADM-Datenbank ebenfalls migriert. Diese Datenmigration findet statt, weil ADM jetzt PostgreSQL Version 10.11 verwendet.
Hinweis
Das Herunterstufen der ADM-Software wird nicht unterstützt. Versuchen Sie nicht, ein Downgrade durchzuführen.
Empfohlene Vorsichtsmaßnahmen:
-
Erstellen Sie einen Snapshot des NetScaler ADM Servers, wenn Sie ein Upgrade auf 13.1 xx.xx und höher durchführen.
-
Sichern Sie den NetScaler ADM -Server, bevor Sie das Upgrade durchführen.
-
Nach dem Upgrade müssen Sie möglicherweise Verbindungen zwischen dem NetScaler ADM-Server und den verwalteten Instanzen wiederherstellen. Eine Bestätigungsaufforderung warnt Sie, dass Verbindungen fehlschlagen können, wenn Sie fortfahren.
-
Wenn Sie ein Upgrade auf eine Version zwischen 13.1.9.x und 13.1.30.x durchführen, setzt NetScaler ADM ein Rollback der vorhandenen StyleBooks ConfigPacks auf die frühere Version zurück.
Um dieses Problem zu vermeiden, führen Sie ein Upgrade auf 13.1.33.50 Build durch.
-
Nehmen Sie bei NetScaler ADM-Servern im Hochverfügbarkeits-Setup beim Upgrade keine Konfigurationsänderungen auf einem der Knoten vor.
Warnung
Aktualisieren Sie den Browser erst, wenn der Upgradevorgang erfolgreich abgeschlossen wurde. Überprüfen Sie die GUI auf die ungefähre Zeit für den Abschluss des Upgrades.
-
Nach dem Upgrade kann sich der aktive Knoten in einem Hochverfügbarkeitspaar ändern.
Aktualisieren Sie einen einzelnen NetScaler ADM-Server auf 13.1-12.x
-
Melden Sie sich mit Administratoranmeldeinformationen bei NetScaler ADM an.
-
Navigieren Sie zu Einstellungen > Administration. Klicken Sie unter Systemwartung auf NetScaler ADM aktualisieren.
-
Aktivieren Sie auf der Seite NetScaler ADM aktualisieren das Kontrollkästchen Software-Image bei erfolgreichem Upgrade bereinigen, um Image-Dateien nach dem Upgrade zu löschen. Wenn Sie diese Option auswählen, werden die NetScaler ADM Imagedateien beim Upgrade automatisch entfernt.
Hinweis
Diese Option ist standardmäßig ausgewählt. Wenn Sie dieses Kontrollkästchen vor dem Starten des Upgrade-Vorgangs nicht aktivieren, müssen Sie die Images manuell löschen.
-
Sie können dann eine neue Image-Datei hochladen, indem Sie entweder Lokal (Ihr lokaler Computer) oder Applianceauswählen. Die Builddatei muss auf der virtuellen NetScaler ADM Appliance vorhanden sein.
-
Klicken Sie auf OK.
-
Auf der Seite ADM aktualisieren werden einige Details wie der Dateiname, die ausgewählte Version und die geschätzte Zeit bis zum Abschluss angezeigt. Klicken Sie auf Upgrade.
Der Upgrade-Prozess wird gestartet.
Nachdem Ihre Konfiguration migriert wurde, können Sie sich bei der ADM-GUI anmelden. Bei der Anmeldung beginnen die historischen Daten im Hintergrund zu migrieren, während Sie weiterhin an ADM arbeiten können.
Während der Migration historischer Daten stehen einige der alten Daten möglicherweise nicht zur Verfügung. Die Zeit für die Migration Ihrer Datenbank hängt von der Größe der Daten und der Anzahl der Tabellen ab.
Sie können die Datenbankmigration mit der ADM-GUI überwachen. Klicken Sie auf Upgrade-Fortschritt anzeigen und der Status der Datenbankmigration wird angezeigt.
Nach Abschluss des Upgrades können Sie die Meldung anzeigen, dass die kostenlosen Standardlizenzen auf zwei reduziert werden. Klicken Sie für weitere Informationen auf Details anzeigen .
Aktualisieren Sie einen einzelnen NetScaler ADM-Server auf 13.1-4.x oder 13.1-9.x
-
Melden Sie sich mit Administratoranmeldeinformationen bei NetScaler ADM an.
-
Navigieren Sie zu System > Systemadministration. Klicken Sie unter der Unterüberschrift Systemadministration auf NetScaler ADM aktualisieren.
-
Aktivieren Sie auf der Seite NetScaler ADM aktualisieren das Kontrollkästchen Software-Image bei erfolgreichem Upgrade bereinigen, um Image-Dateien nach dem Upgrade zu löschen. Wenn Sie diese Option auswählen, werden die NetScaler ADM Imagedateien beim Upgrade automatisch entfernt.
Hinweis
Diese Option ist standardmäßig ausgewählt. Wenn Sie dieses Kontrollkästchen vor dem Starten des Upgrade-Vorgangs nicht aktivieren, müssen Sie die Images manuell löschen.
-
Sie können dann eine neue Image-Datei hochladen, indem Sie entweder Lokal (Ihr lokaler Computer) oder Applianceauswählen. Die Builddatei muss auf der virtuellen NetScaler ADM Appliance vorhanden sein.
-
Klicken Sie auf OK. Das Dialogfeld Bestätigen wird angezeigt. Klicken Sie auf Ja.
Der Upgrade-Prozess wird gestartet.
Nachdem Ihre Konfiguration migriert wurde, können Sie sich bei der ADM-GUI anmelden. Bei der Anmeldung beginnen die historischen Daten im Hintergrund zu migrieren, während Sie weiterhin an ADM arbeiten können.
Während der Migration historischer Daten stehen einige der alten Daten möglicherweise nicht zur Verfügung. Die Zeit für die Migration Ihrer Datenbank hängt von der Größe der Daten und der Anzahl der Tabellen ab.
Sie können die Datenbankmigration mit der ADM-GUI überwachen. Klicken Sie auf Upgrade-Fortschritt anzeigen und der Status der Datenbankmigration wird angezeigt.
Problembehandlung bei Problemen bei der Datenbank
Während des Upgrade-Vorgangs auf 13.1 xx.xx und höher scheint die Migration von Web Insight Verlaufsdaten manchmal hängen zu bleiben. Um in solchen Fällen Details der Datenmigration zu überprüfen, gehen Sie wie folgt vor.
Melden Sie sich bei der ADM-Shell-Eingabeaufforderung an und führen Sie den folgenden Befehl aus, um die detaillierten Details des Fortschritts anzuzeigen.
cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
<!--NeedCopy-->
Hier ist ein Beispiel für eine Ausgabe
bash-3.2# cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
Tue Oct 6 07:41:55 GMT 2020
157 out of 127346 done in 54 seconds
File
/var/mps/db_upgrade/hist_table_mig_data/Web_Insight/af_app_client_server_resp_second_l3p_d7_dump
bash-3.2#
<!--NeedCopy-->
In diesem Beispiel ist af_app_client_server_resp_second_l3p_d7 der Eintrag, der aktualisiert wird. Und 157 Eintritte von 127.346 werden in 54 Sekunden migriert.
Aktualisieren eines Hochverfügbarkeitspaars von Version 12.1 auf Version 13.1
Für NetScaler ADM -Server in einem Hochverfügbarkeitsmodus können Sie ein Upgrade durchführen, indem Sie entweder auf den aktiven Knoten oder auf die schwebende IP-Adresse zugreifen. Beide NetScaler ADM -Server werden automatisch auf den neuesten Build aktualisiert, sobald Sie den Upgradevorgang auf einem der Server initiieren.
Hinweis
Wenn Sie ein Hochverfügbarkeitspaar von 12.0 oder früheren Versionen aktualisieren, lesen Sie NetScaler ADM 12.1 Upgrade
Upgrade der Bereitstellung von NetScaler ADM Disaster Recovery
Das Upgrade der NetScaler ADM Disaster Recovery-Bereitstellung erfolgt in zwei Schritten:
-
Aktualisieren Sie die NetScaler ADM-Knoten, die im Hochverfügbarkeitsmodus am primären Standort konfiguriert sind. Später müssen Sie den Notfallwiederherstellungsknoten aktualisieren.
-
Stellen Sie sicher, dass Sie die NetScaler ADM-Server, die mit hoher Verfügbarkeit bereitgestellt werden, aktualisiert haben, bevor Sie den Disaster Recovery-Knoten aktualisieren.
Aktualisieren des NetScaler ADM Notfallwiederherstellungsknotens
-
Laden Sie die NetScaler ADM-Upgrade-Image-Datei von der NetScaler-Website herunter.
-
Laden Sie diese Datei mit
nsrecover-Anmeldeinformationen auf den Disaster Recovery-Knoten hoch. -
Melden Sie sich mit den
nsrecover-Anmeldeinformationen beim Disaster Recovery-Knoten an. -
Navigieren Sie zu dem Ordner, in dem Sie die Imagedatei abgelegt haben, und entpacken Sie die Datei.
-
Führen Sie das folgende Skript aus:
./installmas
Upgrade von On-Premises-Agents für die Bereitstellung an mehreren Standorten
Das Upgrade der NetScaler ADM Agent-Bereitstellung erfolgt in drei Schritten. Stellen Sie sicher, dass Sie die folgenden Aufgaben ausgeführt haben, bevor Sie die On-Premises-Agents aktualisieren:
-
Aktualisieren Sie die NetScaler ADM -Server, die in Hochverfügbarkeit bereitgestellt werden.
-
Aktualisieren Sie den NetScaler ADM Notfallwiederherstellungsknoten.
Weitere Informationen finden Sie unter Aktualisieren der NetScaler ADM-Disaster Recovery-Bereitstellung.
Upgrade der On-Premises-Agents
-
Laden Sie die NetScaler ADM Agent-Upgrade-Image-Datei von der NetScaler-Website herunter.
-
Laden Sie diese Datei mit den
nsrecover-Anmeldeinformationen auf den Agentknoten hoch. -
Stellen Sie sicher, dass Sie das richtige Agent-Upgradeimage herunterladen.
-
Melden Sie sich mit den
nsrecover-Anmeldeinformationen beim On-Prem-Agent an. -
Navigieren Sie zu dem Ordner, in dem Sie die Imagedatei abgelegt haben, und entpacken Sie die Datei.
-
Führen Sie das folgende Skript aus:
./installmasagent
Zusätzlichen Datenträger für NetScaler ADM-Server bereitstellen
Wenn Ihre NetScaler ADM-Speicheranforderungen den Standardspeicherplatz (120 GB) überschreiten, können Sie einen zusätzlichen Datenträger anschließen. Sie können mehr Datenträger sowohl in Bereitstellungen mit einem Server als auch in Bereitstellungen mit hoher Verfügbarkeit anhängen.
Wenn Sie NetScaler ADM von Release 12.1—13.1 aktualisieren, bleiben die Partitionen, die Sie in der früheren Version auf dem zusätzlichen Datenträger erstellt haben, unverändert. Die Partitionen werden nicht entfernt oder in der Größe geändert.
Das Verfahren zum Bereitstellen weiterer Datenträger bleibt im aktualisierten Build unverändert. Sie können jetzt das neue Datenträgerpartitionierungstool in NetScaler ADM verwenden, um Partitionen auf dem neu hinzugefügten Datenträger zu erstellen. Sie können das Tool auch verwenden, um die Größe der Partitionen auf der vorhandenen More Disk zu ändern. Weitere Informationen zum Bereitstellen weiterer Datenträger und zur Verwendung des neuen Datenträgerpartitionierungstools finden Sie unter Bereitstellen eines zusätzlichen Datenträgers in NetScaler ADM.
NetScaler-Instanzen in OpenStack mit StyleBooks bereitstellen
Ab NetScaler ADM 12.1 Build 49.23 wurde die Architektur eines OpenStack-Orchestrierungs-Workflows aktualisiert. Der Workflow verwendet jetzt NetScaler ADM StyleBooks, um NetScaler Instanzen zu konfigurieren. Wenn Sie von Version 12.0 oder 12.1 Build 48.18 auf NetScaler ADM 13.1 aktualisieren, müssen Sie das folgende Migrationsskript ausführen:
/mps/scripts/migration_scripts/migrate_configurations.py
<!--NeedCopy-->
Weitere Informationen zum StyleBook os-cs-lb-mon und zum Migrationsskript finden Sie unter Provisioning der NetScaler VPX-Instanz auf OpenStack mit StyleBook
In diesem Artikel
- Upgradevorbereitung
- Aktualisieren Sie einen einzelnen NetScaler ADM-Server auf 13.1-12.x
- Aktualisieren Sie einen einzelnen NetScaler ADM-Server auf 13.1-4.x oder 13.1-9.x
- Aktualisieren eines Hochverfügbarkeitspaars von Version 12.1 auf Version 13.1
- Upgrade der Bereitstellung von NetScaler ADM Disaster Recovery
- Upgrade von On-Premises-Agents für die Bereitstellung an mehreren Standorten
- Zusätzlichen Datenträger für NetScaler ADM-Server bereitstellen
- NetScaler-Instanzen in OpenStack mit StyleBooks bereitstellen