NetScaler-Anwendungskonfiguration mithilfe des StyleBooks Configuration Builder migrieren
Hinweis
Diese Funktion befindet sich in der technischen Vorschauphase.
Der StyleBooks Configuration Builder wird verwendet, um ein Anwendungskonfigurations-StyleBook aus einer bestehenden NetScaler-Konfiguration zu erstellen. Diese Funktion automatisiert auch die Migration der Anwendungskonfiguration von einer NetScaler-Instanz zu einer anderen Instanz.
Mithilfe des Configuration Builders können Sie die Anforderung zur Erstellung eines angepassten StyleBooks vereinfachen. Diese Funktion ermöglicht es Ihnen, ein StyleBook ohne tiefgehende Kenntnisse der StyleBooks-Grammatik und -Konstrukte zu erstellen. Andernfalls sind Kenntnisse der StyleBooks-Grammatik und -Konstrukte für die Erstellung eines StyleBooks erforderlich.
Der Configuration Builder erstellt auch ein ConfigPack, das dieselbe ADC-Konfiguration auf einer neuen ADC-Instanz widerspiegelt. Mit diesem ConfigPack kann die anfängliche ADC-Konfiguration von einer ADC-Instanz auf eine andere ADC-Instanz dupliziert werden. Die anfängliche Konfigurationsquelle kann eine der folgenden sein:
-
Eine NetScaler-Instanz: Geben Sie die Instanz an, auf der die Anwendungskonfiguration gehostet wird, die Sie duplizieren möchten.
Der Configuration Builder konvertiert die ADC-Konfiguration in ein StyleBook und ConfigPack, auch wenn Sie die Zielinstanz nicht angeben. Sie können dieses ConfigPack später verwenden, um die ADC-Konfiguration auf andere ADC-Instanzen zu migrieren.
-
Ein Satz von CLI-Befehlen: Fügen Sie die Konfiguration aus
ns.confoder derApplication configein.
Der Configuration Builder identifiziert die Liste der unterschiedlichen Anwendungen, die in der Quellkonfiguration eingebettet sind. Wenn Sie die Anwendungskonfiguration Ihres Interesses auswählen, extrahiert der Configuration Builder den Satz von CLI-Befehlen für die ausgewählte Anwendung. Diese CLI-Befehle werden aus der Quellkonfiguration extrahiert. Außerdem identifiziert er die Bereitstellungs- und Konfigurationsattribute, die möglicherweise Ihre Eingabe erfordern.
-
Bereitstellungsattribute – Sie können die IP-Adresse und den Port der virtuellen Server, Dienste und Dienstgruppenmitglieder aus der ursprünglichen Konfiguration anzeigen und bearbeiten.
-
Konfigurationsattribute – Diese Attribute können Passwörter oder Zertifikate sein, die in der Quellkonfiguration angegeben sind.
Nachdem Sie die erforderlichen Informationen angegeben haben, beginnen Sie mit der Migration oder Duplizierung der Anwendungskonfiguration auf einer Ziel-ADC-Instanz.
Nachdem Sie die Anwendungserstellung und -migration abgeschlossen haben, wird in NetScaler® ADM ein ConfigPack zusammen mit dem entsprechenden StyleBook erstellt. Dieses ConfigPack repräsentiert die Anwendungskonfiguration auf der Ziel-ADC-Instanz. Um das erstellte ConfigPack anzuzeigen, navigieren Sie zu Applications > StyleBooks > Configurations.
Unterstützte NetScaler-Funktionen
Der StyleBook Configuration Builder erkennt und unterstützt die folgenden NetScaler-Funktionen in der Quellkonfiguration:
- Content Switching
- Load Balancing
- Monitoring
- SSL Offloading
- Rate Limiting
- Rewrite
- Responder
- Web Application Firewall (WAF)
Ein StyleBook zur Migration der NetScaler-Anwendungskonfiguration erstellen
Das folgende Verfahren beschreibt, wie ein StyleBook erstellt wird, das die NetScaler-Anwendungsmigration in NetScaler ADM migriert:
-
Navigieren Sie zu Applications > StyleBooks > Configurations.
-
Klicken Sie auf Migrate ADC Configuration.
-
Klicken Sie auf Get Started.
-
Wählen Sie unter Specify Configuration die Konfigurationsquelle aus:
-
Import from an ADC: Diese Option erkennt die aktiven Anwendungen auf der ausgewählten ADC-Instanz.
-
Import using CLI Commands: Diese Option analysiert die CLI-Befehle und extrahiert die Anwendungen aus den CLI-Befehlen.
-
-
Geben Sie die Source ADC Instance an, von der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten.
-
Geben Sie die Target ADC Instance an, auf die Sie die Anwendungskonfiguration migrieren oder duplizieren möchten.
-
Unter Define Application,
-
Geben Sie unter Application Name den Namen der Anwendung an.
-
Wählen Sie die virtuellen Server aus, die Sie migrieren möchten.
-
Klicken Sie auf Next.
-
-
Überprüfen Sie unter Equivalent CLI Commands die Befehle und klicken Sie auf Next.
Diese Befehle sind spezifisch für die ausgewählte Anwendungskonfiguration.
-
Unter Deployment Attributes können Sie die IP-Adresse und den Port der virtuellen Server, Dienste und Dienstgruppenmitglieder anzeigen und bearbeiten.
Um die IP-Adresse und den Port zu bearbeiten, klicken Sie im Flussdiagramm auf das Bearbeitungssymbol für den virtuellen Server, Dienst oder Dienstgruppenmitglied.
Diese Registerkarte wird nur in den folgenden Fällen angezeigt:
- Die Quell- und Zielinstanzen sind unterschiedlich.
- Konfigurationen werden mithilfe von CLI-Befehlen importiert.
-
Geben Sie unter Configuration Attributes die erforderlichen Details an und klicken Sie auf Next.
Diese Registerkarte listet die Geheimnisse wie Schlüssel zum Entschlüsseln von Passwörtern und Zertifikaten auf.
Hinweis
Bevor Sie die Migration starten, werden die fehlenden oder nicht unterstützten Konfigurationen in einer der folgenden Registerkarten angezeigt:
Unsupported Configurations
Unsupported Global Configurations
Um diese Konfigurationen erfolgreich zu migrieren, müssen Sie die fehlenden oder nicht unterstützten Konfigurationen separat auf der Zielinstanz anwenden. Klicken Sie anschließend auf Next.
-
Geben Sie unter Migrate die erforderlichen StyleBook-Details an. Klicken Sie auf Migrate.
Einschränkungen
-
Die in der Quellinstanz genannten benannten Ausdrücke (
named expressions) undresponderhtmlpageswerden nicht identifiziert. Stellen Sie sicher, dass Sie die benannten Ausdrücke undresponderhtmlpagesauf der Zielinstanz vor der Migration konfigurieren. -
Wenn die Quelle eine Konfiguration für
servicegroupund Monitor-Bindung wie folgt enthält:bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>Wird der folgende Fehler angezeigt:
CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }] <!--NeedCopy-->Dieser Fehler tritt auf, weil NetScaler die Bindung zwischen Dienstgruppe und Monitor in einem ungültigen Format speichert. Dieses Problem ist ab NetScaler Build 12.1.52.15 behoben.