Citrix Application Delivery Management-Service

Verwenden von Variablen in Konfigurationsaufträgen

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. Nun möchten Sie möglicherweise dieselbe Konfiguration auf zwei Instanzen haben, aber mit unterschiedlichen Werten für die Namen des virtuellen Servers und der Dienste und IP-Adressen. Sie können die Konfigurationsaufträge Funktion 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\*\*
<!--NeedCopy-->

So erstellen Sie einen Konfigurationsauftrag durch Definieren von Variablen in Citrix 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 Jobparameter aus, z. B. den Namen des Jobs, den Instanztyp und den Konfigurationstyp.

  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 konvertieren ipaddress, wie in der Abbildung unten 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.

    Angabe von Variablen

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

    Definieren von Variablen

  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ägeund wählen Sie Job erstellenaus. Auf der Seite Job erstellen können Sie alle Variablen überprüfen, die Sie beim Erstellen des Konfigurationsauftrags hinzugefügt haben.
    • Navigieren Sie beim Bearbeiten eines Konfigurationsauftrags zu Netzwerk > Konfigurationsaufträge, wählen Sie den Auftragsnamen 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.

    Variable Vorschau

  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.

    Bestätigen der variablen

  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 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 für jede Instanz, die IP-Adressen des Servers und der Dienste, die Portnummern und die 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 in Citrix Application Delivery Management (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 Citrix ADC-Instanz angeben.

    Hinweis

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

       -  Globale Ebene
    
    • Instanzgruppenebene
    • Instanzebene

    Globale Variablen sind Variablenwerte, die über alle Instanzen hinweg 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.

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

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

    Eingabetaste hochladen

    Wichtig

    Wenn Sie eine CSV-Datei von einem Mac hochladen, speichert Mac die CSV-Datei mit Semikolons statt 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 in Citrix ADM hochzuladen.

    Die Schlüsseleingabedateien, die die Variablenwerte enthalten, werden in den Konfigurationsaufträgen 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 Run Configuration Jobs beim Erstellen eines Konfigurationsauftrags anzuzeigen, navigieren Sie zu Netzwerk > Konfigurationsjobsund 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 anzuzeigen, während Sie einen Konfigurationsauftrag bearbeiten, navigieren Sie zu Netzwerk > Konfigurationsjobs, wählen Sie den Job-Namen 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 später ausgeführt wird. Sie können auch auswählen, welche Aktion Citrix 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.

    Führen Sie den Konfigurationsauftrag aus

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

Überprüfen Sie die zu Ihrem Job hinzugefügten Variablen

Hinweis

Die Werte, die Sie für die Variablen in Schritt 5 angegeben haben, werden von Citrix ADM beibehalten, wenn Sie den Auftrag speichern und beenden oder wenn Sie planen, dass ein Job zu einem späteren Zeitpunkt ausgeführt wird.

Verwenden von Variablen in Konfigurationsaufträgen