Aufträge zum Upgrade von NetScaler-Instanzen verwenden

Sie können NetScaler Console verwenden, um eine oder mehrere NetScaler-Instanzen 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 Datenträgerauslastung — 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-Job und führen Sie ihn sofort auf einem der Knoten aus oder planen Sie ihn später.

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 sind 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 die NetScaler Console eine Validierung vor dem Upgrade nur für die angegebene Instanz durch. Überprüfen und beheben Sie vor dem Upgrade die Probleme mit Anpassungen, Datenträgerauslastung und Hardwareproblemen auf den Clusterknoten.

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

Hinweis

Ein 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 der NetScaler Console zu Infrastruktur > Upgrade-Jobs . Klicken Sie auf die Schaltfläche Job erstellen.

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

   

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’).

   

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

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

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

   

   

   • Ü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 Console Agent gespeichert und befinden sich in /var/mps/adcimages. 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 Console löscht die zwischengespeicherten NetScaler-Images alle drei Tage, basierend auf dem Zeitpunkt der letzten Änderung der Images. Nur die letzten beiden Image-Dateien werden gleichzeitig im NetScaler Console Agent 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.

   

   • Richtlinien-Check: Wenn NetScaler Console nicht unterstützte klassische Richtlinien findet, können Sie diese Richtlinien entfernen, um einen Upgrade-Job zu erstellen.

   Wichtig:

   Wenn Sie eine Cluster-IP-Adresse angeben, führt die NetScaler Console die Validierung vor dem Upgrade nur auf der angegebenen Instanz durch, nicht auf den anderen Clusterknoten.

   Um Diskrepanzen zwischen primären und sekundären Knoten während eines Upgrades anzuzeigen, wählen Sie den Hochverfügbarkeitsknoten aus und klicken Sie auf Details.

   

   

   • Im primären Knoten von HA festgestellte Konfigurationsdiskrepanzen − Zeigt alle Konfigurationen an, die im sekundären Knoten des NetScaler-Hochverfügbarkeitspaars gefunden wurden, aber im primären Knoten fehlen.

   • Im sekundären Knoten von HA festgestellte Konfigurationsdiskrepanzen − Zeigt alle Konfigurationen an, die im primären Knoten des NetScaler-Hochverfügbarkeitspaars gefunden wurden, aber im sekundären Knoten fehlen.

   Hinweis:

   Sie können die folgenden Abweichungen ignorieren, die in den Abschnitten mit den Konfigurationsabweichungen auftreten können:

   • Gerätespezifische Konfigurationen wie IP-Adressen.

   • Verschlüsselte Kennwörter oder Zertifikate, die sich zwischen den Knoten unterscheiden können, auch wenn das Kennwort dasselbe ist.

   Sie können die Abweichungen überprüfen und sich dafür entscheiden, sie zu ignorieren, wenn sie nicht relevant sind.

7. Geben Sie in Validation Scriptsdie Skripts an, die vor und nach einem Instanz-Upgrade ausgeführt werden sollen. Sie haben folgende Wahl:

   • Standard-Validierungsskripten − Wählen Sie diese Option, um die vordefinierten Validierungsskripts auszuführen. Diese Skripts werden sowohl vor als auch nach dem Upgrade-Job ausgeführt und generieren einen Differenzbericht für das Validierungsskript.

     Hinweis:

     Sie können diesen vordefinierten Befehlssatz nicht ändern oder bearbeiten.

   • Benutzerdefinierte Validierungsskripte — Wählen Sie diese Option, um Ihr Validierungsskript auszuführen. Sie können angeben, ob die Skripts vor oder nach dem Upgrade ausgeführt werden sollen. Ein Diff-Bericht wird nur generiert, wenn vor und nach dem Upgrade dieselben Skripts ausgewählt werden.

   Um den Befehlssatz in jeder Konfiguration zu erfahren, klicken Sie auf Details anzeigen.

   

   Geben Sie unter Benutzerdefinierte Validierungsskripts die Skripts an, die vor und nach einem Instanz-Upgrade 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 die Skriptausführung in den erforderlichen Phasen aktiviert ist. Andernfalls werden die angegebenen Skripts nicht ausgeführt.

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

   • Dasselbe Skript wie vor dem Upgrade verwenden: Verwenden Sie dasselbe benutzerdefinierte Skript für Pre-Upgrade, Pre-Failover und Post-Upgrade.
   • 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.

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 Instanz-Upgrade-Datei in einem Dateibrowser aus. Die NetScaler Console-GUI zeigt die Instanzdateien an/var/mps/mps_images, die unter 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.

   

   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 Migrationsfunktion, 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.

   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.

Einen geplanten Upgrade-Job anhalten oder fortsetzen

Sie können Ihren geplanten Upgrade-Job auch unterbrechen.

Um diese Funktion zu verwenden, navigieren Sie zu Infrastruktur > Upgrade-Jobs , wählen Sie einen vorhandenen geplanten Upgrade-Job aus und klicken Sie auf Stopp , um den Job anzuhalten. Um den geplanten Upgrade-Job fortzusetzen, klicken Sie auf Fortsetzen .

Hinweis:

Wenn die geplante Zeit für den Upgrade-Job abgelaufen ist, nachdem Sie beschlossen haben, ihn fortzusetzen, müssen Sie den Upgrade-Job erneut erstellen.

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.

   

2. Geben Sie unter Select Instanzdie 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.

   

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-Datenträgerspeichers.

   • Richtlinien-Check: Wenn NetScaler Console nicht unterstützte klassische Richtlinien findet, können Sie diese Richtlinien entfernen, um einen Upgrade-Job zu erstellen.

   

   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.

   

   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 Console-GUI selbst.

1. Auf der Registerkarte Pre-upgrade validation werden im Abschnitt Instanzen 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.

   Eine Seite mit Datenträgerspeicherdetails wird angezeigt. Auf dieser Seite werden die Instanzen, der verwendete Speicher und der verfügbare Speicher angezeigt.

   

3. Wählen Sie im Bereich Datenträgerspeicherdetails 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.

      

   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 Instanzen 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.

      

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:

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

Sie können einen Differenzbericht eines NetScaler-Upgrade-Jobs herunterladen, wenn benutzerdefinierte Skripts angegeben sind. Ein Diff-Bericht enthält die Unterschiede zwischen den Ausgaben der 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 jeden der folgenden Vergleichsberichte herunterladen:

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