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 RoboticsProfessional 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
Einstellungen auf dem Bildschirm „Agentenverwaltung“ konfigurieren
Hinweis
Die Konfigurationseinstellungen auf dem Bildschirm Agentenverwaltung gelten für alle Agenten in einem Multi-Agenten-Cluster.
Wählen Sie auf der Plattform-Startseite (www.diligentoneplatform.com) die Robots-App aus, um sie zu öffnen.
Wenn Sie sich bereits in Diligent One befinden, können Sie über das linke Navigationsmenü zur Robots-App wechseln.
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
Wenn dies im Analysekopf angegeben ist, werden Ergebnisdateien (wie Excel) und Protokolle hochgeladen. Sie können verbundene Dateien auch manuell auf die Robots-Registerkarte Eingabe/Ausgabe hochladen.
Ergebnistabellen, Dateien und Protokolle
Wenn dies im Analysekopf angegeben ist, werden Analytics-Ergebnistabellen, Ergebnisdateien (wie Excel) und Protokolle hochgeladen. Sie können verbundene Dateien auch manuell auf die Robots-Registerkarte Eingabe/Ausgabe hochladen.
Dateiuploads sind nicht zulässig
Keine Dateien können durch Skripts oder manuell durch Benutzer hochgeladen werden. Analyseskripts mit //RESULT FILE- oder //RESULT LOG-Tags werden nicht ausgeführt.
Um das Hochladen eines beliebigen Dateityps in jeder Situation zu verhindern, müssen Sie auch die Konfigurationseinstellung AllowUploadsOnFailure im Robots-Agent auf False setzen.
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.
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:\Program Files (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 benutzerdefinierten Basisordner: D:\acl\robots\data\Production\Robot12\Data |
| 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 benutzerdefinierten Basisordner: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions |
| AclSEProfileBase | Der Basisordner für die Arbeit mit Tabellen bei der Verbindung von Analytics zum Robots-Agent mithilfe 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 Standardpfad lautet C:\Program Files (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 | Gibt an, wie Robots-Agent zwei ACLScript-Befehle, EXECUTE und AICOMMAND, verarbeitet, wenn sie in einem Analyseskript auftreten.
|
| 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 und so weiter. |
| 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. Informationen finden Sie unter Gemeinsame Nutzung und Verknüpfung von Datentabellen in ACL-Robots. |
| AllowUploadsOnFailure | Wenn eine Robot-Aufgabe fehlschlägt, gibt dies an, ob ein Analytics-Ergebnisprotokoll vom Robots-Agent in die Robots-App in der Cloud hochgeladen wird.
Hinweis Wenn die Eigenschaft AllowUploadsOnFailure nicht in der Agent.exe.config-Datei vorhanden ist, fügen Sie sie manuell hinzu, und setzen Sie den Wert je nach den Anforderungen Ihres Unternehmens auf true oder false. Beispiel: <add key="AllowUploadsOnFailure" value="true"> </add> |
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.
Aktualisieren 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:\Program Files (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="YOUR PROXY SERVER ADDRESS:YOUR 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="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
</defaultProxy>
</system.net>
</configuration> |