Konfigurationspakete eines StyleBooks zu einem anderen StyleBook migrieren
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 es 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. Alternativ können Sie 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. Daher haben Sie nun ein StyleBook namens example-lb-mon erstellt. Dieses StyleBook hat die gleiche Load-Balancer-Konfiguration wie das example-lb StyleBook, bietet aber die Möglichkeit, Monitore zu konfigurieren.
Nun möchten Sie Ihre bestehende 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 example-lb-mon StyleBook migrieren. Ihr neues StyleBook kann Monitore und Monitordetails konfigurieren. Nur die monitorbezogenen Konfigurationsobjekte werden den NetScaler-Instanzen hinzugefügt, auf denen das Konfigurationspaket bereitgestellt wurde. Sie müssen jetzt nur noch die Monitordetails angeben. Die bestehende 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 example-lb StyleBook erstelltes Konfigurationspaket zum example-lb-mon StyleBook
-
Navigieren Sie in NetScaler Console zu Applications > Configurations. Die Seite Configurations zeigt alle im System vorhandenen Konfigurationspakete an.
-
Scrollen Sie nach unten, um das Konfigurationspaket example-lb zu finden, das Sie zuvor erstellt haben, und klicken Sie auf Migrate Configpack.
-
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 StyleBook example-lb-mon 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 die gleiche 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. Zum Beispiel zeigt die folgende Abbildung die Parameter des example-lb StyleBooks.
Die folgende Abbildung zeigt die Parameter nach der Migration des Konfigurationspakets zum example-lb-mon StyleBook.
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.
-
Geben Sie Werte für die neuen Parameter ein, die zum Erstellen von Monitoren auf der Instanz verwendet werden.
-
Klicken Sie unter Target Instances 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 mehreren NetScaler-Instanzen bereitstellen können, indem Sie so viele Zielinstanzen wie nötig angeben.
-
Klicken Sie auf Dry Run. Die Seite Objects zeigt die Objekte an, die neu erstellt, geändert oder von den NetScaler-Instanzen entfernt würden.
-
Klicken Sie auf Create, um die Konfiguration der ausgewählten Instanzen zu erstellen oder zu aktualisieren. Das Konfigurationspaket wird erstellt, wenn die Zielinstanzen neu sind. Andernfalls werden die bestehenden 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 NetScaler Console verfügbar.
Sie können ein Konfigurationspaket auch von einer Version eines StyleBooks zur nächsten Version migrieren. Auch hier müssen Sie möglicherweise die Werte für alle neuen erforderlichen Parameter eingeben, die in der neuen Version vorhanden sind. Sie können das Konfigurationspaket auch zu einer älteren Version des StyleBooks migrieren. In diesem Fall werden die zusätzlichen Parameter, die in der älteren StyleBook-Version nicht vorhanden sind, entfernt. Die Seite Objects zeigt alle Objekte an, die aus der Konfiguration entfernt werden.
Nach einer erfolgreichen Migration ist das Konfigurationspaket an das neue StyleBook gebunden.
Sie können sehen, dass der Name des Konfigurationspakets und die Konfigurationspaket-ID dieselben sind wie zuvor. NetScaler Console aktualisiert jedoch den StyleBook-Namen von example-lb auf example-lb-mon.
Erstellen Sie Ihre StyleBooks
Der vollständige Inhalt des example-lb StyleBooks wird unten als Referenz bereitgestellt:
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
<!--NeedCopy-->
Der vollständige Inhalt des example-lb-mon StyleBooks wird unten als Referenz bereitgestellt:
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
<!--NeedCopy-->