Citrix Application Delivery Management-Service

Migrieren der Citrix ADC Anwendungskonfiguration mit dem StyleBooks Configuration Builder

Der StyleBooks Configuration Builder wird verwendet, um eine vorhandene ADC-Konfiguration auf StyleBooks zu migrieren. Diese Funktion automatisiert auch die Migration der Anwendungskonfiguration von einer Citrix ADC-Instanz zu einer anderen Instanz oder einer Autoscale-Gruppe.

Der Configuration Builder bietet eine strukturierte Anwendung StyleBook, die für alle Varianten der ADC-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 ADC-Konfiguration für eine neue ADC-Instanz widerspiegelt. Mit diesem Konfigurationspaket kann die anfängliche ADC-Konfiguration von einer ADC-Instanz auf eine andere ADC-Instanz dupliziert werden. Die ursprüngliche Konfigurationsquelle kann eine der folgenden sein:

  • Eine Citrix ADC-Instanz: Geben Sie die Instanz an, in der die zu duplizierende Anwendungskonfiguration gehostet wird.

    Der Configuration Builder konvertiert die ADC-Konfiguration in StyleBook und das Konfigurationspaket, auch wenn Sie die Zielinstanz nicht angeben. Sie können dieses Konfigurationspaket später verwenden, um die ADC-Konfiguration auf andere ADC-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 vonns.conf oder einApplication config.

Der Configuration Builder identifiziert die Liste der verschiedenen Anwendungen, die in die Quellkonfiguration eingebettet sind. Wenn Sie die von Ihnen gewünschte Anwendungskonfiguration 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 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, starten Sie mit der Migration oder Duplizierung der Anwendungskonfiguration auf einer ADC-Zielinstanz.

Workflow für StyleBooks Configuration Builder

Nach der Erstellung und Migration von Anwendungen wird ein Konfigurationspaket in Citrix ADM mit adc_nitro_application StyleBook erstellt. Dieses StyleBook wird basierend auf den ADC NITRO-Ressourcen erstellt. Dieses Konfigurationspaket stellt die Anwendungskonfiguration auf der ADC-Zielinstanz dar. Um das erstellte Konfigurationspaket anzuzeigen, navigieren Sie zu Anwendungen > StyleBooks > Configurations.

Unterstützte Citrix ADC Funktionen

Der StyleBook Configuration Builder erkennt und unterstützt die folgenden Citrix ADC Features in der Quellkonfiguration:

  • Content Switching
  • Lastausgleich
  • Überwachen
  • SSL-Offload
  • Ratenbegrenzung
  • Neuschreiben
  • Responder
  • Webanwendungs-Firewall (WAF)

Erstellen eines StyleBook zum Migrieren der Citrix ADC Anwendungskonfiguration

Das folgende Verfahren besteht darin, ein StyleBook zu erstellen, das die Citrix ADC Anwendungsmigration in Citrix ADM migriert:

  1. Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.

  2. Klicken Sie auf ADC-Konfiguration migrieren.

  3. Klicken Sie auf Erste Schritte.

  4. Wählen Sie unter Konfiguration angebendie Konfigurationsquelle aus:

    • Import aus einem ADC: Mit dieser Option werden die aktiven Anwendungen auf der ausgewählten ADC-Instanz ermittelt.

    • Import über CLI-Befehle: Diese Option analysiert die CLI-Befehle und extrahiert die Anwendungen aus den CLI-Befehlen.

  5. Geben Sie die Quell-ADC-Instanz 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
  6. Geben Sie die Ziel-ADC-Instanz 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.

  7. In Anwendung definieren,

    1. 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 ADM-Lösung für die automatische Skalierung 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, ist appder Domänenname und example.comder Zonenname.

    2. Wählen Sie die virtuellen Server aus, die Sie migrieren möchten.

      Wählen Sie virtuelle Server aus, die Sie migrieren möchten

    3. Klicken Sie auf Weiter.

  8. Ü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.

  9. 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 das Bearbeitungssymbol des virtuellen Servers, Dienstes oder Dienstgruppenmitglieds.

    Bearbeiten der Bereitstellungsattribute

    Hinweis

    Wenn es sich bei der Zielinstanz um eine Autoscale-Gruppe handelt, ist die Bearbeitung der Front-End-IP-Adresse deaktiviert.

    Diese Registerkarte wird nur in den folgenden Fällen angezeigt:

    • Die Quell- und Zielinstanzen unterscheiden sich.

    • Importieren Sie Konfigurationen mit CLI-Befehlen.

  10. 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 verpassten 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 die Zielinstanz anwenden. Klicken Sie auf Weiter.

  11. 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 und responderhtmlpagesdie Zielinstanz vor der Migration konfigurieren.

  • Wenn die Quelle eine Konfiguration für die Bindung servicegroupund Überwachung 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" }]
    

    Dieser Fehler tritt auf, weil Citrix ADC die Bindung zwischen Dienstgruppe und Monitor in einem ungültigen Format speichert. Dieses Problem wurde von Citrix ADC 12.1.52.15 Build behoben.

Migrieren der Citrix ADC Anwendungskonfiguration mit dem StyleBooks Configuration Builder