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 zu nutzen. Eine umfassende Liste der Verbesserungen, bekannten Probleme und Fehlerbehebungen finden Sie in den Versionshinweisen , die jeder Versionsankündigung beiliegen. Es ist auch wichtig, den Lizenzrahmen und die Arten der verwendbaren Lizenzen zu verstehen, bevor Sie mit dem Upgrade beginnen. Informationen zur NetScaler ADM-Lizenzierung finden Sie unterLizenzierung.

Informationen zum Upgrade-Pfad sind auch im Citrix Upgrade Guideverfügbar.

Vor dem Upgrade

Laden Sie das Upgrade-Paket von der NetScaler ADM-Downloadseite herunter und befolgen Sie die Anweisungen in diesem Artikel, um Ihr System auf die neueste Version 13.1 zu aktualisieren. Nachdem der Upgrade-Prozess begonnen hat, wird ADM neu gestartet und die bestehenden Verbindungen werden beendet und nach Abschluss des Upgrades wiederhergestellt. Die vorhandene Konfiguration bleibt erhalten, 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 Ihrer NetScaler-Version und Ihrem 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.

Zu beachtende Punkte vor dem Upgrade auf 13.1:

• 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:

  1. Aktualisieren Sie von der vorhandenen Version auf 12.0 Build 57.24.

  2. Aktualisieren Sie auf die neueste Version 12.1.

  3. 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 aktualisieren.

• Wenn Sie von Versionen niedriger als 13.0 64.xx aktualisieren, aktualisieren Sie zur Verbesserung der Benutzererfahrung zuerst auf 13.0 64.xx und dann auf 13.1.

Wichtige Punkte, die vor dem Upgrade auf 13.1 xx.xx und höher zu beachten sind

Wenn Sie die ADM-Software auf Version 13.1 xx.xx aktualisieren, wird auch Ihre ADM-Datenbank migriert. Diese Datenmigration erfolgt, weil ADM jetzt PostgreSQL Version 10.11 verwendet.

Notiz

Ein Downgrade 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 auf 13.1 xx.xx und höher aktualisieren.

• Sichern Sie den NetScaler ADM-Server, bevor Sie ein Upgrade durchführen.

• Nach dem Upgrade müssen Sie möglicherweise die Verbindungen zwischen dem NetScaler ADM-Server und den verwalteten Instanzen wiederherstellen. Eine Bestätigungsaufforderung warnt Sie, dass die Verbindung fehlschlagen kann, wenn Sie fortfahren.

• Wenn Sie auf eine Version zwischen 13.1.9.x und 13.1.30.x aktualisieren, setzt NetScaler ADM die vorhandenen StyleBooks ConfigPacks auf die frühere Version zurück.

  Um dieses Problem zu vermeiden, führen Sie ein Upgrade auf Build 13.1.33.50 durch.

• Nehmen Sie bei NetScaler ADM-Servern in Hochverfügbarkeitskonfigurationen beim Upgrade keine Konfigurationsänderungen an den Knoten vor.

  Warnung

  Aktualisieren Sie den Browser nicht, bis der Upgrade-Vorgang erfolgreich abgeschlossen ist. Überprüfen Sie die GUI auf die ungefähre Zeit, die für die Fertigstellung des Upgrades benötigt wird.

• Nach dem Upgrade kann der aktive Knoten in ein Hochverfügbarkeitspaar geändert werden.

Aktualisieren Sie einen einzelnen NetScaler ADM-Server auf 13.1-12.x

1. Melden Sie sich mit Administratoranmeldeinformationen bei NetScaler ADM an.

2. Navigieren Sie zu Einstellungen > Verwaltung. Klicken Sie unter Systemwartungauf NetScaler ADM aktualisieren.

   

3. Aktivieren Sie auf der Seite NetScaler ADM aktualisieren das Kontrollkästchen Software-Image nach erfolgreichem Upgrade bereinigen , um die Image-Dateien nach dem Upgrade zu löschen. Wenn Sie diese Option auswählen, werden die NetScaler ADM-Imagedateien beim Upgrade automatisch entfernt.

   Notiz

   Diese Option ist standardmäßig ausgewählt. Wenn Sie dieses Kontrollkästchen vor dem Starten des Upgrade-Vorgangs nicht aktivieren, müssen Sie die Bilder manuell löschen.

   

4. Sie können dann eine neue Bilddatei hochladen, indem Sie entweder Lokal (Ihren lokalen Computer) oder Gerätauswählen. Die Build-Datei muss auf der virtuellen NetScaler ADM-Appliance vorhanden sein.

5. Klicken Sie auf OK.

6. Auf der Seite „ Upgrade ADM “ werden einige Details angezeigt, z. B. Dateiname, ausgewählte Version und geschätzte Zeit bis zur Fertigstellung. Klicken Sie auf Upgrade.

   

   Der Upgrade-Prozess beginnt.

Nachdem Ihre Konfiguration migriert wurde, können Sie sich bei der ADM-GUI anmelden. Nach der Anmeldung beginnt die Migration der historischen Daten im Hintergrund, während Sie weiterhin an ADM arbeiten können.

Während der Migration historischer Daten sind einige der alten Daten möglicherweise nicht verfügbar. Die für die Migration Ihrer Datenbank benötigte Zeit hängt von der Datengröße und der Anzahl der Tabellen ab.

Sie können die Datenbankmigration mithilfe der ADM-GUI überwachen. Klicken Sie auf Upgrade-Fortschritt anzeigen und der Datenbankmigrationsstatus wird angezeigt.

Nach Abschluss des Upgrades können Sie die Meldung sehen, dass die standardmäßigen kostenlosen Lizenzen auf zwei reduziert werden. Klicken Sie auf Details anzeigen , um weitere Informationen zu erhalten.

Aktualisieren Sie einen einzelnen NetScaler ADM-Server auf 13.1-4.x oder 13.1-9.x

1. Melden Sie sich mit Administratoranmeldeinformationen bei NetScaler ADM an.

2. Navigieren Sie zu System > Systemadministration. Klicken Sie unter der Unterüberschrift Systemadministration auf Upgrade NetScaler ADM.

   

3. Aktivieren Sie auf der Seite NetScaler ADM aktualisieren das Kontrollkästchen Software-Image nach erfolgreichem Upgrade bereinigen , um die Image-Dateien nach dem Upgrade zu löschen. Wenn Sie diese Option auswählen, werden die NetScaler ADM-Imagedateien beim Upgrade automatisch entfernt.

   Notiz

   Diese Option ist standardmäßig ausgewählt. Wenn Sie dieses Kontrollkästchen vor dem Starten des Upgrade-Vorgangs nicht aktivieren, müssen Sie die Bilder manuell löschen.

   

4. Sie können dann eine neue Bilddatei hochladen, indem Sie entweder Lokal (Ihren lokalen Computer) oder Gerätauswählen. Die Build-Datei muss auf der virtuellen NetScaler ADM-Appliance vorhanden sein.

   

5. Klicken Sie auf OK. Das Dialogfeld „Bestätigen“ wird angezeigt. Klicken Sie auf Ja.

   Der Upgrade-Prozess beginnt.

Nachdem Ihre Konfiguration migriert wurde, können Sie sich bei der ADM-GUI anmelden. Nach der Anmeldung beginnt die Migration der historischen Daten im Hintergrund, während Sie weiterhin an ADM arbeiten können.

Während der Migration historischer Daten sind einige der alten Daten möglicherweise nicht verfügbar. Die für die Migration Ihrer Datenbank benötigte Zeit hängt von der Datengröße und der Anzahl der Tabellen ab.

Sie können die Datenbankmigration mithilfe der ADM-GUI überwachen. Klicken Sie auf Upgrade-Fortschritt anzeigen und der Datenbankmigrationsstatus wird angezeigt.

Beheben von Problemen bei der Datenbankmigration

Während des Upgrade-Prozesses auf 13.1 xx.xx und höher kann es manchmal vorkommen, dass die Migration der historischen Web Insight-Daten hängen bleibt. Um in solchen Fällen die 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 eine Beispielausgabe

    bash-3.2# cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
    Dienstag, 6. Oktober 2020, 07:41:55 GMT
    157 von 127346 erledigt in 54 Sekunden
    Datei
     /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 von 127.346 Einträgen werden in 54 Sekunden migriert.

Aktualisieren Sie ein Hochverfügbarkeitspaar von Version 12.1 auf Version 13.1

Bei NetScaler ADM-Servern im Hochverfügbarkeitsmodus können Sie ein Upgrade durchführen, indem Sie entweder auf den aktiven Knoten oder die Floating-IP-Adresse zugreifen. Beide NetScaler ADM-Server werden automatisch auf die neueste Version aktualisiert, sobald Sie den Aktualisierungsprozess auf einem der Server starten.

Aktualisieren Sie die NetScaler ADM-Disaster-Recovery-Bereitstellung

Das Upgrade der NetScaler ADM-Notfallwiederherstellungsbereitstellung erfolgt in zwei Schritten:

• Aktualisieren Sie die im Hochverfügbarkeitsmodus konfigurierten NetScaler ADM-Knoten am primären Standort. Später müssen Sie den Disaster Recovery-Knoten 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 Sie den NetScaler ADM-Notfallwiederherstellungsknoten

1. Laden Sie die NetScaler ADM-Upgrade-Imagedatei von der NetScaler-Site herunter.

2. Laden Sie diese Datei mit den Anmeldeinformationen nsrecover auf den Notfallwiederherstellungsknoten hoch.

3. Melden Sie sich mit den Anmeldeinformationen nsrecover beim Notfallwiederherstellungsknoten an.

4. Navigieren Sie zu dem Ordner, in dem Sie die Bilddatei abgelegt haben, und entpacken Sie die Datei.

5. Führen Sie das folgende Skript aus:

   ./installmas

   

Aktualisieren Sie lokale Agenten für die Bereitstellung an mehreren Standorten

Das Upgrade der NetScaler-Agent-Bereitstellung erfolgt in drei Schritten. Stellen Sie sicher, dass Sie die folgenden Aufgaben abgeschlossen haben, bevor Sie die lokalen Agenten aktualisieren:

1. Aktualisieren Sie die NetScaler ADM-Server, die mit hoher Verfügbarkeit bereitgestellt werden.

2. Aktualisieren Sie den NetScaler ADM-Notfallwiederherstellungsknoten.

   Weitere Informationen finden Sie unter Upgrade der NetScaler ADM-Notfallwiederherstellungsbereitstellung.

Aktualisieren Sie den lokalen Agenten

1. Laden Sie die Image-Datei für das NetScaler-Agent-Upgrade von der NetScaler-Site herunter.

2. Laden Sie diese Datei mit den Anmeldeinformationen nsrecover auf den Agentenknoten hoch.

3. Stellen Sie sicher, dass Sie das richtige Agent-Upgrade-Image herunterladen.

4. Melden Sie sich mit den Anmeldeinformationen nsrecover beim lokalen Agenten an.

5. Navigieren Sie zu dem Ordner, in dem Sie die Bilddatei abgelegt haben, und entpacken Sie die Datei.

   

6. Führen Sie das folgende Skript aus:

   ./installmasagent

   

Fügen Sie dem NetScaler ADM-Server eine zusätzliche Festplatte hinzu

Wenn Ihr NetScaler ADM-Speicherbedarf den Standardspeicherplatz (120 GB) überschreitet, können Sie eine zusätzliche Festplatte anschließen. Sie können sowohl bei Einzelserver- als auch bei Hochverfügbarkeitsbereitstellungen mehr Festplatten anschließen.

Wenn Sie NetScaler ADM von der Release-Version 12.1–13.1Œ aktualisieren, bleiben die Partitionen, die Sie in der früheren Version auf der zusätzlichen Festplatte erstellt haben, unverändert. Die Partitionen werden weder entfernt noch in der Größe geändert.

Das Verfahren zum Anschließen weiterer Festplatten bleibt im aktualisierten Build gleich. Sie können jetzt das neue Festplattenpartitionierungstool in NetScaler ADM verwenden, um Partitionen auf der neu hinzugefügten Festplatte zu erstellen. Sie können das Tool auch verwenden, um die Größe der Partitionen auf der vorhandenen Festplatte zu ändern. Weitere Informationen zum Anschließen weiterer Festplatten und zur Verwendung des neuen Festplattenpartitionierungstools finden Sie unter So schließen Sie eine zusätzliche Festplatte an NetScaler ADM an.

Bereitstellen von NetScaler-Instanzen in OpenStack mithilfe von StyleBooks

Ab NetScaler ADM 12.1 Build 49.23 wurde die Architektur eines OpenStack-Orchestrierungs-Workflows aktualisiert. Der Workflow verwendet jetzt NetScaler ADM StyleBooks zum Konfigurieren von NetScaler-Instanzen. 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 os-cs-lb-mon StyleBook und dem Migrationsskript finden Sie unter Bereitstellung einer NetScaler VPX-Instanz auf OpenStack mit StyleBook