Application Delivery Management

Variablen in Konfigurationsaufträgen verwenden

Ein Konfigurationsjob 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 unterschiedliche Werte für die in Ihrer Konfiguration verwendeten Parameter 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. 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:

füge lb vserver Servername HTTP IP-Adresse Portnummer hinzu

Dienstname 1 IP-Adresse1 HTTP 80 hinzufügen

Service Servicename2 IP-Adresse2 HTTP 80 hinzufügen

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 konvertieren. Wählen Sie beispielsweise die IP-Adresse ipaddress des Load Balancing-Servers aus und klicken Sie auf In Variable konvertieren, wie in der Abbildung unten gezeigt.

    Lokalisierte Abbildung

  5. Sobald Sie sehen, dass der Wert der Variablen von Dollarzeichen umgeben ist, 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.

    Lokalisierte Abbildung

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

    Lokalisierte Abbildung

  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 Variablen in der Vorschau anzeigen, um eine Vorschau der Variablen in einer einzigen konsolidierten Ansicht anzuzeigen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsauftrags definiert haben.

    Lokalisierte Abbildung

  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.

    Lokalisierte Abbildung

  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 NetScaler-Instanz angeben, die Sie zuvor ausgewählt haben, 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-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.

    Lokalisierte Abbildung

    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 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 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 Konfigurationsjobs anzuzeigen, während Sie einen Konfigurationsjob bearbeiten, navigieren Sie zu Netzwerk > Konfigurationsjobs, wählen Sie den Jobnamen 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 wählen, ob Sie Ihren Job jetzt ausführen möchten oder ob er zu einem späteren Zeitpunkt ausgeführt werden soll. Sie können auch auswählen, welche Aktion Citrix ADM ergreifen soll, wenn der Befehl fehlschlägt und ob Sie eine E-Mail-Benachrichtigung über den Erfolg oder Misserfolg des Jobs zusammen mit anderen Details senden möchten.

    Lokalisierte Abbildung

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

Lokalisierte Abbildung

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