Konfigurationspaket erstellen und bearbeiten

Last published : Oct 02, 2026
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 erfolgen über das StyleBook, an das es gebunden ist.

Konfigurationspaket erstellen

Gehen Sie wie folgt vor, um ein Konfigurationspaket aus einem StyleBook zu erstellen:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Klicken Sie auf Add.
  3. Wählen Sie unter Choose StyleBooks die erforderlichen StyleBooks aus, aus denen Sie ein Konfigurationspaket erstellen möchten.
    Diese Seite kategorisiert StyleBooks in Standard-, Unternehmens- und benutzerdefinierte StyleBooks. Wählen Sie die entsprechenden Registerkarten aus, um die erforderlichen StyleBooks zu finden.
  4. Optional können Sie einen eindeutigen Config Key für Ihr Konfigurationspaket angeben. Dieser Schlüssel wird als Display Key für dieses Konfigurationspaket angezeigt.
    • Wenn Sie einen bereits vorhandenen Config Key angeben, kann NetScaler Console das Konfigurationspaket nicht erstellen.
    • Wenn Sie keinen Config Key angeben, weist NetScaler Console automatisch die Configpack ID zu. Dieser Wert wird jedoch nicht als Display Key angezeigt.
    • Wenn Sie keinen Config Key angeben und einer der StyleBook-Parameter das key-Attribut festgelegt hat, wird dieser Parameterwert als Display Key angezeigt. Weitere Informationen finden Sie unter Parameters.
  5. Geben Sie die erforderlichen Details wie Anwendungsname, IP-Adresse, Port oder Protokolltyp an.
    Die GUI-Felder unterscheiden sich von StyleBook zu StyleBook.
  6. Wählen Sie unter Target Instances 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 angeben, wie benötigt werden.
  7. Klicken Sie auf Testlauf.
    Die Seite Objekte zeigt die Objekte an, die auf den NetScaler-Instanzen erstellt, geändert oder entfernt werden.
  8. 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.

Konfigurationen wiederverwenden, die außerhalb von StyleBooks erstellt wurden, und Konfigurationen zwischen Konfigurationspaketen teilen

Manchmal haben Sie möglicherweise NetScaler®-Konfigurationen außerhalb von Stylebooks erstellt, sei es aufgrund spezifischer betrieblicher Anforderungen oder älterer Setups. Sie können diese bereits vorhandenen Konfigurationen nun als Teil von Stylebook-Konfigurationspaketen integrieren und verwalten, was eine flexiblere und zentralisierte Verwaltung ermöglicht.
Zum Beispiel, vor dieser Funktion, wenn NetScaler bereits mit einem SSL-Profil konfiguriert ist und der Konfigurationspaketvorgang von StyleBook versucht, ein SSL-Profil mit demselben Namen zu erstellen, wäre der Konfigurationspaketvorgang mit dem Fehler "Ressource existiert bereits" fehlgeschlagen. Jetzt, da diese Funktion aktiviert ist, ist der Konfigurationspaketvorgang erfolgreich und das vorhandene SSL-Profil mit demselben Namen kann im neuen Konfigurationspaket wiederverwendet werden.
Ähnlich können auch Szenarien auftreten, in denen Ressourcen wie Netzwerkeinstellungen, Sicherheitsrichtlinien oder Teile von Anwendungskonfigurationen über mehrere Anwendungen oder Konfigurationen hinweg benötigt werden. Diese Funktion ermöglicht es Ihnen, die Konfigurationen über mehrere Konfigurationspakete hinweg zu teilen.
Um diese Funktion zu aktivieren, führen Sie die folgenden Schritte aus:
  1. Navigieren Sie zu Anwendungen > Konfiguration > Stylebooks.
  2. Wählen Sie auf der Seite Stylebooks das Stylebook aus, das Sie zum Erstellen eines neuen Konfigurationspakets verwenden werden, oder dasjenige, das mit dem Konfigurationspaket verknüpft ist, das Sie bearbeiten.
  3. Klicken Sie unter Aktion auswählen auf Einstellungen konfigurieren.
  4. Passen Sie die Einstellungen an, indem Sie eine oder beide der folgenden Optionen auswählen:
    • Um die Wiederverwendung vorhandener Ressourcen auf dem NetScaler beim Erstellen von Konfigurationen zu ermöglichen, wählen Sie die Option Wiederverwendung vorhandener Ressourcen auf dem NetScaler beim Erstellen von Konfiguration(en) zulassen.
    • Um wiederverwendete Ressourcen auf dem NetScaler beim Löschen von Konfigurationen beizubehalten, wählen Sie die Option Wiederverwendete Ressourcen auf dem NetScaler beim Löschen von Konfiguration(en) beibehalten?. Diese Option behält die ursprünglich außerhalb von Stylebooks auf dem NetScaler erstellten Ressourcen bei, selbst wenn das letzte Konfigurationspaket, das auf sie verweist, gelöscht wird, wodurch deren fortgesetzte Verfügbarkeit sichergestellt wird.
  5. Klicken Sie auf OK.

Ändern des StyleBooks 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 diese möglicherweise aktualisieren, um das neue aktualisierte StyleBook zu verwenden. Um ein neues StyleBook zu verwenden, ändern Sie das vorhandene StyleBook des Konfigurationspakets.
Betrachten Sie ein Beispiel-StyleBook example-lb, das eine grundlegende Load-Balancer-Konfiguration auf einer NetScaler-Instanz bereitstellt. Und Sie erstellen ein Konfigurationspaket CP1 aus diesem StyleBook.
Um Monitore mit der grundlegenden Load-Balancer-Konfiguration zu konfigurieren, benötigen Sie ein neues StyleBook. Erstellen Sie dazu ein example-lb-mon StyleBook, das die Möglichkeit beinhaltet, Monitore zusammen mit der grundlegenden Load-Balancer-Konfiguration zu konfigurieren.
Nachdem Sie ein StyleBook erstellt haben, aktualisieren Sie das vorhandene Konfigurationspaket CP1, um Monitore hinzuzufügen. Um das Konfigurationspaket zu aktualisieren, gehen Sie wie folgt vor:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Wählen Sie das Konfigurationspaket aus, für das Sie das StyleBook ändern möchten.
    Wählen Sie in diesem Beispiel CP1 aus der Liste aus.
  3. Klicken Sie auf Change StyleBook.
  4. Wählen Sie das gewünschte StyleBook aus der Liste aus. Klicken Sie dann auf Auswahl speichern.
  5. Klicken Sie auf Ändern.
    Wählen Sie in diesem Beispiel example-lb-mon aus der Liste aus.
    Wenn Sie das StyleBook eines Konfigurationspakets ändern, kann die Struktur der Parameter im neuen StyleBook von der des vorhandenen StyleBooks abweichen. Wenn die Parameterstruktur der des vorherigen StyleBooks ähnelt, werden die Werte der Parameter automatisch in den entsprechenden Feldern beibehalten. Andernfalls werden nur Parameter übertragen, die zwischen den beiden StyleBooks dieselbe Struktur aufweisen. Zum Beispiel derselbe Parametername, Typ, Parameter-Parent und mehr.
    Hinweis:
    Die Seite StyleBook-Kompatibilität zeigt die Unterschiede in den Parametern an. Diese Seite hilft Ihnen zu entscheiden, ob Sie das StyleBook ändern oder das vorhandene StyleBook beibehalten möchten. Wenn Sie das StyleBook ändern möchten, überprüfen Sie die Änderungen und klicken Sie dann auf Weiter.
    Wenn im neuen StyleBook neue Parameter hinzugefügt werden, müssen Sie nach dem Ändern des StyleBooks die Werte für solche Parameter manuell angeben.
    In diesem Beispiel sind die Parameter, die auf der Konfigurationsseite für das StyleBook example-lb angezeigt werden, wie folgt:
    Beispiel für ein Lastausgleichs-Konfigurationspaket
    Die Parameter, die auf der Konfigurationsseite für das neue StyleBook example-lb-mon angezeigt werden, sind wie folgt:
    Beispielparameter nach der Migration des Konfigurationspakets
    In diesem Fall behält das StyleBook die älteren Werte für die grundlegende Lastausgleichskonfiguration bei, da das neue StyleBook keine vorhandenen Parameter geändert hat. Es fügt nur die neuen Parameter hinzu. Für Monitorparameter geben Sie die erforderlichen Werte manuell an.
  6. Überprüfen Sie unter Zielinstanzen die ausgewählten Instanzen und aktualisieren Sie die Liste bei Bedarf.
  7. Klicken Sie auf Probelauf.
    Die Seite Objekte zeigt die Objekte an, die in den NetScaler-Instanzen erstellt, geändert oder entfernt werden.
  8. Klicken Sie auf OK.
    Auf der Seite StyleBook > Configurations zeigt die Spalte StyleBook Name den neuen StyleBook-Namen für das ausgewählte Konfigurationspaket an. In diesem Fall wird example-lb-mon angezeigt.

Ändern des StyleBooks mit mehreren Konfigurationspaketen

Wenn Sie ein vorhandenes StyleBook ändern möchten, das mehrere Konfigurationspakete enthält, gehen Sie wie folgt vor:
  1. Importieren Sie ein neues StyleBook in die NetScaler Console.
    Typischerweise hat das neue StyleBook den gleichen Namen und Namespace mit einer höheren Version als das vorhandene StyleBook. Sie können diesen Schritt jedoch überspringen, wenn Name, Namespace oder Version unterschiedlich sind.
  2. Ä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 StyleBooks müssen im ausgewählten StyleBook vorhanden sein.
    • Die neuen Parameter aus dem ausgewählten StyleBook sind optional.
    Um den Fortschritt der ausgewählten Konfigurationspakete anzuzeigen, wählen Sie auf der Seite Configurations die Option Configurations in Progress/Failed aus.
  3. 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-Bundle auf Ihren lokalen Computer heruntergeladen. Dieses Bundle enthält eine JSON-Datei mit allen in einem Konfigurationspaket definierten Parametern.

Konfiguration exportieren

Gehen Sie wie folgt vor, um ein Konfigurationspaket zu exportieren:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Wählen Sie ein Konfigurationspaket aus, das Sie exportieren möchten.
  3. Wählen Sie unter Aktion auswählen die Option Konfiguration exportieren.
    Option zum Exportieren der Konfiguration
  4. Geben Sie im Bereich Konfiguration exportieren Folgendes an:
    • Informationen zu Zielinstanzen, auf denen die Konfiguration bereitgestellt wird: Wählen Sie diese Option, um die Informationen der Zielinstanzen in das Exportpaket aufzunehmen.
    • StyleBook, das der Konfiguration zugeordnet ist: Wählen Sie diese Option, um das StyleBook in das Exportpaket aufzunehmen.
    • Passphrase zum Schutz der Exportkonfigurationsdaten: Geben Sie eine Passphrase ein, um das Exportpaket zu verschlüsseln. Diese Passphrase schützt die sensiblen Daten eines Konfigurationspakets.
    • Dateityp komprimieren: Wählen Sie entweder den Dateityp ZIP oder TGZ.
    Konfigurationspaket exportieren
  5. Klicken Sie auf Exportieren.
    Speichern Sie das Exportpaket auf Ihrem lokalen Computer.

Konfiguration importieren

Sie können ein Konfigurationspaket von Ihrem lokalen Computer auf einen anderen NetScaler Console-Server importieren. Gehen Sie wie folgt vor, um ein Konfigurationspaket zu importieren:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Wählen Sie Import Configuration.
  3. Wählen Sie das Importdateibündel von Ihrem Computer aus.
  4. Verwenden Sie die Passphrase, die Sie beim Export angegeben haben.
  5. Optional: Wählen Sie unter „Erweiterte Optionen“ Nur die Erstellung einer neuen Konfiguration zulassen, wenn alle Konfigurationsobjekte bereits auf NetScaler vorhanden sind.
    Diese Option ändert die Objekte nicht, die bereits auf der NetScaler-Instanz erstellt wurden.
    Angenommen, Sie haben dieselbe NetScaler-Instanz in zwei NetScaler Console-Servern hinzugefügt. 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 dessen Konfigurationsobjekte auf einer NetScaler-Instanz zu ändern.
    Wichtig:
    Um diese Option zu verwenden, stellen Sie sicher, dass das angegebene Konfigurationspaket die Informationen zu den Zielinstanzen enthält. Siehe, Konfiguration exportieren.
    Diese Option migriert die Konfiguration nur, wenn alle Objekte auf der Zielinstanz vorhanden sind.
  6. Klicken Sie auf Importieren.
Konfiguration importieren
Wenn Sie ein Konfigurationspaket importieren, überprüft die NetScaler Console Folgendes:
  • Zugehöriges StyleBook: Wenn das zugehörige StyleBook nicht in der NetScaler Console vorhanden ist, importiert es das StyleBook zusammen mit dem Konfigurationspaket.
  • Zielinstanzen: Prüft auf 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 Bundle das vorhandene Konfigurationspaket.

Konfigurationspaket als Entwurf speichern

Die Option Als Entwurf speichern in Konfigurationspaketen ermöglicht es Ihnen, Ihre Konfigurationsänderungen als Entwürfe zu 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:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Klicken Sie auf der Seite Configurations auf Add.
  3. Wählen Sie Ihr gewünschtes Stylebook aus und klicken Sie auf Select.
  4. Klicken Sie auf der Seite Create Configuration auf Save as Draft.
Als Entwurf speichern
Sobald das Konfigurationspaket als Entwurf gespeichert ist, werden Ihre Konfigurationsänderungen nicht direkt auf der NetScaler-Instanz bereitgestellt. Stattdessen werden die Konfigurationspakete als Entwürfe auf der Registerkarte Draft Configurations unter Pending Configurations gespeichert.
Wählen Sie auf der Registerkarte Draft Configurations 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.
Entwurfskonfigurationen
Sie können auch planen, wann Ihre gespeicherten Entwürfe bereitgestellt werden sollen.
Weitere Informationen finden Sie unter Erstellen eines Zeitplans für ein Konfigurationspaket.

Erstellen eines Zeitplans für ein Konfigurationspaket

Wenn Sie ein Konfigurationspaket erstellen, wird es standardmäßig automatisch auf einer NetScaler-Instanz bereitgestellt. Mit dieser Funktion können Sie die Bereitstellung von Konfigurationspaketen planen.
Führen Sie die folgenden Schritte aus, um einen Zeitplan für ein Konfigurationspaket zu erstellen:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Klicken Sie auf der Seite Configurations auf Add.
  3. Wählen Sie das StyleBook aus und klicken Sie auf Select.
  4. Wählen Sie auf der Seite Create Configuration unter Execution in der Liste Execution Mode die Option Later aus.
  5. Wählen Sie die gewünschte Uhrzeit und das Datum für die Planung aus und klicken Sie auf Submit.
Ausführungsmodus
Alle geplanten Konfigurationen werden auf der Registerkarte Scheduled configurations unter Pending Configurations gespeichert. Sie können den erstellten Zeitplan auswählen, um die Konfigurationsparameter zu bearbeiten, den Zeitplan bereitzustellen oder abzubrechen.
Hinweis:
Die Bereitstellung eines geplanten Konfigurationspakets bricht den Zeitplan ab und führt die Konfiguration sofort aus.
Geplante Konfiguration

Für ein bereitgestelltes Konfigurationspaket

Sie können auch einen Zeitplan erstellen, um ein bereitgestelltes Konfigurationspaket zu bearbeiten und zu löschen.

Bearbeitungsvorgang für ein Konfigurationspaket planen

Um einen Zeitplan für die Bearbeitung des bereitgestellten Konfigurationspakets zu erstellen, führen Sie die folgenden Schritte aus:
  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
  2. Auf der Seite Konfigurationen wählen Sie ein StyleBook aus und klicken Sie auf Bearbeiten.
  3. Auf der Seite Konfiguration bearbeiten bearbeiten Sie das Konfigurationspaket.
  4. Wählen Sie in der Liste Ausführungsmodus die Option Später aus.
  5. Wählen Sie die gewünschte Uhrzeit und das Datum für die Planung aus und klicken Sie auf Senden.

Löschvorgang für ein Konfigurationspaket planen

Um einen Zeitplan für das Löschen des bereitgestellten Konfigurationspakets zu erstellen, führen Sie die folgenden Schritte aus:
  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
  2. Auf der Seite Konfigurationen wählen Sie ein StyleBook aus und klicken Sie auf Löschen.
  3. Wählen Sie in der Liste Ausführungsmodus die Option Später aus.
  4. Wählen Sie die gewünschte Uhrzeit und das Datum für die Planung aus und klicken Sie auf OK.
Zeitplan für Konfigurationspaket löschen

Eine Zielinstanz von einem Konfigurationspaket trennen

Um eine Zielinstanz von einem Konfigurationspaket zu trennen, gehen Sie wie folgt vor:
  1. Navigieren Sie zu Applications > Configuration > Config Packs.
  2. Wählen Sie das Konfigurationspaket mit einer Zielinstanz aus, die Sie entfernen möchten.
  3. Wählen Sie unter Select Action die Option Detach Targets.
  4. Wählen Sie im Bereich Detach Targets die Zielinstanz aus, die Sie aus dem Konfigurationspaket entfernen möchten.
    Ziele trennen
  5. 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 des example-lb StyleBook wird Ihnen als Referenz wie folgt 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 example-lb-mon StyleBook wird Ihnen als Referenz wie folgt 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