Citrix Application Delivery Management-Service

Verwenden des SCP-Befehls (put) in Konfigurationsaufträgen

Sie können die Funktion “ Konfigurationsaufträge “ von Citrix Application Delivery Management (ADM) verwenden, um Konfigurationsjobs zu erstellen, E-Mail-Benachrichtigungen zu senden und Ausführungsprotokolle der erstellten Jobs zu überprüfen. Ein Auftrag ist eine Reihe von Konfigurationsbefehlen, die Sie auf einer einzelnen verwalteten Instanz oder auf mehreren verwalteten Instanzen erstellen und ausführen können. Beispielsweise können Sie Konfigurationsaufträge für Geräte-Upgrades verwenden.

Konfigurationsaufträge in Citrix ADM verwenden Secure Shell (SSH) -Befehle, um Instanzen zu konfigurieren, und Sie können einen Konfigurationsauftrag so konfigurieren, dass Secure Copy (SCP) verwendet wird, um Dateien sicher zu übertragen. SCP basiert auf dem SSH-Protokoll. Einer der SCP-Befehle, die Sie in einen Konfigurationsauftrag aufnehmen können, ist der Befehl put. Sie können den Befehl put in Konfigurationsaufträgen verwenden, um eine oder mehrere Dateien, die in einem lokalen Verzeichnis auf Ihrem System gespeichert sind, in Citrix ADM und dann in ein Verzeichnis auf der Citrix ADC-Instanz oder -Instanzen hochzuladen oder zu übertragen.

Hinweis

Die Datei wird in Citrix ADM hochgeladen und später in die ausgewählten Citrix ADC-Instanzen kopiert (abgelegt). Die hochgeladene Datei wird in Citrix ADM gespeichert und nur gelöscht, wenn der Auftrag gelöscht wird. Dies ist notwendig für Jobs, die später laufen sollen.

Der Befehl hat die folgende Syntax:

put <local_filename> <remote_path/remote_filename>
<!--NeedCopy-->

Hierbei gilt:

<local_filename> ist der Name der lokalen Datei, die hochgeladen werden soll.

<remote_path/ remote_filename> ist der Pfad zu einem entfernten Verzeichnis und der Name, der der Datei zugewiesen werden soll, wenn sie in dieses Verzeichnis kopiert wird.

Beim Erstellen des Konfigurationsauftrags können Sie die Parameter für lokale und remote Dateinamen in Variablen konvertieren. Auf diese Weise können Sie diesen Parametern bei jeder Ausführung des Auftrags verschiedene Dateien für denselben Satz von Citrix ADC-Instanzen zuweisen. Wenn Sie eine Datei an mehreren Stellen in einem Auftrag verwenden und die Datei umbenennen möchten, können Sie die Variable umdefinieren, anstatt den Dateinamen an allen Stellen zu ändern.

So verwenden Sie den Befehl put zum Hochladen von Dateien in einem Konfigurationsauftrag:

  1. Navigieren Sie in Citrix ADM zu Netzwerke > Konfigurationsaufträge.

  2. Klicken Sie auf der Seite Jobs auf Job erstellen.

  3. Geben Sie auf der Seite Job erstellen den Namen des Jobs in das Feld Jobname ein, und geben Sie im Konfigurationseditor den Befehl put ein.

    Wenn Sie beispielsweise einen Konfigurationsauftrag erstellen möchten, der eine auf Ihrem lokalen System gespeicherte SSL-Zertifikatsdatei auf mehrere Citrix ADC-Instanzen kopiert, können Sie einen “put” -Befehl hinzufügen, der eine Variable anstelle des Namens einer bestimmten Datei verwendet, und den Variablentyp als “Datei” definieren.

    put ssl-file /nsconfig/ssl-file
    <!--NeedCopy-->
    

    In diesem Beispiel wird

    • ssl-file - Dies ist der Name der Datei, die in die Citrix ADC-Instanz hochgeladen werden muss.
    • /nsconfig/ssl-file - es ist der Zielordner in der Instanz, in den der nach der Ausführung der Aufgabe abgelegt ssl-file wird.
  4. Wählen Sie in dem eingegebenen Befehl den Dateinamen aus, den Sie in eine Variable konvertieren möchten, und klicken Sie dann auf In Variable umwandeln, wie in der folgenden Abbildung dargestellt.

    In Variable umwandeln

  5. Stellen Sie sicher, dass der Dateiname von Dollarzeichen eingeschlossen wurde (was darauf hinweist, dass es sich jetzt um eine Variable handelt), und klicken Sie dann auf die Variable.

  6. Geben Sie die Details der Variablen an, wie Name, Anzeigename und Typ.

  7. Wählen Sie in der Dropdownliste Typ die Option Datei aus. Klicken Sie auf Save.

    Wenn Sie die Variable als Dateityp deklarieren, können Sie Dateien in Citrix ADM hochladen.

    Speichern Sie die Datei.

  8. Klicken Sie auf Weiter, und wählen Sie die Citrix ADC-Instanzen aus, in die die Dateien kopiert werden sollen.

  9. Wählen Sie auf der Registerkarte Variablenwerte angeben den Abschnitt Allgemeine Variablenwerte für alle Instanzen aus, wählen Sie die Datei aus dem lokalen Speicher auf Ihrem System aus, klicken Sie auf Hochladen, um die Datei in Citrix ADM hochzuladen, und klicken Sie auf Weiter.

    Datei in ADM hochladen

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

  11. Auf der Registerkarte Ausführen können Sie den 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. Sie können auch eine E-Mail-Benachrichtigung erstellen, um Benachrichtigungen über den Erfolg oder Misserfolg des Auftrags und andere Details zu erhalten. Klicken Sie auf Fertig stellen.

  12. Sie können die Auftragsdetails anzeigen, indem Sie zu Netzwerke > Konfigurationsaufträgenavigieren und den von Ihnen konfigurierten Job auswählen. Klicken Sie auf Details, und klicken Sie dann auf Variablendetails, um die Variablen aufzulisten, die Ihrem Auftrag hinzugefügt wurden.

    Überprüfen Sie variable Details

Verwenden des SCP-Befehls (put) in Konfigurationsaufträgen