Konfigurationspakete eines StyleBooks zu einem anderen StyleBook migrieren

Last published : Oct 02, 2026
In NetScaler Console sind Konfigurationspakete immer an das StyleBook gebunden, aus dem sie erstellt wurden. Jede Aktualisierung des Konfigurationspakets kann nur über das StyleBook erfolgen, an das das Konfigurationspaket gebunden ist. NetScaler Console ermöglicht Ihnen jetzt, ein vorhandenes Konfigurationspaket zu einem neuen StyleBook zu migrieren. Das neue StyleBook kann eine ursprünglichere Version des aktuellen StyleBooks sein, das an das Konfigurationspaket gebunden ist. Oder Sie können das Konfigurationspaket auch zu einem völlig anderen StyleBook migrieren.
Sie haben beispielsweise ein StyleBook namens example-lb erstellt. Dieses StyleBook wird verwendet, um eine grundlegende Load Balancer-Konfiguration auf einer NetScaler-Instanz bereitzustellen. Sie haben ein Konfigurationspaket CP1 aus diesem StyleBook auf einer NetScaler-Instanz erstellt. Später stellten Sie fest, dass Ihr StyleBook keine Überwachungskonfiguration enthält. Also haben Sie jetzt ein StyleBook namens example-lb-mon erstellt. Dieses StyleBook hat dieselbe Load Balancer-Konfiguration wie das StyleBook example-lb, bietet aber die Möglichkeit, 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 Monitore zu Ihrer Konfiguration hinzuzufügen. Das Löschen von CP1 führt zur Entfernung aller im Konfigurationspaket CP1 erstellten Konfigurationen auf einer oder mehreren NetScaler-Instanzen. Früher mussten Sie ein neues Konfigurationspaket über das neue StyleBook neu erstellen, indem Sie Werte für alle Parameter eingaben.
Stattdessen können Sie jetzt das vorhandene Konfigurationspaket CP1 zum neuen StyleBook example-lb-mon migrieren. Ihr neues StyleBook kann Monitore und Monitordetails konfigurieren. Nur die monitorbezogenen Konfigurationsobjekte werden zu den NetScaler-Instanzen hinzugefügt, auf denen das Konfigurationspaket bereitgestellt wurde. Sie müssen jetzt nur noch die Monitordetails angeben. Die vorhandene Konfiguration, die auf den NetScaler-Instanzen bereitgestellt wurde und sich nicht geändert hat, bleibt unberührt.

Konfigurationspakete migrieren

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

  1. Navigieren Sie in NetScaler Console zu Applications \> Configurations. Die Seite Configurations zeigt alle im System vorhandenen Konfigurationspakete an.
  2. Scrollen Sie nach unten, um das example-lb-Konfigurationspaket zu finden, das Sie zuvor erstellt haben, und klicken Sie auf Migrate Configpack.
  3. Die Seite Choose target StyleBook for migration wird geöffnet und listet alle in NetScaler Console verfügbaren StyleBooks auf. Scrollen Sie nach unten, um das example-lb-mon StyleBook zu finden, und klicken Sie auf Select StyleBook. 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 können neu sein, oder es kann eine Änderung in ihrer Struktur geben. In einem solchen Fall müssen Sie die Werte für die StyleBook-Parameter manuell eingeben. Das folgende Bild zeigt beispielsweise die Parameter des StyleBooks example-lb.
    lokalisiertes Bild
    Das folgende Bild zeigt die Parameter nach der Migration des Konfigurationspakets zum StyleBook example-lb-mon.
    lokalisiertes Bild
    In diesem Fall sehen Sie, dass die StyleBooks die älteren Werte für die grundlegende Load Balancer-Konfiguration beibehalten. Sie müssen jedoch die Werte für die Monitorparameter manuell eingeben.
  4. Geben Sie Werte für die neuen Parameter ein, die zum Erstellen von Monitoren auf der Instanz verwendet werden.
  5. Klicken Sie unter Zielinstanzen auf die IP-Adresse der NetScaler-Instanz, auf der Sie die Konfiguration ausführen möchten, und wählen Sie diese aus. Beachten Sie, dass Sie die Konfiguration auf mehr als einem NetScaler bereitstellen können, indem Sie so viele Zielinstanzen wie nötig angeben.
  6. Klicken Sie auf Probelauf. Die Seite Objekte zeigt die Objekte an, die neu erstellt, geändert oder von den NetScaler-Instanzen entfernt würden.
  7. 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 wurden, aktualisiert.
    Hinweis:
    Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich entdeckte NetScaler-Instanzen hinzuzufügen. Diese Instanzen sind dann sofort in der Liste der Instanzen in diesem Fenster verfügbar. Das Aktualisierungssymbol ist derzeit nur in der NetScaler Console verfügbar.
Sie können ein Konfigurationspaket auch von einer Version eines StyleBooks auf die nächste Version migrieren. Auch hier müssen Sie möglicherweise 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 StyleBooks migrieren. In diesem Fall werden die zusätzlichen Parameter entfernt, die in dem älteren StyleBook nicht vorhanden sind. Die Seite Objekte zeigt alle Objekte an, die aus der Konfiguration entfernt werden.
Nach einer erfolgreichen Migration ist das ConfigPack an das neue StyleBook gebunden.
Sie können sehen, dass der Name des Konfigurationspakets und die Konfigurationspaket-ID dieselben sind wie zuvor. Die NetScaler Console aktualisiert jedoch den StyleBook-Namen von example-lb auf example-lb-mon.

Erstellen Sie Ihre StyleBooks

Der vollständige Inhalt des StyleBooks example-lb wird Ihnen nachfolgend 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 wird Ihnen nachfolgend als 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 NetScaler 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