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 erfolgen über das StyleBook, an das es gebunden ist.
Konfigurationspaket erstellen
Gehen Sie wie folgt vor, um ein Konfigurationspaket aus einem StyleBook zu erstellen:
-
Navigieren Sie zu Applications > Configuration > Config Packs.
-
Klicken Sie auf Add.
-
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.
-
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 Attribut
key
gesetzt hat, wird dieser Parameterwert als Display Key angezeigt. Weitere Informationen finden Sie unter Parameters.
-
-
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 unter Target Instances Instanzen oder Instanzgruppen aus, auf denen Sie die Konfiguration ausführen möchten.
Note:
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 Objects werden die Objekte angezeigt, die auf den NetScaler-Instanzen erstellt, geändert oder entfernt werden.
-
Klicken Sie auf Create.
Das Konfigurationspaket wird auf der Seite StyleBook > Configurations angezeigt.
Wenn Sie die vorhandenen Konfigurationspakete bearbeiten möchten, wählen Sie das Konfigurationspaket aus und klicken Sie auf Edit.
Außerhalb von StyleBooks erstellte Konfigurationen wiederverwenden und Konfigurationen zwischen ConfigPacks teilen
Manchmal haben Sie NetScaler-Konfigurationen möglicherweise 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.
Wenn beispielsweise vor dieser Funktion NetScaler bereits mit einem SSL-Profil konfiguriert war und der Konfigurationspaketvorgang des StyleBooks versucht, ein SSL-Profil mit demselben Namen zu erstellen, wäre der Konfigurationspaketvorgang mit dem Fehler “Ressource existiert bereits” fehlgeschlagen. Mit dieser aktivierten Funktion ist der Konfigurationspaketvorgang nun erfolgreich, und das vorhandene SSL-Profil mit demselben Namen kann im neuen Konfigurationspaket wiederverwendet werden.
Ähnlich können Sie auch auf Szenarien stoßen, 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.
Gehen Sie wie folgt vor, um diese Funktion zu aktivieren:
-
Navigieren Sie zu Applications > Configuration > Stylebooks.
-
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.
-
Klicken Sie unter Select Action auf Configure Settings.
- 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 Allow reuse of existing resources on the NetScaler while creating configuration(s).
- Um wiederverwendete Ressourcen auf dem NetScaler beim Löschen von Konfigurationen beizubehalten, wählen Sie die Option Retain reused resources on the NetScaler when deleting configuration(s)?. Diese Option behält die ursprünglich außerhalb von Stylebooks erstellten Ressourcen auf dem NetScaler bei, selbst wenn das letzte Konfigurationspaket, das auf sie verweist, gelöscht wird, wodurch deren fortgesetzte Verfügbarkeit sichergestellt wird.
- Klicken Sie auf OK.
StyleBook eines Konfigurationspakets ändern
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 bietet, 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. Gehen Sie wie folgt vor, um das Konfigurationspaket zu aktualisieren:
-
Navigieren Sie zu Applications > Configuration > Config Packs.
-
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.
-
Klicken Sie auf Change StyleBook.
-
Wählen Sie das gewünschte StyleBook aus der Liste aus. Klicken Sie dann auf Save Selection.
-
Klicken Sie auf Change.
Wählen Sie in diesem Beispiel example-lb-mon aus der Liste aus.
Wenn Sie das StyleBook eines Konfigurationspakets ändern, können die Parameter im neuen StyleBook eine andere Struktur als das vorhandene StyleBook haben. Wenn die Parameterstruktur der des vorherigen StyleBooks ähnelt, werden die Werte der Parameter automatisch in ihren jeweiligen Feldern beibehalten. Andernfalls werden nur Parameter übertragen, die dieselbe Struktur zwischen den beiden StyleBooks aufweisen. Zum Beispiel derselbe Parametername, Typ, Parameter-Parent und mehr.
Note:
Die Seite StyleBook Compatibility zeigt die Unterschiede in den Parametern an. Diese Seite hilft Ihnen zu entscheiden, 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 Next.
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:
Die Parameter, die auf der Konfigurationsseite für das neue StyleBook example-lb-mon angezeigt werden, sind wie folgt:
In diesem Fall behält das StyleBook 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. Für Monitor-Parameter geben Sie die erforderlichen Werte manuell an.
-
Überprüfen Sie unter Target Instances die ausgewählten Instanzen und aktualisieren Sie die Liste bei Bedarf.
-
Klicken Sie auf Dry Run.
Auf der Seite Objects werden die Objekte angezeigt, die auf den NetScaler-Instanzen erstellt, geändert oder entfernt werden.
-
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.
StyleBook ändern, das mehrere Konfigurationspakete enthält
Wenn Sie ein vorhandenes StyleBook ändern möchten, das mehrere Konfigurationspakete enthält, gehen Sie wie folgt vor:
-
Importieren Sie ein neues StyleBook in NetScaler Console.
Typischerweise hat das neue StyleBook denselben 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.
-
Ändern Sie das StyleBook für die Konfigurationspakete, die mit dem vorhandenen StyleBook verknüpft sind.
Sie können Change StyleBook nur auswählen, wenn die ausgewählten Konfigurationspakete mit demselben StyleBook verknüpft 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 Configurations in Progress/Failed auf der Seite Configurations 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 auf einen anderen NetScaler Console-Server übertragen. 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:
-
Navigieren Sie zu Applications > Configuration > Config Packs.
-
Wählen Sie ein Konfigurationspaket aus, das Sie exportieren möchten.
-
Wählen Sie unter Select Action die Option Export Configuration.
-
Geben Sie im Bereich Export Configuration Folgendes an:
-
Target instance(s) information on which the configuration is deployed: Wählen Sie diese Option, um Informationen zu den Zielinstanzen in das Export-Bundle aufzunehmen, auf denen die Konfiguration bereitgestellt wird.
-
StyleBook associated with Configuration: Wählen Sie diese Option, um das StyleBook in das Export-Bundle aufzunehmen.
-
Passphrase for protecting the export configuration data: Geben Sie eine Passphrase an, um das Export-Bundle zu verschlüsseln. Diese Passphrase sichert die sensiblen Daten eines Konfigurationspakets.
-
Compress file type: Wählen Sie entweder den Dateityp ZIP oder TGZ.
-
-
Klicken Sie auf Export.
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. Gehen Sie wie folgt vor, um ein Konfigurationspaket zu importieren:
-
Navigieren Sie zu Applications > Configuration > Config Packs.
-
Wählen Sie Import Configuration.
-
Wählen Sie das Import-Dateibündel von Ihrem Computer aus.
-
Verwenden Sie die Passphrase, die Sie beim Export angegeben haben.
-
Optional, wählen Sie unter Advanced Options die Option Only allow creation of new configuration if all config objects already exist on NetScaler.
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.
Important:
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.
-
Klicken Sie auf Import.
Wenn Sie ein Konfigurationspaket importieren, überprüft die NetScaler Console Folgendes:
-
Associated StyleBook: Wenn das zugehörige StyleBook nicht in der NetScaler Console vorhanden ist, importiert es das StyleBook zusammen mit dem Konfigurationspaket.
-
Target instances: Überprüft die 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.
-
Source 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 Save as Draft 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:
- Navigieren Sie zu Applications > Configuration > Config Packs.
- Klicken Sie auf der Seite Configurations auf Add.
- Wählen Sie Ihr gewünschtes Stylebook aus und klicken Sie auf Select.
- Klicken Sie auf der Seite Create Configuration auf Save as Draft.
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 in der Registerkarte Draft Configurations unter Pending Configurations gespeichert.
Wählen Sie auf der Registerkarte Draft Configurations das Konfigurationspaket aus, um die folgenden Operationen 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 Create a schedule for a config pack.
Zeitplan für ein Konfigurationspaket erstellen
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.
Gehen Sie wie folgt vor, um einen Zeitplan für ein Konfigurationspaket zu erstellen:
- Navigieren Sie zu Applications > Configuration > Config Packs.
- Klicken Sie auf der Seite Configurations auf Add.
- Wählen Sie das StyleBook aus und klicken Sie auf Select.
- Wählen Sie auf der Seite Create Configuration unter Execution die Option Later aus der Liste Execution Mode aus.
- Wählen Sie die gewünschte Uhrzeit und das Datum für die Planung aus und klicken Sie auf Submit.
Alle geplanten Konfigurationen werden in der Registerkarte Scheduled configurations unter Pending Configurations gespeichert. Sie können den erstellten Zeitplan auswählen, um die Konfigurationsparameter zu bearbeiten, bereitzustellen oder den Zeitplan abzubrechen.
Note:
Das Bereitstellen eines geplanten Konfigurationspakets bricht den Zeitplan ab und führt die Konfiguration sofort aus.
Für ein bereitgestelltes Konfigurationspaket
Sie können auch einen Zeitplan erstellen, um ein bereitgestelltes Konfigurationspaket zu bearbeiten und zu löschen.
Eine Bearbeitungsoperation für ein Konfigurationspaket planen
Gehen Sie wie folgt vor, um einen Zeitplan zum Bearbeiten des bereitgestellten Konfigurationspakets zu erstellen:
- Navigieren Sie zu Applications > Configuration > Config Packs.
- Wählen Sie auf der Seite Configurations ein StyleBook aus und klicken Sie auf Edit.
- Bearbeiten Sie auf der Seite Edit Configuration das Konfigurationspaket.
- Wählen Sie in der Liste Execution Mode die Option Later aus.
- Wählen Sie die gewünschte Uhrzeit und das Datum für die Planung aus und klicken Sie auf Submit.
Eine Löschoperation für ein Konfigurationspaket planen
Gehen Sie wie folgt vor, um einen Zeitplan zum Löschen des bereitgestellten Konfigurationspakets zu erstellen:
- Navigieren Sie zu Applications > Configuration > Config Packs.
- Wählen Sie auf der Seite Configurations ein StyleBook aus und klicken Sie auf Delete.
- Wählen Sie in der Liste Execution Mode die Option Later aus.
- Wählen Sie die gewünschte Uhrzeit und das Datum für die Planung aus und klicken Sie auf OK.
Eine Zielinstanz von einem Konfigurationspaket trennen
Gehen Sie wie folgt vor, um eine Zielinstanz von einem Konfigurationspaket zu trennen:
-
Navigieren Sie zu Applications > Configuration > Config Packs.
-
Wählen Sie das Konfigurationspaket mit einer Zielinstanz aus, die Sie entfernen möchten.
-
Wählen Sie unter Select Action die Option Detach Targets.
-
Wählen Sie im Bereich Detach Targets die Zielinstanz aus, die Sie aus dem Konfigurationspaket entfernen möchten.
-
Klicken Sie auf OK.
Eine Meldung wird angezeigt, die die Erstellung eines doppelten Konfigurationspakets bestätigt, wobei die Zielinstanz nun entfernt wurde.
Ihre StyleBooks erstellen
Der vollständige Inhalt des StyleBooks example-lb wird Ihnen 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 wird Ihnen als 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-->
In diesem Artikel
- Konfigurationspaket erstellen
- Außerhalb von StyleBooks erstellte Konfigurationen wiederverwenden und Konfigurationen zwischen ConfigPacks teilen
- StyleBook eines Konfigurationspakets ändern
- Konfigurationspakete exportieren oder importieren
- Konfigurationspaket als Entwurf speichern
- Zeitplan für ein Konfigurationspaket erstellen
- Eine Zielinstanz von einem Konfigurationspaket trennen
- Ihre StyleBooks erstellen