Application Delivery Management

Variablen in Konfigurationsaufträgen verwenden

Ein Konfigurationsauftrag besteht aus einer Reihe von Konfigurationsbefehlen, die Sie auf einer oder mehreren verwalteten Instanzen ausführen können. Wenn Sie dieselbe Konfiguration auf mehreren Instanzen ausführen, möchten Sie möglicherweise andere Werte für die in Ihrer Konfiguration verwendeten Parameter verwenden. Sie können Variablen definieren, mit denen Sie verschiedene Werte für diese Parameter zuweisen oder einen Auftrag über mehrere Instanzen ausführen können.

Betrachten Sie beispielsweise eine grundlegende Lastausgleichskonfiguration, bei der Sie einen virtuellen Lastausgleichsserver hinzufügen, zwei Dienste hinzufügen und die Dienste an den virtuellen Server binden. Jetzt möchten Sie möglicherweise dieselbe Konfiguration auf zwei Instanzen haben, jedoch mit unterschiedlichen Werten für die Namen und IP-Adressen des virtuellen Servers und der Dienste. Sie können die Konfigurationsaufträge verwenden, um dies zu erreichen, indem Sie Variablen verwenden, um die Namen und IP-Adressen des virtuellen Servers und der Dienste zu definieren.

In diesem Beispiel werden die folgenden Befehle und Variablen verwendet:

add lb vserver <servername> HTTP <ipaddress> <portnumber>

add service <servicename1> <ipaddress1> HTTP 80

add service <servicename2> <ipaddress2> HTTP 80

bind lb vserver <servername> <servicename1>

bind lb vserver <servername> <servicename2>

So erstellen Sie einen Konfigurationsauftrag durch Definieren von Variablen in NetScaler ADM:

  1. Navigieren Sie zu Netzwerke > Konfigurationsaufträge.

  2. Klicken Sie auf Job erstellen.

  3. Wählen Sie auf der Seite Job erstellen die benutzerdefinierten Job-Parameter wie den Namen des Jobs, den Instanztyp und den Konfigurationstyp aus.

  4. Geben Sie im Konfigurationseditor die Befehle ein, um einen virtuellen Lastausgleichsserver, zwei Dienste hinzuzufügen und die Dienste an den virtuellen Server zu binden. Doppelklicken Sie, um die Werte auszuwählen, die Sie in eine Variable konvertieren möchten, und klicken Sie dann auf In Variable umwandeln. Wählen Sie beispielsweise die IP-Adresse des Load Balancing-Servers aus und klicken Sie auf In Variable umwandeln *ipaddress*, wie in der folgenden Abbildung gezeigt.

    In Variable umwandeln

  5. Wenn Sie sehen, dass Dollarzeichen den Wert der Variablen einschließen, klicken Sie auf die Variable, um die Details der Variablen wie Name, Anzeigename und Typ anzugeben. Sie können auch auf die Option Erweitert klicken, wenn Sie einen Standardwert für Ihre Variable weiter angeben möchten. Klicken Sie auf Speichern, und klicken Sie dann auf Weiter.

    Definieren Sie Variablen 1

    Geben Sie die restlichen Befehle ein und definieren Sie alle Variablen.

    Definieren Sie Variablen 2

  6. Sie können alle Variablen überprüfen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsauftrags in einer einzigen konsolidierten Ansicht definiert haben.

  7. Führen Sie einen der folgenden Schritte aus, um alle Variablen in einer einzigen konsolidierten Ansicht anzuzeigen:

    • Navigieren Sie beim Erstellen eines Konfigurationsauftrags zu Netzwerke > Konfigurationsaufträge und wählen Sie Job erstellen aus. Auf der Seite Job erstellen können Sie alle Variablen überprüfen, die Sie beim Erstellen des Konfigurationsauftrags hinzugefügt haben.

    • Während Sie einen Konfigurationsauftrag bearbeiten, navigieren Sie zu Netzwerk > Konfigurationsjobs, wählen Sie den Job-Namen aus und klicken Sie auf Bearbeiten. Auf der Seite Job konfigurieren können Sie alle Variablen überprüfen, die beim Erstellen des Konfigurationsauftrags hinzugefügt wurden.

  8. Sie können dann auf die Registerkarte Vorschauvariablen klicken, um eine Vorschau der Variablen in einer einzelnen konsolidierten Ansicht anzuzeigen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsauftrags definiert haben.

    Vorschau der Variablen 1

  9. Ein neues Popup-Fenster wird angezeigt, in dem alle Parameter von Variablen wie Name, Anzeigename, Typ und Standardwert in einem tabellarischen Format angezeigt werden. Sie können diese Parameter auch bearbeiten und ändern. Klicken Sie auf die Schaltfläche Fertig, nachdem Sie einen der Parameter bearbeitet oder geändert haben.

    Vorschau der Variablen 2

  10. Anschließend können Sie die Befehle im Konfigurationseditor neu anordnen und neu anordnen. Sie können den Befehl von einer Zeile in eine andere verschieben, indem Sie die Befehlszeile ziehen und dort ablegen. Sie können die Befehlszeile auch von einer Zeile zu einer beliebigen Zielzeile verschieben oder neu anordnen, indem Sie einfach die Befehlszeilennummer im Textfeld ändern.

  11. Wählen Sie die Instanzen aus, auf denen Sie den Konfigurationsauftrag ausführen möchten.

  12. Wählen Sie auf der Registerkarte Variablenwerte angeben die Option Eingabedatei für Variablenwerte hochladen aus und klicken Sie dann auf Eingabeschlüsseldatei herunterladen. In unserem Beispiel müssen Sie den Servernamen auf jeder Instanz, die IP-Adressen des Servers und der Dienste, Portnummern und Dienstnamen angeben. Speichern Sie die Datei und laden Sie sie hoch. Wenn Ihre Werte nicht genau definiert sind, kann das System einen Fehler auslösen.

  13. Die Eingabeschlüsseldatei wird auf Ihr lokales System heruntergeladen und Sie können sie bearbeiten, indem Sie die Variablenwerte für jede zuvor ausgewählte Citrix ADC-Instanz angeben und auf Hochladen klicken, um die Eingabeschlüsseldatei auf Citrix ADM hochzuladen. Klicken Sie auf Weiter. Die Eingabeschlüsseldatei wird in Ihr lokales System heruntergeladen und Sie können sie bearbeiten, indem Sie die Variablenwerte für jede zuvor ausgewählte NetScaler ADC-Instanz angeben.

    Hinweis In der Eingabeschlüsseldatei werden die Variablen auf drei Ebenen definiert:

    • Globales Niveau
    • Instanzgruppen-Ebene
    • Instanz-Ebene

    Globale Variablen sind Variablenwerte, die auf alle Instanzen angewendet werden. Variablenwerte auf Instanzgruppenebene werden auf alle Instanzen angewendet, die in einer Gruppe definiert sind. Variablenwerte auf Instanzebene werden nur auf eine bestimmte Instanz angewendet.

    NetScaler ADM räumt Werten auf Instanzebene erste Priorität ein. Wenn für die Variablen für einzelne Instanzen keine Werte bereitgestellt werden, verwendet NetScaler ADM den auf Gruppenebene bereitgestellten Wert. Wenn auf Gruppenebene keine Werte bereitgestellt werden, verwendet NetScaler ADM den auf globaler Ebene bereitgestellten Variablenwert. Wenn Sie eine Eingabe für eine Variable über alle drei Ebenen hinweg bereitstellen, verwendet NetScaler ADM den Wert der Instanzebene als Standardwert.

  14. Klicken Sie auf Hochladen, um die Eingabeschlüsseldatei auf Citrix ADM hochzuladen. Klicken Sie auf Weiter.

    Schlüsseldatei hochladen

    Wichtig!

    Wenn Sie eine CSV-Datei von einem Mac hochladen, speichert der Mac die CSV-Datei mit Semikolons anstelle von Kommas. Dies führt dazu, dass die Konfiguration fehlschlägt, wenn Sie die Eingabedatei hochladen und den Auftrag ausführen. Wenn Sie einen Mac verwenden, verwenden Sie einen Texteditor, um die erforderlichen Änderungen vorzunehmen und dann die Datei hochzuladen.

  15. Sie können auch gemeinsame Variablenwerte für alle Instanzen angeben und auf Hochladen klicken, um die Eingabeschlüsseldatei auf Citrix ADM hochzuladen.

    Die wichtigsten Eingabedateien, die die Variablenwerte enthalten, werden in den Konfigurationsjobs beibehalten (mit demselben Dateinamen). Sie können diese Eingabedateien anzeigen und bearbeiten, die Sie früher beim Erstellen oder Bearbeiten der Konfigurationsaufträge verwendet und hochgeladen haben.

    Um die Ausführungskonfigurationsaufträge beim Erstellen eines Konfigurationsauftrags anzuzeigen, navigieren Sie zu Netzwerk > Konfigurationsaufträge, und klicken Sie auf Job erstellen. Auf der Seite Job erstellen. Wählen Sie auf der Registerkarte Variablenwerte angeben die Option Gemeinsame Variablenwerte für alle Instanzen aus, um die hochgeladenen Dateien anzuzeigen. Um die Eingabedateien zu bearbeiten, laden Sie die Eingabedatei herunter und bearbeiten und laden Sie die Dateien hoch (unter gleichem Dateinamen).

    Um die bereits ausgeführten Konfigurationsaufträge beim Bearbeiten eines Konfigurationsauftrags anzuzeigen, navigieren Sie zu Netzwerk > Konfigurationsaufträge, wählen Sie den Auftragsnamen aus und klicken Sie auf Bearbeiten. Wählen Sie auf der Seite Job konfigurieren auf der Registerkarte Variablenwerte angeben die Option Gemeinsame Variablenwerte für alle Instanzen aus, um die hochgeladenen Dateien anzuzeigen. Um die Eingabedateien zu bearbeiten, laden Sie die Eingabedatei herunter und bearbeiten und laden Sie die Dateien hoch (unter gleichem Dateinamen).

  16. Auf der Registerkarte Auftragsvorschau können Sie die Befehle auswerten und überprüfen, die für jede Instanz oder Instanzgruppe ausgeführt werden sollen.

  17. Auf der Registerkarte “ Ausführen “ können Sie Ihren Job jetzt ausführen oder planen, dass er zu einem späteren Zeitpunkt ausgeführt wird. Sie können auch auswählen, welche Aktion NetScaler ADM ausführen muss, wenn der Befehl fehlschlägt und Sie eine E-Mail-Benachrichtigung über den Erfolg oder Misserfolg des Jobs zusammen mit anderen Details senden möchten.

    Jobangebot planen

Nachdem Sie Ihre Jobs konfiguriert und ausgeführt haben, können Sie die Auftragsdetails anzeigen, indem Sie zu Netzwerke > Konfigurationsaufträge navigieren und den gerade konfigurierten Job auswählen. Klicken Sie auf Details und dann auf Variablendetails, um die Liste der Variablen anzuzeigen, die Ihrem Job hinzugefügt wurden.

Liste der Variablen

Hinweis

Die Werte, die Sie in SCHRITT 5 für die Variablen angegeben haben, werden von Citrix ADM beibehalten, wenn Sie den Job speichern und beenden oder wenn Sie einen Job für die Ausführung zu einem späteren Zeitpunkt planen.

Variablen in Konfigurationsaufträgen verwenden

In diesem Artikel