Migrieren Sie Konfigurationspakete eines StyleBook auf ein anderes StyleBook
In NetScaler Application Delivery Management (ADM) sind Konfigurationspakete immer an das StyleBook gebunden, aus dem sie erstellt wurden. Jede Aktualisierung des Configpacks kann nur über das StyleBook erfolgen, an das das Configpack gebunden ist. Mit NetScaler ADM können Sie jetzt ein vorhandenes Konfigurationspaket auf ein neues StyleBook migrieren. Das neue StyleBook kann eine originellere Version des aktuellen StyleBook sein, die an das Configpack gebunden ist. Oder Sie können das Configpack 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 Instanz bereitzustellen. Sie haben ein Config Pack CP1 aus diesem StyleBook auf einer NetScaler-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 bestehende Konfiguration, die in Configpack CP1 erstellt wurde, aktualisieren, um einige Monitore hinzuzufügen. Zuvor mussten Sie das Configpack CP1 löschen und ein Configpack CP2 aus dem neuen StyleBook erstellen, um Monitore zu Ihrer Konfiguration hinzuzufügen. Das Löschen von CP1 führt zum Entfernen der gesamten Konfiguration, die im Config Pack CP1 auf einer oder mehreren NetScaler-Instanzen erstellt wurde. Zuvor mussten Sie ein neues Configpack über das neue StyleBook neu erstellen, indem Sie Werte für alle Parameter eingegeben haben.
Stattdessen können Sie jetzt das vorhandene Configpack CP1 auf das neue example-lb-mon StyleBook migrieren. Ihr neues StyleBook kann Monitor-Details konfigurieren. Nur die überwachungsbezogenen Konfigurationsobjekte werden den NetScaler-Instanzen hinzugefügt, in denen das Config Pack bereitgestellt wurde. Sie müssen jetzt nur die Monitordetails angeben. Die vorhandene Konfiguration, die auf den nicht geänderten NetScaler Instanzen bereitgestellt wird, bleibt davon unberührt.
Konfigurationspakete migrieren
Um ein mit example-lb StyleBook erstelltes Konfigurationspaket zu example-lb-mon StyleBook zu migrieren
-
Navigieren Sie in NetScaler ADM zu Anwendungen > Konfigurationen. Auf der Seite Konfigurationen werden alle Konfigurationspakete angezeigt, die im System vorhanden sind.
-
Scrollen Sie nach unten, um das example-lb-Konfigurationspaket zu finden, das Sie zuvor erstellt haben, 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 NetScaler 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.
Das folgende Bild zeigt die Parameter nach der Migration des Configpacks zu 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 Zielinstanzenauf die IP-Adresse der NetScaler-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 NetScaler 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 NetScaler-Instanzen entfernt wurden.
-
Klicken Sie auf Erstellen, um die Konfiguration der ausgewählten Instanzen zu erstellen oder zu aktualisieren. Das Configpack 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 entdeckte NetScaler-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 Configpack von einer Version eines StyleBook zur nächsten 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 Configpack 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.
Sie können sehen, dass der Name des Configpacks und die Configpack-ID dieselben 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
<!--NeedCopy-->
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 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-->