Konfigurationspaket eines StyleBooks zu einem anderen StyleBook migrieren
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 erfolgen, an das das Konfigurationspaket gebunden ist. NetScaler ADM ermöglicht Ihnen jetzt, ein vorhandenes Konfigurationspaket zu einem neuen StyleBook zu migrieren. Das neue StyleBook kann eine neuere Version des aktuellen StyleBooks sein, an das 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. Daher haben Sie jetzt ein StyleBook namens example-lb-mon erstellt. Dieses StyleBook verfügt über dieselbe Load-Balancer-Konfiguration wie das StyleBook example-lb, bietet aber zusätzlich die Möglichkeit, Monitore zu konfigurieren.
Jetzt möchten Sie Ihre vorhandene Konfiguration, die im Konfigurationspaket CP1 erstellt wurde, aktualisieren, um 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 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.
Konfigurationspaket migrieren
So migrieren Sie ein mit dem StyleBook example-lb erstelltes Konfigurationspaket zu example-lb-mon StyleBook
-
Navigieren Sie in NetScaler ADM 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 ADM 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 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. Die folgende Abbildung zeigt beispielsweise die Parameter des StyleBooks example-lb.
Die folgende Abbildung zeigt die Parameter nach der Migration des Konfigurationspakets zum StyleBook example-lb-mon.
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 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 NetScaler ADM 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 aller 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 wurden.
Nach einer erfolgreichen Migration ist das Konfigurationspaket an das neue StyleBook gebunden.
Sie sehen, dass der Name des Konfigurationspakets und die Konfigurationspaket-ID dieselben sind wie zuvor. NetScaler ADM aktualisiert jedoch den StyleBook-Namen von example-lb auf example-lb-mon.
Ihre StyleBooks erstellen
Der vollständige Inhalt des StyleBooks example-lb 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 StyleBooks example-lb-mon 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-->