FTP. Agent Guide. Version: Datum: 2015/09. Automic Software GmbH

Transkript

1 FTP Agent Guide Version: Datum: 2015/09 Automic Software GmbH Automic Software GmbH

2 ii Copyright Copyright Die Marke Automic und das Automic-Logo sind Warenzeichen der Automic Software GmbH (Automic). Die Nutzung sämtlicher Warenzeichen bedarf der ausdrücklichen schriftlichen Genehmigung und unterliegt den Lizenzbedingungen. Die Software/das Computerprogramm sind geschütztes Eigentum der Firma Automic. Zugang und Nutzung vorbehaltlich der geprüften schriftlichen Lizenzbedingungen. Die Software/das Computerprogramm ist weiters durch internationale Verträge sowie nationale und internationale Gesetze urheberrechtlich geschützt. Unbefugter Zugang bzw. Nutzung werden zivil- und strafrechtlich verfolgt. Unbefugtes Kopieren und andere Formen der auszugsweisen oder vollständigen Reproduktion, Dekompilierung, Nachbau, Änderung oder die Entwicklung von aus der Software abgeleiteten Produkten sind strengstens verboten. Die Nichtbeachtung wird strafrechtlich verfolgt. Alle Angaben ohne Gewähr. Änderungen, Irrtümer, Satz- und Druckfehler vorbehalten. Nachdruck auch in Auszügen ist untersagt. Copyright Automic Software GmbH. Alle Rechte vorbehalten.

3 FTP Agent Guide iii Contents 1 Der Rapid Automation FTP-Agent Einführung zum Rapid Automation FTP-Agenten Architektur des RA FTP-Agenten Zusammenhänge von Agenten und Connection-Objekten Informationen zu Rapid Automation-Agenten Speicherort der Hilfedateien und Format des Agenten-Handbuchs 7 2 Konfigurieren des FTP-Agenten Einführung in die Konfiguration des FTP-Agenten Installation des RA-Agenten in einem vorhandenen Automation Engine-System Laden von Rapid Automation Component-JAR-Dateien in Applications Manager Definieren der Timeout-Sekunden zwischen Automation Engine und Agenten Bevor Sie FTP-Jobs aktualisieren: Aktualisieren des Work Process (WP)-Objekt-Cache Jobs aus einer früheren Version des FTP-Agenten aktualisieren FTP Connection-Objekte für FTP-Server erstellen SFTP-Schlüsselauthentifizierung unter UNIX Einrichten von SSL SOCKS-Proxyserver verwenden FTP-Proxyserver verwenden 41 3 Arbeiten mit FTP-Jobs Einführung in FTP-Jobs Verwenden der Dateibrowser von FTP-Jobs Beispiel: Kopieren von Dateien zwischen einem lokalen Dateisystem und einem entfernten FTP-Server Beispiel: Dateien zwischen zwei entfernten FTP-Servern transferieren Hinzufügen, Verschieben, Bearbeiten und Löschen von Befehlen in Befehlssequenzen Einstellungen für den Befehl "Datei(en) kopieren" Einstellungen für den Befehl "Verzeichnis anlegen" Einstellungen für den Befehl "Löschen" Einstellungen für den Befehl "Umbenennen" Einstellungen für den Befehl "Verzeichnisinhalt auflisten" Einstellungen für den Befehl "Verzeichnis wechseln" Einstellungen für die Befehle "Wenn fehlgeschlagen" und "Wenn erfolgreich" 64

4 iv Contents Einstellungen für die FTP Kommandozeile Einstellungen für den Befehl "Log Ausgabe" Einstellungen für den Befehl "Entfernte Ausführung" Bearbeiten von Jobeinstellungen Überschreiben von Connection-Objektattributen auf der Registerkarte "Pre-Script" RA FTP Job-Attribute Beispiel: Verwenden von AE-Variablen in FTP-Jobs Verwaltung von Ausgabe- und Ausführungsoptionen mit dem RA-Tab Einrichten des Traces Debugging-Einstellungen in Applications Manager 89

5 FTP Agent Guide 1 1 Der Rapid Automation FTP-Agent 1.1 Einführung zum Rapid Automation FTP- Agenten Der Rapid Automation (RA) FTP-Agent wurde für den Einsatz mit der Automation Engine v9/v10/v11 und dem Applications Manager v9.0 entwickelt. Er verfügt über spezielle Panels für Connection-Objekte und Jobs. Der Rapid Automation FTP-Agent enthält spezielle Panels für Connection-Objekte und Jobs. Er kann in Verbindung mit der Automation Engine v9/v10/v11 und dem Applications Manager v9.0 verwendet werden. Das FTP-Protokoll Das File Transfer Protocol (FTP) ist ein Standard-Netzwerkprotokoll, welches das Kopieren von Dateien von einem System auf ein anderes über TCP-Netzwerke wie das Internet ermöglicht. Dieses Dokument enthält keine Beschreibung des FTP-Protokolls, sondern beschreibt lediglich die FTP-Agenten-Lösung. Der RA FTP-Agent ist kein Server für Dateiübertragungen, sondern agiert als FTP Mandant. Die FTP- Spezifikationen finden Sie im RFC 959 auf der Website der Internet Engineering Task Force (IETF) unter Rapid Automation-Panels Integrationen von Rapid Automation-Agenten wie FTP sind gleichermaßen unter Automation Engine v9/v10/v11 und Applications Manager v9.0 vorhanden. Die Funktionalität der Panels ist auf beiden Automatisierungsplattformen identisch. In diesem Handbuch wird die Verwendung der einzelnen Panels, nicht die Verwendung der Automatisierungsplattformen beschrieben. In den jeweiligen Abschnitten zur Erstellung von Connection-Objekten, Agenten, Jobs usw. werden daher die Rapid Automation-Panels, nicht jedoch die Objekterstellung selbst beschrieben.

6 2 Chapter 1 Der Rapid Automation FTP-Agent 1.2 Architektur des RA FTP-Agenten Das unten abgebildete Architekturschema zeigt einen FTP-Agenten innerhalb eines definierten AE- Systems. In Abbildung A ist ein beispielhaftes Architekturschema dargestellt. Das Schema enthält einen Host, auf dem ein FTP-Agent installiert ist, und zwei Hosts, auf denen keine Agenten installiert sind. Wenn Sie per FTP Dateien von und zu den Hosts übertragen möchten, auf denen kein FTP-Agent installiert ist, müssen Sie Connection-Objekte für diese Hosts definieren. Beispielhaftes Architekturschema für einen RA FTP-Agenten Connection-Objekte werden über die Benutzeroberfläche der Automation Engine (AE) erstellt und in der Datenbank gespeichert, welche die AE-Objekte enthält. Beachten Sie, dass sich zwischen dem Host mit dem RA FTP-Agenten und den anderen Hosts ein Proxyserver befindet. Informationen zur Konfiguration der Proxyservereinstellungen für den Zugriff auf FTP-Server finden Sie im Abschnitt FTP Connection-Objekte für FTP-Server erstellen.

7 1.3 Zusammenhänge von Agenten und Connection-Objekten FTP Agent Guide 3 Im folgenden Abschnitt werden verschiedene FTP-Szenarien mit Agenten und/oder Connection-Objekten für jeden Host beschrieben. Um mit Hosts zu kommunizieren, müssen folgende Voraussetzungen erfüllt sein: Kommunikation zwischen: Dem lokalen Dateisystem und einem FTP-Server Zwei FTP-Servern Voraussetzung: Ein FTP-Agent, der für das lokale Dateisystem definiert wurde, und ein FTP Connection-Objekt, das für den entfernten Host definiert wurde. Ein FTP-Agent sowie für beide entfernten Hosts definierte Connection- Objekte. Kommunikation zwischen dem lokalen Dateisystem und einem FTP- Server Wenn auf einem Host ein FTP-Agent installiert ist, können Sie von diesem mit einem entfernten Host kommunizieren, indem Sie ein Connection-Objekt definieren. Ein Beispieldiagramm ist in Abbildung A dargestellt Ein Host mit einem Agenten und ein zweiter mit einem Connection-Objekt Beachten Sie, dass Sie ebenfalls ein Connection-Objekt für den entfernten Host definieren müssen, wenn Sie eine Verbindung zwischen zwei Hosts aufbauen, für die Sie auch FTP-Agenten definiert haben. Ein Beispiel für diese Konfiguration finden Sie im Abschnitt Beispiel: Kopieren von Dateien zwischen einem lokalen Dateisystem und einem entfernten FTP-Server. Dateien zwischen zwei FTP-Servern transferieren Um mit zwei entfernten Hosts mit installiertem FTP-Server zu kommunizieren, werden zwei Connection- Objekte verwendet. In diesem Fall führt der FTP-Agent die Befehle auf beiden Hosts aus. Dieses Szenario empfiehlt sich, wenn Sie auf keinem der Hosts, mit denen Sie kommunizieren, einen Agenten installieren können oder möchten. Bei diesem Szenario wird für die meisten Befehle, die Sie in einem Job definiert haben, auf beiden Hosts ein Befehl ausgeführt. Ein Beispieldiagramm ist in Abbildung B dargestellt.

8 4 Chapter 1 Der Rapid Automation FTP-Agent Der Agent führt die Befehle auf beiden Hosts aus. Ein Beispiel für diese Konfiguration finden Sie im Abschnitt Beispiel: Dateien zwischen zwei entfernten FTP-Servern transferieren.

9 FTP Agent Guide Informationen zu Rapid Automation-Agenten Nachdem Sie eine Rapid Automation-JAR-Datei in der Automation Engine geladen haben, können Sie für den jeweiligen Agenten Verbindungs-, Agenten- und Job-Objekte mit spezifischen Fenstern festlegen. Nachdem Sie eine Rapid Automation-JAR-Datei in der Automation Engine geladen haben, können Sie für den jeweiligen RA-Agenten Verbindungs-, Agenten- und Job-Objekte mit spezifischen Fenstern festlegen. In den Handbüchern zu den Rapid Automation Agenten wird die Verwendung dieser RA-Fenster erläutert, nicht jedoch die Definition von Connection-, Agenten- und Job-Objekten. Informationen zum Erstellen dieser Objekte finden Sie in der Hilfe zur Automation Engine. Verwendung von Objektvariablen in den Feldern Objektvariablen im Format &<variable name> können in den meisten Feldern der Rapid Automation- Fenster verwendet werden. Die Werte dieser Objektvariablen werden zur Laufzeit ersetzt. Einstellungen in der Registerkarte bestimmter RA-Agenten außer Kraft setzen Sie können die Einstellungen in der Registerkarte bestimmter RA-Agenten überschreiben (erfordert Automation Engine v9 Service-Pack 4 oder höher). Die Einstellungen können für folgende Vorgänge außer Kraft gesetzt werden: Die einmalige Ausführung eines Rapid Automation-Jobs. Diese Option kann nur für Jobs aktiviert werden, wenn in der Registerkarte RA der Job-Definition die Option Taskparameter abfragen aktiviert ist. Weitere Informationen finden Sie unter Verwaltung von Ausgabe- und Ausführungsoptionen mit dem RA-Tab. Rapid Automation-Jobs, die einem Workflow (vor der Automation Engine v9 Service-Pack 4 auch als AblaufPlan bezeichnet ) als Aufgaben hinzugefügt werden. Weitere Informationen zum Bearbeiten von Workflow-Aufgaben finden Sie in der Hilfe zur Automation Engine. Den einmaligen Durchlauf einer gegenwärtig nicht aktiven Aufgabe im Fenster Aktivitäten durch Rechtsklick und Auswahl der Option Parameter. Suche nach: Eingabe: Beispiel: Could return: Text mit best. Anfangszeichenfolge Platzhalter für einzelnes Zeichen Platzhalter für mehrere Zeichen Text mit best. Endzeichenfolge Kombination von Suchkriterien <Text> oder ^<Text> ^f fan, fast, or fun <optionaler Text>.<optionaler Text> f.n fan or fun <optionaler Text>.*<optionaler Text> oder <optionaler Text>%<optionaler Text> c.*t cat or carrot %<Text>$ oder.*<text>$ %x$ mix, max, suffix <Suche> <Suche>.an ^f can, fan, fast, fun, or man

10 6 Chapter 1 Der Rapid Automation FTP-Agent Zuordnen von Programmen und Optionen Falls erforderlich, können Sie mithilfe von Fenstern wie dem unten abgebildeten Programme und Optionen zuordnen. Zuordnen von Programmen und Optionen bzw. Aufheben der Zuordnung mithilfe eines Doppelklicks oder der Pfeiltasten Die Zuordnung von Programmen und Optionen erfolgt durch das Verschieben aus dem Bereich Nicht zugeordnet in den Bereich Zugeordnet. Die folgende Tabelle erläutert, wie mehrere Optionen auf einmal zugeordnet werden. Ziel: Den ausgewählten Wert zwischen den beiden Bereichen verschieben Alle Werte zwischen den beiden Bereichen verschieben Mehrere aufeinander folgende Werte auswählen Mehrere nicht aufeinander folgende Werte auswählen Vorgehensweise: Doppelklicken Sie auf den Wert. oder Markieren Sie den Wert, und klicken Sie auf die Schaltfläche mit dem einzelnen Pfeil. Klicken Sie auf die Schaltfläche mit dem Doppelpfeil. Drücken und halten Sie die Umschalttaste, und klicken Sie dann auf den ersten und den letzten Wert. Drücken und halten Sie die STRG-Taste, und klicken Sie dann jeden einzelnen Wert an.

11 FTP Agent Guide Speicherort der Hilfedateien und Format des Agenten-Handbuchs Die Hilfedateien für alle Rapid Automation-Agenten liegen als JavaHelp-Projekte vor. Diese Hilfedateien werden bei der Aktualisierung des jeweiligen Agenten auf den neuesten Stand gebracht, nicht bei der Aktualisierung der Automation Engine. Daher bilden sie ein eigenständiges JavaHelp-Projekt. Sie können die Hilfe für den Rapid Automation-Agenten öffnen, indem Sie auf die Hilfeschaltfläche klicken, die sich unten auf dem Tab des jeweiligen Agenten Ihres Agenten- oder Job- Objekts befindet. Format des Agenten-Handbuchs Dieses Agenten-Handbuch ist in verschiedene Themenbereiche gegliedert. Jeder Abschnitt wird durch eine Überschrift und eine kurze Zusammenfassung eingeleitet. Die Zusammenfassung enthält die wichtigsten Konzepte, die in dem jeweiligen Abschnitt erläutert werden. Sie können sich einen schnellen Überblick über ein Kapitel verschaffen, indem Sie die Zusammenfassung lesen und die Abbildungen samt ihrer Bildunterschriften überfliegen.

12 8 Chapter 2 Konfigurieren des FTP-Agenten 2 Konfigurieren des FTP-Agenten 2.1 Einführung in die Konfiguration des FTP- Agenten Im Folgenden werden die Schritte zur Konfiguration des Rapid Automation FTP-Agenten beschrieben. Die Konfiguration des Rapid Automation FTP-Agenten umfasst folgende Schritte: 1. Laden der FTP-JAR-Datei in die Automation Engine. 2. Erstellen von FTP Connection-Objekten für die Hosts, zu oder von denen Sie Dateien übertragen möchten. 3. Einrichten der SFTP-Schlüsselauthentifizierung (optional) 4. Einrichten von SSL (optional) 5. Konfigurieren der Verbindung über einen SOCKS-Proxyserver (optional) 6. Optionales Konfigurieren einer Verbindung über einen FTP-Proxyserver 7. Erstellen von FTP-Jobs Rapid Automation Agenten-Objekte erstellen und konfigurieren Erstellen Sie ein oder mehrere FTPAGENT Rapid Automation Agent-Objekte. Beim Definieren von FTP- Jobs kann der Server, auf dem sich der FTP-Agent befindet, eine der folgenden Rollen einnehmen: Quellhost: Der Host, von dem aus Dateien übertragen werden. Zielhost: Der Host, auf den die Dateien übertragen werden. Vermittler: Ein Vermittler der weder Quell- noch Zielhost ist. FTP-Agenten verfügen über die Registerkarte Ftp, auf der Benutzer mit den entsprechenden Zugriffsrechten folgende Aufgaben ausführen können: Die Entfernte Ausführung von Befehlen für FTP-Jobs aktivieren, indem sie das Kontrollkästchen entfernte Ausführung von Kommandos zulassen auf der in Abbildung A dargestellten Unterregisterkarte Einstellungen aktivieren. Mithilfe der Funktion Entfernte Ausführung von Kommandos zulassen können Sie Befehle auf dem entfernten System ausführen. Unterstützt wird dies allerdings nur für SSH zu UNIX- Systemen. Für Windows und Telnet ist dies generell nicht möglich! Aus Sicherheitsgründen ist das Kontrollkästchen entfernte Ausführung von Kommandos zulassen standardmäßig deaktiviert. Wenn das Kontrollkästchen entfernte Ausführung von Kommandos zulassen deaktiviert ist, können Benutzer zwar Befehle für die Entfernte Ausführung zu FTP-Jobs hinzufügen, diese schlagen jedoch bei der Ausführung des Jobs fehl. Ist das Kontrollkästchen entfernte Ausführung von Kommandos zulassen hingegen aktiviert, werden FTP-Jobs mit Befehlen für die Entfernte Ausführung normal ausgeführt. Weitere Informationen zur Funktion Entfernte Ausführung von Befehlen finden Sie im Abschnitt Einstellungen für den Befehl "Entfernte Ausführung". Aktualisieren Sie FTP-Jobs von früheren Versionen des Rapid Automation FTP-Agenten, indem sie auf die Registerkarte Job Konvertierung klicken und den Anweisungen des Assistenten folgen. Weitere Informationen zum Aktualisieren von Jobs aus früheren Versionen des Rapid Automation FTP-Agenten finden Sie im Abschnitt Jobs aus einer früheren Version des FTP-Agenten aktualisieren.

13 FTP Agent Guide 9 Um die entfernte Ausführung von Befehlen für FTP-Jobs zu aktivieren, müssen Sie in der Definition des Agenten das Kontrollkästchen "entfernte Ausführung von Kommandos zulassen" aktivieren. FTP Connection-Objekte erstellen Wenn Sie den Rapid Automation FTP-Agent verwenden, erstellen Sie Connection-Objekte des Typs FTPAGENT > FTPCONNECTION. Nachdem sie definiert wurden, können für Connection-Objekte folgende Rollen festgelegt werden: Quellhost: Der Host, von dem aus Dateien übertragen werden. Zielhost: Der Host, auf den die Dateien übertragen werden. Für jedes Connection-Objekt wird eines der Protokolle FTP, FTPS, FTPES oder SFTP sowie alle zusätzlichen Optionen festgelegt, die zum Herstellen einer Verbindung mit dem Host erforderlich sind. Weitere Informationen finden Sie im Abschnitt FTP Connection-Objekte für FTP-Server erstellen. FTP-Jobs erstellen FTP-Jobs (FTPAGENT > FTPJOB) verfügen über die spezielle Registerkarte Ftp, die ein Rapid Automation-Panel enthält. Die Registerkarte Ftp dient zum Festlegen der FTP-Parameter und -Befehle. Für die Felder und Befehle auf der Registerkarte Ftp können AE-Variablen eingegeben werden.

14 10 Chapter 2 Konfigurieren des FTP-Agenten In der Automation Engine v9 Service Pack 4 und höher können Sie die auf der Registerkarte Ftp festgelegten Einstellungen überschreiben, und zwar: Für einen Durchlauf eines von Ihnen ausgeführten FTP-Jobs. Um diese Option für den Job zu aktivieren, muss die Option Taskparameter abfragen auf der Registerkarte RA der Jobdefinition aktiviert werden. Weitere Informationen finden Sie im Abschnitt Beispiel: Verwenden von AE- Variablen in FTP-Jobs. Für FTP-Jobs, die als Aufgabe zu einem Workflow hinzugefügt wurden. Weitere Informationen zum Bearbeiten der in einem Workflow enthaltenen Aufgaben finden Sie in der Dokumentation zu Ihrer Automation Plattform. Für einen Durchlauf einer gegenwärtig nicht ausgeführten Aufgabe im Fenster Aktivitäten. Klicken Sie dazu mit der rechten Maustaste auf die Aufgabe, und wählen Sie die Option Aufgaben Parameter modifizieren. Weitere Informationen zu FTP-Jobs finden Sie im Kapitel Arbeiten mit FTP-Jobs.

15 2.2 Installation des RA-Agenten in einem vorhandenen Automation Engine-System FTP Agent Guide 11 In den folgenden Abschnitten erfahren Sie, wie Sie den FTP -Agenten in einem vorhandenen Automation Engine-System installieren können. Java-Anforderungen Prüfen Sie bei allen Hosts und Systemen, auf denen ein Automation Engine UserInterface installiert ist, die aktuelle Version Ihrer Java Virtual Machine (VM) mithilfe des folgenden Befehls: java -version Auf allen Systemen wird Java Version 1.6/1.7/1.8 benötigt. Genaue Informationen zu plattformspezifischen Java-Anforderungen Ihres Automation Engine-Systems finden Sie in den Release Notes der Automation Engine. Die für die Installation von Java erforderlichen Dateien finden Sie unter Beachten Sie, dass der RA FTP-Agent und das UserInterface mit der gleichen Javaversion gestartet werden müssen. Andernfalls tritt der Fehler "Unsupported major.minor version XY" auf, wenn Sie versuchen, mit RA FTP-Objekten im UserInterface zu arbeiten. Der Java-Parameter -D wird zum Starten des Agenten nicht benötigt. Deshalb wird dieser Parameter offiziell nicht unterstützt. Bereitgestellte Dateien Die zum RA-Agenten gehörenden Dateien befinden sich im Verzeichnis IMAGE:AGENTS\RAPIDAUTOMATION der Automation Engine. herunterladen. Dateiname ucxjcitx.jar ucxjcitx.ini *.jar uc.msl setup.exe Beschreibung Agent für Rapid Automation Konfigurationsdatei Bibliotheken Meldungsbibliothek Windows-Installationsdatei Aktivieren der Trace-Einstellungen vor der Installation bzw. vor dem Aktualisiseren des Agenten Vor dem Installieren bzw. Aktualisieren des Agenten empfiehlt es sich, die Trace-Funktion zu aktivieren, indem Sie die Einstellung ra=9 in der INI-Datei ucxjcitx.ini des Agenten hinzufügen.: [TRACE] file=..\temp\ra_trace_##.txt max_trace_kb=8000 tcp/ip=0

16 12 Chapter 2 Konfigurieren des FTP-Agenten ra=9 trccount=10 Sie erhalten dadurch mehr Informationen falls während der Installation des Agenten Fehler auftreten. Nach der erfolgreichen Installation können Sie die Einstellung auf ra=0 setzen und den Agenten neu starten, um die Trace-Funktion wieder zu deaktivieren. Einrichtung eines neuen oder aktualisierten Agenten Für die Einrichtung eines RA-Agenten müssen Sie: Eine Lizenz für den Agenten in die Datenbank laden. Die Dateien des Agenten auf dem Hostsystem ablegen. Die Datei ucxjcitx.ini bearbeiten. Die Datei setup.exe ausführen. Die RA-Lösung laden. Anforderungen für Lizenzdateien Lizenzdateien für RA-Agenten müssen die Zeile EX.RA.<AGENT TYPE> enthalten und in die Datenbank geladen werden. Weitere Informationen zum Laden von Lizenzdateien finden Sie in der Dokumentation für Ihre Automation Engine. Ablegen von Agenten-Dateien auf dem Hostsystem Erstellen Sie auf dem Hostsystem ein Verzeichnis für den RA-Agenten und kopieren Sie die bereitgestellten Dateien in dieses Verzeichnis. Wir empfehlen dringend, den Agenten in einem eigenen Verzeichnis zu installieren. Beispiel: AE/Agent/rapidautomation oder C:\AE\Agent\rapidautomation. In Unix, können Sie die Dateien mit den folgenden Befehlen zu extrahieren: gunzip ucxjcitx.tar.gz tar xvf ucxjcitx.tar Führen Sie in Windows die Datei setup.exe aus. Erstellen des Cache-Verzeichnisses Die für den Agenten verwendete RA-Lösung wird im Verzeichnis cache gespeichert. Erstellen Sie dieses im bin-verzeichnis. Bearbeiten der Datei ucxjcitx.ini Bearbeiten Sie die erforderlichen Parameter für den RA-Agenten in der Datei ucxjcitx.ini gemäß der unten aufgeführten Tabelle. Parameter name= Beschreibung Der Name des Agenten. Der Agentenname darf aus maximal 32 der folgenden Zeichen bestehen: "A Z", "0 9", "_", ".", "$", "@", "-" und "#". Automic empfiehlt, maximal 24 (der möglichen 32) Zeichen für Agentennamen zu verwenden, da die letzten sieben Zeichen für das bei der Erstellung neuer Agenten mit dem Template hinzugefügte Suffix '.NEW.nn' verwendet werden.

17 FTP Agent Guide 13 Parameter system= cache_ directory= cp= Beschreibung Der Name des Automation Engine-Systems. Diese Angabe muss mit dem Eintrag in der INI-Datei des Automation Engine-Servers übereinstimmen. Das Verzeichnis, in dem der Agent die RA-Lösungen speichern soll. Der vorgegebene Standardwert ist cache und kann beibehalten werden. Die Adresse des Kommunikationsprozesses im Automation Engine-System, mit dem sich der Agent verbinden soll. Der Eintrag hat das folgende Format: <DNS-Name oder TCP/IP-Adresse>:<Portnummer> ra= Wird für das Aktivieren bzw. Deaktivieren von Traces verwendet. Informationen zu weiteren Parametern in der Datei ucxjcitx.ini finden Sie in der Dokumentation Ihrer Automation Engine.

18 14 Chapter 2 Konfigurieren des FTP-Agenten Im Folgenden finden Sie ein Beispiel für eine Datei vom Typ ucxjcitx.ini. Die erforderlichen Parameter werden fett gedruckt angezeigt: [GLOBAL] name=ra01 system=ae logcount=10 logging=../temp/ra_log_##.txt ;LogMaxSize: 0...default, qualifiers k...kilo, M...Mega, G...Giga LogMaxSize = 0 language=e helplib=uc.msl [RA] cache_directory=cache ext_directory=external shared_directory=shared lib_directory=lib [TCP/IP] connect=20 cp=localhost:2217 [AUTHORIZATION] KeyStore= InitialPackage= [VARIABLES] uc_host_jcl_var=ra uc_ex_path_bin=. uc_ex_path_temp=..\temp\ uc_ex_path_jobreport=..\temp\ [TRACE] file=..\temp\ra_trace_##.txt ;TraceMaxSize: 0...default, qualifiers k...kilo, M...Mega, G...Giga TraceMaxSize=0 tcp/ip=0 ra=0 trccount=10 [CP_LIST] 2218=PC01 Laden der RA-Lösung Starten Sie auf dem Hostsystem das Dienstprogramm AE DB Load, und wählen Sie die JAR-Datei der RA-Lösung aus. Das Dienstprogramm lädt die Datei in die Datenbank der Automation Engine. Die JAR- Datei lässt sich über die grafische Oberfläche bzw. den Java-Batchmodus (ucybdbld.jar) von AE.DB Load laden. Das Laden der Datei mit "AE DB Load" im Batchmodus (ucybdbld.exe) in Windows ist nicht möglich. Nach dem Laden der RA Solution müssen Sie das UserInterface neu starten. Der RA-Agent kann ausschließlich mit einer RA-Solution verbunden werden. Wenn Sie mehrere RA- Lösungen verwenden möchten, wird für jede Lösung ein eigener RA-Agent benötigt.

19 FTP Agent Guide 15 Die JAR-Datei einer bestimmten RA-Lösung können Sie nicht für andere Systeme nutzen. Wenn Sie es dennoch versuchen, wird das Dienstprogramm "AE DB Load" möglicherweise abgebrochen. Cache bei Start des Agenten deaktivieren Wenn Sie die RA Solution laden und den Agenten daraufhin starten, kann es sein, dass dieser Agent Cachedateien enthält, obwohl er gerade erst geladen wurde. Dies können Sie vermeiden, indem Sie den Zusatz disable_cache an den Startbefehl anhängen (siehe unten). Dadurch wird immer die neu geladene Version des Agenten gestartet. java -jar ucxjcitx.jar disable_cache

20 16 Chapter 2 Konfigurieren des FTP-Agenten 2.3 Laden von Rapid Automation Component- JAR-Dateien in Applications Manager Um Rapid Automation Component-JAR-Dateien in den Applications Manager zu laden, öffnen Sie das Menü "Tools" und wählen Sie die Option "Rapid Automation Loader". Daraufhin wird das Fenster "Rapid Automation Loader" geöffnet. Hier können Sie nach dem Verzeichnis suchen, in dem sich Komponenten befinden. Wählen Sie eine Komponente aus, um sie zu laden. Dieser Abschnitt ist nicht relevant, wenn Ihre Automation Engine v9 v10 or v11 betrifft. Nähere Informationen zum Laden der Rapid Automation.jar-Dateien in die der Automation Engines sind verfügbar unter Installation des RA Agenten in einem vorhandenen Automation Engine-System. Rapid Automation Component-JAR-Dateien lassen sich mit dem Rapid Automation Loader in den Applications Manager laden. Anforderungen der Datei "keyfile.ini" Im Applications Manager benötigen RA-Agenten zwei Zeilen in der Datei keyfile.ini: eine, mit der Benutzer die JAR-Datei des Agenten laden können, und eine zweite, die für die Ausführung des spezifischen Agenten benötigt wird. Wenn Sie einen RA-Agenten gekauft haben, verfügt Ihre keyfile.ini- Datei bereits über die erforderlichen Zeilen. Wenn die Zeilen nicht vorhanden sind oder Sie die Datei "keyfile.ini" von einer anderen Instanz erhalten haben, wird entweder der Menüeintrag Rapid Automation Loader nicht angezeigt (wenn die RA-Zeile nicht existiert) oder Sie können den RA-Agenten nicht starten. Text aus einer Musterdatei vom Typ keyfile.ini mit dem RA Loader und zwei RA-Agenten finden Sie hier: RA= x x999 FTPAGENT= x x999 BANNERAGENT= x x999 Aktivieren der Debugging-Einstellungen vor dem Laden des Agenten Vor dem Laden des Agenten empfiehlt es sich, die Rapid Automation Debugging-Funktion zu aktivieren, indem Sie die Einstellung radebuglevel=9 in der INI-Datei awenv.ini des Agenten hinzufügen. Sie erhalten dadurch mehr Informationen falls während der Installation des Agenten Fehler auftreten. Nach der erfolgreichen Installation können sie die Einstellung auf radebuglevel=0 setzen und den Agenten neu starten, um das Debugging wieder zu deaktivieren. Verwenden des Rapid Automation Loaders So verwenden Sie den Rapid Automation Loader: 1. Rufen Sie das Menü Tools auf, und wählen Sie Rapid Automation Loader. Im Applications Manager wird das Fenster Rapid Automation Loader geöffnet (siehe folgende Darstellung).

21 FTP Agent Guide 17 Suchen Sie nach einem RA-Komponentenverzeichnis, und wählen Sie eine Komponente aus, um sie zu laden. 2. Suchen Sie im Fenster Rapid Automation Loader mit der Schaltfläche Durchsuchen nach einem Verzeichnis, in dem sich RA-Komponenten auf Ihrem PC befinden. 3. Wählen Sie im Feld Available Components eine Komponente aus. 4. Optional können Sie eine ID für die Komponenten in das ID-Feld eingeben. Wenn Sie keine ID eingeben, wird die nächste verfügbare Nummer verwendet. In den meisten Fällen müssen Sie sich gar nicht um IDs kümmern. Sie müssen nur dann eine solche Nummer einrichten, wenn ein Agent mit Verweisen aus der Datenbank gelöscht wird und mit der gleichen Nummer in der Tabelle SO_OPERATORS wiederhergestellt werden muss. Dies kommt äußerst selten vor. 5. Klicken Sie auf OK oder Übernehmen. Mit OK werden die Änderungen gespeichert und das Fenster geschlossen. Mit Übernehmen werden die Änderungen gespeichert, das Fenster bleibt geöffnet. In jedem Fall teilt Ihnen ein Bestätigungsfenster mit, dass die Komponente geladen und dem Feld Loaded Components hinzugefügt wurde. Agenten dieser Art können Sie nun im Applications Manager definieren. 6. Wenn Sie einen vorhandenen RA Agenten-Typen aktualisieren möchten, für den Sie bereits Agenten definiert haben, müssen Sie für alle zuvor definierten Agenten den Prozess AgentService stoppen und neu starten. 7. Sobald die Komponente geladen ist, melden Sie sich ab und erneut am Applications Manager Client an. Löschen geladener Komponenten Um eine geladene Komponente zu löschen, wählen Sie die Komponente aus und klicken Sie auf "Löschen". Zum Löschen einer Komponente müssen Sie zunächst alle Objekte aus Applications Manager löschen, die auf diese Komponente verweisen. Vergleich von Build-Informationen Um Build-Informationen von verfügbaren und geladenen Komponenten zu vergleichen, wählen Sie im Feld Available Components eine verfügbare Komponente auf Ihrem PC sowie im Feld Loaded Components eine geladene Komponente aus und klicken Sie auf Build Info. Applications Manager öffnet das Fenster "Build Info" (siehe unten), in dem Sie die Informationen zu den zwei Versionen überprüfen können.

22 18 Chapter 2 Konfigurieren des FTP-Agenten Vergleichen Sie die verfügbaren und geladenen Builds im Fenster "Build Info".

23 FTP Agent Guide Definieren der Timeout-Sekunden zwischen Automation Engine und Agenten Das Timeout (in Sekunden) zwischen der Automation Engine v9/10/11 und den Rapid Automation- Agenten können Sie mithilfe der Einstellung agenttimeoutin der Datei uc4config.xml festlegen. Das Timeout (in Sekunden) zwischen der Automation Engine v9/10/11 und den Rapid Automation- Agenten können Sie mithilfe der Einstellung agenttimeout in der Datei uc4config.xml file festlegen. <paths> <docu type="hh">../../docu</docu> <!--docu type="wh">../docu</docu--> <!--browser type="mozilla Firefox">/users/uc4/firefox/firefox</browser--> <logging count="10">../temp/ucdj_log_##.txt</logging> <trace count="10" ra="9" tcp="10" xml="10">../temp/ucdj_trc_ ##.TXT</trace> <tcpip_keepalive>1</tcpip_keepalive> <tcp_nodelay>1</tcp_nodelay> <agenttimeout>300</agenttimeout> <SendBufferSize> </SendBufferSize> <RecvBufferSize> </RecvBufferSize> </paths> Der Standardwert beträgt 100 Sekunden, wenn keine Einstellung für agenttimeout festgelegt wurde. Im Falle eines Timeouts eines Agenten wird folgende Fehlermeldung angezeigt: Beispiel für einen Timeout-Fehler

24 20 Chapter 2 Konfigurieren des FTP-Agenten 2.5 Bevor Sie FTP-Jobs aktualisieren: Aktualisieren des Work Process (WP)-Objekt- Cache Ein Cache-Problem kann beim Aktualisieren von Jobdefinitionen zum Fehlschlagen des Aktualisierungsprogramms für FTP-Jobs führen. Dieses Problem wurde in der AE v9 Service Pack 4 und Operations Manager v8.0 Service Pack 5 HotFix 5 behoben. Sie können das Problem aber auch umgehen, indem Sie den Objekt-Cache für Arbeitsprozesse (Work Process, WP) vor dem Ausführen des Job- Aktualisierungsprogramms vergrößern. So vergrößern Sie den Objekt-Cache von WP-Prozessen: 1. Öffnen Sie das Fenster Systemübersicht und wählen Sie aus der Baumstruktur auf der linken Seite Automation Engine aus (siehe Abbildung A). Bearbeiten Sie die Eigenschaften der WP-Prozesse im Fenster Systemübersicht. 2. Klicken Sie rechts auf dem Bildschirm mit der rechten Maustaste auf einen WP-Prozess, und wählen Sie Eigenschaften aus. Das Fenster Eigenschaftenfür den/die primären WP-Prozess/e wird geöffnet. 3. Wählen Sie die Registerkarte Eigenschaften aus und erhöhen Sie den Wert im Feld Objekt Cache. Sie können einen beliebigen Wert für den Objekt-Cache festlegen, sofern dieser höher als der Ausgangswert ist. Durch das Erhöhen des Werts im Feld Objekt Cache wird der Cache erneut geladen und so das Problem behoben.

25 FTP Agent Guide 21 Vergrößern des Objekt-Cache Was geschieht, wenn der Objekt-Cache nicht vergrößert wird? Wenn Sie das Aktualisierungsprogramm für FTP-Jobs ausführen, ohne zuvor den Objekt-Cache zu vergrößern, wird möglicherweise im Feld Zusammenfassung der Jobkonvertierung auf der Unterregisterkarte Job Konvertierung des FTP-Agenten der folgende Fehler angezeigt. U Das Objekt konnte nicht gefunden werden! Es wurde möglicherweise gelöscht oder umbenannt. In diesem Fall ist die Aktualisierung des letzten Jobs im Feld Zusammenfassung der Jobkonvertierungfehlgeschlagen und der Job wurde im Zuge der Aktualisierung der FTP-Jobs gelöscht. Das Aktualisierungsprogramm für FTP-Jobs erstellt vor der Aktualisierung für jeden FTP-Job eine Exportdatei. Diese können Sie vom folgenden Pfad erneut importieren: Bei UNIX-Betriebssystemen: bin/<mandanten-nummer>/job_export/<job-name>.exp. Bei Windows-Betriebssystemen: bin/<mandanten-nummer>/job_export/<job-name>.exp. Bedenken Sie jedoch, dass Sie für den Rückimport von Jobs in den AE-Mandanten die ältere Version des FTP-Agenten verwenden müssen, indem Sie mit dem Dienstprogramm DB Load eine ältere.jar-datei

26 22 Chapter 2 Konfigurieren des FTP-Agenten laden. Weitere Informationen zum Laden von.jar-dateien mit dem Dienstprogramm DB Load finden Sie in der Dokumentation zur Automation Plattform. Falls weitere Fehler auftreten, wenden Sie sich bitte an den Automic Support.

27 FTP Agent Guide Jobs aus einer früheren Version des FTP- Agenten aktualisieren Nach der Aktualisierung des/der FTP-Agenten von einer beliebigen früheren Version auf v3.0.0 müssen Sie sich am Mandant 0 anmelden und sämtliche FTP-Jobs aktualisieren, die Sie mit der früheren Version des FTP-Agenten erstellt haben. Die Aktualisierung von FTP-Jobs erfolgt mithilfe des Dienstprogramms zur Aktualisierung von FTP-Jobs, das sich auf der untergeordneten Registerkarte "Job Konvertierung" der Registerkarte "FTP" eines aktualisierten FTP-Agent befindet. Sie müssen das Dienstprogramm zur Aktualisierung von FTP-Jobs einmal für jeden Mandanten ausführen, auf dem Sie FTP-Jobs definiert haben. Nach der Aktualisierung Ihrer FTP-Agenten von einer beliebigen früheren Version auf v3.0.0 müssen Sie auch sämtliche FTP-Jobs aktualisieren, die Sie mit der älteren Version erstellt haben. Achtung! Beachten Sie folgenden Hinweis, bevor Sie FTP-Jobs aktualisieren!ein Cache- Problem kann beim Aktualisieren von Jobs zum Fehlschlagen des Aktualisierungsprogramms für FTP- Jobs führen. Dieses Problem wurde in der Automiation Engine v9 Service Pack 4 und Operations Manager v8.0 Service Pack 5 HotFix 5 behoben. Sie können das Problem aber auch umgehen, indem Sie den Objekt-Cache für Arbeitsprozesse (Work Process, WP) vor dem Ausführen des Job- Aktualisierungsprogramms vergrößern. Anweisungen finden Sie unter Bevor Sie FTP-Jobs aktualisieren: Aktualisieren des Work Process (WP)-Objekt-Cache. Achtung!Automic empfiehlt dringend, dass Sie das Dienstprogramm zur Aktualisierung von FTP-Jobs in einer Automation Engine-Testumgebung ausführen und sicherstellen, dass Ihre FTP-Jobs ordnungsgemäß ausgeführt werden, bevor Sie Ihre FTP-Jobs in einer produktiven Automation Engine- Umgebung aktualisieren. Beachten Sie, dass der Test nicht in einer Mandanten-basierten Umgebung durchgeführt werden sollte, da die Installation einer RA Lösung mandantenübergreifend auf allen Agentendefinitionen erfolgt. Darüber hinaus erstellt das Dienstprogramm zur Aktualisierung von FTP- Jobs Exportdateien aller Jobs, bevor diese wie unten beschrieben aktualisiert werden. Alternativ können Sie auch einen Export oder Transportkoffer Ihrer FTP-Jobs erstellen, bevor Sie den Job- Aktualisierungsprozess starten. Wir empfehlen, außerdem eine Sicherung Ihres gesamten AE- Systems einschließlich Verzeichnisstruktur und Datenbank zu erstellen. Weitere Informationen zu empfohlenen Vorgehensweisen für die Sicherung und die Aktualisierung der Software von Automic finden Sie im Abschnitt Update-Installation, der sich in der Dokumentation zu Automation Engine v9 und Operations Manager v8.00 unter Administratorhandbuch > Installation befindet. So aktualisieren Sie FTP-Jobs: 1. Stellen Sie sicher, dass auf dem Mandanten, dessen Jobs Sie aktualisieren möchten, gegenwärtig kein FTP-Job von einem Benutzer bearbeitet wird. 2. Bearbeiten Sie einen FTP-Agent auf Mandant 0, und öffnen Sie wie in Abbildung A dargestellt die Registerkarte Ftp und anschließend die untergeordnete Registerkarte Job Konvertierung.

28 24 Chapter 2 Konfigurieren des FTP-Agenten Aktualisierung von FTP-Jobs auf der Unterregisterkarte "Job Konvertierung" 3. Geben Sie in der Unterregisterkarte Job Konvertierung die Automation Engine-Daten für die unten beschriebenen Felder ein. Feld Hostname Mandant Beschreibung Hostname oder IP-Adresse der Automation Engine Die Nummer des Mandanten, auf dem FTP-Jobs definiert sind. CP-Port Name Abteilung Passwort Hinweis: Sie müssen das Dienstprogramm zur Aktualisierung von FTP-Jobs für jeden Mandanten ausführen, auf dem Sie FTP-Jobs definiert haben. Wenn Sie zum Beispiel auf den Mandanten 1 und 2 FTP-Jobs definiert haben, würden Sie hier 1 eingeben und die im Folgenden beschriebenen Schritte ausführen. Anschließend würden Sie wieder mit diesem Schritt beginnen, den Wert 2 eingeben und die folgenden Schritte erneut ausführen. Die Portnummer des Kommunikationsprozesses (Communication Process, CP) der Automation Engine Ein AE-Benutzer mit der Berechtigung zum Bearbeiten aller FTP-Jobs auf dem ausgewählten Mandanten Die Abteilung des AE-Benutzers (falls erforderlich) Das Kennwort des AE-Benutzers 4. Klicken Sie auf Weiter. Der FTP-Agent öffnet das in Abbildung B dargestellte Fenster Status Dialog um anzuzeigen, dass eine Abfrage sämtlicher FTP-Jobs auf dem angegebenen Mandanten durchgeführt wird.

29 FTP Agent Guide 25 Das Fenster "Status Dialog" zeigt an, dass sämtliche FTP-Jobs des ausgewählten Mandanten geladen werden. Nach Abschluss des Ladevorgangs: Der FTP-Agent erstellt für jeden nicht aktualisierten FTP-Job eine Exportdatei unter folgendem Pfad: Bei UNIX-Betriebssystemen unter bin/<mandanten-nummer>/job_ export/<jobname>.exp. Bei Windows-Betriebssystemen unter bin\<mandanten-nummer>\job_ export\<jobname>.exp. Falls Sie zu einem späteren Zeitpunkt ein Downgrade des FTP-Agenten durchführen, indem Sie mit dem Dienstprogramm DB Load eine frühere JAR-Datei laden, können Sie diese Jobs erneut importieren, indem Sie die Option Import im Fenster Explorer der AE- Benutzeroberfläche verwenden. Weitere Informationen zum Importieren von AE-Objekten finden Sie in der Dokumentation zu Ihrer Automation Plattform. Die auf der Unterregisterkarte Job Konvertierung angezeigten Informationen werden wie in Abbildung C dargestellt aktualisiert. Nun wird eine Liste aller FTP-Jobs angezeigt, die in dem angegeben Mandanten definiert sind. Wenn Sie Ihre FTP-Agenten aktualisieren und einen oder mehrere neue FTP-Jobs erstellen, bevor Sie das Dienstprogramm zur Aktualisierung von FTP-Jobs ausführen, werden Ihre neuen FTP-Jobs hier zusammen mit den FTP-Jobs angezeigt, die noch nicht aktualisiert wurden. Beim Aktualisierungsprozess werden jedoch an Ihren neuen FTP-Jobs keine Änderungen vorgenommen.

30 26 Chapter 2 Konfigurieren des FTP-Agenten Nach Abschluss des Ladevorgangs werden alle auf dem Mandanten definierten FTP-Jobs angezeigt. 5. Überprüfen Sie die Liste der Jobs auf der Unterregisterkarte Job Konvertierung, und klicken Sie anschließend auf Weiter. Der FTP-Agent öffnet das in Abbildung D dargestellte Fenster Status Dialog um anzuzeigen, dass sämtliche FTP-Jobs in dem angegebenen Mandanten aktualisiert werden. Die Anzeige im Status Dialog wird regelmäßig aktualisiert um anzuzeigen, wie viele Jobs bereits bearbeitet wurden. Im Fenster "Status Dialog" wird der Fortschritt des Aktualisierungsprozesses für FTP-Jobs angezeigt. Wenn die Aktualisierung der Jobs abgeschlossen ist, wird auf der Unterregisterkarte Job Konvertierung die in Abbildung E dargestellte Zusammenfassung der Jobkonvertierung angezeigt.

31 FTP Agent Guide 27 Nach der Aktualisierung der FTP-Jobs wird eine Zusammenfassung angezeigt. Die Zusammenfassung der Jobkonvertierung enthält folgende Informationen: Die Gesamtanzahl der FTP-Jobs vor der Aktualisierung. Eine Liste von FTP Connection-Objekten, bei denen vor der Aktualisierung im Feld Protocol die Option "EXEC" ausgewählt war. Vor Version v3.0.0 stand ein Protokoll mit der Bezeichnung "EXEC" zur Verfügung. Dieses wird nicht mehr unterstützt. Wenn Sie Connection-Objekte verwenden, die mit einer früheren Version des FTP-Agenten erstellt wurden und bei denen im Feld Protocol die Option "EXEC" ausgewählt ist, müssen Sie diese nach der Jobaktualisierung anpassen. Wenn Sie dieses modifizieren, wählen Sie eines der unterstützten Protokolle und aktualisieren Sie das Passwort (dieses muss auch eingegeben werden, auch wenn es nicht geändert wurde) und speichern Sie das Objekt. Bei Verwendung des Operations Manager v8.00 besteht ein bekanntes Problem. Um es zu umgehen müssen Sie das Protokoll auf SFTP setzen und den in dem Feld Pass phrase enthaltenen Wert. Weitere Informationen hierzu sind in den Release Notes, die sich am Ende dieses Handbuchs befinden, verfügbar. Connection-Objekte, bei denen vor der Aktualisierung des Agenten das Protokoll "EXEC" ausgewählt war, dürfen erst geändert werden, nachdem das Dienstprogramm zur Jobaktualisierung für den Mandanten ausgeführt wurde. Wenn Sie die Connection- Objekte vor der Ausführung des Dienstprogramms zur Jobaktualisierung ändern, werden in den Jobs, denen das jeweilige Connection-Objekt zugeordnet ist, keine Befehle für die Entfernte Ausführung, sondern Befehle für die FTP Kommandozeile erstellt. Weitere Informationen zu Connection-Objekten finden Sie im Abschnitt FTP Connection- Objekte für FTP-Server erstellen. Informationen zum Erfolg bzw. zum Fehlschlagen der Aktualisierung für jeden Job. Wenn das Dienstprogramm zur Aktualisierung von FTP-Jobs einen FTP-Job nicht aktualisieren

32 28 Chapter 2 Konfigurieren des FTP-Agenten kann, wird der Aktualisierungsprozess gestoppt und eine Fehlermeldung in der Zusammenfassung der Jobkonvertierung angezeigt. Ein Hinweis, ob die Aktualisierung erfolgreich abgeschlossen wurde oder fehlgeschlagen ist. Wenn die Aktualisierung der FTP-Jobs fehlschlägt, erfahren Sie durch diese Meldung, wie viele FTP-Jobs aktualisiert wurden und bei welchem Job die Aktualisierung fehlgeschlagen ist. Nach der Aktualisierung werden alle: FTP-Formularjobs (Typ FTPFILETRANSFERJOB) frei eingegebenen FTP- Jobs (Typ FTPJOB) mit dem Protokoll FTP, FTPS, FTPES oder SFTP aktualisiert zu FTP-Jobs mit: einem Befehl Datei(en) kopieren. Weitere Informationen zum Befehl Datei(en) kopieren finden Sie im Abschnitt Einstellungen für den Befehl "Datei(en) kopieren". einem Befehl für die FTP Kommandozeile. Weitere Informationen zu Befehlen für die FTP Kommandozeile finden Sie im Abschnitt Einstellungen für die FTP Kommandozeile.

33 FTP Agent Guide 29 Nach der Aktualisierung werden alle: frei eingegebenen FTP- Jobs (Typ FTPJOB) mit dem Protokoll EXEC aktualisiert zu FTP-Jobs mit: einem oder mehreren Befehlen für die Entfernte Ausführung. Weitere Informationen zu Befehlen für die Entfernte Ausführung finden Sie im Abschnitt Einstellungen für den Befehl "Entfernte Ausführung". Vor Version v3.0.0 stand ein Protokoll mit der Bezeichnung "EXEC" zur Verfügung. Dieses wird nicht mehr unterstützt. Wenn Sie Connection-Objekte verwenden, die mit einer früheren Version des FTP-Agenten erstellt wurden und bei denen im Feld Protocol die Option "EXEC" ausgewählt ist, müssen Sie diese nach der Jobaktualisierung anpassen. Wenn Sie dieses modifizieren, wählen Sie eines der unterstützten Protokolle und aktualisieren Sie das Passwort (dieses muss auch eingegeben werden, auch wenn es nicht geändert wurde) und speichern Sie das Objekt. Bei Verwendung des Operations Manager v8.00 besteht ein bekanntes Problem. Um es zu umgehen müssen Sie das Protokoll auf SFTP setzen und den in dem Feld Pass phrase enthaltenen. Weitere Informationen hierzu sind in den Release Notes, die sich am Ende dieses Handbuchs befinden, verfügbar. Vorsicht! Connection-Objekte, bei denen vor der Aktualisierung des Agenten das Protokoll "EXEC" ausgewählt war, dürfen erst geändert werden, nachdem das Dienstprogramm zur Jobaktualisierung für den Mandanten ausgeführt wurde. Wenn Sie die Connection-Objekte vor der Ausführung des Dienstprogramms zur Jobaktualisierung ändern, werden in den Jobs, denen das jeweilige Connection-Objekt zugeordnet ist, keine Befehle für die Entfernte Ausführung, sondern Befehle für die FTP Kommandozeile erstellt. Weitere Informationen zu Connection-Objekten finden Sie im Abschnitt FTP Connection-Objekte für FTP-Server erstellen. Aus Sicherheitsgründen sind Befehle für die Entfernte Ausführung standardmäßig deaktiviert. Um diese Befehle zu aktivieren, müssen Sie das Kontrollkästchen entfernte Ausführung von Kommandos zulassen auf der Unterregisterkarte Einstellungen des FTP-Agenten aktivieren. Weitere Informationen zum Aktivieren entfernter Befehle für einen FTP-Agent finden Sie im Abschnitt Einführung in die Konfiguration des FTP-Agenten. 6. Wenn Sie auf weiteren Mandanten FTP-Jobs definiert haben, führen Sie das Dienstprogramm zur Aktualisierung von FTP-Jobs auch für alle anderen Mandanten aus. Die einfachste Möglichkeit zur wiederholten Ausführung des Dienstprogramms zur Aktualisierung von FTP-Jobs besteht darin, zweimal auf Zurück zu klicken, die Nummer im Feld Mandant anzupassen und die obigen Anweisungen für die weiteren Mandanten auszuführen. 7. Optional können Sie den FTP-Agent vor dem Schließen speichern. Die Werte in den Feldern der Unterregisterkarte Job Konvertierung werden zum Speichern der Agentendefinition nicht benötigt. Es empfiehlt sich jedoch, den FTP-Agent vor dem Schließen zu speichern, damit Sie zu einem späteren Zeitpunkt das Dienstprogramm zur Aktualisierung von FTP-Jobs ohne erneute Eingabe der Verbindungsinformationen ausführen können.

34 30 Chapter 2 Konfigurieren des FTP-Agenten 2.7 FTP Connection-Objekte für FTP-Server erstellen Wenn Sie den Rapid Automation FTP-Agenten verwenden, erstellen Sie als Quell- und Zielhost Connection-Objekte des Typs FTPAGENT > FTPCONNECTION. Für jedes Connection-Objekt werden eines der Protokolle FTP, FTPS, FTPES oder SFTP sowie alle zusätzlichen Optionen festgelegt, die zum Herstellen einer Verbindung erforderlich sind. In Abbildung A sind einige Beispiele für Connection-Objekte dargestellt. Beispiele für Connection-Objekte für alle Protokolle Das Feld Login in der Registerkarte Attribute wird für Automation Engine-Jobs des FTP -Agenten. Die folgende Tabelle enthält eine Beschreibung der Felder für alle Connection-Objekte vom Typ FTPCONNECTION:

35 FTP Agent Guide 31 Feld Protokoll Beschreibung Das Protokoll für dieses Connection-Objekt. Folgende Verbindungsprotokolle stehen zur Verfügung: FTP: File Transfer Protocol FTPS: FTP mit impliziter Authentifizierung FTPES: FTP mit expliziter Authentifizierung SFTP: SSH File Transfer Protocol (empfohlen) Das Protokoll bestimmt folgende Einstellungen: Die Standardportnummer im Feld Port. Die Erweiterte Optionen im unteren Bereich der Registerkarte. Vor Version v3.0.0 stand ein Protokoll mit der Bezeichnung "EXEC" zur Verfügung. Dieses wird nicht mehr unterstützt. Wenn Sie Connection- Objekte verwenden, die mit einer früheren Version des FTP-Agenten erstellt wurden und bei denen im Feld Protocol die Option "EXEC" ausgewählt ist, müssen Sie diese nach der Jobaktualisierung anpassen. Wenn Sie dieses modifizieren, wählen Sie eines der unterstützten Protokolle und aktualisieren Sie das Passwort (dieses muss auch eingegeben werden, auch wenn es nicht geändert wurde) und speichern Sie das Objekt. Bei Verwendung des Operations Manager v8.00 besteht ein bekanntes Problem. Um es zu umgehen müssen Sie das Protokoll auf SFTP setzen und den in dem Feld Pass phrase enthaltenen. Weitere Informationen hierzu sind in den Release Notes, die sich am Ende dieses Handbuchs befinden, verfügbar. Connection-Objekte, bei denen vor der Aktualisierung des Agenten das Protokoll "EXEC" ausgewählt war, dürfen erst geändert werden, nachdem das Dienstprogramm zur Jobaktualisierung für den Mandanten ausgeführt wurde. Wenn Sie die Connection-Objekte vor der Ausführung des Dienstprogramms zur Jobaktualisierung ändern, werden in den Jobs, denen das jeweilige Connection-Objekt zugeordnet ist, keine Befehle für die Entfernte Ausführung, sondern Befehle für die FTP Kommandozeile erstellt. Host Port Hostname oder IP-Adresse des Zielhosts. Der für die Verbindung verwendete Port. Jedes Mal, wenn Sie im Feld Protokoll oben ein Protokoll auswählen oder das ausgewählte Protokoll ändern, wird der Standardwert in diesem Feld automatisch aktualisiert. Standardports der Protokolle: Für FTP und FTPES wird Port 21 festgelegt. Für FTPS wird Port 990 festgelegt. Für SFTP wird Port 22 festgelegt. Benutzername Passwort Wenn Sie einen anderen Port für den Vorgang verwenden möchten, geben Sie die gewünschte Portnummer ein, nachdem Sie das Protokoll ausgewählt haben. Der Benutzername auf dem Zielhost. Das Kennwort für den Benutzernamen auf dem Zielhost.

36 32 Chapter 2 Konfigurieren des FTP-Agenten Feld Socks- Proxyservereinstellungen verwenden Beschreibung Verwendet mit SOCKS-Proxyservern: Bei aktiviertem Kontrollkästchen: Der Agent verwendet die Einstellungen auf seiner untergeordneten Registerkarte SOCKS- Proxyservereinstellungen. Weitere Informationen zur untergeordneten Registerkarte SOCKS-Proxyservereinstellungen siehe SOCKS-Proxyserver verwenden. Bei deaktiviertem Kontrollkästchen (Voreinstellung): SOCKS- Proxyservereinstellungen werden nicht verwendet. Erweiterte Optionen für FTP Die folgende Tabelle enthält eine Beschreibung der Optionen, die unter Erweiterte Optionen für FTP zur Verfügung stehen: Feld Active Mode erzwingen Beschreibung Legt fest, auf welche Weise Datenverbindungen hergestellt werden. Aktivieren Sie dieses Kontrollkästchen, wenn Sie Dateien über einen Proxyserver übertragen oder aus einem anderen Grund den aktiven Modus verwenden müssen: Bei aktiviertem Kontrollkästchen: Der Agent erstellt einen Socket, öffnet den Befehlsport und den Datenport für die Verbindung mit dem Server und initiiert die Sitzungen. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Bei deaktiviertem Kontrollkästchen (Voreinstellung): Der Agent versucht, eine Verbindung im passiven Modus herzustellen, um Befehle über den Befehlsport zu senden. Remote Host Adressverifizierung FTP- Proxyservereinstellungen verwenden Aktiviert die Verifizierung der Adresse des entfernten Hosts: Bei aktiviertem Kontrollkästchen: Beim Erstellen des Datenports für die FTP-Übertragung überprüft der Agent, ob die entfernte IP- Adresse mit dem Socket übereinstimmt. Wenn dieses Kontrollkästchen aktiviert ist und Sie versuchen, Übertragungen über einen Proxyserver durchzuführen, schlägt die Übertragung fehl. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Die Adresse des entfernten Hosts wird nicht überprüft, sodass FTP- Übertragungen über einen Proxyserver erfolgreich durchgeführt werden können. Verwendet mit FTP-Proxyservern: Bei aktiviertem Kontrollkästchen: Der Agent verwendet die Einstellungen auf seiner untergeordneten Registerkarte FTP- Proxyservereinstellungen. Weitere Informationen zur untergeordneten Registerkarte FTP-Proxyservereinstellungen siehe FTP-Proxyserver verwenden. Bei deaktiviertem Kontrollkästchen (Voreinstellung): FTP- Proxyservereinstellungen werden nicht verwendet.

37 FTP Agent Guide 33 Erweiterte Optionen für FTPS Bei FTPS wird implizit TLS/SSL verwendet. Dabei werden die SSL-Versionen 1.0, 2.0 und 3.0 unterstützt. Die folgende Tabelle enthält eine Beschreibung der Optionen, die unter Erweiterte Optionen für FTPS zur Verfügung stehen: Feld Active Mode erzwingen Beschreibung Legt fest, auf welche Weise Datenverbindungen hergestellt werden. Aktivieren Sie dieses Kontrollkästchen, wenn Sie Dateien über einen Proxyserver übertragen oder aus einem anderen Grund den aktiven Modus verwenden müssen: Bei aktiviertem Kontrollkästchen: Der Agent erstellt einen Socket, öffnet den Befehlsport und den Datenport für die Verbindung mit dem Server und initiiert die Sitzungen. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Bei deaktiviertem Kontrollkästchen (Voreinstellung): Der Agent versucht, eine Verbindung im passiven Modus herzustellen, um Befehle über den Befehlsport zu senden. Remote Host Adressverifizierung Aktiviert die Verifizierung der Adresse des entfernten Hosts: Bei aktiviertem Kontrollkästchen: Beim Erstellen des Datenports für die FTP-Übertragung überprüft der Agent, ob die entfernte IP-Adresse mit dem Socket übereinstimmt. Wenn dieses Kontrollkästchen aktiviert ist und Sie versuchen, Übertragungen über einen Proxyserver durchzuführen, schlägt die Übertragung fehl. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Die Adresse des entfernten Hosts wird nicht überprüft, sodass FTP-Übertragungen über einen Proxyserver erfolgreich durchgeführt werden können. Erweiterte Optionen für FTPES Bei FTPES wird implizit TLS/SSL verwendet. Dabei werden die SSL-Versionen 1.0, 2.0 und 3.0 unterstützt. Die folgende Tabelle enthält eine Beschreibung der Optionen, die unter Erweiterte Optionen für FTPES zur Verfügung stehen: Feld Active Mode erzwingen Beschreibung Legt fest, auf welche Weise Datenverbindungen hergestellt werden. Aktivieren Sie dieses Kontrollkästchen, wenn Sie Dateien über einen Proxyserver übertragen oder aus einem anderen Grund den aktiven Modus verwenden müssen: Bei aktiviertem Kontrollkästchen: Der Agent erstellt einen Socket, öffnet den Befehlsport und den Datenport für die Verbindung mit dem Server und initiiert die Sitzungen. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Bei deaktiviertem Kontrollkästchen (Voreinstellung): Der Agent versucht, eine Verbindung im passiven Modus herzustellen, um Befehle über den Befehlsport zu senden.

38 34 Chapter 2 Konfigurieren des FTP-Agenten Feld Remote Host Adressverifizierung Beschreibung Aktiviert die Verifizierung der Adresse des entfernten Hosts: Bei aktiviertem Kontrollkästchen: Beim Erstellen des Datenports für die FTP-Übertragung überprüft der Agent, ob die entfernte IP-Adresse mit dem Socket übereinstimmt. Wenn dieses Kontrollkästchen aktiviert ist und Sie versuchen, Übertragungen über einen Proxyserver durchzuführen, schlägt die Übertragung fehl. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Die Adresse des entfernten Hosts wird nicht überprüft, sodass FTP-Übertragungen über einen Proxyserver erfolgreich durchgeführt werden können. PBSZ Die Größe des Protection Puffers. Der Standardwert ist 0. PROT Verschlüsselungsart des Datenkanals (PROT-Befehl): Zeigt dem Server an, welche Art von Verschlüsselung für den Datenkanal zwischen dem Client und dem Server genutzt werden soll. Folgende Optionen stehen zur Verfügung: Clear (keine Verschlüsselung) Safe (sicher, nur SSL-Protokoll) Confidential (vertraulich, nur SSL-Protokoll) Private (privat, Voreinstellung) Erweiterte Optionen für SFTP Die folgende Tabelle enthält eine Beschreibung der Optionen, die unter Erweiterte Optionen für SFTP zur Verfügung stehen: Feld SFTP Keyauthentifizierung Key file Pass phrase Beschreibung Gib an, ob SFTP-Schlüsselauthentifizierung verwendet werden soll: Bei aktiviertem Kontrollkästchen: Der Agent führt die Authentifizierung mit den Werten durch, die in den Feldern Key file und Pass phrase festgelegt sind. Bei deaktiviertem Kontrollkästchen (Voreinstellung): Die Einstellungen für die SFTP-Schlüsselauthentifizierung werden nicht verwendet. Geben Sie den absoluten Pfad zu einer Datei an, die einen privaten Schlüssel enthält. Ein optionales Kennwort. Weitere Informationen zur SFTP-Schlüsselauthentifizierung finden Sie im Abschnitt SFTP- Schlüsselauthentifizierung unter UNIX.

39 FTP Agent Guide SFTP-Schlüsselauthentifizierung unter UNIX Führen Sie die unten aufgeführten Schritte aus, um die SFTP-Schlüsselauthentifizierung auf einem UNIX- Betriebssystem einzurichten. Unter Windows stehen unterschiedliche Softwareprodukte für das Einrichten der Schlüsselauthentifizierung zur Verfügung. Lesen Sie in diesem Fall die Dokumentation des Herstellers, um weitere Informationen zu erhalten. Der FTP-Agent unterstützt nur Open-SSH kompatible Keys für SFTP! Putty Keys müssen mit PuTTYGen zum Open-SSH Format umgewandelt werden. Dazu sind folgende Schritte durchzuführen (mit Windows Putty): PuTTY Key Generator (PuttyGen) starten Den Menüpunkt Conversions auswählen Über Import Key den bestehenden Putty Key laden Anschließend den OpenSSH Key über den Befehl Export umwandeln. Kommt es zu einem Authentifizierungs-Fehler und zum Abbruch des SFTP-Jobs, kann dies auch den Einstellungen der JVM liegen. Um dieses Problem zu vermeiden, kann die Java Cryptography Extension (JCE) vom JVM-Hersteller heruntergeladen und gemäß deren Beschreibung eingespielt werden. So definieren Sie unter UNIX das Schlüsselpaar für SFTP: 1. Geben Sie auf dem Host, auf dem der RA FTP-Agent ausgeführt wird, den Befehl ssh-keygen -t dsa ein. Der Befehl ssh-keygen muss auf dem Host ausgeführt werden, auf dem auch der Agent ausgeführt wird. Der zur Ausführung des Befehls verwendete Benutzername und der Hostname werden in der öffentlichen Schlüsseldatei gespeichert. Unten sehen Sie ein Beispiel für eine öffentliche Schlüsseldatei. ssh-dssaaaab3nzac1kc3maaacbakzrw/a7wqdedmupc/avmffuaib001agcrrnwe 93iZBbIy8miAXgrzBYMTc17rTb4pZiw/tl gwlmpdzetu1a1wn6rg4wxire0o7yfhmaykqnoblojkfaywbw1p7rnlkgvxtp5ptea+ +xbb7oknmljq2xg4blf41ibbvsle8hbaaaafqdazj47sz76eb5wccamhivije3wuwa AIB2CCOH0tcToyXu6npMmCL0CpS+X5UAHAwp0pdMNfDNzSM4Opuht0ti5nf69+c1rA ORHQSrMocHM0yu0wR1Wiiz5RalvpT55YG2+46SXlS5d2RwdeE7TnsTH8u5r8Ra2L0i BFF11mDvxEkiO4w8OTqmM1TQImzZxszM5S7BNiEwAAAIAk4is1gOrjeNHuM9hMsGj7 HlhFTUhHG+5fLP5lNHEPt3ggnN7EGRKk7h0fLJimzYv5XL690 GpcBDnXFUAHXzwMuHBnYCgJxPz56WHlk kzjkkttdhjbi9vqjocdpyghkc3vbynienjug3y5bll4bzduwu4k4mq8ageh81tkoaa = qa4@xpert64.example.com Der fett markierte Text oben, qa4@xpert64.example.com, ist die Signatur dieser Schlüsseldatei. Dies bedeutet, dass der Befehl ssh-keygen auf dem Host xpert64.example.com unter dem Benutzernamen qa4 ausgeführt wurde. Außerdem bedeutet dies, dass der Agent eine Verbindung zu dem Benutzernamen qa4 auf dem Host xpert64.example.com herstellen und Zugriff auf die Datei mit dem privaten Schlüssel haben muss. 2. Beantworten Sie sämtliche Fragen, die nach Eingabe des obigen Befehls gestellt werden. Wenn Sie die Standardwerte beibehalten möchten, drücken Sie einfach die Eingabetaste. 3. Nach Abschluss des Befehls werden zwei neue Dateien erzeugt: id_dsa und id_dsa.pub. Die Datei id_dsa.pub enthält den öffentlichen Schlüssel, die Datei id_dsa den privaten Schlüssel.

40 36 Chapter 2 Konfigurieren des FTP-Agenten 4. Verschieben Sie die Datei mit dem öffentlichen Schlüssel auf den Server (Host auf dem der FTP- Server ausgeführt wird) in das Verzeichnis $HOME/.ssh, und benennen Sie die Datei in authorized_keys um. Wenn diese Datei bereits auf dem Server vorhanden ist, hängen Sie den Inhalt der neuen öffentlichen Schlüsseldatei an die bereits vorhandene Datei an. Dies ist zum Beispiel mit folgendem Befehl möglich: cat id_dsa.pub >> authorized_keys 5. Auf dem Host, auf dem der RA FTP-Agent ausgeführt wird, benötigen Sie nun den privaten Schlüssel. Der private Schlüssel wird benötigt, um die Verbindung mit dem öffentlichen Schlüssel in der Datei authorized_keys auf dem Server zu authentifizieren. 6. Legen Sie in der Registerkarte RA des SFTP Connection-Objekts die Werte der folgenden Felder fest: Feld SFTP Keyauthentifizierung Key file Pass phrase Beschreibung Aktivieren Sie dieses Kontrollkästchen. Der absolute Pfad zu der Datei, in der sich der private Schlüssel befindet. Der private Schlüssel muss sich auf dem Host befinden, auf dem der RA FTP-Agent ausgeführt wird. Wenn Sie beim Erstellen des Schlüsselpaars mithilfe des Befehls sshkeygen ein Kennwort eingegeben haben, müssen Sie dieses Kennwort hier ebenfalls eingeben. In Abbildung A ist ein Beispiel für ein SFTP Connection-Objekt dargestellt. Ein FTP Connection-Objekt mit SFTP-Schlüsselauthentifizierung Wenn SFTP-Schlüsselauthentifizierung verwendet wird, wird das oben angegebene Kennwort nicht benutzt.

41 FTP Agent Guide 37 Unten sehen Sie die Ausgabe eines beispielhaften Jobs mit SFTP-Schlüsselauthentifizierung. Die beiden fett markierten Zeilen in der Ausgabe des Jobs zeigen an, welche private Schlüsseldatei verwendet wurde. host name = xpert64.example.com remote user identification = qa4 Using SFTP private key file: /u01/users/qa/.ssh/id_dsa Not using pass phrase session created known hosts file = C:\Documents and Settings\sport/.ssh/known_hosts FtpAgent_FTPFileTransferJob_connection completed_s sftp channel opened

42 38 Chapter 2 Konfigurieren des FTP-Agenten 2.9 Einrichten von SSL Rufen Sie zur Einrichtung von SSL das x509-zertifikat vom Application-Server ab, wandeln Sie es in eine Binärdatei um, wenn es als Textdatei vorliegt, und importieren Sie das Zertifikat in die CACERTS-Datei der JRE. Bei der SSL-Authentifizierung handelt es sich nicht um eine RA-Funktion, sondern um eine Funktion der JVM-Infrastruktur. So stellen Sie mit SSL eine Verbindung zu einem Dienst her: 1. Rufen Sie das x509-zertifikat vom Application-Server (FTPS-Server, HTTPS-Webdienst usw.) ab. 2. Wenn die Zertifikatdatei im Textformat vorliegt, verwenden Sie den folgenden Befehl, um sie in das Binärformat umzuwandeln: openssl x509 -in "<Name des absoluten Pfads der Zertifikatdatei>" -out cert.der -outform DER 3. Geben Sie den folgenden Befehl ein, um das Zertifikat in die CACERTS-Datei der Java- Laufzeitumgebung (JRE) zu importieren: keytool -import -v -alias servercert -file cert.der -keystore "<Pfad der CACERTS-Datei für Ihre JRE>"

43 FTP Agent Guide SOCKS-Proxyserver verwenden Sie können die Proxyserver-Einstellungen für Connection-Objekte, bei denen das Kontrollkästchen Socks-Proxyservereinstellungen verwenden aktiviert ist, auf der untergeordneten Registerkarte SOCKS-Proxyservereinstellungen vornehmen. Der Proxyserver muss ein SOCKS 4- oder SOCKS 5- Server sein. So konfigurieren Sie einen SOCKS-Proxyserver für einen FTP-Agenten: 1. Wählen Sie im FTP-Agenten die Registerkarte Agent-Einstellungen und dann die untergeordnete Registerkarte SOCKS-Proxyservereinstellungen wie in Abbildung A gezeigt aus. Die untergeordnete Registerkarte SOCKS-Proxyservereinstellungen des Agenten 2. Geben Sie IP-Adresse und Port des Proxyservers in die Felder IP-Adresse und Port ein. 3. Geben Sie optional den Benutzernamen und das Kennwort des Proxyservers in die Felder Benutzername und Kennwort ein. 4. Aktivieren Sie für jedes Connection-Objekt, bei dem die Einstellungen der untergeordneten Registerkarte SOCKS-Proxyservereinstellungen des Agenten verwendet werden sollen, das Kontrollkästchen Socks-Proxyservereinstellungen verwenden wie in Abbildung B gezeigt.

44 40 Chapter 2 Konfigurieren des FTP-Agenten Beispiel eines FTP-Connection-Objekts mit aktiviertem Kontrollkästchen Socks-Proxyservereinstellungen verwenden 5. Wenn Sie einen SOCKS-Proxyserver für die Protokolle FTP, FTPS und FTPES verwenden, sollten Sie auch das Kontrollkästchen Active Mode erzwingen in den Connection-Objekten aktivieren. Falls Sie den voreingestellten passiven Modus verwenden, kann der FTP-Agent keine Verbindung zum FTP-Server aufbauen, sodass die Aufgaben fehlschlagen. Die folgende Dokumentation stammt von Oracle und ist als Referenz beigefügt. Aktualisierungen und weitere Informationen erhalten Sie auf der Website von Oracle sowie über die bereitgestellte Dokumentation. Einstellungen zur Unterstützung des SOCKS-Protokolls Der Benutzername und das Kennwort für SOCKS werden folgendermaßen ermittelt: Zuerst wird überprüft, ob die Anwendung eine Standardinstanz von java.net.authenticator registriert hat. Wenn dies der Fall ist, wird diese Instanz mit dem String "SOCKS5" als Protokoll um dem String "SOCKS authentication" als Anfrage abgefragt. Wenn der Authenticator keinen Benutzernamen und kein Kennwort zurückgibt oder kein Authenticator registriert ist, überprüft das System die Benutzereinstellungen "java.net.socks.username" und "java.net.socks.password". Wenn diese Einstellungen nicht vorhanden sind, wird die Systemeigenschaft "user.name" auf einen Benutzernamen überprüft. In diesem Fall wird kein Kennwort übermittelt. socksproxyhost socksproxyport (Standardwert: 1080) Gibt den Namen des SOCKS-Proxyservers und die Portnummer für die SOCKS- Protokollschicht an. Wenn für "socksproxyhost" ein Wert festgelegt wurde, wird bei allen TCP-Sockets der SOCKS-Proxyserver genutzt, um eine Verbindung herzustellen oder eine Verbindung anzunehmen. Als SOCKS- Proxyserver kann ein SOCKS-v4- oder SOCKS-v5-Server verwendet werden. Der Server muss nicht authentifizierte Verbindungen zulassen.

45 FTP Agent Guide FTP-Proxyserver verwenden Sie können die FTP-Proxyserver-Einstellungen für FTP-Connection-Objekte, bei denen das Kontrollkästchen FTP-Proxyservereinstellungen verwenden aktiviert ist, auf der untergeordneten Registerkarte FTP-Proxyservereinstellungen vornehmen. So konfigurieren Sie einen FTP-Proxyserver für einen FTP-Agenten: 1. Wählen Sie im FTP-Agent die Registerkarte Agent-Einstellungen und dann die untergeordnete Registerkarte FTP-Proxyservereinstellungen wie in Abbildung A gezeigt aus. Die untergeordnete Registerkarte FTP-Proxyservereinstellungen des Agenten 2. Geben Sie IP-Adresse und Port des Proxyservers in die Felder IP-Adresse und Port ein. 3. Geben Sie optional den Benutzernamen und das Kennwort des Proxyservers in die Felder Benutzername und Kennwort ein. 4. Wählen Sie das Optionsfeld für ihren FTP-Proxy-Typ aus. Daraufhin wird das Textfeld mit den entsprechenden Befehlsabfolgen und den zugehörigen Werten ausgefüllt, die mithilfe von Ersatzvariablen festgelegt werden. Jede Ersatzvariable besitzt je zwei

46 42 Chapter 2 Konfigurieren des FTP-Agenten Unterstriche vor und nach ihrem Namen. Unter dem Textfeld befindet sich eine Liste von Ersatzvariablen.. FTP-Proxy-Typ: USER@HOST SITE OPEN Custom Textfeld wird ausgefüllt mit: USER proxyuser PASS proxypassword USER targethost PASS password USER proxyuser PASS proxypassword SITE targethost USER user PASS password USER proxyuser PASS proxypassword OPEN targethost USER user PASS password Nichts Falls Sie USER@HOST, SITE oder OPEN wählen, brauchen Sie nichts im Textfeld zu ändern. Bei Bedarf jedoch können Sie diese Befehle und ihre Werte bearbeiten (Sie können direkt eingegebene Werte statt Ersatzvariablen verwenden) oder mit leerem Textfeld beginnen, indem Sie Custom auswählen. 5. Aktivieren Sie für jedes Connection-Objekt mit Protokolltyp FTP, bei dem die Einstellungen der untergeordneten Registerkarte FTP-Proxyservereinstellungen des Agenten verwendet werden sollen, das Kontrollkästchen FTP-Proxyservereinstellungen verwenden wie in Abbildung B gezeigt. Ein Beispiel FTP Connection-Objekt, das die FTP-Proxyservereinstellungen verwenden Option aktiviert hat

47 FTP Agent Guide 43 3 Arbeiten mit FTP-Jobs 3.1 Einführung in FTP-Jobs FTP-Jobs verfügen über die spezielle Registerkarte Ftp mit zwei Dateibrowsern für Hosts sowie einer Liste von Befehlen, die Sie per Drag-and-Drop in die Befehlsabfolge des entsprechenden Jobs verschieben können. FTP-Jobs (FTPAGENT > FTPJOB) verfügen über die spezielle Registerkarte Ftp mit einem Rapid Automation-Panel. Die Registerkarte Ftp dient zum Festlegen der FTP-Parameter und -Befehle. Für die Felder und Befehle auf der Registerkarte Ftp können AE-Variablen eingegeben werden. In der Automation Engine v9 Service Pack 4 und höher können Sie die auf der Registerkarte Ftp festgelegten Einstellungen überschreiben, und zwar: Für einen Durchlauf eines von Ihnen ausgeführten FTP-Jobs. Um diese Option für den Job zu aktivieren, muss die Option Taskparameter abfragen auf der Registerkarte RA der Jobdefinition aktiviert werden. Weitere Informationen finden Sie im Abschnitt Beispiel: Verwenden von AE- Variablen in FTP-Jobs. Für FTP-Jobs, die als Aufgabe zu einem Workflow hinzugefügt wurden. Weitere Informationen zum Bearbeiten der in einem Workflow enthaltenen Aufgaben finden Sie in der Dokumentation zu Ihrer Automation Plattform. Für einen Durchlauf einer gegenwärtig nicht ausgeführten Aufgabe im Fenster Aktivitäten. Klicken Sie dazu mit der rechten Maustaste auf die Aufgabe, und wählen Sie die Option Aufgaben Parameter modifizieren. Beispiel einer FTP-Jobdefinition Abbildung A zeigt einen beispielhaften FTP-Job, bei dem die Registerkarte Ftp sichtbar ist. Die Registerkarte Ftp enthält die folgenden Elemente:

48 44 Chapter 3 Arbeiten mit FTP-Jobs Oben im Fenster werden zwei Dateibrowser angezeigt. Der Dateibrowser auf der linken Seite trägt die Bezeichnung Host A, der Browser auf der rechten Seite die Bezeichnung Host B. Links unten auf dem Bildschirm wird eine Liste häufig verwendeter Befehle angezeigt, die auf allen FTP-Servern zur Verfügung stehen. Verwenden Sie den Befehlstyp FTP Kommandozeile, um FTP-Anweisungen/-Befehle einzugeben. Weitere Informationen finden Sie im Abschnitt Einstellungen für die FTP Kommandozeile. Rechts unten auf dem Bildschirm wird die Befehlsabfolge des Jobs angezeigt. Die Befehlsabfolge enthält alle Befehle eines Jobs in der entsprechenden Reihenfolge. Die Titelleiste der Befehlsabfolge enthält Schaltflächen, mit denen Sie Jobeinstellungen festlegen und Befehle erweitern, reduzieren sowie löschen können.

49 FTP Agent Guide Verwenden der Dateibrowser von FTP-Jobs Die im oberen Teil der Registerkarte Ftp angezeigten Dateibrowser beziehen sich auf zwei Hosts. Sie können bei beiden Hosts das lokale Dateisystem, auf dem sich der Agent befindet, oder ein FTP- Connection-Objekt auswählen. Unter den Host-Feldern werden in Tabellen die Verzeichnisse und Dateien für die ausgewählten Hosts und ihr aktueller Pfad angezeigt. Für den FTP-Job sind oben auf der Registerkarte Ftp zwei Dateibrowser verfügbar. In Abbildung A ist ein beispielhafter FTP-Job dargestellt. FTP-Jobs verfügen im oberen Teil der Registerkarte "Ftp" über zwei Dateibrowser. Die beiden Dateibrowser im oberen Teil der Registerkarte Ftp bestehen aus folgenden Elementen: Host A oder B. Die verfügbaren Hosts in diesem Dropdown-Menü können folgende Elemente umfassen: Lokales Dateisystem: Das Dateisystem, auf dem sich der FTP-Agent befindet. Der Agent wurde auf der Registerkarte Attribute des Jobs ausgewählt. Alle Connection-Objekte, auf die Sie Zugriff haben. AE-Variablen im Format &<name>#, z. B. &CONNECTION_XYZ#. Beide Hosts können sowohl Quelle als auch Ziel der Transfers sein, die Sie festlegen. Die Festlegung von Host A und Host B als Quelle bzw. Ziel hängt von der Definition der Befehle in der Befehlsabfolge unten ab. Sie können die Werte für Host A und Host B ändern, nachdem Sie Befehle erstellt haben. Dabei werden die Verbindungsdaten sämtlicher Befehle aktualisiert, die Sie bereits in die Befehlsabfolge aufgenommen haben.

50 46 Chapter 3 Arbeiten mit FTP-Jobs Ein bearbeitbares Kombinationsfeld für den aktuellen Pfad Dieses Feld umfasst Folgendes: Einen Pfeil nach oben, um im Pfad eine Ebene nach oben zu wechseln. Ein Aktualisierungssymbol, um den ausgewählten Browser zu aktualisieren. Ein Dropdown-Menü zur Auswahl der Unterverzeichnisse unter dem aktuellen Pfad. Wenn Sie den Pfad durch die Auswahl eines neuen Verzeichnisses ändern, wird die Tabelle unten aktualisiert. Ein neues Verzeichnis können Sie folgendermaßen auswählen: Geben Sie im Verzeichnisfeld ein neues Verzeichnis ein, und drücken Sie die Eingabetaste. Klicken Sie auf das Verzeichnisfeld, und drücken Sie die Nach-oben- und Nach-unten- Pfeiltasten auf Ihrer Tastatur, um ein Verzeichnis auszuwählen. Drücken Sie abschließend die Eingabetaste. Doppelklicken Sie auf ein Verzeichnis in der Tabelle unten. Eine Tabelle mit den Verzeichnissen und Dateien des aktuell ausgewählten Pfads. Die hier ausgewählten Verzeichnisse und Dateien können per Drag-and-Drop in die Befehle verschoben werden, die in der Befehlsabfolge unten auf dem Bildschirm definiert wurden. Wenn Sie den Pfad durch Wechseln in ein Verzeichnis ändern, wird die Pfadanzeige oben aktualisiert. Unterabschnitte In den folgenden Unterabschnitten werden FTP-Jobs beschrieben, die den Befehl Datei(en) kopieren verwenden, und zwar: Von einem lokalen Dateisystem zu einem entfernten Host mit FTP-Server. Zwischen zwei entfernten Hosts mit FTP-Servern.

51 FTP Agent Guide Beispiel: Kopieren von Dateien zwischen einem lokalen Dateisystem und einem entfernten FTP-Server In dem nachfolgenden Beispiel wird ein Datei(en) kopieren -Befehl definiert, um Dateien von einem lokalen Dateisystem zu einem entfernten Host mit FTP-Server zu kopieren. Wenn auf einem Host ein FTP-Agent installiert ist, können Sie Übertragungsbefehle von und zu diesem Host ausführen, indem Sie ein Connection-Objekt definieren. Ein Beispieldiagramm ist in Abbildung A dargestellt. Beachten Sie, dass Sie selbst dann ein Connection-Objekt für den Host (das nicht dem Agenten entspricht, der auf der Registerkarte Attribute des Jobs im Feld Host ausgewählt wurde) definieren müssen, wenn Sie eine Verbindung zwischen zwei Hosts aufbauen, für die Sie FTP-Agenten definiert haben. Ein Host mit einem Agenten und ein zweiter mit einem Connection-Objekt Um Befehle zwischen einem lokalen Dateisystem und einem entfernten Host mit FTP-Server auszuführen, gehen Sie wie folgt vor: 1. Wählen Sie wie in Abbildung B dargestellt auf der Registerkarte Attribute des Jobs im Feld Host den RA FTP-Agenten aus. Host des FTP-Agenten 2. Wählen Sie im Feld Host A bzw. Host B das lokale Dateisystem und ein Connection-Objekt für den anderen Host aus. Es spielt keine Rolle, welcher Host als Quelle und welcher als Ziel dient. Dies wird beim Definieren der Befehle für den Job festgelegt. In Abbildung C wird im Feld Host A das lokale Dateisystem und im Feld Host B das Connection- Objekt VWADEV27_SFPT ausgewählt. Das für das Connection-Objekt definierte Protokoll (FTP, FTPS, FTPES oder SFTP) bestimmt das Protokoll der Befehle des Jobs.

52 48 Chapter 3 Arbeiten mit FTP-Jobs Der Agent und das Connection-Objekt, der/das als Host ausgewählt wurde Beim Ausführen des Jobs werden Befehle von dem Host ausgeführt, auf dem der Agent installiert ist. Einige Beispiele: Für Host A ist das lokale Dateisystem, für Host B ein Connection-Objekt ausgewählt. Der Befehl Datei(en) kopieren kopiert eine Datei von dem Host, auf dem der Agent installiert ist, zu dem Host mit dem definierten Connection-Objekt. In diesem Fall kopiert der Agent eine Datei vom lokalen Host (auf dem sich der Agent befindet) zum dem Host, der im angegebenen Connection-Objekt definiert wurde. Weitere Informationen zum Befehl Datei(en) kopieren finden Sie im Abschnitt Einstellungen für den Befehl "Datei(en) kopieren". Für Host A ist das lokale Dateisystem, für Host B ein Connection-Objekt ausgewählt. Der Befehl Datei(en) kopieren kopiert Datei vom Host mit dem definierten Connection-Objekt zu dem Host, auf dem der Agent installiert ist und ausgeführt wird. In diesem Fall kopiert der Host mit dem installierten Agent eine Datei von dem Host, für den das Connection-Objekt definiert wurde.

53 FTP Agent Guide Beispiel: Dateien zwischen zwei entfernten FTP- Servern transferieren Im nachfolgenden Beispiel wurde der Befehl Datei(en) kopieren für zwei entfernte Hosts mit installiertem FTP-Server definiert. Um Befehle zwischen zwei Hosts mit installiertem FTP-Server auszuführen, werden Connection-Objekte verwendet. In diesem Fall führt der FTP-Agent die Befehle auf beiden Hosts aus. Dieses Szenario empfiehlt sich, wenn Sie auf keinem der Hosts, zwischen denen Sie die Befehle ausführen, einen Agenten installieren können oder möchten. Bei diesem Szenario wird für die meisten Befehle, die Sie in einem Job definiert haben, auf beiden Hosts ein Befehl ausgeführt. Ein Beispieldiagramm ist in Abbildung A dargestellt. Der Agent führt die Befehle auf beiden Hosts aus. Beim Ausführen von Befehlen zwischen zwei entfernten Hosts mit FTP-Servern gehen Sie wie folgt vor: 1. Wählen Sie wie in Abbildung B dargestellt auf der Registerkarte Attribute des Jobs im Feld Host den RA FTP-Agenten aus. Host des FTP-Agenten 2. Wählen Sie in den Feldern Host A und Host B die Connection-Objekte aus.

54 50 Chapter 3 Arbeiten mit FTP-Jobs In Abbildung C wird im Feld Host A das Connection-Objekt VWADEV29_SFPT und im Feld Host B das Connection-Objekt VWADEV27_SFPT ausgewählt. Zwei Connection-Objekte, die als Hosts ausgewählt wurden Beim Ausführen des Jobs werden Befehle von dem Host ausgeführt, auf dem der Agent installiert ist. Wenn zum Beispiel der Befehl Datei(en) kopieren zwischen zwei Hosts ausgeführt wird, werden folgende Schritte durchgeführt: 1. Der Host mit dem installierten Agent kopiert eine Datei von einem Host, für den ein Connection- Objekt definiert wurde. 2. Der Host mit dem installierten Agent kopiert die Datei zu dem anderen Host, für den ein Connection-Objekt definiert wurde.

55 FTP Agent Guide Hinzufügen, Verschieben, Bearbeiten und Löschen von Befehlen in Befehlssequenzen Über die Registerkarte Ftp können Sie Befehle zur Befehlsabfolge eines Jobs hinzufügen, Befehle in die Befehlsabfolge verschieben sowie Befehle bearbeiten oder löschen. Mithilfe der Liste Befehle und der Befehlsabfolge können Sie die Befehle für einen FTP-Job verschieben, bearbeiten und löschen. In Abbildung A ist ein beispielhafter FTP-Job dargestellt. Beispiel eines FTP-Jobs Hinzufügen von Befehlen zur Befehlsabfolge eines Jobs Sie können Befehle zur Befehlsabfolge eines Jobs auf eine der folgenden Weisen hinzufügen: Durch Ziehen und Ablegen von Dateien zwischen den Dateibrowsern Wenn Sie Dateien zwischen den Dateibrowsern ziehen und ablegen, wird der Befehl Datei(en) kopieren zur Befehlsabfolge hinzugefügt. Durch Ziehen und Ablegen von Befehlen aus der Liste Befehle in die Befehlsabfolge rechts auf dem Bildschirm Die vertikale Anordnung beim Ablegen des Befehls bestimmt dessen Position in der Befehlsabfolge. Sie können Befehle auch in den Befehlen Wenn erfolgreich oder Wenn fehlgeschlagen ablegen. Durch Doppelklicken auf die Befehle aus der Liste Befehle. Wenn der Befehl in der Befehlsabfolge ausgewählt wurde, wird nach Doppelklicken auf einen Befehl in der Liste Befehle der neue Befehl in der Befehlsabfolge an letzter Stelle angezeigt. Nachdem ein Befehl zur Befehlsabfolge hinzugefügt wurde, können Sie dessen Einstellungen bearbeiten.

56 52 Chapter 3 Arbeiten mit FTP-Jobs Verschieben von Befehlen in die Befehlsabfolge Sie können jederzeit Befehle in der Befehlsabfolge ziehen und ablegen, um ihre Reihenfolge zu verändern oder sie dem Befehl Wenn erfolgreich bzw. Wenn fehlgeschlagen zuzuordnen. Bearbeiten und Löschen von Befehlen in der Befehlsabfolge So bearbeiten oder löschen Sie vorhandene Befehle in der Befehlsabfolge eines Jobs: 1. Verwenden Sie die folgenden Symbole, um Befehle in der Befehlsabfolge zu erweitern, zu reduzieren oder zu löschen. Aktion: Symbol: Titelleiste: Erweitern eines einzelnen Befehls in der Befehlsabfolge Erweitern sämtlicher Befehle in der Befehlsabfolge Reduzieren eines einzelnen Befehls in der Befehlsabfolge Reduzieren sämtlicher Befehle in der Befehlsabfolge Löschen eines einzelnen Befehls aus der Befehlsabfolge Löschen sämtlicher Befehle aus der Befehlsabfolge Titelleiste des Befehls Titelleiste der Befehlsabfolge Titelleiste des Befehls Titelleiste der Befehlsabfolge Titelleiste des Befehls Titelleiste der Befehlsabfolge Es ist auch möglich, einen Befehl in der Befehlsabfolge durch Doppelklicken auf dessen Titelleiste zu erweitern bzw. zu reduzieren. 2. Um Befehle zu bearbeiten, geben Sie Werte für die Befehlsdefinition ein. Jeder Befehlstyp ist anders definiert. Befehlstypen können folgende Elemente enthalten: Felder zur Eingabe von Daten am Anfang der Definition Registerkarten mit Optionen und zusätzlichen Einstellungen Die Befehle Wenn erfolgreich und Wenn fehlgeschlagen enthaltenfelder, auf die Sie weitere Befehle ziehen können, die ausgeführt werden, wenn der vorherige Befehl erfolgreich war bzw. fehlgeschlagen ist. 3. In der Registerkarte Kommentar können Sie eine Beschreibung des Befehls eingeben, um den Befehl zu kommentieren. In Abbildung B ist die Registerkarte Kommentar eines Befehls dargestellt.

57 FTP Agent Guide 53 Beispiel einer Registerkarte zur Beschreibung von Befehlen Texte, die in der Registerkarte Kommentar eingegeben wurden, werden nicht in die Ausgabedatei des Jobs eingefügt, wenn dieser ausgeführt wird. Verwenden Sie den Befehl Log Ausgabe, um Text in die Ausgabedatei eines Jobs einzufügen. Weitere Informationen finden Sie im Abschnitt Einstellungen für den Befehl "Log Ausgabe". Unterabschnitte In den folgenden Unterabschnitten werden die in der Liste Befehle verfügbaren FTP-Befehle für FTP-Jobs beschrieben.

58 54 Chapter 3 Arbeiten mit FTP-Jobs Einstellungen für den Befehl "Datei(en) kopieren" Verwenden Sie den Befehl Datei(en) kopieren, um Dateien zwischen Hosts zu verschieben. Mit dem in Abbildung A dargestellten Befehl Datei(en) kopieren können Dateien zwischen Hosts verschoben werden. Beachten Sie, dass die Befehle get und put in der Benutzeroberfläche nicht zu sehen sind. Ob der FTP-Befehl get oder put verwendet wird, hängt davon ab, welche Verbindungen in den Dropdown-Feldern Von und Nach ausgewählt wurden. Beispiel für den Befehl "Datei(en) kopieren" So kopieren Sie Dateien: 1. Wählen Sie die Hosts aus den Dropdown-Feldern Von und Nach aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Datei(en)/Verzeichnis einen absoluten oder relativen Pfad für die Datei(en) auf dem Quellhost an. Sie können Pfade/Dateien aus den Dateibrowsern oben ziehen und ablegen. 3. In diesem Feld können Sie die Platzhalter * und? verwenden. Der Platzhalter * steht für eine beliebige Anzahl von Zeichen, der Platzhalter? für ein einzelnes Zeichen. Platzhalterzeichen bilden einen Filter, den Sie zum Festlegen von Dateien verwenden können, die übertragen werden sollen. Zu kopierende Dateien: Dateien mit der Erweiterung.txt Bestimmte Dateien mit dem Namen report und beliebiger Erweiterung Bestimmte Dateien mit dem Namen quarter, gefolgt von einem einzelnen Zeichen Eingabe: *.txt report.* quarter? Dateien, deren Name aus genau vier aber beliebigen Zeichen besteht????

59 FTP Agent Guide Geben Sie das Ziel im Feld Pfad an. Element: Ein Unterverzeichnis für eine einzelne oder für mehrere Dateien Ein Dateiname in einem Unterverzeichnis für eine einzelne Datei Eingabe: Pfad zum Unterverzeichnis Beispiel: /home/logs Der Pfad mit dem Dateinamen Beispiel: /home/logs/out.txt Sie können Pfade/Dateien aus den Dateibrowsern oben ziehen und ablegen. Der Pfad im Feld Pfad muss vorhanden sein. Der Befehl Datei(en) kopieren erstellt keine Unterverzeichnisse. Um ein neues Unterverzeichnis zu erstellen, fügen Sie den Befehl Verzeichnis anlegen vor dem Befehl Datei(en) kopieren ein. 5. Füllen Sie die in der nachfolgenden Tabelle angegebenen Felder auf der Registerkarte Optionen aus. Feld Übertragungstyp (FTP) Beschreibung Legt einen der folgenden Werte als Dateityp fest: ASCII: Legt den ASCII-Übertragungsmodus fest. BINÄR: Legt den binären Übertragungsmodus fest. IMAGE: Legt den Bildübertragungsmodus fest. Die Daten werden in diesem Fall als ununterbrochener Bitstrom gesendet, der für den Datentransfer in 8-Bit-Pakete aufgeteilt wird. EBCDIC: Legt den EBCDIC-Übertragungsmodus fest. In diesem Fall wird EBCDIC für die interne Zeichendarstellung verwendet. LOCAL: Legt den lokalen Übertragungsmodus fest. Die Daten werden in diesem Fall in logischen Bytes übertragen, deren Größe durch den zweiten obligatorischen Parameter "Bytegröße" bestimmt wird. Diese Einstellung gilt nur für Jobs, bei denen FTP als Protokoll für das Connection-Objekt festgelegt ist. Beachten Sie, dass das Connection-Objekt eines Jobs durch eine AE-Variable angegeben werden kann. Die Attribute des Connection-Objekts können mit dem Befehl :PUT_ATT überschrieben werden.

60 56 Chapter 3 Arbeiten mit FTP-Jobs Feld Datenübertragungsmodus (SFTP) Beschreibung Legt den Übertragungsmodus fest: STREAM: Die Daten werden als ununterbrochener Datenstrom gesendet. Das FTP-Protokoll wird in diesem Fall von der Verarbeitung befreit. Die Datenverarbeitung wird stattdessen auf TCP-Ebene durchgeführt. Ein Indikator für das Dateiende (End of File) wird nicht benötigt, sofern die Daten nicht in Datensätze unterteilt sind. COMPRESSED: Die Daten werden mithilfe eines Algorithmus (in der Regel eine Lauflängenkodierung, RLE) komprimiert. BLOCK: Das FTP-Protokoll teilt die Daten in mehrere Blöcke auf (mit Kopf, Byteanzahl und Datenfeld) und leitet diese anschließend an die TCP-Ebene weiter. Diese Einstellung gilt nur für Jobs, bei denen SFTP als Protokoll für das Connection-Objekt festgelegt ist. Beachten Sie, dass das Connection-Objekt eines Jobs durch eine AE-Variable angegeben werden kann. Die Attribute des Connection-Objekts können mit dem Befehl :PUT_ATT überschrieben werden. Übertragene Dateien auf Quellhost löschen Unterverzeichnisse und Inhalte kopieren Job abbrechen, wenn Quelldateien nicht gefunden werden Wenn die Datei bereits am Zielhost existiert Wenn diese Option aktiviert ist, werden die Dateien nach erfolgreicher Übertragung vom Quellhost gelöscht. Wenn diese Option aktiviert ist und der Platzhalter * verwendet wird, wird in Unterverzeichnissen des Quellpfads nach passenden Dateien gesucht. Diese werden anschließend kopiert und auf dem Zielhost im selben Unterverzeichnis platziert. Setzt den Jobstatus auf "ABEND", wenn keine Quelldatei gefunden wird. Legt die Vorgehensweise für den Fall fest, dass auf dem Zielhost eine Datei mit demselben Namen wie die zu kopierende Datei vorhanden ist: Datei überspringen: Die Datei wird nicht kopiert. Datei überspringen und "Im Fehlerfall"-Option folgen: Die Datei wird nicht kopiert, und das Flag "Bei Fehler" wird gesetzt (siehe Im Fehlerfall unten). An bestehende Datei anhängen: Hängt die Inhalte der kopierten Datei an die bereits bestehende Datei an. Datei überschreiben: Überschreibt die Datei.

61 FTP Agent Guide 57 Feld Im Fehlerfall Beschreibung Legt das Verhalten für den Fall fest, dass der Befehl Datei(en) kopieren fehlschlägt. Es gibt in diesem Fall zwei Möglichkeiten. Im ersten Fall wird nach einem Fehlschlag beim Ausführen des Befehls Datei(en) kopieren der Befehl Datei(en) kopieren bzw. der gesamte Job abgebrochen. Bei einem Befehlsabbruch wird das Flag "Abbruch bei Fehlschlag" gesetzt. Dieses kann von den Befehlen Wenn fehlgeschlagen bzw. Wenn erfolgreich gelesen werden, der Jobstatus wird dadurch jedoch nicht geändert. Bei einem Jobabbruch wird der Status auf "ABEND" gesetzt. Im zweiten Fall werden nach einem Fehlschlag des Befehls Datei (en) kopieren die verbleibenden Dateien entweder kopiert oder übersprungen. Wenn der Kopierbefehl fehlschlägt, sind folgende Optionen möglich: Verbleibende Dateien kopieren und Befehl abbrechen: Kennzeichnet den Befehl als abgebrochen und kopiert die verbleibenden Dateien des Befehls. Verbleibende Dateien kopieren und Job abbrechen: Setzt den Jobstatus auf "ABEND" und kopiert die verbleibenden Dateien des Befehls. Verbleibende Dateien überspringen und Befehl abbrechen: Kennzeichnet den Befehl als abgebrochen und überspringt die verbleibenden Dateien des Befehls. Verbleibende Dateien überspringen und Job abbrechen: Setzt den Jobstatus auf "ABEND" und überspringt die verbleibenden Dateien des Befehls. 6. Nur für z/os-jobs: Füllen Sie die in Abbildung B dargestellten Felder auf der Registerkarte z/os aus. Eingabe der z/os-befehle auf der Registerkarte z/os Die z/os-felder werden in der nachfolgenden Tabelle beschrieben. Feld Beschreibung Block size Die Blockgröße (BLKSIZE). Record length Die Anzahl der Bytes pro Datensatz (LRECL).

62 58 Chapter 3 Arbeiten mit FTP-Jobs Feld Record format (recfm) Record descriptor word Space unit Primary storage (primary) Secondary storage (secondary) Partitional directory blocks Beschreibung Die in diesem Datensatz enthaltenen Datensatztypen (RECFM). Record descriptor word aufzeichnen oder nicht. Tracks oder Zylinder als Speichereinheit verwenden. Die Zuordnungsnummer für den primären Speicher. Die Zuordnungsnummer für den sekundären Speicher. Nummer der Verzeichnisblöcke auf der Partition. Weitere Informationen zu z/os-einstellungen finden Sie in der Dokumentation zum z/os- Betriebssystem.

63 FTP Agent Guide Einstellungen für den Befehl "Verzeichnis anlegen" Der Befehl Verzeichnis anlegen erstellt ein Unterverzeichnis. Sie können nur ein Verzeichnis pro Befehl erstellen. Das Erstellen einer Verzeichnishierarchie mit einem einzigen Befehl ist nicht möglich. Der in Abbildung A dargestellte Befehl Verzeichnis anlegen erstellt ein Verzeichnis. Beispiel für den Befehl "Verzeichnis anlegen" So erstellen Sie ein Verzeichnis: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Pfad einen absoluten oder relativen Pfad an. Sie können einen Pfad aus den Dateibrowsern oben ziehen und ablegen. 3. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll. Sie können nur ein Verzeichnis pro Befehl erstellen. Das Erstellen einer Verzeichnishierarchie mit einem einzigen Befehl ist nicht möglich. Um unter dem neuen Verzeichnis weitere Verzeichnisse zu erstellen, fügen Sie in der Befehlsabfolge weitere Verzeichnis anlegen-befehle hinzu.

64 60 Chapter 3 Arbeiten mit FTP-Jobs Einstellungen für den Befehl "Löschen" Der Befehl Löschen löscht eine oder mehrere Dateien bzw. Verzeichnisse. Der in Abbildung A dargestellte Befehl Löschen löscht eine oder mehrere Dateien bzw. Verzeichnisse. Beispiel für den Befehl "Löschen" So löschen Sie eine oder mehrere Dateien bzw. Verzeichnisse: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Datei/Verzeichnis einen absoluten oder relativen Pfad für die Datei bzw. das Verzeichnis an. In diesem Feld können Sie die Platzhalter * und? verwenden. Der Platzhalter * steht für eine beliebige Anzahl von Zeichen, der Platzhalter? für ein einzelnes Zeichen. Zu löschende Dateien: Dateien mit der Erweiterung.txt Bestimmte Dateien mit dem Namen report und beliebiger Erweiterung Bestimmte Dateien mit dem Namen quarter, gefolgt von einem einzelnen Zeichen Eingabe: *.txt report.* quarter? Dateien, deren Name aus genau vier aber beliebigen Zeichen besteht???? Sie können einen Pfad aus den Dateibrowsern oben ziehen und ablegen. 3. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll. 4. Aktivieren Sie das Kontrollkästchen Dateien in Unterverzeichnissen löschen, um untergeordnete Verzeichnisse samt Dateien zu löschen, wenn sie den Platzhalterkriterien für das Feld Datei/Verzeichnis entsprechen. 5. Wenn das Kontrollkästchen Dateien in Unterverzeichnissen löschen aktiviert ist, können Sie bei Bedarf leere Verzeichnisse mit dem Befehl Leere Verzeichnisse löschen löschen.

65 FTP Agent Guide Einstellungen für den Befehl "Umbenennen" Mit dem Befehl Umbenennen können einzelne Dateien bzw. Verzeichnisse umbenannt werden. Mit dem Befehl Umbenennen können einzelne Dateien bzw. Verzeichnisse umbenannt werden. Der in Abbildung A dargestellte Befehl Umbenennen gibt die zwei für das Feld Neuer Datei-/Verzeichnisname zulässigen Syntaxstrukturen an. Beispiel für den Befehl "Umbenennen" So benennen Sie eine Datei oder ein Verzeichnis um: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Datei-/Verzeichnisname einen absoluten oder relativen Pfad an. Sie können Pfade aus den Dateibrowsern oben ziehen und ablegen. 3. Geben Sie im Feld Neuer Datei-/Verzeichnisname einen neuen Dateinamen an. Sie können den neuen Dateinamen folgendermaßen eingeben: Den Pfad aus dem Feld Datei-/Verzeichnisname und den neuen Dateinamen. Z. B. config/options_old.ini. Nur den neuen Dateinamen, ohne das im Feld Datei-/Verzeichnisname angegebene Verzeichnis. Z. B. options_old.ini. Beide Beispiele sind in Abbildung A dargestellt. 4. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll.

66 62 Chapter 3 Arbeiten mit FTP-Jobs Einstellungen für den Befehl "Verzeichnisinhalt auflisten" Mit dem Befehl Verzeichnisinhalt auflisten können Dateien in einem Verzeichnis aufgelistet und in den Job-Report geschrieben werden. Mit dem in Abbildung A dargestellten Befehl Verzeichnisinhalt auflisten können Dateien in einem Verzeichnis aufgelistet und in den Job-Report geschrieben werden. Beispiel für den Befehl "Verzeichnisinhalt auflisten" So listen Sie die Dateien in einem Verzeichnis auf: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Pfad einen absoluten oder relativen Pfad an. Sie können einen Pfad aus den Dateibrowsern oben ziehen und ablegen. 3. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll.

67 FTP Agent Guide Einstellungen für den Befehl "Verzeichnis wechseln" Mit dem Befehl Verzeichnis wechseln kann das absolute bzw. relative Verzeichnis geändert werden. Mit dem in Abbildung A dargestellten Befehl Verzeichnis wechseln kann das aktuelle Verzeichnis geändert werden. Da Sie im oben dargestellten Browser für beide Hosts einen absoluten Pfad festlegen können, wird dieser Befehl nur in Verbindung mit anderen Befehlen verwendet. Beispiel für den Befehl "Verzeichnis wechseln" So ändern Sie das aktuelle Verzeichnis: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Pfad den zu ändernden absoluten oder relativen Pfad an. Sie können einen Pfad aus den Dateibrowsern oben ziehen und ablegen. 3. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll.

68 64 Chapter 3 Arbeiten mit FTP-Jobs Einstellungen für die Befehle "Wenn fehlgeschlagen" und "Wenn erfolgreich" Mit dem Befehl Wenn fehlgeschlagen können Sie einen oder mehrere Befehle einfügen, wenn der vorherige Befehl fehlgeschlagen ist. Mit dem Befehl Wenn erfolgreich können Sie einen oder mehrere Befehle einfügen, wenn der vorgehende Befehl erfolgreich war. Beide Befehle beinhalten das Feld "Sonst". Dort können Sie ebenfalls einen oder mehrere Befehle einfügen. Sie können Befehle per Drag-and-Drop aus der Liste Befehle in diese Felder verschieben, wie Sie es auch beim Hinzufügen von Befehlen zur Befehlsabfolge tun. Zudem können Sie per Drag-and-Drop vorhandene Befehle zwischen diesen Feldern und der übrigen Befehlsabfolge verschieben. Mit dem in Abbildung A dargestellten Befehl Wenn fehlgeschlagen können Sie Befehle festlegen, die ausgeführt werden sollen, wenn der vorhergehende Befehl: fehlschlägt erfolgreich ist (mit dem Feld sonst) Beispiel für den Befehl "Wenn fehlgeschlagen" Mit dem in Abbildung B dargestellten Befehl Wenn erfolgreich können Sie Befehle festlegen, die ausgeführt werden sollen, wenn der vorhergehende Befehl: erfolgreich ist fehlschlägt (mit dem Feld sonst) Beispiel für den Befehl "Wenn erfolgreich"

69 FTP Agent Guide 65 Die Befehle Wenn fehlgeschlagen und Wenn erfolgreich funktionieren auf ähnliche Weise, kommen jedoch in gegensätzlichen Kontexten vor.

70 66 Chapter 3 Arbeiten mit FTP-Jobs Einstellungen für die FTP Kommandozeile Mit dem Befehl FTP Kommandozeile können eigene Befehle definiert werden. Mit den Befehlen der FTP Kommandozeile wie in Abbildung A gezeigt können Sie eigene Befehle unter Verwendung von statischen Befehlen bzw. AE-Variablen definieren. Beispiel zu aus statischen Befehlen und AE-Variablen gebildeten Befehlen. So definieren Sie den Befehl FTP Kommandozeile: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie Befehle in das Feld Befehle ein. Wenn in den Verzeichnissen bzw. Dateien Leerzeichen enthalten sind, müssen Sie das Argument in doppelte Anführungszeichen " " einfassen. In diesem Feld sind AE-Variablen im Format &<name># zulässig. Leere Zeilen sind nun erlaubt. 3. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll. 4. Aktivieren Sie das Kontrollkästchen Den Job abbrechen, wenn die source-datei nicht gefunden wurde (nur bei put-and-get Befehlen benutzen), wenn der Job abgebrochen werden soll, falls keine Quelldateien gefunden werden. FTP-, FTPS- und FTPES-Befehle In der nachfolgenden Tabelle werden die verfügbaren FTP-, FTPS- und FTPES-Befehle beschrieben. Befehl ascii binary image ebcdic Beschreibung Legt den ASCII-Übertragungsmodus fest. Legt den binären Übertragungsmodus fest. Legt den Bildübertragungsmodus fest. Die Daten werden in diesem Fall als ununterbrochener Bitstrom gesendet, der für den Datentransfer in 8- Bit-Pakete aufgeteilt wird. Legt den EBCDIC-Übertragungsmodus fest. In diesem Fall wird EBCDIC für die interne Zeichendarstellung verwendet.

71 FTP Agent Guide 67 Befehl local get remote-path [localpath] [ERASE] put local-path [remotepath] [ERASE] mget remote-path [localpath] [ERASE] mput local-path [remotepath] [ERASE] site arg1 [ arg2 ]... namelis [remote-directory] ls [remote-directory] dir [remote-directory] pwd cwd cd lcd account password allocate bytes mkdir directory-name rmdir directory-name rename from to move from to delete remote-file rm remote-file append local-file [remotefile] transfermode [stream compressed block] filestructure [file page record] Beschreibung Legt den lokalen Übertragungsmodus fest. Die Daten werden in diesem Fall in logischen Bytes übertragen, deren Größe durch den zweiten obligatorischen Parameter "Bytegröße" bestimmt wird. Datei herunterladen. Durch Eingabe des Attributs ERASE am Ende des Befehls können Sie die Quelldatei nach erfolgreicher Übertragung löschen. Datei hochladen. Durch Eingabe des Attributs ERASE am Ende des Befehls können Sie die Quelldatei nach erfolgreicher Übertragung löschen. Mehrere Dateien herunterladen. Durch Eingabe des Attributs ERASE am Ende des Befehls können Sie die Quelldatei nach erfolgreicher Übertragung löschen. Mehrere Dateien hochladen. Durch Eingabe des Attributs ERASE am Ende des Befehls können Sie die Quelldatei nach erfolgreicher Übertragung löschen. Einen Site-Befehl mit Argumenten initiieren. Einen NLST-Befehl in einem Server Verzeichnis ausführen. Eine Liste der Dateien und Unterverzeichnisse in einem Verzeichnis am Server anzeigen. Eine Liste der Dateien und Unterverzeichnisse in einem Verzeichnis am Server anzeigen Den aktuellen absoluten Pfad am Server anzeigen. Den aktuellen Pfad am Server ändern. Das Verzeichnis am Server wechseln. Das Verzeichnis auf dem lokalen Host wechseln. Das Kennwort für die Systemanmeldung. Bytes für den Dateispeicher auf dem Server zuweisen. Ein bestimmtes Verzeichnis am Server erstellen. Ein bestimmtes Verzeichnis am Server löschen. Eine Datei am Server umbenennen. Eine Datei am Server verschieben. Eine Datei am Server löschen. Eine Datei am Server entfernen. Lokale Datei an Datei mit dem gleichen Namen am Server anhängen. Den Übertragungsmodus festlegen. Die Dateistruktur festlegen.

72 68 Chapter 3 Arbeiten mit FTP-Jobs Die FTP-Befehle wurden um zusätzliche Funktionen ergänzt, um dem Konzept des FTP-Agenten gerecht zu werden. Erwähnenswert sind insbesondere die Parameter CANCEL und ERASE. CANCEL bewirkt, dass die Dateiübertragung abgebrochen wird. Beim Übertragen mehrerer Dateien werden diese nacheinander verarbeitet. ERASE bewirkt, dass die Quelldatei nach Abschluss der Dateiübertragung gelöscht wird. SFTP-Befehle In der nachfolgenden Tabelle werden die verfügbaren SFTP-Befehle beschrieben. Befehl cd path lcd path chgrp grp path chmod mode path chown own path help get remote-path [localpath] [ERASE] lls [path] ln oldpath newpath lpwd ls [path] mkdir path put local-path [remotepath] [ERASE] pwd stat path rename oldpath newpath rmdir path rm path symlink oldpath newpath readlink path realpath path rekey compression level Beschreibung Am Server in das Verzeichnis "path" wechseln. In das lokale Verzeichnis "path" wechseln. Gruppe der Datei "path" zu "grp" ändern. Berechtigungen der Datei "path" zu "mode" ändern. Eigentümer der Datei "path" zu "own" ändern. Den Hilfetext anzeigen. Datei herunterladen. Durch Eingabe des Attributs ERASE am Ende des Befehls können Sie die Quelldatei nach erfolgreicher Übertragung löschen. Inhalt des lokalen Verzeichnisses anzeigen. Symbolische Verknüpfung der entfernten Datei erstellen. Den lokalen aktuellen Pfad anzeigen. Eine Liste der Dateien und Unterverzeichnisse in einem Verzeichnis am Server anzeigen. Ein bestimmtes Verzeichnis am Server erstellen. Datei hochladen. Durch Eingabe des Attributs ERASE am Ende des Befehls können Sie die Quelldatei nach erfolgreicher Übertragung löschen. Den aktuellen absoluten Pfad am Server anzeigen. Informationen zum Pfad anzeigen. Eine Datei am Server umbenennen. Ein Verzeichnis am Server löschen. Eine Datei am Server löschen. Symbolische Verknüpfung der Datei am Server erstellen. Das Ziel einer symbolischen Verknüpfung überprüfen. Pfad in seine kanonische Form auflösen. Schlüssel erneut austauschen. Paketkomprimierung aktivieren.

73 FTP Agent Guide Einstellungen für den Befehl "Log Ausgabe" Mit dem Befehl Log Ausgabe kann eine Nachricht in den Job-Report geschrieben werden. Mit dem in Abbildung A dargestellten Befehl Log Ausgabe kann eine Nachricht in den Job-Report geschrieben werden. Beispiel für den Befehl "Log Ausgabe" Beim Ausführen des Jobs schreibt der FTP-Agent eine Nachricht in den Job-Report. Nachfolgend ist eine beispielhafte ECHO-Nachricht im Code eines Job-Reports dargestellt :59:50 Executing command: rename /home/qa4/cardtransactions/store12/ /home/qa4/cardtransactions/store12_ :59:50 on Local File System :59:50 Echo: Der Name des Verzeichnisses wird mit einem Zeitstempel umbenannt, um es einzigartig machen. Sie können zu Testzwecken ein Fehlschlagen des Jobs erzwingen, indem Sie das Kontrollkästchen Job nach Log Ausgabe abbrechen aktivieren.

74 70 Chapter 3 Arbeiten mit FTP-Jobs Einstellungen für den Befehl "Entfernte Ausführung" Mit dem Befehl Entfernte Ausführung können Sie Befehle unter Verwendung von SSH auf entfernten UNIX Systemen ausführen. Unterstützt wird die Entfernte Ausführung nur für SSH zu UNIX-Betriebssystemen. Für SSH sind SFTP Connection-Objekte zu verwenden. SSH-Verbindungen werden immer über den Port geöffnet, der für das SFTP Connection-Objekt konfiguriert ist. Wenn Jobs mit mehreren Befehlen vom Typ Entfernte Ausführung ausgeführt werden, wird für sämtliche Befehle nur eine Anmeldesitzung pro Verbindung verwendet. Beispiel für den Befehl "Entfernte Ausführung" Aus Sicherheitsgründen sind Befehle für die Entfernte Ausführung standardmäßig deaktiviert. Sie werden jedoch immer in der Liste Befehle des FTP-Jobs aufgelistet. Status von "Entfernte Ausführung": Deaktiviert Aktiviert Ergebnis, wenn Job mit dem Befehl "Entfernte Ausführung" ausgeführt wird: Fehlschlag Normale Ausführung Weitere Informationen zum Aktivieren entfernter Befehle für einen FTP-Agenten finden Sie im Abschnitt Einführung in die Konfiguration des FTP-Agenten. So führen Sie einen entfernten Befehl aus: 1. Wählen Sie im Dropdown-Menü Host einen Host aus. Sie können im Dropdown-Menü nur die beiden Hosts auswählen, die in den Dateibrowsern oben ausgewählt wurden. 2. Geben Sie im Feld Befehl einen Befehl ein. In diesem Feld sind AE-Variablen im Format &<name># zulässig. 3. Optional können Sie eine Ziffer für den erwarteten Rückgabewert eingeben, um das Erfolgskriterium des Befehls für das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen zu bestimmen. 4. Deaktivieren Sie das Kontrollkästchen Bei Auftreten eines Fehlers den Job abbrechen, wenn der Job nach einem Fehlschlag des Befehls nicht abgebrochen werden soll.

75 FTP Agent Guide Bearbeiten von Jobeinstellungen Jobeinstellungen wirken sich auf den Job und auf sämtliche Befehle in der Befehlsabfolge aus. Klicken Sie auf die Schaltfläche "Jobeinstellungen", um Jobeinstellungen anzuzeigen und zu bearbeiten. So bearbeiten Sie Jobeinstellungen: 1. Klicken Sie in der Titelleiste der Befehlsabfolge auf die Schaltfläche. Das in Abbildung A dargestellte Fenster Job-Einstellungen wird geöffnet. Beispiel für Jobeinstellungen 2. In der nachfolgenden Tabelle werden die Felder im Fenster Job-Einstellungen beschrieben. Feld Anzahl paralleler Übertragungen Anzahl Verbindungsversuche (nach Verbindungsunterbrechung) Beschreibung Schränkt bei Verwendung von Platzhaltern für die Dateiselektion (*,?) die parallele Übertragung von Dateien ein. Standardwert: 2 Die Anzahl der erneuten Verbindungsversuche nach einem Fehlschlag, wenn der Agent in einem der folgenden Fälle den Socket schließt: Die Verbindung wird durch die Jobüberwachung unterbrochen. Der Agent führt einen Befehl aus, auf den innerhalb der im Feld Verbindung als unterbrochen annehmen, wenn inaktiv für (Sek.) angegebenen Zeit keine Reaktion erfolgt. Verbindung als unterbrochen annehmen, wenn inaktiv für (Sek.) Standardwert: 2 Gibt an, wann der FTP-Agent den Socket schließen soll, wenn keine Daten übertragen werden. Standardwert: 60

76 72 Chapter 3 Arbeiten mit FTP-Jobs Feld Nach Wiederherstellung der Verbindung Übertragung fortsetzen Beschreibung Legt das Verhalten für den Fall fest, dass die Übertragung unterbrochen wird: Bei aktiviertem Kontrollkästchen (Voreinstellung): Die Übertragung wird nach erneutem Verbindungsaufbau noch einmal überprüft. Bei deaktiviertem Kontrollkästchen: Die Übertragung wird nach erneutem Verbindungsaufbau wieder aufgenommen. 3. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Fenster Job-Einstellungen zu schließen. 4. Um die Änderungen zu speichern, speichern Sie den Job durch Klicken auf Speichern. Job Attribute für :GET_ATT und :PUT_ATT Befehle im UserInterface anzeigen lassen Sie können Job-Attributbezeichnungen für Job-Felder der Befehle der Script-Anweisungen :GET_ATT und :PUT_ATT in den Tooltips des Automation Engine UserInterface einblenden lassen. Sie müssen dazu - DshowXmlNames=true in die ucdj.ini Ihres UserInterface eintragen, wie im nachfolgenden Beipiel zu sehen ist: ;command how to start the client cmd="c:\program Files (x86)\java\jre7\bin\javaw" -Xmx1024m - Dsun.locale.formatasdefault=true -DshowXmlNames=true com.uc4.ucdf.ucdialogfactory -U%User% Wenn Sie die Job-Attribute für Feldnamen auf diese Weise im UserInterface einblenden und Ihre Maus über den Job-Feldnamen bewegen, wird der XML-Name angezeigt. Wenn das Feld bereits einen Tooltip hat, wird dieser Tooltip angezeigt, gefolgt von einem Bindestrich und der Job Attribut-Bezeichnung. Wenn das Feld noch keinen Tooltip besitzt, zeigt der Tooltip nur den Bindestrich und die Attribut- Bezeichnung an. Achten Sie bei Job-Attributen auf Groß- und Kleinschreibung.

77 FTP Agent Guide Überschreiben von Connection- Objektattributen auf der Registerkarte "Pre- Script" Sie können die Werte aller Einstellungen für die beiden Hosts eines Jobs überschreiben. Verwenden Sie dazu die Befehle :PUT_ATT auf der Registerkarte Pre-Script. Sie können die Werte aller Einstellungen für die beiden Hosts eines Jobs überschreiben. Verwenden Sie dazu die in Abbildung A dargestellten Befehle :PUT_ATT auf der Registerkarte Pre-Script. In diesem Beispiel wird der Name von Host B überschrieben. Das Überschreiben der Host-Einstellungen ermöglicht Verbindungen zu Hosts, für die Sie keine Connection-Objekte definiert haben. Diese Lösung bietet sich an, wenn Sie Verbindungen zu mehreren ähnlichen Hosts herstellen, für die Sie keine Connection-Objekte erstellen möchten. Nehmen wir zum Beispiel an, dass Hunderte von Hosts dasselbe Protokoll, Kennwort und denselben Benutzernamen verwenden. In diesem Fall könnten Sie ein einzelnes Connection-Objekt für einen Host definieren und es sämtlichen Jobs zuweisen. Anschließend könnten Sie den Hostnamen in der Registerkarte Pre-Script der einzelnen Jobs überschreiben. Attribute host_a_operation host_b_operation Überschreibungen Der im Feld Protokoll des Connection-Objekts festgelegte Wert. Die mögliche Werte lauten: FTP, FTPS, FTPES und SFTP.

78 74 Chapter 3 Arbeiten mit FTP-Jobs Attribute host_a_hostname host_b_hostname host_a_port host_b_port host_a_userid host_b_userid host_a_password host_b_password host_a_activemode host_b_activemode host_a_ sftpkeyauthentication host_b_ sftpkeyauthentication host_a_keyfile host_b_keyfile host_a_passphrase host_b_passphrase host_a_ remoteserververification host_b_ remoteserververification host_a_pbszsize host_b_pbszsize host_a_protcommand host_b_protcommand Überschreibungen Der im Feld Host des Connection-Objekts festgelegte FTP-Servername. Die im Feld Port des Connection-Objekts festgelegte Portnummer. Der im Feld Benutzername des Connection-Objekts festgelegte Benutzername. Das im Feld Passwort des Connection-Objekts festgelegte Kennwort. Hinweis: Kennwörter werden nicht zu Job-Reports hinzugefügt. Das Kontrollkästchen Active Mode erzwingen für Connection-Objekte mit den Protokollen FTP, FTPS und FTPES. Der Wert kann true oder false lauten; true steht für den aktiven Modus und false für den passiven. Das Kontrollkästchen SFTP Keyauthentifizierung für Connection-Objekte mit dem Protokoll SFTP. Der Wert kann true oder false lauten. Der Pfad im Feld Key file für Connection-Objekte mit dem Protokoll SFTP. Das Kennwort im Feld Pass phrase für Connection-Objekte mit dem Protokoll SFTP. Das Kontrollkästchen Remote Host Adressverifizierung für Connection- Objekte mit den Protokollen FTP und SFTP. Der Wert kann true oder false lauten. Die Protection Puffergröße im Feld PBSZ für Connection-Objekte mit dem Protokoll FTPES. Das Verschlüsselungsart des Datenkanals im Feld PROT für Connection- Objekte mit dem Protokoll FTPES. Die mögliche Werte lauten: C, S, E und P. Überschreiben von Attributen mit AE-Variablen Um die Anzahl der zu definierenden Jobs einzuschränken, können Sie wie in Abbildung B dargestellt Attribute durch AE-Variablen festlegen. In diesem Beispiel wird der Name von Host B mit dem Wert der Variablen &COLLECTION_HOST überschrieben. Die Variable &COLLECTION_HOST kann auf verschiedene Weise gesetzt werden, unter anderem durch den Wert einer Eingabeaufforderung in einem PromptSet-Objekt, das dem Job zugewiesen wurde.

79 In diesem Beispiel wird der Hostname von Host B durch eine AE-Variable bestimmt. FTP Agent Guide 75

80 76 Chapter 3 Arbeiten mit FTP-Jobs 3.6 RA FTP Job-Attribute Es ist möglich die spezifischen Attribute von RA FTP-Jobs über die Script-Srachmittel GET_ATT / :PUT_ ATT auszulesen bzw. zu setzen. Folgendes Dokument enthält eine Beschreibung dazu und die Auflistung aller Attribute. Der Name des Attributes, welches beim Sprachmittel GET_ATT /:PUT_ATT angegeben werden kann, setzt sich folgendermaßen zusammen: prompt_<index>_<feld> <Index> = Hier handelt es sich um die Nummer der Befehlssequenz, dessen Attribute angesprochen werden sollen. Befehlsequenzen werden entsprechend Ihrer Reihenfolge in der Registerkarte FTP aufsteigend nummeriert, beginnend mit dem Index "0". Ändern Sie nachträglich die Reihenfolge der Befehlsequenzen, so ändert sich auch deren Nummerierung! <Feld> = Feld, welches innerhalb der angegebenen Befehlssequenz angesprochen werden soll. Beachten Sie, dass jede Befehlsequenz über bestimmte Felder verfügt. Das angegebene Feld muss daher zum Typ der Befehlsequenz passen. Die Felder, welche pro Befehlssequenz-Typ angegeben sind in der unteren Tabelle aufgelistet. Prinzipiell können alle Felder gesetzt (:PUT_ATT) und ausgelesen werden (GET_ATT). Feld / Befehl Allgemeine Felder failjoboncommandfailure command Beschreibung / Bedeutung Die allgemeinen Felder können bei jeder Befehlssequenz angegebenen werden. Job beim Auftreten eines Fehlers abbrechen Diese Option gibt es für alle Befehlssequenzen, unabhängig von deren Typ. Typ der Befehlssequenz Vermeiden Sie, diesen Wert mittels :PUT_ATT zu verändern, da es ansonsten zum Abbruch der FTP-Jobs kommen kann. Mögliche Werte: "COPY" - Kopieren "FREEFORM" - Kommandozeile "MKDIR" - Verzeichnis erstellen "DELETE" - Löschen "RENAME" - Umbenennen "LIST" - Verzeichnisinhalt auflisten "CD" - Verzeichnis wechseln "JOBMESSAGE" - Logausgabe "REMOTECOMMAND" - Entfernte Ausführung Verzeichnis wechseln sourcedir execconnection Verzeichnis, in welches gewechselt werden soll. Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird.

81 FTP Agent Guide 77 Verzeichnisinhalt auflisten sourcedir execconnection Verzeichnis erstellen sourcedir execconnection Kopieren sourcedir destdir fromconnection toconnection erasesource multiprocessing copyallchildrenfiles sourcenotfoundoption filetype Verzeichnis, dessen Inhalt aufgelistet werden soll. Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird. Zu erstellendes Verzeichnis Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird. Quellverzeichnis Zielverzeichnis FTP Verbindungs-Objekt für die Quelle FTP Verbindungs-Objekt für das Ziel Dateien nach erfolgreicher Übertragung auf dem Quellhost löschen Unterverzeichnisse und Inhalte kopieren Job abbrechen, wenn Quelldateien nicht gefunden werden. Transfer Typ (FTP) Mögliche Werte: "ASCII" "BINARY" "IMAGE" "EBCDIC" "LOCAL" filetransfermode Datenübertragungsmodus (SFTP) "STREAM" "COMPRESSED" "BLOCK" onfailureoption iffileexistsoption Löschen sourcedir execconnection deleteallchildrenfiles deleteemptydirectories Umbenennen sourcedir Aktion, die im Fehlerfall durchgeführt werden soll. Aktion, die durchgeführt werden soll, wenn die Datei bereits am Zielhost existiert. Zu löschendes Verzeichnis bzw. Datei Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird. Unterverzeichnisse berücksichtigen Leere Verzeichnisse löschen. Datei bzw. Verzeichnis, welches umbenannt werden soll

82 78 Chapter 3 Arbeiten mit FTP-Jobs renamefile execconnection Kommandozeile commandstring execconnection Entfernte Ausführung sourcedir execconnection retcode Log Ausgabe message Neuer Datei- bzw. Verzeichnisname Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird. Kommandozeilen-Befehle Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird. Verzeichnis Name eines FTP Verbindungs-Objektes, welches für die Durchführung des Befehls verwendet wird. Erwarteter Rückgabewert für die erfolgreiche Durchführung Nachricht

83 FTP Agent Guide Beispiel: Verwenden von AE-Variablen in FTP-Jobs Im nachfolgenden Beispiel wird eine Variable verwendet, die für eine Eingabeaufforderung (Prompt) bzw. einen For Each-Workflow festgelegt wurde. Im folgenden Beispiel werden AE-Funktionen verwendet, die in der Automation Engine v9 Service Pack 3 und höher verfügbar sind. Wir gehen davon aus, dass Sie die Automation Engine v9 Service Pack 3 oder höher installiert haben bzw. dass Sie über grundlegende Kenntnisse der Funktionen der Automation Engine verfügen. In diesem Beispiel wird eine Variable in einem FTP-Job verwendet, und zwar: um einen FTP-Host festzulegen. in FTP-Befehlen. Art der Ausführung: Einzelne Ausführung Ausführung in einem For Each- Workflow Variablenwert wird festgelegt durch: Eingabeaufforderung in einem PromptSet- Objekt Eigenschaften des For Each-Workflows Zuweisung des VARA-Objekts als: Datenreferenz der Eingabeaufforderung, die das Auswählen eines Hosts aus einer dynamischen Liste ermöglicht Quelle für den Variablenwert. Wenn der Workflow ausgeführt wird, generiert er für jeden Host, der vom VARA-Objekt zurückgegeben wird, eine Instanz des FTP-Jobs. In Abbildung A ist das Beispiel eines FTP-Jobs mit der Bezeichnung JOBS.FTPAGENT.GET_CARD_ TRANSACTIONS_SELECT_REMOTE_HOST dargestellt. Die Variable &CONNECTION# befindet sich im Feld Host A. Dies bedeutet, dass beim Ausführen des Jobs der Wert für Host A durch den Wert der Variablen &CONNECTION# bestimmt wird.

84 80 Chapter 3 Arbeiten mit FTP-Jobs Die Variable &CONNECTION# wird als Wert von Host A festgelegt. Der Job umfasst die drei in Abbildung B, C und D dargestellten Befehle. Für jeden Job wird die Variable &CONNECTION# verwendet. Ein Verzeichnis wird unter Verwendung der Variablen &CONNECTION# erstellt.

85 FTP Agent Guide 81 Dateien von einem entfernten Host werden im lokalen Dateisystem in ein Unterverzeichnis geschrieben, dessen Name von der Variablen &CONNECTION# vorgegeben wird. Das mithilfe des ersten Befehls erstellte Unterverzeichnis wird unter Verwendung einer vordefinierten Variablen umbenannt, um für jeden Jobdurchlauf einen eindeutigen Namen zu erzeugen. Die Variable &CONNECTION# wird jedes Mal gesetzt, wenn der Job JOBS.FTPAGENT.GET_CARD_ TRANSACTIONS_SELECT_REMOTE_HOST FTP infolge einer Eingabeaufforderung ausgeführt wird, die in einem PromptSet-Objekt mit der Bezeichnung PRPT.CONNECTION definiert wurde, das dem Job zugewiesen wurde (siehe Abbildung E). Das Objekt PRPT.CONNECTION wird zum Job hinzugefügt.

86 82 Chapter 3 Arbeiten mit FTP-Jobs Die PromptSet-Definition für PRPT.CONNECTION wird in Abbildung F dargestellt. Beachten Sie, dass das VARA-Objekt VARA.SQLI.CONNECTION_NAME nur als Datenreferenz für die Eingabeaufforderung PRPT.CONNECTION dient. Die PromptSet-Definition PRPT.CONNECTION Die VARA-Definition für VARA.SQLI.CONNECTION_NAME wird in Abbildung G dargestellt. Sie enthält eine SQL-Anweisung, die die Rückgabe einer Hostliste bewirkt, die auf der Namenskonvention STORE<number> beruht. Die Objektdefinition VARA.SQLI.CONNECTION_NAME VARA In Abbildung H wird eine Vorschau der SQL-Anweisung der Definition VARA.SQLI.CONNECTION_ NAME dargestellt.

87 FTP Agent Guide 83 Vorschautext zum VARA-Objekt VARA.SQLI.CONNECTION_NAME Abbildung I: JOBS.FTPAGENT.GET_CARD_TRANSACTIONS_SELECT_REMOTE_HOST ist die einzige Aufgabe im For Each-Workflow JOBP.FOREACH.REMOTE_HOST. Die Logik des Workflows JOBP.FOREACH.REMOTE_HOST In der Registerkarte For Each im Fenster Eigenschaften des in Abbildung J angezeigten Workflows ist als Variablen-Objekt JOBP.FOREACH.REMOTE_HOST der Wert VARA.SQLI.CONNECTION_NAME angegeben. &CONNECTION# ist als Variable festgelegt, in der die Werte veröffentlicht werden.

88 84 Chapter 3 Arbeiten mit FTP-Jobs Eigenschaften des Workflows JOBP.FOREACH.REMOTE_HOST Beim Ausführen des Workflows JOBP.FOREACH.REMOTE_HOST wird eine Instanz des Jobs JOBS.FTPAGENT.GET_CARD_TRANSACTIONS_SELECT_REMOTE_HOST FTP für jeden Host erzeugt, der von dem VARA-Objekt VARA.SQLI.CONNECTION_NAME VARA zurückgegeben wird.

89 3.8 Verwaltung von Ausgabe- und Ausführungsoptionen mit dem RA-Tab FTP Agent Guide 85 Sie können festlegen, wie Job-Reports gespeichert werden (z. B. mit oder ohne Agenten-Logdaten) und ob die Informationen des RA-Agenten-spezifischen Tabs angezeigt werden, wenn der Job mit der Registerkarte RA ausgeführt wird. Sie können festlegen, wie Job-Reports gespeichert werden (zum Beispiel mit oder ohne Agenten- Logdaten) und ob die Informationen des RA-Agenten-spezifischen Tabs angezeigt werden, wenn der Job mit der Registerkarte RA ausgeführt wird. Die Registerkarte RA eines Jobs kann zum Beispiel folgendermaßen aussehen: Beispiel-Registerkarte RA für einen Job Die Optionen des RA-Tabs für Jobs werden in der folgenden Tabelle beschrieben. Feld Datenbank Datei Beschreibung Bei Aktivierung dieser Option wird der Job-Report in der Automation Engine verwaltet. Nach der Ausführung eines Jobs wird das Prozessprotokoll per Dateiübertragung in die Datenbank der Automation Engine gesendet. Bei Aktivierung dieser Option wird der Job-Report in der Automation Engine verwaltet. Nach der Ausführung eines Jobs ist das Prozessprotokoll im Zielsystem als Datei aufrufbar.

90 86 Chapter 3 Arbeiten mit FTP-Jobs Feld Nur im Fehlerfall generieren Agentenlog Taskparameter abfragen Beschreibung Bei Aktivierung dieser Option werden der Job-Report in der Datenbank der Automation Engine und/oder eine Datei im Zielsystem gespeichert, falls der Job abgebrochen wurde. Diese Funktion ist ausschließlich dann verfügbar, wenn die Optionen Datenbank und/oder Datei aktiviert sind. Bei Aktivierung dieser Option weisen Job-Reports eine Registerkarte für das Agentenlog auf. Wenn Fehler aufgetreten sind, werden diese im Agentenlog aufgeführt. Wir empfehlen, dieses Kästchen für die Fehlerbehebung aktiviert zu lassen. Bei Aktivierung dieser Option werden die Daten aus der RA-Agenten-spezifischen Registerkarte eines Jobs in einem Pop-Up-Fenster angezeigt, sobald Sie den Job ausführen. In diesem Fenster können Sie einmalige Änderungen für einzelne Job- Instanzen vornehmen. Manche Felder der RA-Agenten-spezifischen Tabs lassen sich ausschließlich in Job-Definitionen konfigurieren. Diese Felder sind nicht Bestandteil des Pop-Up-Fensters, wenn bei einer Abfrage des Jobs die Option "Taskparameter abfragen" aktiviert ist. Ein Pop-Up-Fenster für einen Job kann wie folgt aussehen. Wenn die Option "Taskparameter abfragen" aktiviert ist, können Sie die Daten des RA-spezifischen Tabs eines Jobs für eine einzelne Instanz bearbeiten (bei Ausführung des Jobs).