Migrieren der NetScaler Anwendungskonfiguration mit dem StyleBooks Configuration Builder
Der StyleBooks Configuration Builder wird verwendet, um eine Anwendungskonfiguration StyleBook aus einer vorhandenen NetScaler-Konfiguration zu erstellen. Diese Funktion automatisiert auch die Migration der Anwendungskonfiguration von einer NetScaler-Instanz zu einer anderen Instanz.
Mit Configuration Builder können Sie den Prozess der Erstellung eines benutzerdefinierten StyleBook optimieren und es so einfach machen, auch wenn Ihnen ein tiefes Verständnis der StyleBook-Grammatik und der StyleBook-Konstrukte fehlt. Andernfalls sind Kenntnisse der StyleBook-Grammatik und der StyleBook-Konstrukte erforderlich, um ein StyleBook zu erstellen.
Der Configuration Builder erstellt auch ein Konfigurationspaket, in dem die Konfiguration von einer NetScaler-Instanz auf eine andere NetScaler-Instanz dupliziert werden kann. Die ursprüngliche Konfigurationsquelle kann eine der folgenden sein:
-
Eine NetScaler-Instanz: Geben Sie die Instanz an, in der die Anwendungskonfiguration, die Sie duplizieren möchten, verfügbar ist.
Der Configuration Builder konvertiert die NetScaler-Konfiguration in ein StyleBook und ein Config Pack, auch wenn Sie die Zielinstanz nicht angeben. Sie können dieses Config Pack später verwenden, um die NetScaler-Konfiguration auf andere NetScaler-Instanzen zu migrieren.
-
Eine Reihe von CLI-Befehlen: Fügen Sie die Konfiguration von
ns.confoder einApplication config. -
Konfigurationsdatei hochladen: Laden Sie eine Konfiguration von Ihrem lokalen Computer hoch.
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.
-
Informationen zur Anwendungsbereitstellung — Sie können die IP-Adresse und den Port der virtuellen Server, Dienste und Dienstgruppenmitglieder aus der ursprünglichen Konfiguration anzeigen und bearbeiten. Sie können auch den Status und den ARP eines virtuellen Servers anzeigen und bearbeiten.
-
Konfigurationsattribute — Bei diesen Attributen kann es sich um Kennwörter oder Zertifikate handeln, die in der Quellkonfiguration angegeben sind.
Nachdem Sie die erforderlichen Informationen angegeben haben, beginnen Sie mit der Migration oder Duplizierung der Anwendungskonfiguration auf einer NetScaler-Zielinstanz.
Nachdem Sie die Anwendungserstellung und -migration abgeschlossen haben, wird in NetScaler ADM ein Konfigurationspaket zusammen mit dem entsprechenden StyleBook erstellt. Dieses Config Pack stellt die Anwendungskonfiguration auf der NetScaler-Zielinstanz dar. Um das erstellte Konfigurationspaket 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:
- Analytics
- AppFlow
- Quality of Experience-Konfiguration auf Anwendungsebene (AppQOE)
- Authentifizierung und Autorisierung
- Prüfung
- Bot-Verwaltung
- Cache-Umleitung
- Content Switching
- DNS
- Frontend-Optimierung
- HTTP-Komprimierung
- Integriertes Caching
- Lastausgleich
- Überwachen
- QUIC-Protokoll
- Ratenbegrenzung
- Responder
- Rewrite
- SSL Offloading
- Überlauf
- Verkehrs-Management
- URL-Transformation
- Firewall für Webanwendungen (WAF)
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 ADM migriert:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs .
-
Klicken Sie auf NetScaler-Konfiguration migrieren.
-
Klicken Sie auf Erste Schritte.
-
Wählen Sie unter Konfiguration angebeneine der folgenden Konfigurationsquellen aus:
-
Aus einem NetScaler importieren:
- NetScaler-Quellinstanz — Wählen Sie eine NetScaler-Instanz aus, von der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten. Klicken Sie auf OK.
-
Mit CLI-Befehlen importieren — Fügen Sie die Konfiguration aus einer Konfigurationsdatei ein.
-
Konfigurationsdatei hochladen — Klicken Sie auf Durchsuchen, um eine Konfigurationsdatei von Ihrem lokalen Computer auszuwählen.
Zielinstanz — Wählen Sie entweder eine NetScaler-Instanz oder eine Autoscale-Gruppe aus, zu der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten. Klicken Sie auf OK.
Klicken Sie auf Weiter.
-
-
In der erweiterten Richtlinienkonfigurationergeben sich je nach Konfiguration die folgenden Szenarien:
- Alle vorhandenen klassischen Richtlinien in der Konfiguration werden erfolgreich und ohne Fehler in erweiterte Richtlinien konvertiert. Überprüfen Sie die aktualisierte Konfiguration und wählen Sie die Bestätigung aus. Klicken Sie auf Weiter.
- Alle vorhandenen klassischen Richtlinien in der Konfiguration werden erfolgreich mit Fehlern in erweiterte Richtlinien konvertiert. Überprüfen und beheben Sie die Fehler. Klicken Sie auf Zurück.
- Wenn es keine klassischen Richtlinien gibt, wird die Konfiguration nicht aktualisiert. Klicken Sie auf OK, um fortzufahren.
-
In Anwendung definieren,
-
Geben Sie unter Anwendungsnameden Namen der Anwendung an.
-
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.
-
In den Informationen zur Anwendungsbereitstellungkönnen Sie die IP-Adresse, den Port, den Status und den ARP der virtuellen Server, Dienste und Dienstgruppenmitglieder anzeigen und bearbeiten.
Auf der Detailseite können Sie die IP-Adresse, den Port, den Status und den ARP-Status der NSIP-Entität bearbeiten.
Hinweis:
- Der Status der NSIP-Entität für die virtuelle Server-IP bestimmt den Anfangsstatus des ARP.
- Wenn die NSIP-Entität für die virtuelle Server-IP bereits auf dem Ziel-NetScaler konfiguriert ist, können Sie den ARP-Status des virtuellen Servers nicht ändern.
- Wenn Sie den ARP-Status für einen virtuellen Server ändern, wird der ARP-Status für alle virtuellen Server mit derselben IP-Adresse geändert. Das Ändern des Status des virtuellen Servers wirkt sich nur auf den zugehörigen virtuellen Server aus.
- ARP gilt nicht für virtuelle Server, die auf IP-Mustern basieren.
- Wenn der NSIP-Status für die virtuelle Server-IP in der Quellkonfiguration deaktiviert ist, wird ARP ebenfalls automatisch deaktiviert, und Sie können ARP nicht ändern.
Die Registerkarte Informationen zur Anwendungsbereitstellung wird nicht angezeigt, wenn Quell- und Zielinstanz identisch sind.
-
Unter Informationen zur Bereitstellung der Authentifizierungkönnen Sie die Attribute der Authentifizierungsserver anzeigen und bearbeiten, sofern verfügbar. Klicken Sie auf das Bearbeitungssymbol, um die IP-Adresse, die Server-IP, den Servernamen und die Portnummer der Server zu bearbeiten.
-
Laden Sie in Resource Files/Secretsdie Zertifikate und Schlüssel hoch, um Passwörter und Zertifikate zu entschlüsseln. Klicken Sie auf Weiter.
-
Sehen Sie sich unter Globale Konfigurationdie Unterschiede in den globalen Konfigurationseinstellungen zwischen Quelle und Ziel an. Überprüfen Sie die Konfiguration, die auf das Ziel angewendet werden soll, und wählen Sie die Bestätigung aus. Klicken Sie auf Weiter.
-
Sehen Sie sich in Migratedie StyleBook-Details an. Klicken Sie auf Migrate.
Hinweis:
Standardmäßig verwaltet NetScaler ADM das Config Pack, das bei der Migration von Anwendungen oder virtuellen Servern zu NetScaler erstellt wird. Deaktivieren Sie das Kontrollkästchen Konfiguration über ADM verwalten, wenn Sie der resultierenden Konfiguration kein Confipack zuordnen möchten.
-
Sehen Sie sich unter Nicht unterstützte Konfigurationalle verpassten oder nicht unterstützten Konfigurationen an. Um diese Konfigurationen erfolgreich zu migrieren, müssen Sie die fehlenden oder nicht unterstützten Konfigurationen separat auf die Zielinstanz anwenden. Klicken Sie auf Weiter.
Einschränkungen
-
Die benannten Ausdrücke und die in der Quellinstanz erwähnten
responderhtmlpageswerden 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.