RA-Agent

[GLOBAL]

name=

Name des Agenten

Der Name des Agenten darf maximal 32 Zeichen lang sein. Folgende Zeichen sind erlaubt: "A-Z", "0-9", "_", ".", "$", "@", "-" und "#".

Obwohl der Name des Agenten maximal 32 Zeichen lang sein darf, sollten Sie diesen auf unter 25 Zeichen reduzieren. Die letzten sieben Zeichen sollten für das Suffix 'NEW.nn' freigehalten werden, falls ein neuer Agent von seinem Template erstellt wird.

system=

Name des Automation Engine Systems
Dieser Eintrag muss mit dem Eintrag in der INI-Datei der Automation Engine identisch sein.

language=

Sprache, in der das Logging durchgeführt wird.

Erlaubte Werte: "E" (Standardwert), "D", "F"

logging=

Pfad und Dateiname der Logdatei.

Die Nummernzeichen dienen als Platzhalter für eine aufsteigende Nummerierung. Beim Start des Agenten werden die Logdateien umbenannt, so dass die aktuellste Logdatei immer die mit der Nummer "00" ist.

logcount=

Anzahl der aufbewahrten Logdateien

max_logging_kb=

Maximale Größe der Logdatei

Beim Erreichen der hier eingestellten Größe wird eine neue Logdatei angelegt.

helplib=

Pfad und Name der Meldungsdatei.

This optional field is available for OEBS agents used in a multi node system with different operating systems. In this case, this variable should be set to 0 and no check will be performed. Therefore, the RA agent can register files that may not be valid file names on the OS where the RA agent runs.

Allowed values: "0" and "1" (default value)

"0" = Registered files are not checked.
"1" = Registered files are checked.

Name und Pfad der Datei, die das Authentifizierungspaket enthält (Company-Key Datei).

Der Parameter ist anzugeben, wenn Sie die Authentifizierungsmethode "Server" oder "Server und Agent" verwenden. Kann die Company-Keydatei nicht gefunden werden, so schlägt die Anmeldung fehl.

Der Agent liest die Datei beim Start aus und speichert die Informationen in der Datei, die Sie im Parameter KeyStore= angeben. Anschließend löscht er die erste Datei.

Name und Pfad der Datei, welche die Informationen des Authentifizierungspakets enthält (siehe Parameter InitialPackage=).

Wird der Dateiname und/oder Pfad nicht angegeben, so wird der Name (mit Dateiendung *.kstr) bzw. Pfad der INI-Datei des Agenten verwendet. Geben Sie einen Dateinamen an, so wird die Endung *.kstr nicht automatisch hinzugefügt.

Die KeyStore-Datei wird angelegt, wenn der Agent zum ersten Mal gestartet wird. Die Datei darf anschließend nicht gelöscht, umbenannt oder verschoben werden. Findet der Agent beim Start die Datei nicht, so schlägt die Anmeldung fehl. Dies ist unabhängig von der verwendeten Authentifizierungsmethode. Um die Anmeldung in diesem Fall wieder zu ermöglichen, ist für den betreffenden Agenten in der Systemübersicht der Menüpunkt "Transferkey erneuern" aufzurufen.

Java-Agenten (SAP, RA, Datenbank und JMX), die unter UNIX laufen, erstellen die Keystore-Datei mit der Berechtigung "-rw-r--r—". Dadurch können eventuell auch andere Betriebssystem-Benutzer auf diese Datei zugreifen.

[RA]

cache_directory=

[TCP/IP]

bindaddr=

IP-Adresse oder Hostname für die Verbindung zum Kommunikationsprozess

Nutzen Sie diesen Parameter, wenn die Verbindung über eine bestimmte IP-Adresse erfolgen soll (z. B. wenn der Rechner mehr als eine Netzwerkkarte besitzt).

connect=

Zeitintervall in Sekunden, in dem der Agent eine Verbindung zu den Automation Engines herzustellen versucht. Betrifft den Verbindungsaufbau bei einem Neustart oder nach einem Verbindungsverlust.

Standardwert: 60 Sekunden

Dieser Parameter wirkt nur, bis sich der Agent das erste Mal erfolgreich am Automation Engine System anmelden kann. Danach wird der Parameter RECONNECT_TIME aus der Host-Charakteristik verwendet.

cp=

Adresse des Primärkommunikationsprozesses im Automation Engine System, mit dem sich der Agent verbinden soll.

Erlaubte Formate:
DNS-Name:Portnummer
TCP/IP-Adresse:Portnummer

[VARIABLES]

Dieser Abschnitt enthält Agenten-Variablen, die Informationen und Einstellungen zum Agenten beinhalten.

[TRACE]

file=

Pfad und Dateiname der Tracedatei.

Die Nummernzeichen dienen als Platzhalter für eine aufsteigende Nummerierung. Beim Einschalten eines Traces werden die Tracefiles umbenannt, sodass das aktuellste Tracefile immer die mit der Nummer "00" ist.

trccount=

Anzahl der aufbewahrten Tracedateien

max_trace_kb=

Maximale Größe der Tracedatei

Beim Erreichen der hier eingestellten Größe wird eine neue Tracedatei angelegt.

tcp/ip=

Traceflag des Agenten.

Erlaubte Werte: "0" (Standardwert) bis "9"

Traceflags sind nur in enger Abstimmung mit dem Support zu setzen!

Traceflag des Rapid-Automation-Agenten.

Erlaubte Werte: "0" (Standardwert) bis "12"

"0" = Rapid-Automation-Trace-Datei schreiben ist deaktiviert.
"1" - "9" = Rapid-Automation-Trace-Datei schreiben ist auf der angegebenen Ebene aktiviert. "1" ist die unterste Ebene, "9" ist der vollständige Trace. Ein Rapid Automation Agenten-Trace muss immer auf den Wert "9" festgelegt werden.
"10" - "12" = Vollständiger Trace ist gesetzt, zusätzliche Bibliothek-Traces von Drittanbietern sind gesetzt, falls vorhanden. Der Web Service-Agent hat einen Drittanbieter-Trace. Bibliothek-Traces von Drittanbietern können nur in dieser Datei ausgeführt werden. Sie können nicht, wie bei anderen Agenten, im UserInterface festgelegt werden.

[CP_LIST]

Liste von Kommunikationsprozessen

Die Liste wird beim Start des Agenten erstellt und erweitert, sobald neue Kommunikationsprozesse aktiviert werden. Mehr Informationen zum Verbindungsaufbau erhalten Sie im Kapitel zum Mehr-Server-Betrieb.

Die Liste enthält keinen Eintrag für den Kommunikationsprozess, der im Parameter cp= (Sektion [TCP/IP]) definiert wird.

Form:
Portnummer= DNS-Name
bzw.
Portnummer= TCP/IP-Adresse