In der NetScaler-Konsole können Sie ein Konfigurationspaket aus einem StyleBook erstellen. Und das Konfigurationspaket ist an das StyleBook gebunden, aus dem es erstellt wurde. Die Aktualisierungen des Konfigurationspakets erfolgen über das StyleBook, an das es gebunden ist.
Führen Sie die folgenden Schritte aus, um ein Konfigurationspaket aus einem StyleBook zu erstellen:
Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.
Klicken Sie auf und fügen Siehinzu.
Wählen Sie in StyleBooks auswählendie gewünschten StyleBooks aus, aus denen Sie ein Konfigurationspaket erstellen möchten.
Auf dieser Seite werden StyleBooks in Standard- und benutzerdefinierte StyleBooks kategorisiert. Wählen Sie die entsprechenden Registerkarten aus, um die erforderlichen StyleBooks zu finden.
Geben Sie die erforderlichen Details wie Anwendungsname, IP-Adresse, Port oder Protokolltyp an.
Die GUI-Felder unterscheiden sich von einem StyleBook zum anderen.
Wählen Sie in ZielinstanzenInstanzen oder Instanzgruppen aus, auf denen Sie die Konfiguration ausführen möchten.
Notiz:
Sie können die Konfiguration auf mehr als einem NetScaler bereitstellen, indem Sie so viele Zielinstanzen wie nötig angeben.
Klicken Sie auf Trockenlauf.
Auf der Seite „ Objekte “ werden die Objekte angezeigt, die in den NetScaler-Instanzen erstellt, geändert oder daraus entfernt werden.
Klicken Sie auf Erstellen Sie
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.
Manchmal haben Sie möglicherweise NetScaler-Konfigurationen außerhalb von Stylebooks erstellt, sei es aufgrund besonderer Betriebsanforderungen oder älterer Setups. Sie können diese zuvor vorhandenen Konfigurationen jetzt als Teil von Stylebook-Konfigurationspaketen integrieren und verwalten, was eine flexiblere und zentralere Verwaltung ermöglicht.
Wenn NetScaler beispielsweise vor dieser Funktion bereits mit einem SSL-Profil konfiguriert war und der Config-Pack-Vorgang von StyleBook versuchte, ein SSL-Profil mit demselben Namen zu erstellen, wäre der Config-Pack-Vorgang mit dem Fehler „Ressource bereits vorhanden“ fehlgeschlagen. Wenn diese Funktion nun aktiviert ist, ist der Configpack-Vorgang erfolgreich und das vorhandene SSL-Profil mit demselben Namen kann im neuen Configpack wiederverwendet werden.
Ebenso können Sie mit Szenarien konfrontiert werden, in denen Ressourcen wie Netzwerkeinstellungen, Sicherheitsrichtlinien oder Teile von Anwendungskonfigurationen für mehrere Anwendungen oder Konfigurationen erforderlich sind. Mit dieser Funktion können Sie die Konfigurationen über mehrere Konfigurationspakete hinweg teilen.
Um diese Funktion zu aktivieren, führen Sie die folgenden Schritte aus:
Navigieren Sie zu Anwendungen > Konfiguration > Stylebooks.
Wählen Sie auf der Seite „Stylebooks“ das Stylebook aus, das Sie zum Erstellen eines neuen Konfigurationspakets verwenden möchten, oder das Stylebook, das mit dem Konfigurationspaket verknüpft ist, das Sie bearbeiten.
Klicken Sie unter „Aktion auswählen“ auf „Einstellungen konfigurieren“.
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 aus diesem StyleBook ein Konfigurationspaket CP1.
Wenn Sie Monitore mit der grundlegenden Load Balancer-Konfiguration konfigurieren möchten, benötigen Sie ein neues StyleBook. Erstellen Sie daher example-lb-mon StyleBook, das neben der grundlegenden Load Balancer-Konfiguration auch die Möglichkeit zum Konfigurieren von Monitoren bietet.
Nachdem Sie ein StyleBook erstellt haben, aktualisieren Sie das vorhandene Konfigurationspaket CP1, um einige Monitore hinzuzufügen. Gehen Sie hierzu wie folgt vor:
Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.
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 StyleBook ändern.
Wählen Sie das gewünschte StyleBook aus der Liste aus. Klicken Sie dann auf Auswahl speichern.
Klicken Sie auf und ändern Sie.
Wählen Sie in diesem Beispiel 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 Parameterwerte automatisch in ihren jeweiligen Feldern beibehalten. Ansonsten werden nur Parameter übertragen, die zwischen den beiden StyleBooks die gleiche Struktur aufweisen. Beispielsweise derselbe Parametername, Typ, übergeordneter Parameter und mehr.
Wenn im neuen StyleBook neue erforderliche Parameter hinzugefügt werden, müssen Sie nach der Änderung des StyleBooks die Werte für diese Parameter manuell angeben.
In diesem Beispiel lauten 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 example-lb-mon StyleBook angezeigt werden, sind wie folgt:
In diesem Fall behalten die StyleBooks die älteren Werte für die grundlegende Load Balancer-Konfiguration bei, da das neue StyleBook vorhandene Parameter nicht geändert hat. Und es werden nur die neuen Parameter hinzugefügt. Geben Sie für Monitorparameter die erforderlichen Werte manuell an.
Überprüfen Sie in Zielinstanzendie ausgewählten Instanzen und aktualisieren Sie die Liste bei Bedarf.
Klicken Sie auf Trockenlauf.
Auf der Seite „ Objekte “ werden die Objekte angezeigt, die in den NetScaler-Instanzen erstellt, geändert oder daraus entfernt werden.
Klicken Sie auf OK.
Auf der Seite „ StyleBook > Konfigurationen “ wird in der Spalte „ StyleBook-Name “ der neue StyleBook-Name für das ausgewählte Konfigurationspaket angezeigt. In diesem Fall wird example-lb-monangezeigt.
Wenn Sie ein vorhandenes StyleBook mit mehreren Konfigurationspaketen ändern, gehen Sie wie folgt vor:
Importieren Sie ein neues StyleBook in die NetScaler-Konsole.
Normalerweise hat das neue StyleBook denselben Namen und Namespace, jedoch eine höhere 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 StyleBook ändern nur auswählen, wenn die ausgewählten Konfigurationspakete mit demselben StyleBook verknüpft sind.
Für die ausgewählten Konfigurationspakete ändert die NetScaler-Konsole 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 Konfigurationen in Bearbeitung/Fehlgeschlagen auf der Seite Konfigurationen .
Entfernen Sie das alte StyleBook aus der NetScaler-Konsole, sobald alle Konfigurationspakete an das neue StyleBook gebunden sind.
Sie können ein Konfigurationspaket wie StyleBooks exportieren oder importieren. Mit dieser Funktion können Sie die StyleBook-Konfiguration problemlos mit einer anderen NetScaler-Konsole teilen. Wenn Sie ein Konfigurationspaket exportieren, wird ein tgz
- oder zip
-Paket auf Ihren lokalen Computer heruntergeladen. Dieses Paket enthält eine JSON-Datei mit allen in einem Konfigurationspaket definierten Parametern.
Gehen Sie wie folgt vor, um ein Konfigurationspaket zu exportieren:
Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.
Wählen Sie ein Konfigurationspaket aus, das Sie exportieren möchten.
Wählen Sie in Aktion auswählenund dann Konfiguration exportierenaus.
Geben Sie im Bereich Exportkonfiguration Folgendes an:
Informationen zu den Zielinstanzen, auf denen die Konfiguration bereitgestellt wird: Wählen Sie diese Option, um Informationen zu den Zielinstanzen in das Exportpaket aufzunehmen.
StyleBook verknüpft mit Konfiguration: Wählen Sie diese Option, um das StyleBook in das Exportpaket aufzunehmen.
Passphrase zum Schutz der Exportkonfigurationsdaten: Geben Sie eine Passphrase zum Verschlüsseln des Exportpakets an. Diese Passphrase sichert die sensiblen Daten eines Konfigurationspakets.
Dateityp komprimieren: Wählen Sie entweder den Dateityp ZIP oder TGZ .
Klicken Sie auf Exportieren.
Speichern Sie das Exportpaket auf Ihrem lokalen Computer.
Sie können ein Konfigurationspaket von Ihrem lokalen Computer in eine andere NetScaler-Konsole importieren. Gehen Sie wie folgt vor, um ein Konfigurationspaket zu importieren:
Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.
Wählen Sie Konfiguration importierenaus.
Wählen Sie das Importdateipaket von Ihrem Computer aus.
Verwenden Sie die Passphrase, die Sie beim Export angegeben haben.
Optional: Wählen Sie in den erweiterten Optionen aus. Erlauben Sie die Erstellung einer neuen Konfiguration nur, wenn alle Konfigurationsobjekte bereits auf NetScalervorhanden sind.
Diese Option ändert nicht die Objekte, die bereits auf der NetScaler-Instanz erstellt wurden.
Bedenken Sie, dass Sie dieselbe NetScaler-Instanz in zwei NetScaler-Konsolenservern hinzugefügt haben. Und Sie möchten ein Konfigurationspaket von einem NetScaler-Konsolenserver 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 Informationen zu den Zielinstanzen enthält. Siehe Exportkonfiguration.
Diese Option migriert die Konfiguration nur, wenn alle Objekte auf der Zielinstanz vorhanden sind.
Wenn Sie ein Konfigurationspaket importieren, überprüft die NetScaler-Konsole Folgendes:
Zugehöriges StyleBook: Wenn sich das zugehörige StyleBook nicht in der NetScaler-Konsole befindet, wird das StyleBook zusammen mit dem Konfigurationspaket importiert.
Zielinstanzen: Sucht nach Zielinstanzen und stellt die Konfiguration auf den angegebenen Zielinstanzen bereit. Wenn die genannten NetScaler-Instanzen in der NetScaler-Konsole fehlen, wird das Konfigurationspaket ohne Zielinstanzen importiert.
Quell-NetScaler-Konsole: Wenn Sie ein Konfigurationspaket auf demselben NetScaler-Konsolenserver importieren, aktualisiert das ausgewählte Paket das vorhandene Konfigurationspaket.
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.
So speichern Sie ein Konfigurationspaket als Entwurf:
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 Entwurfskonfigurationen unter Ausstehende Konfigurationengespeichert.
Wählen Sie auf der Registerkarte „ Entwurfskonfigurationen “ das Konfigurationspaket aus, um die folgenden Vorgänge auszuführen:
Sie können auch planen, wann Ihre gespeicherten Entwürfe bereitgestellt werden sollen.
Weitere Informationen finden Sie unter Planen eines Konfigurationspakets.
Wenn Sie ein Konfigurationspaket erstellen, wird das Konfigurationspaket standardmäßig automatisch auf einer NetScaler-Instanz bereitgestellt. Mit dieser Funktion können Sie planen, wann das Konfigurationspaket bereitgestellt werden soll.
So erstellen Sie einen Zeitplan für ein Konfigurationspaket:
Alle geplanten Konfigurationen werden auf der Registerkarte Geplante Konfigurationen unter Ausstehende Konfigurationengespeichert. Sie können den erstellten Zeitplan auswählen, um ihn zu bearbeiten, bereitzustellen oder abzubrechen.
Sie können auch einen Zeitplan zum Bearbeiten und Löschen eines bereitgestellten Konfigurationspakets erstellen.
So erstellen Sie einen Zeitplan zum Bearbeiten des bereitgestellten Konfigurationspakets:
So erstellen Sie einen Zeitplan zum Löschen des bereitgestellten Konfigurationspakets:
Um eine Zielinstanz von einem Konfigurationspaket zu trennen, gehen Sie wie folgt vor:
Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
Wählen Sie das Konfigurationspaket mit einer Zielinstanz aus, die Sie entfernen möchten.
Wählen Sie in Aktion auswählen Ziele trennenaus.
Wählen Sie im Bereich „ Ziele trennen “ 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.
Der vollständige Inhalt von example-lb StyleBook wird Ihnen wie folgt zu Ihrer Information bereitgestellt:
Name: example-lb
Namespace: examples.stylebooks
Version: "1.0"
Anzeigename: Basic Load Balancer App
Beschreibung: Dies ist ein Beispiel-StyleBook, das eine Load Balancer-Anwendung erstellt
Schemaversion: "1.0"
Import-Stylebooks:
-
Namespace: com.citrix.adc.stylebooks
Präfix: stlb
Version: "1.0"
Parameter-Standardquellen:
- stlb::lb
Komponenten:
-
Name: lb-comp
Typ: stlb::lb
Beschreibung: Verwendet das Standard-lb-StyleBook zum Erstellen der typischen lb-Konfigurationsobjekte
Eigenschaften-Standardquellen:
- $parameters
<!--NeedCopy-->
Der vollständige Inhalt von example-lb-mon StyleBook wird Ihnen wie folgt zu Ihrer Information bereitgestellt:
Name: example-lb-mon
Namespace: examples.stylebooks
Version: „1.0“
Beschreibung: Dies ist ein Beispiel-StyleBook, das eine Load Balancer-Anwendung mit Monitoren erstellt
Anzeigename: Einfache Load Balancer-App mit Monitoren
Schemaversion: „1.0“
Import-Stylebooks:
-
Namespace: netscaler.nitro.config
Präfix: ns
Version: „10.5“
-
Namespace: com.citrix.adc.stylebooks
Präfix: stlb
Version: „1.0“
-
Namespace: com.citrix.adc.commontypes
Präfix: cmtypes
Version: „1.0“
Parameter-Standardquellen:
- stlb::lb
Parameter:
-
Name: Monitore
Bezeichnung: „Liste der Monitore“
Beschreibung: „Liste der Monitore zur Überwachung von Anwendungsservern“
Typ: cmtypes::monitor[]
Ersetzungen:
mon-name(appname, monname): $appname + "-mon-" + $monname
Komponenten:
-
Name: lb-comp
Typ: stlb::lb
Beschreibung: Verwendet das Standard-lb-StyleBook zum Erstellen der typischen lb-Konfigurationsobjekte
Eigenschaften-Standardquellen:
- $parameters
-
Name: monitors-comp
Typ: cmtypes::monitor
Bedingung: $parameters.monitors
repeat: $parameters.monitors
repeat-item: mon
repeat-index: ndx
description: Erstellt eine Liste von NetScaler-Monitorobjekten und bindet sie an die Servicegruppe dieser LB-Konfiguration
properties-default-sources:
- $mon
properties:
monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
Komponenten:
-
Name: monitor-svcg-binding-comp
Bedingung: $parameters.svc-servers
Typ: ns::servicegroup_lbmonitor_binding
Eigenschaften:
Servicegruppenname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
Monitorname: $parent.properties.monitorname
<!--NeedCopy-->