Erstellen und Bearbeiten eines Konfigurationspakets

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.

Erstellen Sie ein Konfigurationspaket

Führen Sie die folgenden Schritte aus, um ein Konfigurationspaket aus einem StyleBook zu erstellen:

  1. Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.

  2. Klicken Sie auf und fügen Siehinzu.

  3. 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.

  4. Geben Sie die erforderlichen Details wie Anwendungsname, IP-Adresse, Port oder Protokolltyp an.

    Die GUI-Felder unterscheiden sich von einem StyleBook zum anderen.

  5. 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.

  1. Klicken Sie auf Trockenlauf.

    Auf der Seite „ Objekte “ werden die Objekte angezeigt, die in den NetScaler-Instanzen erstellt, geändert oder daraus entfernt werden.

  2. 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.

Verwenden Sie außerhalb von StyleBooks erstellte Konfigurationen erneut und teilen Sie Konfigurationen zwischen ConfigPacks

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:

  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 möchten, oder das Stylebook, das mit dem Konfigurationspaket verknüpft ist, das Sie bearbeiten.

  3. Klicken Sie unter „Aktion auswählen“ auf „Einstellungen konfigurieren“. Option „Einstellungen konfigurieren“

    Option „Stylebooks-Einstellungen konfigurieren“

  4. Passen Sie die Einstellungen an, indem Sie eine oder beide der folgenden Optionen auswählen:
  5. Klicken Sie auf OK.

Ändern Sie das 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 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:

  1. Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.

  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 StyleBook ändern.

  4. Wählen Sie das gewünschte StyleBook aus der Liste aus. Klicken Sie dann auf Auswahl speichern.

  5. 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.

    Ändern Sie das StyleBook eines Konfigurationspakets

    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:

    Beispiel für ein Lastenausgleichs-Konfigurationspaket

    Die Parameter, die auf der Konfigurationsseite für das neue example-lb-mon StyleBook angezeigt werden, sind wie folgt:

    Beispielparameter nach der Migration des Konfigurationspakets

    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.

  6. Überprüfen Sie in Zielinstanzendie ausgewählten Instanzen und aktualisieren Sie die Liste bei Bedarf.

  7. Klicken Sie auf Trockenlauf.

    Auf der Seite „ Objekte “ werden die Objekte angezeigt, die in den NetScaler-Instanzen erstellt, geändert oder daraus entfernt werden.

  8. 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.

Ändern Sie das StyleBook, das mehrere Konfigurationspakete enthält

Wenn Sie ein vorhandenes StyleBook mit mehreren Konfigurationspaketen ändern, gehen Sie wie folgt vor:

  1. 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.

  2. Ä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:

    Um den Fortschritt der ausgewählten Konfigurationspakete anzuzeigen, wählen Sie Konfigurationen in Bearbeitung/Fehlgeschlagen auf der Seite Konfigurationen .

  3. Entfernen Sie das alte StyleBook aus der NetScaler-Konsole, sobald alle Konfigurationspakete an das neue StyleBook gebunden sind.

Exportieren oder Importieren von Konfigurationspaketen

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.

Konfiguration exportieren

Gehen Sie wie folgt vor, um ein Konfigurationspaket zu exportieren:

  1. Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.

  2. Wählen Sie ein Konfigurationspaket aus, das Sie exportieren möchten.

  3. Wählen Sie in Aktion auswählenund dann Konfiguration exportierenaus.

    Konfigurationsoption exportieren

  4. Geben Sie im Bereich Exportkonfiguration Folgendes an:

    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 in eine andere NetScaler-Konsole importieren. Gehen Sie wie folgt vor, um ein Konfigurationspaket zu importieren:

  1. Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.

  2. Wählen Sie Konfiguration importierenaus.

  3. Wählen Sie das Importdateipaket von Ihrem Computer aus.

  4. Verwenden Sie die Passphrase, die Sie beim Export angegeben haben.

  5. 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.

  1. Klicken Sie auf Importieren.

Konfiguration importieren

Wenn Sie ein Konfigurationspaket importieren, überprüft die NetScaler-Konsole Folgendes:

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.

So speichern Sie ein Konfigurationspaket als Entwurf:

  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
  2. Klicken Sie auf der Seite Konfigurationen auf Hinzufügen.
  3. Wählen Sie Ihr gewünschtes Stylebook aus und klicken Sie auf . Wählen Sieaus.
  4. Klicken Sie auf der Seite Konfiguration erstellen auf Als Entwurf speichern.

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 Entwurfskonfigurationen unter Ausstehende Konfigurationengespeichert.

Wählen Sie auf der Registerkarte „ Entwurfskonfigurationen “ das Konfigurationspaket aus, um die folgenden Vorgänge auszuführen:

Entwurfskonfigurationen

Sie können auch planen, wann Ihre gespeicherten Entwürfe bereitgestellt werden sollen.

Weitere Informationen finden Sie unter Planen eines Konfigurationspakets.

Erstellen Sie einen Zeitplan für ein Konfigurationspaket

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:

  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
  2. Klicken Sie auf der Seite Konfigurationen auf Hinzufügen.
  3. Wählen Sie das StyleBook aus und klicken Sie auf . Wählen Sieaus.
  4. Wählen Sie auf der Seite Konfiguration erstellen unter Ausführungdie Option Später aus der Liste Ausführungsmodus aus.
  5. Wählen Sie die gewünschte Uhrzeit und das gewünschte Datum für die Planung aus und klicken Sie auf Senden.

Ausführungsmodus

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.

Geplante Konfiguration

Für ein bereitgestelltes Konfigurationspaket

Sie können auch einen Zeitplan zum Bearbeiten und Löschen eines bereitgestellten Konfigurationspakets erstellen.

Planen Sie einen Bearbeitungsvorgang für ein Konfigurationspaket

So erstellen Sie einen Zeitplan zum Bearbeiten des bereitgestellten Konfigurationspakets:

  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
  2. Wählen Sie auf der Seite Konfigurationen ein StyleBook aus und klicken Sie auf Bearbeiten.
  3. Bearbeiten Sie auf der Seite „ Konfiguration bearbeiten “ das Konfigurationspaket.
  4. Wählen Sie in der Liste Ausführungsmodus die Option Späteraus.
  5. Wählen Sie die gewünschte Uhrzeit und das gewünschte Datum für die Planung aus und klicken Sie auf Senden.

Planen Sie einen Löschvorgang für ein Konfigurationspaket

So erstellen Sie einen Zeitplan zum Löschen des bereitgestellten Konfigurationspakets:

  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
  2. Wählen Sie auf der Konfigurationsseiteein StyleBook aus und klicken Sie auf Löschen.
  3. Wählen Sie in der Liste Ausführungsmodus die Option Späteraus.
  4. Wählen Sie die gewünschte Uhrzeit und das gewünschte Datum für die Planung aus und klicken Sie auf Senden.

Trennen einer Zielinstanz von einem Konfigurationspaket

Um eine Zielinstanz von einem Konfigurationspaket zu trennen, gehen Sie wie folgt vor:

  1. Navigieren Sie zu Anwendungen > Konfiguration > Konfigurationspakete.

  2. Wählen Sie das Konfigurationspaket mit einer Zielinstanz aus, die Sie entfernen möchten.

  3. Wählen Sie in Aktion auswählen Ziele trennenaus.

  4. Wählen Sie im Bereich „ Ziele trennen “ 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 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-->