Konfigurationspaket erstellen und bearbeiten
In NetScaler Console können Sie ein Konfigurationspaket aus einem StyleBook erstellen. Das Konfigurationspaket ist an das StyleBook gebunden, aus dem es erstellt wurde. Alle Aktualisierungen des Konfigurationspakets werden über das StyleBook vorgenommen, an das es gebunden ist.
Erstellen Sie ein Konfigurationspaket
Gehen Sie wie folgt vor, um ein Konfigurationspaket aus einem StyleBook zu erstellen:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
-
Klicken Sie auf Hinzufügen.
-
Wählen Sie in Choose StyleBooksdie erforderlichen StyleBooks aus, aus denen Sie ein Konfigurationspaket erstellen möchten.
Diese Seite unterteilt StyleBooks in Standard-, Unternehmens- und benutzerdefinierte StyleBooks. Wählen Sie die entsprechenden Reiter aus, um die erforderlichen StyleBooks zu finden
-
Geben Sie optional einen eindeutigen Konfigurationsschlüssel für Ihr Konfigurationspaket an. Dieser Schlüssel wird als Anzeigetaste für dieses Konfigurationspaket angezeigt.
-
**Wenn Sie einen vorhandenen Konfigurationsschlüssel angeben, kann NetScaler Console das Konfigurationspaket nicht erstellen.
-
** Wenn Sie keinen Konfigurationsschlüssel angeben, weist NetScaler Console automatisch die **Configpack-ID zu. Dieser Wert wird jedoch nicht als Anzeigetaste angezeigt.
-
Wenn Sie keinen Konfigurationsschlüssel angeben und einer der StyleBook-Parameter das Attribut
keyfestgelegt hat, wird dieser Parameterwert als Anzeigeschlüssel angezeigt. Weitere Informationen finden Sie unter Parameter.
-
-
Geben Sie die erforderlichen Details wie Anwendungsname, IP-Adresse, Port oder Protokolltyp an.
Die GUI-Felder unterscheiden sich von StyleBook zu StyleBook.
-
Wählen Sie in Target Instanzen Instanzen oder Instanzgruppen aus, in denen Sie die Konfiguration ausführen möchten.
Hinweis:
Sie können die Konfiguration auf mehr als einem NetScaler bereitstellen, indem Sie so viele Zielinstanzen wie nötig angeben.
-
Klicken Sie auf Dry Run.
Auf der Seite Objekte werden die Objekte angezeigt, die erstellt, geändert oder aus den NetScaler-Instanzen entfernt werden.
-
Klicken Sie auf Erstellen.
Das Konfigurationspaket wird auf der Seite StyleBook > Konfigurationen angezeigt.
Wenn Sie die vorhandenen Konfigurationspakete bearbeiten möchten, wählen Sie das Konfigurationspaket aus und klicken Sie auf Bearbeiten.
Ändern des StyleBook eines Konfigurationspakets
Manchmal müssen Sie das StyleBook aktualisieren, um Funktionen hinzuzufügen oder ein Problem zu beheben. Wenn Sie bereits Konfigurationspakete mit dem alten StyleBook erstellt haben, möchten Sie sie möglicherweise aktualisieren, um das neue aktualisierte StyleBook zu verwenden. Um ein neues StyleBook zu verwenden, ändern Sie das vorhandene StyleBook des Konfigurationspakets.
Stellen Sie sich ein Beispiel für StyleBook example-lb vor, das eine grundlegende Load Balancer-Konfiguration auf einer NetScaler-Instanz bereitstellt. Und Sie erstellen ein Konfigurationspaket CP1 aus diesem StyleBook.
Um Monitore mit der Load Balancer-Grundkonfiguration zu konfigurieren, benötigen Sie ein neues StyleBook. Erstellen Sie dazu ein Example-lb-mon StyleBook, das neben der grundlegenden Load Balancer-Konfiguration auch die Möglichkeit bietet, Monitore zu konfigurieren.
Nachdem Sie ein StyleBook erstellt haben, aktualisieren Sie das vorhandene Konfigurationspaket CP1, um Monitore hinzuzufügen. Gehen Sie wie folgt vor, um das Konfigurationspaket zu aktualisieren:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
-
Wählen Sie das Konfigurationspaket aus, für das Sie das StyleBook ändern möchten.
In diesem Beispiel wählen Sie CP1 aus der Liste aus.
-
Klicken Sie auf StyleBook ändern.
-
Wählen Sie das gewünschte StyleBook aus der Liste aus. Klicken Sie dann auf “ Auswahl speichern”.
-
Klicken Sie auf Ändern.
In diesem Beispiel wählen Sie example-lb-mon aus der Liste aus.
Wenn Sie das StyleBook eines Konfigurationspakets ändern, haben die Parameter im neuen StyleBook möglicherweise eine andere Struktur als das vorhandene StyleBook. Wenn die Parameterstruktur dem vorherigen StyleBook ähnelt, werden die Werte der Parameter automatisch in den jeweiligen Feldern beibehalten. Andernfalls werden nur Parameter übertragen, die die gleiche Struktur zwischen den beiden StyleBooks haben. Zum Beispiel derselbe Parametername, Typ, übergeordnetes Parameterelement und vieles mehr.
Hinweis:
Auf der Seite StyleBook-Kompatibilität werden die Unterschiede in den Parametern angezeigt. Diese Seite hilft Ihnen bei der Entscheidung, ob Sie das StyleBook ändern oder mit dem vorhandenen StyleBook fortfahren möchten. Wenn Sie das StyleBook ändern möchten, überprüfen Sie die Änderungen und klicken Sie dann auf Weiter.
Wenn dem neuen StyleBook neue Parameter hinzugefügt werden, müssen Sie nach dem Ändern des StyleBook die Werte für solche Parameter manuell angeben.
In diesem Beispiel lauten die Parameter, die auf der Konfigurationsseite für das StyleBook example-lb angezeigt werden:
Die Parameter, die auf der Konfigurationsseite für das neue StyleBook example-lb-mon angezeigt werden, lauten wie folgt:
In diesem Fall behält das StyleBooks die älteren Werte für die grundlegende Load Balancer-Konfiguration bei, da das neue StyleBook die vorhandenen Parameter nicht geändert hat. Und es fügt nur die neuen Parameter hinzu. Geben Sie für Monitorparameter manuell die erforderlichen Werte an.
-
Überprüfen Sie in Target Instanzen die ausgewählten Instanzen und aktualisieren Sie die Liste bei Bedarf.
-
Klicken Sie auf Dry Run.
Auf der Seite Objekte werden die Objekte angezeigt, die erstellt, geändert oder aus den NetScaler-Instanzen entfernt werden.
-
Klicken Sie auf OK.
Auf der Seite StyleBook > Configurations wird in der Spalte StyleBook Name der neue StyleBook-Name für das ausgewählte Konfigurationspaket angezeigt. In diesem Fall wird Beispiel-lb-monangezeigt.
StyleBookmit mehreren Konfigurationspaketen ändern
Wenn Sie ein vorhandenes StyleBook mit mehreren Konfigurationspaketen ändern möchten, gehen Sie wie folgt vor:
-
Importieren Sie ein neues StyleBook in die NetScaler Console.
In der Regel hat das neue StyleBook den gleichen Namen und den gleichen Namespace mit einer höheren Version als das vorhandene StyleBook. Sie können diesen Schritt jedoch überspringen, wenn der Name, der Namensraum oder die Version unterschiedlich sind.
-
Ändern Sie das StyleBook für die Konfigurationspakete, die dem vorhandenen StyleBook zugeordnet sind.
Sie können Change StyleBook nur auswählen, wenn die ausgewählten Konfigurationspakete demselben StyleBook zugeordnet sind.
Für die ausgewählten Konfigurationspakete ändert die NetScaler Console das StyleBook erfolgreich, wenn die folgenden Bedingungen erfüllt sind:
-
Alle Konfigurationsparameter des vorhandenen StyleBook müssen im ausgewählten StyleBook enthalten sein.
-
Die neuen Parameter aus dem ausgewählten StyleBook sind optional.
Um den Fortschritt der ausgewählten Konfigurationspakete zu sehen, wählen Sie auf der Seite Konfigurationen die Option Konfigurationen in Bearbeitung/Fehlgeschlagen aus.
-
-
Entfernen Sie das alte StyleBook aus der NetScaler Console, sobald alle Konfigurationspakete an das neue StyleBook gebunden sind.
Konfigurationspakete exportieren oder importieren
Sie können ein Konfigurationspaket wie StyleBooks exportieren oder importieren. Mit dieser Funktion können Sie die StyleBook-Konfiguration problemlos für einen anderen NetScaler Console-Server freigeben. Wenn Sie ein Konfigurationspaket exportieren, wird ein tgz oder zip Paket auf Ihren lokalen Computer heruntergeladen. Dieses Bundle enthält eine JSON-Datei mit allen in einem Konfigurationspaket definierten Parameter.
Export-Konfiguration
Führen Sie Folgendes aus, um ein Konfigurationspaket zu exportieren:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
-
Wählen Sie ein Konfigurationspaket aus, das Sie exportieren möchten.
-
Wählen Sie unter Aktionauswählen die Option Konfiguration exportierenaus.
-
Geben Sie im Bereich Exportkonfiguration Folgendes an:
-
Informationen zu Zielinstanzen, für die die Konfiguration bereitgestellt wird: Wählen Sie diese Option aus, um die Informationen der Zielinstanzen in das Exportpaket aufzunehmen.
-
Mit Konfiguration verknüpftes StyleBook: Wählen Sie diese Option aus, um das StyleBook in das Export-Bundle aufzunehmen.
-
Passphrase zum Schutz der Exportkonfigurationsdaten: Geben Sie eine Passphrase an, um das Export-Bundle zu verschlüsseln. Diese Passphrase sichert die sensiblen Daten eines Konfigurationspakets.
-
Dateityp komprimieren: Wählen Sie entweder ZIP- oder TGZ-Dateityp aus.
-
-
Klicken Sie auf Exportieren.
Speichern Sie das Export-Bundle auf Ihrem lokalen Computer.
Konfiguration importieren
Sie können ein Konfigurationspaket von Ihrem lokalen Computer auf einen anderen NetScaler Console-Server importieren. Um ein Konfigurationspaket zu importieren, führen Sie die folgenden Schritte aus:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
-
Wählen Sie Konfiguration importierenaus.
-
Wählen Sie das Importdatei-Paket von Ihrem Computer aus.
-
Verwenden Sie die Passphrase, die Sie beim Export angegeben haben.
-
Wählen Sie optional unter Erweiterte Optionen die Option Nur die Erstellung einer neuen Konfiguration zulassen, wenn alle Konfigurationsobjekte bereits auf NetScaler vorhanden sind .
Diese Option ändert nicht die Objekte, die bereits auf der NetScaler-Instanz erstellt wurden.
Bedenken Sie, dass Sie dieselbe NetScaler-Instanz auf zwei NetScaler Console-Servern hinzugefügt haben. Und Sie möchten ein Konfigurationspaket von einem NetScaler Console-Server auf einen anderen Server migrieren. Verwenden Sie diese Option, um ein Konfigurationspaket zu importieren, ohne seine Konfigurationsobjekte auf einer NetScaler-Instanz zu ändern.
Wichtig:
Um diese Option zu verwenden, stellen Sie sicher, dass das angegebene Konfigurationspaket die Zielinstanzinformationen enthält. Siehe Konfiguration exportieren.
Diese Option migriert die Konfiguration nur, wenn alle Objekte auf der Zielinstanz vorhanden sind.
-
Klicken Sie auf Importieren.
Wenn Sie ein Konfigurationspaket importieren, überprüft die NetScaler Console Folgendes:
-
Zugeordnetes StyleBook: Wenn sich das zugehörige StyleBook nicht in der NetScaler Console befindet, importiert es das StyleBook zusammen mit dem Konfigurationspaket.
-
Zielinstanzen: Suchen Sie nach Zielinstanzen und stellt die Konfiguration auf den angegebenen Zielinstanzen bereit. Wenn die genannten NetScaler-Instanzen in der NetScaler Console nicht vorhanden sind, wird das Konfigurationspaket ohne Zielinstanzen importiert.
-
Quell-NetScaler Console: Wenn Sie ein Konfigurationspaket auf demselben NetScaler Console-Server importieren, aktualisiert das ausgewählte Paket das vorhandene Konfigurationspaket.
Speichern Sie ein Konfigurationspaket als Entwurf
Mit der Option Als Entwurf speichern in Konfigurationspaketen können Sie Ihre Konfigurationsänderungen als Entwürfe speichern. Diese Funktion speichert die Änderungen, ohne sie sofort auf einer NetScaler-Instanz bereitzustellen.
Gehen Sie wie folgt vor, um ein Konfigurationspaket als Entwurf zu speichern:
- Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
- Klicken Sie auf der Seite Konfigurationen auf Hinzufügen.
- Wählen Sie Ihr gewünschtes Stylebook aus und klicken Sie auf Auswählen.
- Klicken Sie auf der Seite Konfiguration erstellen auf Als Entwurf speichern.
Sobald das Config Pack als Entwurf gespeichert wurde, werden Ihre Konfigurationsänderungen nicht direkt auf der NetScaler-Instanz bereitgestellt. Stattdessen werden die Konfigurationspakete als Entwürfe auf der Registerkarte Entwurfskonfigurationen unter Ausstehende Konfigurationen gespeichert.
Wählen Sie auf der Registerkarte Entwurfskonfigurationen das Konfigurationspaket aus, um die folgenden Vorgänge auszuführen:
- Bearbeiten Sie die Konfiguration des Entwurfs.
- Stellen Sie die Konfiguration auf einer NetScaler-Instanz bereit.
- Löschen Sie den Entwurf.
Sie können auch planen, wann Ihre gespeicherten Entwürfe bereitgestellt werden sollen.
Weitere Informationen finden Sie unter Zeitplan für ein Konfigurationspaket erstellen.
Erstellen Sie einen Zeitplan für ein Konfigurationspaket
Wenn Sie ein Config Pack erstellen, wird das Config Pack standardmäßig automatisch auf einer NetScaler-Instanz bereitgestellt. Mit dieser Funktion können Sie die Bereitstellung von Konfigurationspaketen planen.
Gehen Sie wie folgt vor, um einen Zeitplan für ein Config Pack zu erstellen:
- Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
- Klicken Sie auf der Seite Konfigurationen auf Hinzufügen.
- Wählen Sie das StyleBook aus und klicken Sie auf Auswählen.
- Wählen Sie auf der Seite Konfiguration erstellen unter Ausführung in der Liste Ausführungsmodus die Option Später aus.
- Wählen Sie die gewünschte Uhrzeit und das gewünschte Datum für die Planung aus und klicken Sie auf Senden.
Alle geplanten Konfigurationen werden auf der Registerkarte Geplante Konfigurationen unter Ausstehende Konfigurationen gespeichert. Sie können den erstellten Zeitplan auswählen, um die Konfigurationsparameter zu bearbeiten, den Zeitplan bereitzustellen oder abzubrechen.
Hinweis:
Durch die Bereitstellung eines geplanten Konfigurationspakets wird der Zeitplan storniert und die Konfiguration wird sofort ausgeführt.
Für ein bereitgestelltes Konfigurationspaket
Sie können auch einen Zeitplan erstellen, um ein bereitgestelltes Konfigurationspaket zu bearbeiten und zu löschen.
Einen Bearbeitungsvorgang für ein Konfigurationspaket planen
Gehen Sie wie folgt vor, um einen Zeitplan für die Bearbeitung des bereitgestellten Konfigurationspakets zu erstellen:
- Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
- Wählen Sie auf der Seite Konfigurationen ein StyleBook aus und klicken Sie auf Bearbeiten.
- Bearbeiten Sie auf der Seite Konfiguration bearbeiten das Konfigurationspaket.
- Wählen Sie in der Liste Ausführungsmodus die Option Später aus.
- Wählen Sie die gewünschte Uhrzeit und das gewünschte Datum für die Planung aus und klicken Sie auf Senden.
Einen Löschvorgang für ein Config Pack planen
Gehen Sie wie folgt vor, um einen Zeitplan zum Löschen des bereitgestellten Konfigurationspakets zu erstellen:
- Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
- Wählen Sie auf der Seite Konfigurationen ein StyleBook aus und klicken Sie auf Löschen.
- Wählen Sie in der Liste Ausführungsmodus die Option Später aus.
- Wählen Sie die gewünschte Uhrzeit und das gewünschte Datum für die Planung aus und klicken Sie auf OK.
Trennen Sie eine Zielinstanz von einem Konfigurationspaket
Gehen Sie wie folgt vor, um eine Zielinstanz von einem Konfigurationspaket zu trennen:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
-
Wählen Sie das Konfigurationspaket mit einer Zielinstanz aus, die Sie entfernen möchten.
-
Wählen Sie unter Aktion auswählen die Option Ziele trennen aus.
-
Wählen Sie im Bereich Detach Targets die Zielinstanz aus, die Sie aus dem Konfigurationspaket entfernen möchten.
-
Klicken Sie auf OK.
Es wird eine Meldung angezeigt, die die Erstellung eines doppelten Konfigurationspakets bestätigt, wobei die Zielinstanz nun entfernt wurde.
Erstellen Sie Ihre StyleBooks
Der vollständige Inhalt von Beispiel-lb StyleBook wird wie folgt 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 von beispiel-lb-mon StyleBook wird wie folgt 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-->
In diesem Artikel
- Erstellen Sie ein Konfigurationspaket
- Ändern des StyleBook eines Konfigurationspakets
- Konfigurationspakete exportieren oder importieren
- Speichern Sie ein Konfigurationspaket als Entwurf
- Erstellen Sie einen Zeitplan für ein Konfigurationspaket
- Trennen Sie eine Zielinstanz von einem Konfigurationspaket
- Erstellen Sie Ihre StyleBooks