Verwenden von Variablen in Konfigurationsaufträgen

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>

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

  1. Navigieren Sie zu Infrastruktur > 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 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 Infrastruktur > Konfigurationsaufträge undwählen Sie Auftrag erstellenaus. 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 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 hochladenaus, 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 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.

    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 allgemeine Variablenwerte für alle Instanzen angeben und aufHochladenklicken, 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 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 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.

    Jobangebot planen

Nachdem Sie Ihre Jobs konfiguriert und ausgeführt haben, können Sie die Jobdetails anzeigen, indem Sie zu Infrastruktur > Konfigurationsaufträge navigieren und den Job auswählen, den Sie gerade konfiguriert haben. 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 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 Auftrag zu einem späteren Zeitpunkt ausgeführt wird.

Verwenden von Variablen in Konfigurationsaufträgen

In diesem Artikel