Konfigurationspaket eines StyleBook auf ein anderes StyleBook migrieren

January 23, 2024

Beitrag von:

In NetScaler Application Delivery Management (ADM) sind Konfigurationspakete immer an das StyleBook gebunden, aus dem sie erstellt wurden. Jede Aktualisierung des Konfigurationspakets kann nur über das StyleBook durchgeführt werden, an das das Konfigurationspaket gebunden ist. NetScaler ADM ermöglicht es Ihnen jetzt, ein bestehendes Konfigurationspaket auf ein neues StyleBook zu migrieren. Das neue StyleBook kann eine originellere Version des aktuellen StyleBook sein, das an das Konfigurationspaket gebunden ist. Oder Sie können das Konfigurationspaket auch auf ein völlig anderes StyleBook migrieren.

Sie haben beispielsweise ein StyleBook namens example-lberstellt. Dieses StyleBook wird verwendet, um eine grundlegende Load Balancer-Konfiguration auf einer NetScaler ADC Instanz bereitzustellen. Sie haben ein Konfigurationspaket CP1 aus diesem StyleBook auf einer NetScaler ADC-Instanz erstellt. Später haben Sie erkannt, dass Ihr StyleBook keine Überwachungskonfiguration enthält. Sie haben jetzt ein StyleBook namens example-lb-monerstellt. Dieses StyleBook hat die gleiche Load Balancer-Konfiguration wie example-lb StyleBook, fügt jedoch die Möglichkeit hinzu, Monitore zu konfigurieren.

Jetzt möchten Sie Ihre vorhandene Konfiguration, die im Konfigurationspaket CP1 erstellt wurde, aktualisieren, um einige Monitore hinzuzufügen. Zuvor mussten Sie das Konfigurationspaket CP1 löschen und ein Konfigurationspaket CP2 aus dem neuen StyleBook erstellen, um Ihrer Konfiguration Monitore hinzuzufügen. Das Löschen von CP1 führt dazu, dass alle im Konfigurationspaket CP1 erstellten Konfiguration auf einer oder mehreren NetScaler ADC-Instanzen entfernt wird. Zuvor mussten Sie ein neues Konfigurationspaket über das neue StyleBook neu erstellen, indem Sie Werte für alle Parameter eingeben.

Stattdessen können Sie jetzt das vorhandene Konfigurationspaket CP1 auf das neue Beispiel-lb-mon StyleBook migrieren. Ihr neues StyleBook kann Monitor-Details konfigurieren. Nur diese monitorbezogenen Konfigurationsobjekte werden den NetScaler ADC-Instanzen hinzugefügt, in denen das Konfigurationspaket bereitgestellt wurde. Sie müssen jetzt nur die Monitordetails angeben. Die vorhandene Konfiguration, die auf den nicht geänderten NetScaler ADC Instanzen bereitgestellt wird, bleibt davon unberührt.

Konfigurationspaket migrieren

So migrieren Sie ein mit example-lb StyleBook erstelltes Konfigurationspaket zum Beispiel lb-mon StyleBook

Navigieren Sie in NetScaler ADM zu Anwendungen > Konfigurationen. Auf der Seite “ Konfigurationen “ werden alle im System vorhandenen Konfigurationspakete angezeigt.
Scrollen Sie nach unten, um das Example-lb-Konfigurationspaket zu finden, das Sie zuvor erstellt hätten, und klicken Sie auf Migrate Configpack.
Die Seite Ziel-StyleBook für Migration auswählen wird geöffnet, auf der alle StyleBooks aufgeführt sind, die in Citrix ADM verfügbar sind. Scrollen Sie nach unten, um das StyleBook example-lb-mon zu finden, und klicken Sie auf StyleBook auswählen. Sie können auch nach dem StyleBook suchen, indem Sie example-lb-mon eingeben.

Wenn Sie von einem StyleBook zu einem anderen migrieren, haben möglicherweise nicht alle Parameter in den beiden StyleBooks dieselbe Struktur. Wenn die Parameterstruktur ähnlich ist, werden die vorherigen Werte automatisch in den Parameterfeldern beibehalten. Einige der Parameter im neuen StyleBook sind möglicherweise neu, oder ihre Struktur wurde geändert. In einem solchen Fall müssen Sie die Werte für die StyleBook-Parameter manuell eingeben. Die folgende Abbildung zeigt beispielsweise die Parameter des example-lb StyleBook.

Die folgende Abbildung zeigt die Parameter nach der Migration des Konfigurationspakets auf example-lb-mon StyleBook.

In diesem Fall können Sie sehen, dass die StyleBooks die älteren Werte für die grundlegende Load Balancer-Konfiguration beibehalten. Sie müssen die Werte für die Monitorparameter jedoch manuell eingeben.
Geben Sie Werte für die neuen Parameter ein, die für die Erstellung von Monitoren auf der Instanz verwendet werden.
Klicken Sie unter Zielinstanzen auf die IP-Adresse der Citrix ADC-Instanz, auf der Sie die Konfiguration ausführen möchten, und wählen Sie sie aus. Beachten Sie, dass Sie die Konfiguration auf mehr als einem Citrix ADC bereitstellen können, indem Sie so viele Zielinstanzen wie nötig angeben.
Klicken Sie auf Dry Run. Auf der Seite Objekte werden die Objekte angezeigt, die neu erstellt, geändert oder aus den Citrix ADC-Instanzen entfernt wurden.
Klicken Sie auf Erstellen, um die Konfiguration der ausgewählten Instanzen zu erstellen oder zu aktualisieren. Das Konfigurationspaket wird erstellt, wenn die Zielinstanzen neu sind. Andernfalls werden die vorhandenen Konfigurationen, die auf den Instanzen bereitgestellt werden, aktualisiert.

Hinweis:

Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich erkannte Citrix ADC-Instanzen hinzuzufügen. Diese Instanzen sind also sofort in der Liste der Instanzen in diesem Fenster verfügbar. Das Aktualisierungssymbol ist derzeit nur auf NetScaler ADM verfügbar.

Sie können auch ein Konfigurationspaket von einer Version eines StyleBook auf die nächste Version migrieren. Hier können Sie auch die Werte aller neuen erforderlichen Parameter eingeben, die in der neuen Version vorhanden sind. Sie können das Konfigurationspaket auch auf eine ältere Version des StyleBook migrieren. In diesem Fall werden die zusätzlichen Parameter, die im älteren StyleBook nicht vorhanden sind, entfernt. Auf der Objektseite werden alle Objekte angezeigt, die aus der Konfiguration entfernt wurden.

Nach einer erfolgreichen Migration ist das ConfigPack an das neue StyleBook gebunden.

Lokalisierte Abbildung

Sie können sehen, dass der Name des Konfigurationspakets und die ID des Konfigurationspakets identisch sind wie zuvor. NetScaler ADM aktualisiert jedoch den StyleBook-Namen in example-lb-mon von example-lb.

Erstellen Sie Ihre StyleBooks

Der vollständige Inhalt des StyleBooks example-lb ist unten als Referenz zur Verfügung gestellt:

name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
parameters-default-sources:
  - stlb::lb
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
 

Der vollständige Inhalt des StyleBooks example-lb-mon ist unten für Ihre Referenz zur Verfügung gestellt:

name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
  -
    namespace: netscaler.nitro.config
    prefix: ns
    version: "10.5"
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
  -
    namespace: com.citrix.adc.commontypes
    prefix: cmtypes
    version: "1.0"
parameters-default-sources:
  - stlb::lb
parameters:
  -
    name: monitors
    label: "List of Monitors"
    description: "List of Monitors to monitor Application Servers"
    type: cmtypes::monitor[]
substitutions:
  mon-name(appname, monname): $appname + "-mon-" + $monname
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
  -
    name: monitors-comp
    type: cmtypes::monitor
    condition: $parameters.monitors
    repeat: $parameters.monitors
    repeat-item: mon
    repeat-index: ndx
    description: Builds a list of Citrix ADC monitor objects and binds them to the servicegroup of this LB config
    properties-default-sources:
      - $mon
    properties:
        monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
    components:
      -
        name: monitor-svcg-binding-comp
        condition:  $parameters.svc-servers
        type: ns::servicegroup_lbmonitor_binding
        properties:
          servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
          monitor_name: $parent.properties.monitorname
 

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

Konfigurationspaket eines StyleBook auf ein anderes StyleBook migrieren

January 23, 2024

Beitrag von:

Konfigurationspaket eines StyleBook auf ein anderes StyleBook migrieren

Konfigurationspaket migrieren

So migrieren Sie ein mit example-lb StyleBook erstelltes Konfigurationspaket zum Beispiel lb-mon StyleBook

Erstellen Sie Ihre StyleBooks

In diesem Artikel