Einen lokalen Robots-Agenten konfigurieren
Die Standardkonfiguration des Robots-Agenten wird während der Installation festgelegt. Bevor Sie den Robots-Agent verwenden, überprüfen Sie die Konfigurationseinstellungen und vergewissern Sie sich, dass diese für Ihre Organisation geeignet sind. Stellen Sie insbesondere sicher, dass die Einstellung Zugelassene Dateiuploads entsprechend konfiguriert ist.
Hinweis
Die Informationen in diesem Thema richten sich nur an Organisationen, die einen lokalen Robots-Agenten verwenden, um ACL-Skripts in ACL-Robots auszuführen.
Personen und Organisationen mit ACL Robotics Professional Edition haben keinen Robots-Agenten vor Ort. Python/HCL-Skripts, die in HighBond-Robots oder Workflow-Robots ausgeführt werden, verwenden den Robots Agent nicht.
Wo Sie Konfigurationseinstellungen festlegen können
Konfigurationseinstellungen für Robots-Agenten legen Sie an zwei Stellen fest:
- In Robots auf dem Bildschirm Agentenverwaltung
- Auf dem Windows-Server im Installationsverzeichnis von Robots-Agent in der Datei Agent.exe.config
Hinweis
Die Konfigurationseinstellungen auf dem Bildschirm Agentenverwaltung haben Vorrang vor den Einstellungen in der Datei Agent.exe.config.
Einstellungen auf dem Bildschirm „Agentenverwaltung“ konfigurieren
Hinweis
Die Konfigurationseinstellungen auf dem Bildschirm Agentenverwaltung gelten für alle Agenten in einem Multi-Agenten-Cluster.
- Melden Sie sich bei Diligent One (www.highbond.com) an.
- Klicken Sie auf der Startseite von Launchpad unter Automatisierung auf die Robots-App.
- Klicken Sie in der oberen rechten Ecke des Dashboards auf Einstellungen.
- Vergewissern Sie sich, dass im linken Fensterbereich die Option Agentenverwaltung ausgewählt ist.
- Wählen Sie unter Konfiguration die entsprechende Option für Zugelassene Dateiuploads.
Zugelassene Dateiuploads bestimmt, welche ausgegebenen Ergebnisse vom Robots-Agent in die Robots-App in der Cloud hochgeladen werden:
- Nur Ergebnisdateien und Protokolle
Bei Angabe in einem Analysekopf werden Ergebnisdateien (z. B. Excel) und Protokolle hochgeladen. Sie können verbundene Dateien auch manuell auf die Robots-Registerkarte Eingabe/Ausgabe hochladen.
- Ergebnistabellen, Dateien und Protokolle
Bei Angabe in einem Analysekopf werden Analytics-Ergebnistabellen, Ergebnisdateien (z. B. Excel) und Protokolle hochgeladen. Sie können verbundene Dateien auch manuell auf die Robots-Registerkarte Eingabe/Ausgabe hochladen.
- Dateiuploads sind nicht zulässig
Es können überhaupt keine Dateien durch Skripts oder manuell von Benutzern hochgeladen werden. Analyseskripts mit den //RESULT FILE- oder //RESULT LOG-Tags werden nicht ausgeführt.
- Nur Ergebnisdateien und Protokolle
- Geben Sie unter Konfiguration die entsprechenden Verzeichnisse für Pfadkonfiguration an und klicken Sie auf Speichern.
- Datenspeicher
Das Windows-Server- oder Netzwerkverzeichnis zur permanenten Speicherung von Analytics-Datentabellen, die von Analyseskripts mit einem //DATA-Tag ausgegeben werden.
Ein eigenes Verzeichnis für Datentabellen ermöglicht es Ihnen, einen kostengünstigeren, langsameren Speicherort für große Dateien anzugeben, auf die nur gelegentlich zugegriffen wird.
- Ergebnispfad
Das Verzeichnis auf dem Windows-Server oder das Netzwerkverzeichnis für Analytics-Ergebnistabellen, die von Analyseskripts mit einem //RESULT TABLE-Tag ausgegeben werden.
Wichtig
Die Verzeichnisse, die Sie unter Konfiguration angeben, müssen durch den Robots-Agenten oder durch alle Agenten (falls Sie ein Cluster mit mehreren Agenten verwenden) erreichbar sein. Für jedes angegebene Verzeichnis muss das Dienstkonto, das den Agenten ausführt, über die Berechtigungen Lesen/Schreiben, Auflisten verfügen. Weitere Informationen finden Sie unter Sicherheit des lokalen Robots Agent.
- Datenspeicher
Einstellungen in der Datei Agent.exe.config konfigurieren
Zur Aktualisierung der Konfigurationseinstellungen bearbeiten Sie die Datei Agent.exe.config, die sich im Installationsverzeichnis von Robots-Agent befindet. Starten Sie dann den Windows-Dienst Robots Agent neu.
Der Standardspeicherort der Konfigurationsdatei ist:
C:\Programme (x86)\ACL Software\Robots Agent\agent\Agent.exe.config.
Hinweis
Sie müssen den Dienst Robots-Agent neu starten, damit die Änderungen wirksam werden.
Bei Installationen mit mehreren Agenten müssen Sie auf jedem Windows-Server die Datei Agent.exe.config aktualisieren und den Dienst Robot-Agent neu starten. Konfigurationseinstellungen für jeden Agenten können identisch oder unterschiedlich sein, je nach Ihren speziellen Anforderungen.
Konfigurationseinstellungen in Agent.exe.config
| Schlüssel | Wert |
|---|---|
| RuntimeBasePath |
Der Basisordner für:
Der Standardbasisordner ist C:\acl\robots\data\. Ein separater Laufzeit-Basisordner ermöglicht es Ihnen, die Verarbeitung von Analyse-Jobs auf einem schnelleren und leistungsfähigeren Gerät wie einem Solid-State-Laufwerk (SSD) durchzuführen. Beispiel für einen vollständigen Pfad zu einem Ordner für Analyse-Jobs mit einem benutzerkonfigurierten Basisordner: E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp |
| DataBasePath |
Der Basisordner für die permanente Speicherung von Analytics-Datentabellen, die von Analyseskripts mit einem //DATA-Tag ausgegeben werden. Der Standardbasisordner ist C:\acl\robots\data\. Ein eigener Basisordner für Analytics-Datentabellen ermöglicht es Ihnen, einen kostengünstigeren, langsameren Speicherort für große Dateien anzugeben, auf die nur gelegentlich zugegriffen wird. Beispiel für einen vollständigen Pfad zu einem Datendateiordner mit einem benutzerkonfigurierten Basisordner: D:\acl\robots\data\Production\Robot12\Data Hinweis Der Wert von DataBasePath wird nicht verwendet, wenn ein anderer Wert in der Konfigurationseinstellung Datenspeicher auf dem Bildschirm Agentenverwaltung in Robots angezeigt wird. Weitere Informationen finden Sie unter Einstellungen auf dem Bildschirm „Agentenverwaltung“ konfigurieren. |
| ResultsBasePath |
Der Basisordner für Analytics-Ergebnistabellen, die von Analyseskripts mit einem //RESULT TABLE-Tag ausgegeben werden. Der Standardbasisordner ist C:\acl\robots\data\. Beispiel für einen vollständigen Pfad zu einem Ergebnisordner mit einem vom Benutzer konfigurierten Basisordner: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions Hinweis Der Wert von ResultsBasePath wird nicht verwendet, wenn ein anderer Wert in der Konfigurationseinstellung Ergebnispfad auf dem Bildschirm Agentenverwaltung in Robots angezeigt wird. Weitere Informationen finden Sie unter Einstellungen auf dem Bildschirm „Agentenverwaltung“ konfigurieren. |
| AclSEProfileBase |
Der Basisordner für die Arbeit mit Tabellen bei der Verbindung von Analytics zum Robots-Agent mit Hilfe des Robots-Datendienst. Der Standardbasisordner ist C:\acl\robots\aclse\. |
| LogFile |
Der Dateipfad und -name der Protokolldatei für den Robots-Agenten. Der Standardpfad und -name lautet C:\acl\robots\logs\application.log. |
| EnginePath |
Der Dateipfad der Programmdatei. die die Aufgaben ausführt. Der Standardspeicherort ist C:\Programme (x86)\ACL Software\Robots Agent\AclScript.exe. |
| KeepJobFolder |
Gibt an, ob der temporäre Ordner für Analysejobs beibehalten wird, wenn eine Robot-Aufgabe fehlschlägt.
Hinweis Bei erfolgreichen Robot-Aufgaben hat die Einstellung KeepJobFolder keine Wirkung. Wenn eine Aufgabe erfolgreich ausgeführt wurde, wird der temporäre Ordner für Analysejobs automatisch gelöscht. Achtung Sie können für den Wert true festlegen, um Dateien für die Fehlerbehebung beizubehalten. Wenn für diesen Wert dauerhaft true festgelegt ist, kann es dazu kommen, dass dem Server-Datenträger oder einem Solid-State-Laufwerk der Platz ausgeht. |
| AllowExecuteCommand |
Legt fest, wie der Robots Agent den EXECUTE-Befehl behandelt, wenn er in einer Analyse auf ihn trifft:
|
| MaxLogSizeKB |
Die maximale Größe der Protokolldatei von Robots-Agent, bevor die Datei archiviert und eine neue Protokolldatei erstellt wird. Der Standardwert ist 102400 (100 MB). Die aktuelle Protokolldatei ist application.log. Archivierte Protokolldateien werden im gleichen Ordner wie die aktuelle Protokolldatei gespeichert und erhalten ein fortlaufendes numerisches Suffix: application.0.log, application.1.log usw. |
| SkipPathAccessCheck |
Steuert, auf welche Ordner der Robots-Agent zugreifen kann, wenn er Tabellen oder Dateien liest oder schreibt.
Wenn der Wert auf true gesetzt wird und die Aktivierung des Ordnerzugriffs übersprungen wird, kann dies die Leistung des Robots-Agent bei der Ausführung von Skripten in manchen Umgebungen verbessern. Sie haben auch die Möglichkeit, Lese- und Schreiboperationen in allen Robots durchzuführen. Achtung Die Einschränkung, auf welche Ordner ein Skript zugreifen kann, ist eine Robots-Sicherheitsfunktion, die versehentliche oder absichtliche Datenzugriffsverstöße zu vermeiden. Legen Sie für den Wert nur dann true fest, wenn Sie sicher sind, dass die Genehmigung für ACL-Skripte, Tabellen und Dateien in allen ACL-Robots zu lesen oder schreiben, kein Sicherheitsrisiko darstellt. Hinweis Die Einstellung SkipPathAccessCheck hat keine Auswirkungen auf die Möglichkeit, Analytics-Datentabellen zwischen Robots freizugeben und zu verlinken. Weitere Informationen finden Sie unter Gemeinsame Nutzung und Verknüpfung von Datentabellen in ACL-Robots. |
Robots-Agent zur Zusammenarbeit mit einem bestimmten Proxy-Server konfigurieren
Sie können den Robots-Agenten manuell konfigurieren, damit er sich über einen Proxy-Server Ihrer Wahl mit der Robots-App verbindet. Die manuelle Konfiguration nehmen Sie wie folgt vor:
-
Fügen Sie der Datei Agent.exe.config einen zusätzlichen Abschnitt hinzu.
-
Erstellen Sie die beiden zusätzlichen Konfigurationsdateien AgentService.exe.config und Worker.exe.config.
Schritte
-
Auf dem Server, auf dem der Robots-Agent installiert ist, rufen Sie das Installationsverzeichnis des Robots-Agenten auf.
Der Standardpfad des Installationsverzeichnisses lautet:
C:\Programme (x86)\ACL Software\Robots Agent\agent\
-
Sehen Sie in der folgenden Tabelle nach, um die Konfigurationsdateien im Unterordner \agent zu aktualisieren.
-
Nachdem Sie alle Dateien gespeichert haben, starten Sie den Windows-Dienst Robots Agent neu, damit die Kommunikation zwischen dem Robots-Agenten und der Robots-App über Ihren angegebenen Proxy-Server begonnen wird.
Hinweis
Es sind unterschiedliche Konfigurationseinstellungen für den Proxy-Server möglich. Die folgenden Konfigurationsinformationen entsprechen unter Umständen nicht genau Ihren Anforderungen. Weitere Informationen finden Sie in der technischen Microsoft-Dokumentation:
| Dateiname | Konfigurationsinformationen |
|---|---|
| Agent.exe.config |
Aktualisieren Sie diese Datei, indem Sie den Abschnitt <System.net> an der Stelle einfügen, die im Beispiel gezeigt ist.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<appSettings>
<other configuration settings>
</appSettings>
<system.net>
<defaultProxy useDefaultCredentials="true">
<proxy proxyaddress="IHRE PROXY-SERVERADRESSE:IHR PORT" bypassonlocal="true" />
</defaultProxy>
</system.net>
</configuration>
|
|
AgentService.exe.config Worker.exe.config |
Aktualisieren Sie in beiden Dateien den Abschnitt <defaultProxy> basierend auf dem unten gezeigten Beispiel.
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.net>
<defaultProxy useDefaultCredentials="true">
<proxy proxyaddress="IHRE PROXY-SERVERADRESSE:IHR PORT" bypassonlocal="true" />
</defaultProxy>
</system.net>
</configuration>
|
