Migrieren der NetScaler Anwendungskonfiguration mit dem StyleBooks Configuration Builder
Der StyleBooks Configuration Builder wird verwendet, um eine vorhandene NetScaler-Konfiguration zu StyleBooks zu migrieren. Diese Funktion automatisiert auch die Migration der Anwendungskonfiguration von einer NetScaler-Instanz zu einer anderen Instanz oder einer Autoscale-Gruppe.
Der Configuration Builder bietet ein strukturiertes Anwendungs-StyleBook, das für alle Varianten der NetScaler-Konfiguration verwendet werden kann. Diese Funktion hilft Ihnen, mit StyleBooks zu beginnen, ohne umfassende Kenntnisse der StyleBooks-Grammatik und -Konstrukte zu haben. Andernfalls ist das Wissen über StyleBooks Grammatik und Konstrukte notwendig, um ein StyleBook zu erstellen.
Der Configuration Builder erstellt auch ein Konfigurationspaket, das dieselbe NetScaler-Konfiguration auf einer neuen NetScaler-Instanz widerspiegelt. Mit diesem Konfigurationspaket kann die anfängliche NetScaler-Konfiguration von einer NetScaler-Instanz auf eine andere NetScaler-Instanz dupliziert werden. Die ursprüngliche Konfigurationsquelle kann eine der folgenden sein:
-
Eine NetScaler-Instanz: Geben Sie die Instanz an, in der die zu duplizierende Anwendungskonfiguration gehostet wird.
Der Configuration Builder konvertiert die NetScaler-Konfiguration in StyleBook und Configuration Pack, auch wenn Sie die Zielinstanz nicht angeben. Sie können dieses Konfigurationspaket später verwenden, um die NetScaler-Konfiguration auf andere NetScaler-Instanzen zu migrieren.
Wenn es sich bei der Zielinstanz um eine Autoscale-Gruppe handelt, wird das Konfigurationspaket auf der Seite Netzwerk > AutoScale-Gruppe angezeigt. Auf der Registerkarte “ Konfiguration “.
-
Eine Reihe von CLI-Befehlen: Fügen Sie die Konfiguration von
ns.confoder einApplication config.
Der Configuration Builder identifiziert die Liste der unterschiedlichen Anwendungen, die in die Quellkonfiguration eingebettet sind. Wenn Sie die gewünschte Anwendungskonfiguration auswählen, extrahiert der Configuration Builder die CLI-Befehle für die ausgewählte Anwendung. Diese CLI-Befehle werden aus der Quellkonfiguration extrahiert. Außerdem werden die Bereitstellungs- und Konfigurationsattribute identifiziert, die möglicherweise Ihre Eingabe erfordern.
-
IP-Adresse/Ports - Sie können die IP-Adresse und den Port der virtuellen Server, Dienste und Servicegruppenmitglieder von der ursprünglichen Konfiguration aus anzeigen und bearbeiten.
-
Konfigurationsdateien/Secrets - Bei diesen Attributen können in der Quellkonfiguration angegebene Kennwörter oder Zertifikate sein.
Nachdem Sie die erforderlichen Informationen angegeben haben, beginnen Sie mit der Migration oder Duplizierung der Anwendungskonfiguration auf einer NetScaler-Zielinstanz.
Nach der Anwendungserstellung und -migration wird in NetScaler Console mithilfe adc_nitro_applicationvon StyleBook ein Konfigurationspaket erstellt. Dieses StyleBook wird basierend auf den NetScaler NITRO-Ressourcen erstellt. Dieses Konfigurationspaket stellt die Anwendungskonfiguration auf der NetScaler-Zielinstanz dar. Um das erstellte Konfigurationspaket anzuzeigen, navigieren Sie zu Anwendungen > Konfiguration > Confg Packs.
Unterstützte NetScaler Funktionen
Der StyleBook Configuration Builder erkennt und unterstützt die folgenden NetScaler-Funktionen in der Quellkonfiguration:
- Content Switching
- Lastausgleich
- Überwachen
- SSL Offloading
- Ratenlimit
- Rewrite
- Responder
- Firewall für Webanwendungen (WAF)
- Bot-Verwaltung
- Steuerung der Kompression
Erstellen Sie ein StyleBook, um die NetScaler-Anwendungskonfiguration zu migrieren
Das folgende Verfahren besteht darin, ein StyleBook zu erstellen, das die NetScaler-Anwendungsmigration in NetScaler Console migriert:
-
Navigieren Sie zu Anwendungen > Konfiguration > Confg Packs.
-
Klicken Sie auf NetScaler-Konfiguration migrieren.
-
Klicken Sie auf Erste Schritte.
-
Wählen Sie unter Konfiguration angebendie Konfigurationsquelle aus:
-
Aus einem NetScalerimportieren : Mit dieser Option werden die aktiven Anwendungen auf der ausgewählten NetScaler-Instanz ermittelt.
-
Import mit CLI-Befehlen: Diese Option analysiert die CLI-Befehle und extrahiert die Anwendungen aus den CLI-Befehlen.
-
-
Geben Sie die NetScaler-Quellinstanz an, von der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten.**
Um die Anwendungskonfiguration auf eine Autoscale-Gruppe zu migrieren, stellen Sie sicher, dass die folgenden Informationen nicht in der Quellkonfiguration enthalten sind:
IPset- Geräte-Profil
- Protokoll
- Port
-
Geben Sie die NetScaler-Zielinstanz an, zu der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten.**
Um eine Anwendungskonfiguration auf eine Autoscale-Gruppe zu migrieren, wählen Sie die Autoscale-Gruppe aus der Liste aus.
-
In Anwendung definieren,
-
Geben Sie unter Anwendungsnameden Namen der Anwendung an.
Wenn es sich bei der Zielinstanz um eine Autoscale-Gruppe handelt, geben Sie die folgenden Autoscale-Parameter an:
-
Zugriffstyp— Sie können die Autoscaling-Lösung von NetScaler Console sowohl für externe als auch für interne Anwendungen verwenden. Wählen Sie den erforderlichen Anwendungszugriffstyp aus.
-
Domänenname - Geben Sie den Domänennamen einer Anwendung an. Diese Option ist nur anwendbar, wenn Sie Benutzerdefinierter FQDN-Typ auswählen.
-
Zone der Domäne - Wählen Sie den Zonennamen einer Anwendung aus der Liste aus. Diese Option ist nur anwendbar, wenn Sie Benutzerdefinierter FQDN-Typ auswählen.
Dieser Domänen- und Zonenname leitet zu den virtuellen Servern in Azure um. Wenn Sie beispielsweise eine Anwendung in
app.example.comhosten, istappder Domänenname undexample.comder Zonenname.
-
-
Wählen Sie die virtuellen Server aus, die Sie migrieren möchten.
-
Klicken Sie auf Weiter.
-
-
Überprüfen Sie unter Äquivalente CLI-Befehledie Befehle und klicken Sie auf Weiter.
Diese Befehle sind spezifisch für die ausgewählte Anwendungskonfiguration.
Hinweis:
Sie können die Konfiguration bei Bedarf auch hinzufügen oder bearbeiten.
-
In Bereitstellungsattributekö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 dem virtuellen Server, Dienst oder Dienstgruppenmitglied auf das Bearbeitungssymbol.
Hinweis:
Wenn die Zielinstanz eine Autoscale-Gruppe ist, ist die Bearbeitung der Front-End-IP-Adresse deaktiviert.
Diese Registerkarte wird nur in den folgenden Fällen angezeigt:
-
Die Quell- und Zielinstanzen sind unterschiedlich.
-
Importieren Sie Konfigurationen mit CLI-Befehlen.
-
-
Geben Sie unter Konfigurationsattributedie erforderlichen Details an und klicken Sie auf Weiter.
Auf dieser Registerkarte werden die Geheimnisse wie Schlüssel zum Entschlüsseln von Kennwörtern und Zertifikaten aufgeführt.
Hinweis:
Bevor Sie mit der Migration beginnen, werden die fehlenden oder nicht unterstützten Konfigurationen auf einer der folgenden Registerkarten angezeigt:
-
Nicht unterstützte Konfigurationen
-
Nicht unterstützte globale Konfigurationen
Um diese Konfigurationen erfolgreich zu migrieren, müssen Sie die fehlenden oder nicht unterstützten Konfigurationen separat auf der Zielinstanz anwenden. Klicken Sie auf Weiter.
-
-
Klicken Sie in Migrateauf Migrate.
Einschränkungen
-
Die benannten Ausdrücke, die in der Quellinstanz
responderhtmlpageserwähnt werden, werden 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 eine Monitorbindung wie folgt hat:bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>Der folgende Fehler wird 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 wurde von NetScaler 12.1.52.15 Build behoben.