Verwenden von Variablen in Konfigurationsaufträgen

Ein Konfigurationsauftrag ist ein Satz von Konfigurationsbefehlen, die Sie auf einer oder mehreren verwalteten Instanzen ausführen können. Wenn Sie dieselbe Konfiguration auf mehreren Instanzen ausführen, sollten Sie für die in Ihrer Konfiguration verwendeten Parameter unterschiedliche Werte verwenden. Sie können Variablen definieren, mit denen Sie unterschiedliche Werte für diese Parameter zuweisen oder einen Job über mehrere Instanzen hinweg 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 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 auf die Werte, die Sie in eine Variable konvertieren möchten, und klicken Sie dann auf In Variable konvertieren. Wählen Sie beispielsweise die IP-Adresse der Load Balancing Server-IP-Adresseaus, und klicken Sie auf In Variable konvertieren(siehe Abbildung unten).

    lokalisiertes Bild

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

    lokalisiertes Bild

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

    lokalisiertes Bild

  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 Auftrag erstellen. 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 Variablenvorschau klicken, um die Variablen in einer einzigen konsolidierten Ansicht anzuzeigen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsauftrags definiert haben.

    lokalisiertes Bild

  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.

    lokalisiertes Bild

  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.

    lokalisiertes Bild

    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 ausgeführten Konfigurationsaufträ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 während der Bearbeitung 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 soll, wenn der Befehl fehlschlägt und Sie eine E-Mail-Benachrichtigung über den Erfolg oder Misserfolg des Auftrags zusammen mit anderen Details senden möchten.

    lokalisiertes Bild

Nachdem Sie Ihre Aufträge konfiguriert und ausgeführt haben, können Sie die Auftragsdetails anzeigen, indem Sie zu Netzwerke > 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 zu sehen, die Ihrem Job hinzugefügt wurden.

lokalisiertes Bild

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