Aufträge zum Upgrade von NetScaler-Instanzen verwenden

Sie können NetScaler Application Delivery Management (ADM) verwenden, um eine oder mehrere NetScaler-Instances zu aktualisieren. Sie müssen das Lizenzierungsframework und die Lizenztypen kennen, bevor Sie eine Instanz aktualisieren.

Wenn Sie Ihre NetScaler-Instanz durch Erstellen eines Wartungsauftrags aktualisieren, führen Sie die Vorvalidierungsprüfung für die Instanzen durch, die Sie aktualisieren möchten.

  1. AufAnpassungen prüfen - Sichern Sie Ihre Anpassungen, und löschen Sie sie aus den Instanzen. Sie können die gesicherten Anpassungen nach dem Instanz-Upgrade erneut anwenden.

  2. Überprüfen Sie die Festplattenauslastung — Wenn der /var Ordner weniger als 6 GB Speicherplatz hat und der /flash Ordner weniger als 200 MB Speicherplatz hat, bereinigen Sie den Speicherplatz. Überprüfen Sie die folgenden Ordnerpfade, um den Speicherplatz zu leeren:

    • /var/nstrace
    • /var/log
    • /var/nslog
    • /var/tmp/support
    • /var/core
    • /var/crash
    • /var/nsinstall
    • /var/netscaler/nsbackup
  3. Überprüfen Sie auf Datenträger-Hardwareprobleme - Beheben Sie ggf. die Hardwareprobleme.

Sie können ein NetScaler HA-Paar in zwei Schritten aktualisieren:

  1. Erstellen Sie einen Upgrade-Auftrag und führen Sie sofort auf einem der Knoten aus oder planen Sie später ein.

  2. Planen Sie den Upgrade-Auftrag später auf dem verbleibenden Knoten. Stellen Sie sicher, dass Sie diesen Auftrag nach dem ersten Upgrade des Knotens planen.

Beachten Sie beim Upgrade eines NetScaler HA-Paars Folgendes:

  • Der sekundäre Knoten wird zuerst aktualisiert.

  • Synchronisation und Weitergabe der Knoten werden deaktiviert, bis beide Knoten erfolgreich aktualisiert wurden.

  • Nach dem erfolgreichen HA-Paar-Upgrade erscheint eine Fehlermeldung in der Ausführungshistorie. Diese Meldung wird angezeigt, wenn sich Ihre Knoten im HA-Paar auf unterschiedlichen Builds oder Versionen befinden. Diese Meldung zeigt an, dass die Synchronisierung zwischen primären und sekundären Knoten deaktiviert ist.

Wenn Sie einen NetScaler-Cluster aktualisieren, führt der ADM die Validierung vor dem Upgrade nur für die angegebene Instanz durch. Überprüfen und beheben Sie vor dem Upgrade die Probleme mit Anpassungen, Festplattenauslastung und Hardwareproblemen auf den Clusterknoten.

Erstellen Sie einen Upgrade-Wartungsauftrag, um NetScaler-Instanzen zu aktualisieren

Hinweis

NetScaler-Upgrade von einer höheren Version auf eine niedrigere Version wird nicht unterstützt. Wenn Ihre NetScaler-Instanz beispielsweise 13.0 82.x ist, können Sie die NetScaler-Instanz nicht auf 13.0 79.x oder eine andere frühere Version herunterstufen.

  1. Navigieren Sie in NetScaler ADM zu Infrastruktur > Upgrade-Jobs. Klicken Sie auf die Schaltfläche Job erstellen.

    Wartungsauftrag erstellen

  2. Wählen Sie unter Wartungsaufträge erstellendie Option NetScaler (Standalone/Hochverfügbarkeit/Cluster) aktualisieren aus und klicken Sie auf Fortfahren.

    Wartungsauftrag für das Upgrade auswählen

  3. Geben Sie unter Instanz auswähleneinen Namen Ihrer Wahl für Auftragsname ein.

  4. Klicken Sie auf Instanzen hinzufügen, um NetScaler-Instanzen hinzuzufügen, die Sie aktualisieren möchten.

    • Um ein NetScaler-Hochverfügbarkeitspaar zu aktualisieren, wählen Sie die IP-Adressen des Hochverfügbarkeitspaars aus (gekennzeichnet durch das hochgestellte Zeichen ‘S’ und ‘P’).

    • Um einen Cluster zu aktualisieren, wählen Sie die Cluster-IP-Adresse aus (gekennzeichnet durch das hochgestellte Zeichen von ‘C’).

    Hinzufügen von Instanzen zum Upgrade des Wartungsauftrags

  5. Wählen Sie auf der Registerkarte Select Image ein NetScaler-Image von Ihrem lokalen Laufwerk oder aus den Build-Images aus.

    • Lokal — Wählen Sie die Instanzupgradedatei von Ihrem lokalen Computer

    • Appliance — Wählen Sie die Instance-Upgrade-Datei in einem NetScaler ADM-Dateibrowser aus. Die NetScaler ADM-GUI zeigt die Instanzdateien an, die unter /var/mps/ns_images vorhanden sind.

    Wählen Sie Bilder aus, um den Wartungsauftrag zu aktualisieren

    Wählen Sie Bilder aus, um den Wartungsauftrag zu aktualisieren

    • Überspringen Sie das Hochladen von Bildern auf NetScaler, wenn das ausgewählte Image bereits verfügbar ist — Diese Option überprüft, ob das ausgewählte Image in NetScaler verfügbar ist. Beim Upgrade-Job wird das Hochladen eines neuen Images übersprungen und das in NetScaler verfügbare Image verwendet.

    • Software-Image von NetScaler bei erfolgreichem Upgrade bereinigen — Diese Option löscht das hochgeladene Image in der NetScaler-Instanz nach dem Instanz-Upgrade.

    Klicken Sie auf Weiter, um die Validierung vor dem Upgrade für die ausgewählten Instanzen zu starten.

    Hinweis:

    • Die heruntergeladenen NetScaler-Images werden im NetScaler ADM Agent gespeichert und sind in /var/mps/adcimages vorhanden. Diese zwischengespeicherten Images können für mehrere NetScaler-Upgrades verwendet werden, sodass Sie nicht jedes Mal ein Image für ein Upgrade herunterladen müssen.
    • NetScaler ADM löscht die zwischengespeicherten NetScaler-Images alle drei Tage, basierend auf dem Zeitpunkt der letzten Änderung der Images. Im NetScaler ADM Agent werden jeweils nur die letzten beiden Imagedateien zwischengespeichert.
  6. Auf der Registerkarte Pre-upgrade validation werden die folgenden Abschnitte angezeigt:
    • Instanzen, die für das Upgrade bereit sind. Sie können mit dem Upgrade dieser Instanzen fortfahren.

    • Für das Upgrade blockierte Instanzen. Diese NetScaler-Instanzen sind aufgrund von Validierungsfehlern vor dem Upgrade für das Upgrade gesperrt.

      Sie können die Fehler überprüfen, korrigieren und dann für das Upgrade auf Move to ready for upgrade klicken. Wenn Sie auf einer Instanz nicht genügend Speicherplatz haben, können Sie den Speicherplatz überprüfen und bereinigen. Siehe NetScaler-Speicherplatz bereinigen.

    Validierungsbericht vor dem Upgrade

    • Richtlinienprüfung: Wenn NetScaler ADM nicht unterstützte klassische Richtlinien findet, können Sie diese Richtlinien entfernen, um einen Upgrade-Auftrag zu erstellen.

    Wichtig

    Wenn Sie die Cluster-IP-Adresse angeben, führt ADM die Validierung vor dem Upgrade nur für die angegebene Instanz und nicht auf den anderen Clusterknoten durch.

  7. Optional geben Sie in Custom scriptsdie Scripts an, die vor und nach einem Instanzupgrade ausgeführt werden sollen. Verwenden Sie eine der folgenden Möglichkeiten, um die Befehle auszuführen:

    Die benutzerdefinierten Skripts werden verwendet, um die Änderungen vor und nach einem NetScaler-Instanz-Upgrade zu überprüfen. Beispiel:

    • Die Instanzversion vor und nach dem Upgrade.
    • Der Status von Schnittstellen, Hochverfügbarkeitsknoten, virtuellen Servern und Diensten vor und nach dem Upgrade.
    • Die Statistik der virtuellen Server und Dienste.
    • Die dynamischen Routen.

    Ein Instanz-Upgrade hat mehrere Phasen. Sie können jetzt festlegen, dass diese Skripte in den folgenden Phasen ausgeführt werden:

    • Vor dem Upgrade: Das angegebene Script wird vor dem Upgrade einer Instanz ausgeführt.

    • Vorab-Failover nach dem Upgrade (gilt für HA): Diese Phase gilt nur für die Bereitstellung mit hoher Verfügbarkeit. Das angegebene Skript wird nach dem Upgrade der Knoten, jedoch vor ihrem Failover ausgeführt.

    • Upgrade nach dem Upgrade (gilt für Standalone)/Nach dem Upgrade nach dem Failover (gilt für HA): Das angegebene Skript wird nach dem Upgrade einer Instanz in der eigenständigen Bereitstellung ausgeführt. Bei der Bereitstellung mit hoher Verfügbarkeit wird das Skript nach dem Upgrade der Knoten und ihres Failovers ausgeführt.

    Hinweis Stellen Sie

    sicher, dass Sie die Skriptausführung in den erforderlichen Phasen aktivieren Andernfalls werden die angegebenen Skripts nicht ausgeführt.

    Sie können eine Skriptdatei importieren oder Befehle direkt in die ADM-GUI eingeben.

    • Befehle aus Datei importieren: Wählen Sie die Befehlseingabedatei von Ihrem lokalen Computer aus.
    • Befehle eingeben: Geben Sie die Befehle direkt auf der GUI ein.

    In den Phasen nach dem Upgrade können Sie das gleiche Skript verwenden, das in der Pre-Upgrade-Phase angegeben ist.

    Benutzerdefinierte Skripte

  8. Wählen Sie unter Task planen eine der folgenden Optionen aus:

    • Jetzt upgraden - Der Upgrade-Auftrag wird sofort ausgeführt.

    • Später planen - Wählen Sie diese Option, um diesen Upgrade-Auftrag später auszuführen. Geben Sie das Ausführungsdatum und die Startzeit an, wenn Sie die Instanzen aktualisieren möchten.

      Wenn Sie ein NetScaler HA-Paar in zwei Schritten aktualisieren möchten, wählen Sie Zweistufiges Upgrade für Knoten in HA durchführenaus.

      Geben Sie das Ausführungsdatum und die Startzeit an, zu der Sie eine andere Instanz im HA-Paar aktualisieren möchten.

  9. Geben Sie unter Job erstellen die folgenden Details an:

    1. Wählen Sie eine der folgenden Optionen aus der Liste Software-Image aus:

      • Lokal — Wählen Sie die Instanzupgradedatei von Ihrem lokalen Computer

      • Appliance — Wählen Sie die Instance-Upgrade-Datei in einem ADM-Dateibrowser aus. Die ADM-GUI zeigt die Instanzdateien an /var/mps/mps_images, die vorhanden sind.

    2. Geben Sie an, wann Sie das Image auf eine Instanz hochladen möchten:

      • Jetzt hochladen - Wählen Sie diese Option, um das Image sofort hochzuladen. Der Upgrade-Auftrag wird jedoch zum geplanten Zeitpunkt ausgeführt.

      • Upload zum Zeitpunkt des Ausführens - Wählen Sie diese Option, um das Image hochzuladen, wenn der Upgradeauftrag ausgeführt wird.

      Für ein Hochverfügbarkeitspaar können Sie die Knoten angeben, auf die Sie das Image hochladen möchten:

      • Sowohl auf den primären als auch auf den sekundären Knoten hochladen: Laden Sie die Build-Image-Datei sowohl auf den primären als auch auf den sekundären Knoten hoch.

      • Nur auf den sekundären Knoten hochladen: Laden Sie die Build-Image-Datei nur auf den sekundären Knoten hoch. Nach dem Upgrade des sekundären Knotens erfolgt ein Failover und die Build-Image-Datei wird auf den neuen sekundären Knoten hochgeladen, der zuvor der primäre Knoten war.

    NetScaler Hochverfügbarkeitsupgrade auf Knoten

    Weitere Informationen zu den verfügbaren Planungsszenarien für Hochverfügbarkeitspaare finden Sie unter Planung von Upgrade-Jobs für Hochverfügbarkeitspaare.

    • Software-Image von NetScaler bei erfolgreichem Upgrade bereinigen — Wählen Sie diese Option, um das hochgeladene Image in der NetScaler-Instanz nach dem Instanzupgrade zu löschen.

    • Erstellen Sie ein Backup der NetScaler-Instanzen, bevor Sie das Upgrade starten. - Erstellt ein Backup der ausgewählten NetScaler-Instanzen.

    • Den primären und sekundären Status der HA-Knoten nach dem Upgrade beibehalten: Wählen Sie diese Option, wenn der Upgrade-Job nach dem Upgrade jedes Knotens einen Failover starten soll. Auf diese Weise behält der Upgrade-Job den primären und sekundären Status der Knoten bei.

    • NetScaler-Konfiguration speichern, bevor das Upgrade gestartet wird — Speichert die laufende NetScaler-Konfiguration, bevor die NetScaler-Instanzen aktualisiert werden.

    • Aktivieren Sie ISSU, um Netzwerkausfälle auf dem NetScaler HA-Paar zu vermeiden — ISSU gewährleistet ein Upgrade ohne Ausfallzeiten auf einem NetScaler-Hochverfügbarkeitspaar. Diese Option bietet eine Migrationsfunktionalität, die die vorhandenen Verbindungen während des Upgrades berücksichtigt. So können Sie ein NetScaler HA-Paar ohne Ausfallzeiten aktualisieren. Geben Sie das Timeout der ISSU Migration in Minuten an.

    • Ausführungsbericht per E-Mail empfangen - Sendet den Ausführungsbericht per E-Mail. Informationen zum Hinzufügen einer E-Mail-Verteilerliste finden Sie unter Erstellen einer E-Mail-Verteilerliste.

    • Ausführungsbericht über Pufferzeit empfangen - Sendet den Ausführungsbericht in Pufferzeit. Informationen zum Hinzufügen eines Slack-Profils findest du unter Erstellen eines Slack-Profils.

    Upgrade-Job erstellen und Image auf NetScaler hochladen

  10. Klicken Sie auf Job erstellen.

Der Upgrade-Job wird unter Infrastruktur > Upgrade-Jobsangezeigt. Wenn Sie einen vorhandenen Job bearbeiten, können Sie zu allen Registerkarten wechseln, wenn die erforderlichen Felder bereits ausgefüllt sind. Wenn Sie sich beispielsweise auf der Registerkarte Konfiguration auswählen befinden, können Sie auf die Registerkarte Job-Vorschau wechseln.

Fehlgeschlagene Upgrade-Jobs erneut versuchen

  1. Wählen Sie unter Infrastruktur > Upgrade-Jobsden fehlgeschlagenen Upgrade-Job aus und klicken Sie auf Erneut versuchen. Alternativ können Sie auch zu Aktion auswählen > Upgrade-Job erneut versuchen navigieren, um einen fehlgeschlagenen Job erneut zu versuchen.

    Fehlgeschlagene Jobs erneut versuchen

  2. Geben Sie unter Select Instancedie folgenden Details an:

    • Jobname — Geben Sie einen Namen für das Upgrade ein.

    • Wählen Sie die NetScaler-Instanzen, die Sie aktualisieren möchten, aus der Liste aus. Um alle Instanzen zu löschen, klicken Sie auf Entfernen.

    Klicken Sie auf Weiter, um den Validierungsprozess zu starten.

    Fehlgeschlagene Jobs erneut versuchen

  3. Auf der Registerkarte Pre-upgrade validation werden die folgenden Abschnitte angezeigt:
    • Instanzen, die für das Upgrade bereit sind. Sie können mit dem Upgrade dieser Instanzen fortfahren.

    • Für das Upgrade blockierte Instanzen. Diese NetScaler-Instanzen sind aufgrund von Validierungsfehlern vor dem Upgrade für das Upgrade gesperrt.

      Sie können die Fehler überprüfen, korrigieren und dann für das Upgrade auf Move to ready for upgrade klicken. Wenn Sie auf einer Instanz nicht genügend Speicherplatz haben, können Sie den Speicherplatz überprüfen und bereinigen. Weitere Informationen finden Sie unter Bereinigen des NetScaler-Festplattenspeichers.

    • Richtlinienprüfung: Wenn NetScaler ADM nicht unterstützte klassische Richtlinien findet, können Sie diese Richtlinien entfernen, um einen Upgrade-Auftrag zu erstellen.

    Fehlgeschlagene Jobs erneut versuchen

    Klicken Sie auf Weiter.

  4. Wählen Sie unter Task planen eine der folgenden Optionen aus:

    • Jetzt upgraden: Der Upgrade-Job wird sofort ausgeführt.

    • Später planen: Wählen Sie diese Option, um diesen Upgrade-Auftrag später auszuführen. Geben Sie das Ausführungsdatum und die Startzeit an, wenn Sie die Instanzen aktualisieren möchten.

    Fehlgeschlagene Jobs erneut versuchen

    Klicken Sie auf Wiederholen.

NetScaler-Speicherplatz bereinigen

Wenn beim Upgrade einer NetScaler-Instanz das Problem mit unzureichendem Speicherplatz auftritt, bereinigen Sie den Speicherplatz über die NetScaler ADM-GUI selbst.

  1. Auf der Registerkarte Pre-upgrade validation werden im Abschnitt Instances blocked from upgrade die Instanzen angezeigt, bei denen das Upgrade aufgrund von unzureichendem Speicherplatz fehlgeschlagen ist. Wählen Sie die Instanz aus, bei der das Speicherplatzproblem auftritt.

  2. Klicken Sie auf Speicherplatz überprüfen.

    Ein Bereich mit Speicherplatzdetails wird angezeigt. In diesem Bereich werden die Instanzen, der verwendete Speicher und der verfügbare Speicher angezeigt.

    Angaben zum Speicherplatz

  3. Wählen Sie im Bereich Disk Space Details die Instanz aus, die bereinigt werden muss, und führen Sie einen der folgenden Schritte aus:

    1. Disk Cleanup - Navigieren Sie zu den erforderlichen Ordnern oder Verzeichnissen und löschen Sie sie, um Speicherplatz freizugeben.

    2. Quick Cleanup - Geben Sie schnell Speicherplatz frei, indem Sie mehrere Ordner löschen. Wählen Sie im daraufhin angezeigten Bestätigungsbereich die Ordner aus, die Sie löschen möchten, und klicken Sie auf Ja.

      Quick Cleanup

    3. Nachdem Sie den Speicherplatz freigegeben haben, können Sie überprüfen, ob jetzt ausreichend Speicherplatz für ein Upgrade der Instanz verfügbar ist. Klicken Sie im Abschnitt Instances blocked from upgrade auf Revalidate.

      Im folgenden Beispiel ist Speicherplatz verfügbar. Sie können jetzt auf Move to ready for upgrade klicken, um die Instanz zu aktualisieren, oder auf Weiter klicken, um mit dem nächsten Schritt fortzufahren.

      Validate Cleanup

Planung von Upgrade-Jobs für ein NetScaler Hochverfügbarkeitspaar

In der folgenden Tabelle sind die verschiedenen Planungsszenarien auf der Seite „ Aufgabe planen “ und die entsprechenden Upgrade-Optionen aufgeführt, die auf der Seite „ Job erstellen “ verfügbar sind:

Wann möchten Sie den Upgrade-Job ausführen? Wann möchten Sie das Software-Image auf NetScaler hochladen? Wie möchten Sie das Build-Image auf HA-Knoten hochladen?
Jetzt aufrüsten Nicht zutreffend Sowohl auf den primären als auch auf den sekundären Knoten hochladen (Standardoption)
Später planen Zum Zeitpunkt der Ausführung hochladen (Standardoption) Sowohl auf den primären als auch auf den sekundären Knoten hochladen (Standardoption)
Jetzt hochladen
Später planen (wenn die Option Zweistufiges Upgrade für Knoten in HA durchführen ausgewählt ist) Zum Zeitpunkt der Ausführung hochladen (Standardoption) Nur auf den sekundären Knoten hochladen (Standard und einzige Option)
Jetzt hochladen

Laden Sie einen kombinierten Vergleichsbericht eines NetScaler-Upgrade-Jobs herunter

Sie können einen Diff-Bericht eines NetScaler-Upgrade-Jobs herunterladen, wenn benutzerdefinierte Skripts angegeben sind. Ein Diff-Bericht enthält die Unterschiede zwischen den Ausgaben des Pre-Upgrade- und Post-Upgrade-Skripts. Mit diesem Bericht können Sie feststellen, welche Änderungen an der NetScaler-Instanz nach dem Upgrade vorgenommen wurden.

Hinweis

Der Diff-Bericht wird nur generiert, wenn Sie dasselbe Skript in den Phasen vor dem Upgrade und nach dem Upgrade angeben.

Um einen Diff-Bericht über einen Upgrade-Job herunterzuladen, gehen Sie wie folgt vor:

  1. Navigieren Sie zu Infrastruktur > Konfigurationsaufträge > Wartungsaufträge.

  2. Wählen Sie den Upgrade-Job aus, für den Sie einen Diff-Bericht herunterladen möchten.

  3. Klicken Sie auf Diff-Berichte.

  4. Laden Sie in Diff Reportseinen konsolidierten Diff-Bericht des ausgewählten Upgrade-Jobs herunter.

    Auf dieser Seite können Sie einen der folgenden Arten von Diff-Berichten herunterladen:

    • Vor und nach dem Upgrade vor dem Failover-Diff-Bericht
    • Diff-Bericht vor und nach dem Upgrade

    Laden Sie einen Vergleichsbericht eines NetScaler-Upgrade-Jobs herunter

Aufträge zum Upgrade von NetScaler-Instanzen verwenden