ADC

Überlegungen zum Upgrade für Konfigurationen mit klassischen Richtlinien

Klassische Richtlinien sind ab NetScaler Version 12.0 Build 56.20 veraltet. Ab Version 13.1 wird die klassische Richtlinienunterstützung aus einigen Funktionen entfernt. Die vollständige Liste der Funktionen oder Befehle, die in Version 13.1 nicht unterstützt werden, finden Sie in Tabelle 2 in der Ankündigung einer Statusänderung für richtlinienbasierte Features und Funktionen von NetScaler Classic.

Als Voraussetzung für ein Upgrade auf Version 13.1 oder höher empfehlen wir Ihnen, die klassischen Richtlinien in erweiterte Richtlinien für die Funktionen umzuwandeln, die vom NSPEPI-Tool unterstützt werden. Informationen zu den Funktionen, die vom NSPEPI-Tool unterstützt werden, finden Sie unter Befehle oder Funktionen, die vom NSPEPI-Konvertierungstool verwaltet werden. Wenn Sie vor dem Upgrade nicht auf erweiterte Richtlinien umstellen, schlägt das Upgrade aufgrund einer ungültigen Konfiguration fehl.

Wichtig:

Bevor Sie auf Version 13.1 oder höher aktualisieren, empfehlen wir Ihnen, das Tool zur Überprüfung der Vorkonfiguration auszuführen. Dieses Tool stellt sicher, dass Ihre Konfiguration keine Befehle enthält, die sich auf veraltete oder entfernte Funktionen beziehen. Wenn es Befehle gibt, die sich auf die veralteten oder entfernten Funktionen beziehen, gibt das Tool einen Fehler aus und die Konfiguration geht möglicherweise verloren. Wir empfehlen Ihnen, die neueste Version des Tools zur Überprüfung der Voreinstellung über den öffentlichen GitHub-Link herunterzuladen - https://github.com/citrix/ADC-scripts/tree/master/nspepi.

Weitere Informationen finden Sie im Tool zur Überprüfung der Vorkonfiguration vor dem Upgrade.

Wenn bei der Vorkonfigurationsprüfung Fehler auftreten, empfehlen wir Ihnen, das nspepi Tool zu verwenden, um die ungültigen Konfigurationen in gültige Konfigurationen umzuwandeln. Laden Sie die neueste Version des nspepi Tools über den öffentlichen GitHub-Link herunter - https://github.com/citrix/ADC-scripts/tree/master/nspepi. Weitere Informationen zum Konvertieren von Richtlinienausdrücken mit dem nspepi Tool finden Sie unter Konvertieren von Richtlinienausdrücken mit dem NSPEPI-Tool.

Wenn Sie die Konvertierung der klassischen Richtlinien vor dem Upgrade versäumen, können Sie während des Upgrades entscheiden, ob Sie die Konvertierung zu erweiterten Richtlinien durchführen möchten. Im Rahmen des Upgrades können Sie beim Ausführen des Befehls ./installns eine der in der folgenden Tabelle beschriebenen Optionen auswählen.

Option Beschreibung
Keine Option Wenn im Rahmen der Vorkonfigurationsprüfung Fehler auftreten, wird die Installation gestoppt. Sie müssen klassische Richtlinien in erweiterte Richtlinien konvertieren, um mit dem Upgrade-Vorgang fortzufahren.
-M Das NSPEPI-Tool wird als Teil der Installation ausgeführt und konvertiert klassische Richtlinien in erweiterte Richtlinien.
-Y Diese Option wird nicht empfohlen. Bei dieser Option wird die Überprüfung der Voreinstellung übersprungen und daher kann jede gültige Konfiguration verloren gehen.

Um klassische Richtlinien während des Upgrades in erweiterte Richtlinien zu konvertieren, wählen Sie die Option -M aus. Die Option -M löst das NSPEPI-Tool aus und aktualisiert die vorhandene Datei ns.conf mit der geänderten Konfiguration. Die alte Konfiguration ist zur späteren Bezugnahme unter /nsconfig/ns.conf_old verfügbar.

./installns -M`
<!--NeedCopy-->

Wenn Sie bei der erweiterten Richtlinienkonvertierung einen Fehler feststellen, wenden Sie sich an den NetScaler-Support.

Das nspepi Tool übernimmt die Konvertierung einiger Befehle oder Funktionen nicht. Eine vollständige Liste finden Sie unter Befehle oder Funktionen, die nicht vom nspepi-Konvertierungstool verarbeitet werden.

Hinweis:

Wenn Sie klassische Richtlinien haben und diese während des Upgrades in erweiterte Richtlinien konvertieren möchten, können Sie das reguläre Upgrade-Verfahren (HA- oder Cluster- oder Standalone-Setup) verwenden, aber die Option “-M” mit dem Befehl installns verwenden.

Wenn Sie die Konfiguration vor dem Upgrade konvertieren möchten, führen Sie für jede Konfiguration die folgenden Schritte aus:

  1. Führen Sie das Tool nspepiauf Citrix ADC Version 12.1 oder 13.0 aus, um die Datei ns.conf zu konvertieren. Das NSPEPI-Tool generiert zwei Dateien mit Präfixen und. new_warn_ Die Datei mit dem Präfix new_ enthält die konvertierte Konfiguration und die Datei mit dem Präfix warn_ enthält die Warnungen und Fehler.
  2. Überprüfen Sie die Datei mit dem Präfix warn_ und beheben Sie Fehler (falls vorhanden).
  3. Testen Sie die konvertierte Konfiguration. Wenden Sie die konvertierte Konfiguration mit einer der folgenden Optionen an:
    1. Führen Sie den Befehl clear config -f basic aus und beziehen Sie dann die konvertierte Konfiguration, indem Sie den Befehl source /nsconfig/new_ns.conf ausführen.
    2. Entfernen Sie die klassischen Befehle manuell (indem Sie die Bindung aufheben und Richtlinien entfernen) und beziehen Sie dann die konvertierte Konfiguration, indem Sie den Befehl source /nsconfig/new_ns.conf ausführen.

      Hinweis:

      Möglicherweise werden für die Konfigurationen, die nicht mit dem clear config -f basicBefehl gelöscht wurden, die Fehlermeldung “Ressource ist bereits vorhanden ” angezeigt. Sie können diese Fehler ignorieren.

  4. Speichern Sie die Konfiguration.

Nachdem Sie ungültige Konfigurationen erfolgreich in gültige Konfigurationen konvertiert haben, überprüfen Sie, ob weitere Voraussetzungen erfüllt sind, und fahren Sie dann mit dem Upgrade fort. Weitere Informationen finden Sie unter Upgrade und Downgrade einer NetScaler-Appliance.

Überlegungen zum Upgrade für Konfigurationen mit klassischen Richtlinien

In diesem Artikel