Einen lokalen Robots-Agenten installieren oder aktualisieren
Der Robots-Agent führt die in der Robots-App geplanten Aufgaben aus. Der Agent führt die Aufgaben auf einem sicheren lokalen Windows-Server im Unternehmen in der Nähe der Datenquelle und innerhalb der geschützten Grenzen Ihres Netzwerks aus.
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.
Allgemeine Informationen
Laden Sie das Robots-Agent-Installationspaket herunter und installieren Sie damit Robots-Agent auf einem Windows-Server. Sie können mit dem Installationspaket auch ein Upgrade für einen auf dem Server vorhandenen Robots-Agenten durchführen.
Schlüsseldateien
Während der Installation registrieren Sie den Robots-Agenten mit einer Registrierungsschlüsseldatei (registration.key). Sie generieren die Schlüsseldatei in der Robots-App und laden sie in den Windows-Server herunter, auf dem der Robots-Agent installiert ist.
Die Registrierungsschlüsseldatei authentifiziert die erste Verbindung zwischen dem Robots-Agenten und der Robots-App. Nachfolgende Verbindungen und Datenflüsse werden durch Verschlüsselungsschlüssel gesichert (RSA-Schlüsselpaar mit öffentlichem und privatem Schlüssel). Das RSA-Schlüsselpaar wird beim Start des Robots-Agent-Diensts automatisch generiert.
Die Registrierungsschlüsseldatei und die Verschlüsselungsschlüssel sind separate Objekte, die in unterschiedlichen Phasen des Registrierungs- und Verbindungsprozesses genutzt werden.
Wenn Sie ein Upgrade des Robots-Agenten durchführen, ist die Registrierungsschlüsseldatei daran nicht beteiligt. Dann sollten Sie keine neue Instanz von registration.key generieren.
Mehrere Agenten
Um die Verarbeitungskapazität für Analysen zu erhöhen und den Lastausgleich zu implementieren, haben Sie die Möglichkeit, zusätzliche Instanzen des Robots-Agenten auf weiteren Windows-Servern zu installieren.
Windows-Dienste und -Konten für Robots-Agenten
Wenn Sie den Robots-Agenten installieren, werden auf dem Server zwei Windows-Dienste bereitgestellt:
- Robots-Agent Führt geplante und Ad-hoc-Robots-Aufgaben aus
- Robots-Datendienst Bietet die Konnektivität, die es Benutzern ermöglicht, Robots-Agent-Tabellen in Analytics zu öffnen
Wenn einer dieser beiden Dienste nicht läuft, ist die von ihnen bereitgestellte Funktionalität nicht verfügbar.
Tipp
Wenn sich Aufgaben lange Zeit in der Warteschlange von Robots befinden und dann übersprungen werden oder fehlschlagen, überprüfen Sie, ob der Robots-Agent-Dienst läuft.
Wenn Benutzer beim Versuch, eine Robots-Agent-Tabelle in Analytics zu öffnen, einen Verbindungsfehler erhalten, überprüfen Sie, ob der Robots-Datendienst ausgeführt wird.
Dienstkonten und Ports
Zur Ausführung der beiden Windows-Dienste des Robots-Agenten verwenden Sie Dienstkonten. Detaillierte Informationen über die Anmelderechte und die Berechtigungen, die für die Konten notwendig sind, finden Sie unter Sicherheit des lokalen Robots Agent.
Hinweis
Wenn Sie die Eigenschaften eines der Windows-Dienste nach der Installation des Robots-Agenten ändern, müssen Sie den Dienst neu starten, damit die Änderung wirksam wird.
Windows-Dienst | Konto, auf dem der Dienst ausgeführt wird | Port |
---|---|---|
Robots-Agent-Dienst |
Während oder nach der Installation angegebenes Domänenkonto |
443, nur für ausgehende Kommunikation |
Robots-Datendienst | Lokales System | 10000 Standard, konfigurierbar während und nach der Installation |
Sichergehen, dass sich der Robots-Agent mit der Zertifizierungsstelle verbinden kann
Der Robots-Agent verwendet ein digitales Zertifikat, um seine Authentizität und Integrität zu validieren. Das Zertifikat benötigt eine Internetverbindung zu DigiCert, der externen Zertifizierungsstelle, damit das Zertifikat verifiziert werden kann. Wenn Sie den Robots-Agenten hinter einer Netzwerk-Firewall installieren, muss die Firewall so konfiguriert sein, dass sich das Zertifikat mit DigiCert verbinden kann. Ohne diese erforderliche Verbindung funktioniert der Robots-Agent nicht.
Konfigurieren Sie ggf. gemeinsam mit der IT-Abteilung Ihrer Organisation eine Netzwerk-Firewall oder einen Proxyserver, die/der die Verbindung zwischen dem Zertifikat und DigiCert zulässt. Das digitale Zertifikat im Robots-Agenten nutzt die folgenden URLs zur Verbindung mit der Zertifikatsperrliste von DigiCert und dem OCSP-Server:
- http://cacerts.digicert.com
- http://crl3.digicert.com
- http://crl4.digicert.com
- http://ocsp.digicert.com
Weitere Informationen zur URL finden Sie im installierten Zertifikat.
Installiertes Zertifikat untersuchen
Untersuchen Sie nach der Installation des Robots-Agenten das installierte Zertifikat, um die URLs der Zertifizierungsstelle herauszufinden.
- Klicken Sie im Installationsverzeichnis des Robots-Agenten mit der rechten Maustaste auf Agent.exe und wählen Sie Eigenschaften.
Das Standardverzeichnis der Installation ist C:\Programme (x86)\ACL Software\Robots Agent\agent.
- Wählen Sie im Dialogfeld Eigenschaften von Agent.exe die Registerkarte Digitale Signaturen.
- In der Signaturliste doppelklicken Sie auf Diligent Corporation und klicken dann einmal auf Zertifikat anzeigen.
- Auf der Registerkarte Details im Dialogfeld Zertifikat wählen Sie diese Felder aus:
- CRL-Verteilungspunkte
- Informationszugriff der Zertifizierungsstelle
Für jedes Feld werden URLs im Anzeigebereich unten im Dialogfeld angezeigt.
- Auf der Registerkarte Zertifizierungspfad im Dialogfeld Zertifikat gehen Sie wie folgt vor:
- Wählen Sie diese Einträge zum Zertifizierungspfad aus:
- DigiCert Trusted Root G4
- DigiCert Trusted G4 Code Signing...
- Klicken Sie bei jedem Eintrag auf Zertifikat anzeigen.
- Auf der Registerkarte Details wählen Sie diese Felder aus:
- Informationszugriff der Zertifizierungsstelle
- CRL-Verteilungspunkte
Für jedes Feld werden URLs im Anzeigebereich unten im Dialogfeld angezeigt.
- Wählen Sie diese Einträge zum Zertifizierungspfad aus:
Registrierungsschlüsseldatei des Robots-Agenten generieren
Wenn Sie Neukunde sind und den Robots-Agenten zum ersten Mal installieren, müssen Sie eine Registrierungsschlüsseldatei (registration.key) generieren. Die Registrierungsschlüsseldatei authentifiziert die erste Verbindung zwischen dem Robots-Agenten und der Robots-App.
Wenn Sie Bestandskunde sind und bereits einen installierten Robots-Agenten nutzen, sollten Sie in den meisten Fällen keine neue Registrierungsschlüsseldatei generieren. Die Generierung einer neuen Registrierungsschlüsseldatei ist oft unnötig. Außerdem kann sie die Konfiguration der Robots-Instanz Ihrer Organisation beeinträchtigen.
Status des Robots-Agenten | Registrierungsschlüsseldatei generieren |
---|---|
Neue Installation des Robots-Agenten, Installation eines einzelnen Agenten | Ja |
Neue Installation einer weiteren Instanz des Robots-Agenten in einem Cluster mit mehreren Agenten |
Nein Vorhandene Registrierungsschlüsseldatei kopieren Weitere Informationen finden Sie unter Weitere Instanz von Robots-Agent installieren. |
Upgrade eines bereits installierten Robots-Agenten |
Nein Die Registrierungsschlüsseldatei ist nicht am Upgrade beteiligt. |
Problem mit einer vorhandenen Registrierungsschlüsseldatei, Robots-Agent kann keine Verbindung zur Robots-App herstellen | Ja |
Änderung des Windows-Kontos, in dem ein bereits installierter Robots-Agent ausgeführt wird |
Nein Die Registrierungsschlüsseldatei ist nicht am Kontowechsel beteiligt. Weitere Informationen finden Sie unter Robots-Agent-Dienstkonto ändern. |
Hinweis
Sie müssen die Berechtigung „Agent verwalten” besitzen, um die Registrierungsschlüsseldatei des Robots-Agenten zu generieren. Weitere Informationen finden Sie unter Berechtigungen der Robots-App.
- Melden Sie sich bei Diligent One (www.highbond.com) an.
- Wählen Sie auf der Startseite von Launchpad unter Audit und Analyse die Robots-App aus.
- Klicken Sie in der oberen rechten Ecke des Dashboards auf Einstellungen.
- Vergewissern Sie sich, dass im linken Fensterbereich die Option Agentenverwaltung ausgewählt ist.
- Wenn Ihre Instanz von Robots aktuell einen cloudbasierten Robots-Agenten verwendet, tun Sie Folgendes:
- Klicken Sie auf Cloud-Agent ersetzen.
- Klicken Sie auf Agent registrieren und Schlüssel generieren.
- Wenn Ihre Instanz von Robots aktuell einen lokalen Robots-Agenten verwendet oder wenn kein Robots-Agent festgelegt wurde, tun Sie Folgendes:
- Klicken Sie auf Neuen Registrierungsschlüssel generieren.
Das angezeigte Warndialogfeld trifft auf Sie zu, wenn Sie bereits einen oder mehrere Agenten lokal installiert haben.
Klicken Sie auf Neuen Registrierungsschlüssel generieren.
- Klicken Sie auf Neuen Registrierungsschlüssel generieren.
- Klicken Sie auf Schlüsseldatei herunterladen und schließen.
Achtung
Schließen Sie das Browser-Fenster erst, nachdem Sie die Schlüsseldatei heruntergeladen haben.
- Speichern Sie die heruntergeladene Schlüsseldatei in einem sicheren Speicherort auf dem Windows-Server, auf dem der Robots-Agent ausgeführt wird.
Hinweis
Der erste Teil der Registrierung eines Robot-Agents besteht aus der Generierung einer Schlüsseldatei. Die Registrierung ist abgeschlossen, wenn Sie die Schlüsseldatei an der richtigen Stelle in der Verzeichnisstruktur des Robots-Agenten ablegen, den Robots-Agent-Dienst starten oder neu starten und erfolgreich eine Verbindung zur Robots-App herstellen.
Robots-Agent installieren
Verwenden Sie das Installationspaket des Robots-Agenten, um eine Neuinstallation des Robots-Agenten durchzuführen.
Hinweis
Sie benötigen auf dem Windows-Server lokale Administratorberechtigungen, um die Installation abzuschließen.
Wenn Sie unterschiedliche Windows-Konten zum Installieren des Robots-Agenten und zum Ausführen des Robots-Agent-Diensts verwenden, stellen Sie sicher, dass Sie über das Kennwort für das Robots-Agent-Dienstkonto verfügen, bevor Sie mit der Installation beginnen.
Installationspaket herunterladen
- Laden Sie das Installationspaket für den Robots-Agenten über Launchpad herunter (RobotsAgent17.exe):
- Melden Sie sich bei Diligent One (www.highbond.com) an.
- Klicken Sie in Launchpad unter Audit und Analyse auf die Kachel Analytics, um auf Downloads zuzugreifen.
- Klicken Sie im oberen Menü auf Robots-Agent.
- Klicken Sie auf Version 17 herunterladen.
- Nachdem Sie das Installationspaket auf den Windows-Server heruntergeladen haben, doppelklicken Sie auf das Installationspaket.
-
Falls ein Dialogfeld mit einer Sicherheitswarnung erscheint, überprüfen Sie die aufgelisteten Informationen und klicken auf Ja.
Tipp
Das Dialogfeld mit der Sicherheitswarnung könnte hinter geöffneten Fenstern verborgen sein.
Installationsprogramm extrahieren und ausführen
- Wählen Sie die gewünschte Sprache der Installation aus und klicken Sie auf OK.
- Geben Sie auf der Seite Extraktionspfad einrichten den Ordner an, in den die Installationsdateien extrahiert werden sollen, und klicken Sie auf Extrahieren.
Sie können auf Durchsuchen klicken, um einen Ordner auszuwählen, oder den Standardspeicherort akzeptieren:
C:\Benutzer\Name_des_Benutzerkontos\Downloads\ACL Installers\RobotsAgent17
Die Setup-Dateien werden in den angegebenen Zielordner extrahiert. Nachdem die Dateien extrahiert wurden, wird das Installationsprogramm automatisch gestartet.
Hinweis
Wenn das Installationsprogramm nicht automatisch gestartet wird, können Sie im Windows-Explorer den Ordner öffnen, in den die Setup-Dateien extrahiert wurden. Doppelklicken Sie dort auf Setup.exe.
Erforderliche Komponenten installieren, soweit notwendig
Falls Sie aufgefordert werden, erforderliche Komponenten zu installieren, klicken Sie auf Installieren.
Nachdem die erforderlichen Komponenten installiert wurden, fährt das -Installationsprogramm automatisch fort.
Eine Liste mit den Voraussetzungen finden Sie unter Systemanforderungen für den lokalen Robots-Agenten.
Eigenschaften der Installation konfigurieren
- Klicken Sie auf der Seite Willkommen auf Weiter.
- Wählen Sie auf der Seite Lizenzvertrag die Option Ich stimme den obigen Bedingungen zu aus und klicken Sie auf Weiter.
- Auf der Seite Robots-Agent-Edition auswählen wählen Sie die zu installierende Edition aus und klicken anschließend auf Weiter:
- Nicht-Unicode
- Unicode
Achtung
Stellen Sie sicher, dass die installierte Edition für das Unternehmen geeignet ist. Damit Sie die Tabellen des Robots-Agenten in Analytics öffnen können, müssen die Editionen übereinstimmen.
Wenn Sie einen Multi-Agenten-Cluster einrichten, müssen alle Agenten im Cluster die gleiche Edition haben. Entweder alle Nicht-Unicode oder alle Unicode.
Weitere Informationen finden Sie unter Diligent-Unicode-Produkte.
- Lassen Sie auf der Seite Optionale Analytics-Datenkonnektoren die Option Installieren aktiviert, es sei denn, es gibt einen Grund dafür, warum die optionalen Konnektoren nicht installiert werden sollen, und klicken Sie auf Weiter.
Hinweis
Wenn Sie die optionalen Konnektoren nicht installieren und später einen der Konnektoren verwenden möchten, müssen Sie den Robots-Agenten deinstallieren sowie erneut installieren.
- Lassen Sie auf der Seite Maschinelles Lernen aktivieren die Option Aktivieren aktiviert, es sei denn, es gibt einen Grund dafür, warum die Python-Engine nicht installiert werden sollte, und klicken Sie auf Weiter.
Hinweis
Wenn Sie die Python Engine nicht installieren, sie aber später zur Ausführung von Befehlen für maschinelles Lernen verwenden möchten, müssen Sie den Robots-Agenten deinstallieren sowie erneut installieren.
- Führen Sie auf der Seite Serviceeinstellungen für Robots-Agent die folgenden Einstellungen für das Servicekonto ein und klicken Sie dann auf Weiter:
- Port des Robots-Datendienstes Legen Sie einen Port für den Datenservice fest oder verwenden Sie die Standardeinstellung 10000.
Sie können jeden verfügbaren Port zwischen 0 und 65536 angeben.
- Robots-Agent-Dienstkonto Geben Sie ein vorhandenes Domänenkonto an, um den Robots-Agent-Dienst auszuführen, und geben Sie das Kennwort an.
Beim Konto muss es sich um ein Domänenkonto handeln, das im Format Domaene\Dienstkonto angegeben wird. Das Konto erfordert die Berechtigung, Dienste auf dem Windows-Server-Betriebssystem auszuführen sowie vollständigen Zugriff auf den Datenordner, den Sie während der Installation angeben. Weitere Informationen finden Sie unter Sicherheit des lokalen Robots Agent.
Hinweis
Bei Bedarf können Sie das Robots-Agent-Dienstkonto nach der Installation ändern.
- Port des Robots-Datendienstes Legen Sie einen Port für den Datenservice fest oder verwenden Sie die Standardeinstellung 10000.
-
Wenn Sie aufgefordert werden, die Berechtigung Anmelden als Dienst für das Dienstkonto des Robots-Agenten zu erteilen, klicken Sie auf Ja und dann OK.
- Füllen Sie auf der Seite Zielordner die folgenden Einstellungen für Ziel und Verbindung aus und klicken Sie auf Weiter:
- Zielordner für Robots-Agent
- Wählen Sie den Zielordner für die Installation des Robots-Agenten oder verwenden Sie den Standardspeicherort.
Standardspeicherort: C:\Programme (x86)\ACL Software\Robots Agent\
- Wählen Sie den Speicherort für einen Datenordner oder verwenden Sie den Standardspeicherort.
Standardspeicherort: C:\acl\robots\
Hinweis
Der Datenordner sollte sich nicht im Zielordner für die Installation oder umgekehrt befinden. Bei einer Deinstallation des Robots-Agenten könnte es sonst zu einem Datenverlust kommen.
- Wählen Sie den Zielordner für die Installation des Robots-Agenten oder verwenden Sie den Standardspeicherort.
- Speicherort der Registrierungsdatei für Robots-Agent
- Wählen Sie Registrierungsdatei kopieren und navigieren Sie dann zum Speicherort der Datei registration.key oder geben Sie den Dateipfad von Hand ein.
Wenn das Installationsprogramm ausgeführt wird, kopiert es die Schlüsseldatei automatisch in den richtigen Pfad der Verzeichnisstruktur des Robots-Agenten.
Hinweis
Lassen Sie die Option zum Kopieren der Registrierungsdatei deaktiviert und geben Sie keine Registrierungsdatei an, wenn Sie planen, das Robots-Agent-Dienstkonto nach der Installation des Robots-Agenten zu ändern.
- Wählen Sie Registrierungsdatei kopieren und navigieren Sie dann zum Speicherort der Datei registration.key oder geben Sie den Dateipfad von Hand ein.
- Zielordner für Robots-Agent
Installation abschließen
- Klicken Sie auf der Seite Die Installation kann jetzt durchgeführt werden auf Installieren.
Der Robots-Agent ist installiert.
- Falls Sie gefragt werden, ob Sie Microsoft Access Database Engine installieren möchten, haben Sie folgende Möglichkeiten:
- Klicken Sie auf „Ja“, um die Database Engine zu installieren, wenn Sie den Robots-Agenten aus älteren Excel-Dateien (*.xls) oder aus Microsoft Access-Dateien (*.mdb) importieren oder in diese Formate exportieren müssen.
- Klicken Sie auf „Nein“, um die Database Engine auszuschließen, wenn Sie den Robots-Agenten nur mit der aktuellen Generation von Excel-Dateien (*.xlsx) nutzen und keine älteren Excel-Dateien oder Microsoft Access-Dateien verwenden. Die Database Engine kann Kompatibilitätsprobleme mit anderen, neueren Microsoft Office-Produkten verursachen. Daher sollten Sie die Database Engine nur einschließen, wenn Sie sie tatsächlich benötigen.
- Sobald die Installation abgeschlossen ist, klicken Sie auf Fertigstellen.
Prüfen, ob der Robots-Agent-Dienst ausgeführt wird
Der Robots-Agent-Dienst muss ausgeführt werden, damit der Robots-Agent eine Verbindung zur Robots-App herstellen kann. Ohne Verbindung kann der Robots-Agent keine Robot-Aufgaben und Skripts verarbeiten.
Bei Bedarf können Sie das Robots-Agent-Dienstkonto ändern, wenn Sie prüfen, ob der Robots-Agent-Dienst ausgeführt wird.
Bei der Installation angegebenes Robots-Agent-Dienstkonto verwenden
- Öffnen Sie den Windows-Dienst-Manager.
-
Überprüfen Sie, ob beide Windows-Dienste des Robots-Agenten ausgeführt werden:
- Robots-Agent
- Robots-Datendienst
Falls notwendig, starten Sie einen oder beide Dienste.
Hinweis
Wenn in einer Fehlermeldung angegeben wird, dass der Robots-Agent-Dienst gestartet und dann gestoppt wurde, war die Registrierung des Robots-Agenten möglicherweise nicht erfolgreich.
Stellen Sie sicher, dass die Registrierungsschlüsseldatei (registration.key) im Installationsverzeichnis des Robots-Agenten vorhanden ist. Wenn die Registrierungsschlüsseldatei dort nicht zu finden ist, kopieren Sie die Schlüsseldatei manuell aus ihrem Speicherort in das Installationsverzeichnis. Starten Sie den Robots-Agent-Dienst neu.
Das Standardverzeichnis der Installation ist C:\Programme (x86)\ACL Software\Robots Agent\agent.
- Prüfen Sie die Protokolldatei der Anwendung, um sicherzustellen, dass der Robots-Agent erfolgreich mit der Robots-App verbunden wurde.
Suchen Sie am Ende der Protokolldatei nach dem Eintrag INFO|Connected mit einem Zeitstempel, der dem Start des Robots-Agent-Dienstes entspricht.
Der Standardpfad der Protokolldatei lautet C:\acl\robots\logs\application.log
. - Navigieren Sie in der Robots-App zum Bildschirm Agentenverwaltung und drücken Sie F5, um die Seite neu zu laden.
Wenn der Robots-Agent den Status Online hat, wurde er erfolgreich registriert.
Robots-Agent-Dienstkonto ändern
Führen Sie diese Schritte aus, wenn Sie die Option zum Kopieren der Registrierungsdatei bei der Installation des Robots-Agenten nicht aktiviert haben und das Robots-Agent-Dienstkonto ändern möchten.
Schlüsseldatei für die Registrierung von Hand installieren
- Kopieren Sie die Registrierungsschlüsseldatei (registration.key) aus ihrem Speicherort.
- Navigieren Sie zum Installationsverzeichnis des Robots-Agenten und fügen Sie die Registrierungsschlüsseldatei in den Unterordner agent ein.
Das Standard-Installationsverzeichnis ist: C:\Program File (x86)\ACL Software\Robots Agent\agent
Falls erforderlich, löschen oder überschreiben Sie eine bestehende Schlüsseldatei.
Robots-Agent-Dienst zu einem anderen Konto überführen
- Öffnen Sie den Windows-Dienst-Manager.
- Klicken Sie mit der rechten Maustaste auf den Robots-Agent-Dienst und wählen Sie Eigenschaften aus.
- Klicken Sie auf der Registerkarte Anmelden auf Durchsuchen.
- Geben Sie im Dialogfeld Benutzer auswählen im Feld Geben Sie die zu verwendenden Objektnamen ein den Namen des gewünschten Dienstkontos ein und klicken Sie auf Namen überprüfen.
Das Dienstkonto sollte im Feld vorausgefüllt sein.
- Klicken Sie auf OK.
- Geben Sie auf der Registerkarte Anmelden das Kennwort für das Dienstkonto ein, bestätigen Sie es und klicken Sie auf OK.
- Starten Sie im Windows-Dienst-Manager den Robots-Agent-Dienst (neu).
- Starten Sie ggf. den Robots-Datendienst.
Prüfen, ob der Robots-Agent erfolgreich registriert wurde
- Prüfen Sie die Protokolldatei der Anwendung, um sicherzustellen, dass der Robots-Agent erfolgreich mit der Robots-App verbunden wurde.
Suchen Sie am Ende der Protokolldatei nach dem Eintrag INFO|Connected mit einem Zeitstempel, der dem Start des Robots-Agent-Dienstes entspricht.
Der Standardpfad der Protokolldatei lautet C:\acl\robots\logs\application.log
. - Navigieren Sie in der Robots-App zum Bildschirm Agentenverwaltung und drücken Sie F5, um die Seite neu zu laden.
Wenn der Robots-Agent den Status Online hat, wurde er erfolgreich registriert.
Robots-Agent-Einstellungen in der Robots-App konfigurieren
Sofern für Ihre Organisation zutreffend, aktualisieren Sie in der Robots-App die Standardwerte für zwei Robots-Agent-Konfigurationseinstellungen:
- Zugelassene Dateiuploads bestimmt, ob ausgegebenen Ergebnisse vom Robots-Agent in die Robots-App in der Cloud hochgeladen werden:
- Pfadkonfiguration gibt die Windows-Server- oder Netzwerkverzeichnisse für Analytics-Datentabellen und -Ergebnistabellen an
Weitere Informationen finden Sie unter Einen lokalen Robots-Agenten konfigurieren.
Robots-Agent testen
Nachdem Sie den Robots-Agent installiert haben, können Sie ein einfaches Skript übertragen und ausführen, um zu testen, ob der Robots-Agent korrekt funktioniert.
Hinweis
Für diesen Test ist es erforderlich, dass Datei-Uploads auf Robots zulässig sind. Aktivieren Sie bei Bedarf vorübergehend Datei-Uploads für den Test. Weitere Informationen finden Sie unter Einen lokalen Robots-Agenten konfigurieren.
Analytics-Projekt erstellen und die Testdatei herunterladen
- Erstellen Sie ein neues Analytics-Projekt mit dem Namen Robots Agent test.acl.
- Klicken Sie mit der rechten Maustaste auf den unten stehenden Link und speichern Sie die Datei im gleichen Ordner wie das gerade erstellte Projekt:
Testskript kopieren
- Erstellen Sie im Analytics-Projekt ein neues Skript mit dem Namen Robots_Agent_test_script.
- Klicken Sie auf den unten stehenden Link, um das Testskript in einem Browser zu öffnen:
- Drücken Sie Strg+A, um das gesamte Skript auszuwählen, und Strg+C, um es in die Zwischenablage zu kopieren.
- Fügen Sie das Skript in Robots_Agent_test_script ein und klicken Sie auf Project speichern .
Skript an Robots übertragen und einen Robot direkt erstellen
- Wählen Sie aus dem Analytics-Hauptmenü Datei > Skripts übermitteln.
- Falls notwendig, doppelklicken Sie im Dialogfeld Ziel auswählen auf die jeweilige Diligent One-Instanz.
Die Robot-Sammlung wird mit der Liste bestehender Robots angezeigt, falls bereits welche vorhanden sind.. Ein Robot ist ein Container für Skripts, Daten und automatisierte Aufgaben.
- Geben Sie in das Feld Neuer Robot Testrobot ein, und klicken Sie auf Erstellen.
Der Robot wird erstellt, und eine Robot-ID wird automatisch generiert.
- Geben Sie im Dialogfeld Skripts übermitteln einen Übermittlungshinweis wie „Testskript hochladen“ ein und klicken Sie auf OK.
Das Skript wird an Robots übergeben und befindet sich in dem Robot, den Sie gerade erstellt haben.
- Klicken Sie im Dialogfeld Skripts wurden erfolgreich übermittelt auf den zweiten Link.
Ergebnis Die Robots-Anwendung wird in einem Browserfenster geöffnet, wobei die Registerkarte Skriptversionen ausgewählt ist. Möglicherweise müssen Sie sich in Diligent One anmelden. Sie sollten die Skriptversion sehen, die Sie gerade übermittelt haben.
- Klicken Sie in Analytics auf OK, um das Dialogfeld Skripts wurden erfolgreich übermittelt zu verlassen.
Testdatei hochladen
- Wählen Sie in Robots die Registerkarte Eingabe/Ausgabe.
- Klicken Sie auf wählen Sie auf Ihrem Computer aus und navigieren Sie zu dem Speicherort, an dem Sie die Datei Robots_Agent_test_file.txt gespeichert haben.
- Wählen Sie die Datei aus und klicken Sie auf Öffnen.
Ergebnis Die Datei wird hochgeladen und unter Dateien auf der Registerkarte Eingabe/Ausgabe angezeigt.
Aufgabe erstellen und das Testskript ausführen
- Wählen Sie die Registerkarte Aufgaben und klicken Sie dann auf Aufgabe erstellen.
- Geben Sie als Namen für die Aufgabe Testaufgabe ein und klicken Sie auf Speichern.
- Wählen Sie das Testskript Robots-Agent und klicken Sie auf An das Ende springen > Aufgabe bestätigen und erstellen.
- Klicken Sie auf der Registerkarte Aufgaben in der Testaufgabe auf > Jetzt ausführen.
Ergebnis Die Aufgabe mit dem Testskript wird ausgeführt.
Wenn die Aufgabe mit dem Status Erfolgreich abgeschlossen wird, arbeitet der von Ihnen installierte lokale Robots-Agent korrekt.
Hinweis
Wenn die Aufgabe fehlschlägt, überprüfen Sie, ob der Robots-Agent-Dienst auf dem Server ausgeführt wird, auf dem Sie den Robots-Agenten installiert haben. Starten Sie den Dienst, wenn er nicht läuft, und versuchen Sie erneut, die Testaufgabe auszuführen.
Wenn die Aufgabe weiterhin fehlschlägt, wenden Sie sich an den Diligent-Support.
Skriptausgabe überprüfen
Überprüfen Sie die folgenden Positionen in Robots, um sicherzustellen, dass das Testskript die richtigen Dateien ausgibt.
Position in Robots | Vom Testskript ausgegebene Dateien |
---|---|
Registerkarte Aufgabenausführungen Wählen Sie den Eintrag Testaufgabe. |
Im Seitenbereich Details zur Aufgabenausführung unter Ausgabe:
|
Registerkarte Eingabe/Ausgabe Wählen Sie den Eintrag Robots_Agent_test_file. |
Im Abschnitt Andere Tabellen:
Wählen Sie Robots_Agent_test_file aus. Im Seitenbereich Tabellendetails unter Felder: Sie sollten Informationen zu Name, Typ und Größe (Länge) für drei Felder sehen:
|
Robots-Agent aktualisieren
Verwenden Sie das Installationspaket des Robots-Agenten, um für eine bestehende Installation des Robots-Agenten ein Upgrade auf Version 17.0 durchzuführen.
Bevor Sie das Upgrade durchführen, vergewissern Sie sich, dass keine Robot-Aufgaben ausgeführt werden, sich in der Warteschlange befinden oder die Ausführung in Kürze geplant ist.
Hinweis
Sie benötigen auf dem Windows-Server lokale Administratorberechtigungen, um das Upgrade abzuschließen.
Robots-Agent-Windows-Dienste stoppen
- Öffnen Sie den Manager für Windows-Dienste auf dem Server, auf dem sich der Robots-Agent befindet.
- Halten Sie beide Robots-Agent-Windows-Dienste an:
- Robots-Agent
- Robots-Datendienst
Installationspaket herunterladen
- Laden Sie das Installationspaket für den Robots-Agenten über Launchpad herunter (RobotsAgent17.exe):
- Melden Sie sich im Launchpad (www.highbond.com) an.
- Klicken Sie unter Ressourcen auf Downloads.
- Klicken Sie im oberen Menü auf Robots-Agent.
- Klicken Sie auf Version 17 herunterladen.
- Nachdem Sie das Installationspaket auf den Windows-Server heruntergeladen haben, doppelklicken Sie auf das Installationspaket.
-
Falls ein Dialogfeld mit einer Sicherheitswarnung erscheint, überprüfen Sie die aufgelisteten Informationen und klicken auf Ja.
Tipp
Das Dialogfeld mit der Sicherheitswarnung könnte hinter geöffneten Fenstern verborgen sein.
Installationsprogramm extrahieren und ausführen
- Wählen Sie die gewünschte Sprache der Installation aus und klicken Sie auf OK.
- Geben Sie auf der Seite Extraktionspfad einrichten den Ordner an, in den die Installationsdateien extrahiert werden sollen, und klicken Sie auf Extrahieren.
Sie können auf Durchsuchen klicken, um einen Ordner auszuwählen, oder den Standardspeicherort akzeptieren:
C:\Benutzer\Name_des_Benutzerkontos\Downloads\ACL Installers\RobotsAgent17
Die Setup-Dateien werden in den angegebenen Zielordner extrahiert. Nachdem die Dateien extrahiert wurden, wird das Installationsprogramm automatisch gestartet.
Hinweis
Wenn das Installationsprogramm nicht automatisch gestartet wird, können Sie im Windows-Explorer den Ordner öffnen, in den die Setup-Dateien extrahiert wurden. Doppelklicken Sie dort auf Setup.exe.
- Klicken Sie in der Upgrade-Eingabeaufforderung auf Ja.
- Klicken Sie im Dialogfeld Informationen zum Robots-Agent-Installationsprogramm nur dann auf OK, wenn Sie die aufgelisteten Anforderungen erfüllt haben.
Wenn Sie die Anforderungen noch nicht erfüllt haben, müssen Sie sie zunächst erfüllen, bevor Sie mit dem Upgrade fortfahren. Deaktivieren Sie bei Bedarf alle Robot-Aufgaben, die für eine baldige Ausführung geplant sind.
Erforderliche Komponenten installieren, soweit notwendig
Falls Sie aufgefordert werden, erforderliche Komponenten zu installieren, klicken Sie auf Installieren.
Nachdem die erforderlichen Komponenten installiert wurden, fährt das -Installationsprogramm automatisch fort.
Eine Liste mit den Voraussetzungen finden Sie unter Systemanforderungen für den lokalen Robots-Agenten.
Eigenschaften der Installation konfigurieren
- Klicken Sie auf der Seite Willkommen auf Weiter.
- Wählen Sie auf der Seite Lizenzvertrag die Option Ich stimme den obigen Bedingungen zu aus und klicken Sie auf Weiter.
- Auf der Seite Robots-Agent-Edition auswählen klicken Sie auf Weiter.
Das Installationsprogramm erzwingt Ihre aktuell installierte Edition von Robots-Agent (Nicht-Unicode oder Unicode).
Hinweis
Während eines Upgrades kann die Edition nicht geändert werden. Um die Edition zu ändern, müssen Sie die aktuelle Version des Robots-Agenten deinstallieren und anschließend Version 17.0 installieren.
- Lassen Sie auf der Seite Optionale Analytics-Datenkonnektoren die Option Installieren aktiviert, es sei denn, es gibt einen Grund dafür, warum die optionalen Konnektoren nicht installiert werden sollen, und klicken Sie auf Weiter.
Hinweis
Wenn Sie die optionalen Konnektoren nicht installieren und später einen der Konnektoren verwenden möchten, müssen Sie den Robots-Agenten deinstallieren sowie erneut installieren.
- Lassen Sie auf der Seite Maschinelles Lernen aktivieren die Option Aktivieren aktiviert, es sei denn, es gibt einen Grund dafür, warum die Python-Engine nicht installiert werden sollte, und klicken Sie auf Weiter.
Hinweis
Wenn Sie die Python Engine nicht installieren, sie aber später zur Ausführung von Befehlen für maschinelles Lernen verwenden möchten, müssen Sie den Robots-Agenten deinstallieren sowie erneut installieren.
- Führen Sie auf der Seite Serviceeinstellungen für Robots-Agent die folgenden Einstellungen für das Servicekonto ein und klicken Sie dann auf Weiter:
- Port des Robots-Datendienstes Sie können den für den Datendienst angegebenen vorhandenen Port beibehalten oder einen anderen Port angeben.
Sie können jeden verfügbaren Port zwischen 0 und 65536 angeben.
- Robots-Agent-Dienstkonto Sie können das vorhandene Domänenkonto, auf dem der Robots-Agent-Dienst ausgeführt wird, beibehalten oder ein anderes Konto angeben. Geben Sie das Kennwort für das Konto an.
Beim Konto muss es sich um ein Domänenkonto handeln, das im Format Domaene\Dienstkonto angegeben wird. Das Konto erfordert die Berechtigung, Dienste auf dem Windows-Server-Betriebssystem auszuführen, sowie vollständigen Zugriff auf den Datenordner des vorhandenen Robots-Agenten. Weitere Informationen finden Sie unter Sicherheit des lokalen Robots Agent.
Hinweis
Wenn Sie das Robots-Agent-Dienstkonto ändern müssen, sollten Sie das nach dem Upgrade tun.
Wenn Sie das Konto beim Upgrade im Installationsprogramm ändern, müssen Sie den Robots-Agenten erneut registrieren. Bei der erneuten Registrierung eines installierten Agenten kann die Konfiguration der Robots-Instanz Ihrer Organisation beeinträchtigt werden.
Weitere Informationen finden Sie unter Robots-Agent-Dienstkonto ändern.
- Port des Robots-Datendienstes Sie können den für den Datendienst angegebenen vorhandenen Port beibehalten oder einen anderen Port angeben.
- Überprüfen Sie auf der nächsten Seite die Konfigurationsinformationen und klicken Sie auf Weiter.
Aktualisierung abschließen
- Klicken Sie auf der Seite Die Installation kann jetzt durchgeführt werden auf Installieren.
Das Upgrade für den Robots-Agenten wurde durchgeführt.
- Falls Sie gefragt werden, ob Sie Microsoft Access Database Engine installieren möchten, haben Sie folgende Möglichkeiten:
- Klicken Sie auf „Ja“, um die Database Engine zu installieren, wenn Sie den Robots-Agenten aus älteren Excel-Dateien (*.xls) oder aus Microsoft Access-Dateien (*.mdb) importieren oder in diese Formate exportieren müssen.
- Klicken Sie auf „Nein“, um die Database Engine auszuschließen, wenn Sie den Robots-Agenten nur mit der aktuellen Generation von Excel-Dateien (*.xlsx) nutzen und keine älteren Excel-Dateien oder Microsoft Access-Dateien verwenden. Die Database Engine kann Kompatibilitätsprobleme mit anderen, neueren Microsoft Office-Produkten verursachen. Daher sollten Sie die Database Engine nur einschließen, wenn Sie sie tatsächlich benötigen.
- Wenn die Aktualisierung abgeschlossen ist, klicken Sie auf Fertigstellen.
- Klicken Sie auf Ja, um den Server neu zu starten und das Upgrade abzuschließen.
-
Überprüfen Sie im Windows-Dienstprogramm, dass beide Windows-Dienste des Robots-Agenten ausgeführt werden:
- Robots-Agent
- Robots-Datendienst
Falls notwendig, starten Sie einen oder beide Dienste.
Weitere Instanz von Robots-Agent installieren
Verwenden Sie das Installationspaket von Robots-Agent, um zusätzliche Instanzen von Robots-Agent auf weiteren Windows-Servern zu installieren.
Die Installation mehrerer Agenten ermöglicht es Ihnen, die Verarbeitungskapazität für Analysen zu erhöhen und einen Lastausgleich zwischen den Agenten zu implementieren. Wenn Sie mehrere Robot-Aufgaben gleichzeitig ausführen, wird die Verarbeitung der Analyseskripts automatisch zwischen den mehreren Agenten auf mehreren Windows-Servern verteilt. Dadurch können Sie eine größere Zahl von Aufgaben in kürzerer Zeit ausführen.
Hinweis
Die Multi-Agent-Funktion hat nichts mit den Entwicklungs- und Produktionsmodi in Robots zu tun. Bei der Aufgabenausführung haben beide Modi gleichen Zugang zu allen Agenten.
Wichtig
Die Installation mehrerer Agenten erfordert, dass alle Agenten Version 15 oder höher haben und alle die gleiche Codierung verwenden: Entweder sind sie Nicht-Unicode- oder Unicode-Agenten.
Alle Agenten müssen auch in der Lage sein, auf die Verzeichnisse zuzugreifen, die Sie für Ausgabetabellen von Skripts im Bildschirm Agentenverwaltung festlegen. 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 Einen lokalen Robots-Agenten konfigurieren.
Hinweis
Sie müssen auf jedem Windows-Server, auf dem Sie den Robots-Agenten installieren, über lokale Administratorrechte verfügen.
Diese Anweisungen beziehen sich auf Server 1 und Server 2:
- Server 1 Der Windows-Server, auf dem Sie die erste Instanz von Robots-Agent installiert haben
- Server 2 Ein weiterer Windows-Server, auf dem Sie eine zusätzliche Instanz von Robots-Agent installieren
Hinweis
Sie können den Vorgang für so viele weitere Agenten und Server wie erforderlich wiederholen.
Robots-Agent auf Server 2 installieren
- Führen Sie auf Server 2 denselben Installationsvorgang aus, mit dem Sie Robots-Agent auf Server 1 installiert haben.
-
Lassen Sie im Installationsprogramm auf der Seite Zielordner die Option zum Kopieren der Registrierungsdatei deaktiviert und lassen Sie das Feld Speicherort der Registrierungsdatei für Robots-Agent leer.
Angaben zu den Installationsschritten siehe Robots-Agent installieren.
Namen des RSA-Schlüssels über die Robots-App ermitteln
- Melden Sie sich bei Diligent One (www.highbond.com) an.
- Wählen Sie auf der Startseite von Launchpad unter Audit und Analyse die Robots-App aus.
- Klicken Sie in der oberen rechten Ecke des Dashboards auf Einstellungen.
- Vergewissern Sie sich, dass im linken Fensterbereich die Option Agentenverwaltung ausgewählt ist.
- Klicken Sie auf Wie zusätzliche Agenten hinzugefügt werden.
- Klicken Sie auf , um den Namen des RSA-Schlüssels in die Zwischenablage zu kopieren.
- Fügen Sie den Namen des RSA-Schlüssels in eine Textdatei ein, um ihn vorübergehend zu speichern.
RSA-Schlüssel von Robots-Agent in eine Datei einbinden
Binden Sie mit dem Dienstprogramm EncryptionKeyCLI.exe auf Server 1 den RSA-Schlüssel von Robots-Agent in eine Datei ein.
Hinweis
Wenn Sie bereits einen zusätzlichen Robots-Agent installiert und eine Zip-Datei mit dem RSA-Schlüssel erstellt haben, verwenden Sie die vorhandene Datei. Es ist nicht erforderlich, eine weitere Kopie zu erstellen.
- Öffnen Sie auf Server 1 die Windows-Befehlszeile als Administrator.
- Führen Sie den folgenden Befehl aus, um in das Installationsverzeichnis des Robots-Agenten zu wechseln:
cd C:\Programme (x86)\ACL Software\Robots Agent\agent
Geben Sie den korrekten Pfad an, falls Sie den Robots-Agenten nicht im Standardverzeichnis installiert haben.
- Führen Sie den folgenden Befehl aus, um den RSA-Schlüssel des Robots-Agenten in eine ZIP-Datei einzubinden:
EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX
Ersetzen Sie ACL_XXXXXXXX durch den tatsächlichen Namen des RSA-Schlüssels, den Sie in Robots aus dem Bildschirm Agentenverwaltung kopiert haben.
RSAKeyfile dabei kann es sich um einen beliebigen Dateinamen ohne Leerzeichen handeln, den Sie angeben möchten. Sie können optional einen Dateipfad für einen bestehenden Ordner auf dem Server festlegen. Schließen Sie den gesamten Pfad und den Dateinamen in doppelte Anführungszeichen ein, wenn er Leerzeichen enthält.
- Falls notwendig, geben Sie Y ein, um eine bestehende Datei zu überschreiben.
Ergebnis Der RSA-Schlüssel ist in einer ZIP-Datei gebündelt und wird im Standardpfad (C:\ProgramData\robots\RSAKeyfile.zip) oder dem von Ihnen angegebenen Speicherort gespeichert.
.Hinweis
Wenn Sie den Ordner ProgramData nicht sehen, ist er vielleicht ausgeblendet. Damit der Ordner sichtbar wird, wählen Sie im Windows-Explorer das Stammverzeichnis C:\ aus und dann Ausgeblendete Elemente (Registerkarte Ansicht > Ausgeblendete Elemente)
RSA-Schlüsseldatei auf Server #2 migrieren
Extrahieren Sie mit dem Dienstprogramm EncryptionKeyCLI.exe auf Server 2 den RSA-Schlüssel von Robots-Agent aus der Zip-Datei und importieren Sie ihn in den Microsoft-KeyStore.
- Kopieren Sie RSAKeyfile.zip von Server 1 in das Installationsverzeichnis von Robots-Agent auf Server 2.
Das Standardverzeichnis der Installation ist C:\Programme (x86)\ACL Software\Robots Agent\agent.
- Öffnen Sie auf Server 2 die Windows-Befehlszeile als Administrator.
- Führen Sie den folgenden Befehl aus, um in das Installationsverzeichnis des Robots-Agenten zu wechseln:
cd C:\Programme (x86)\ACL Software\Robots Agent\agent
Geben Sie den korrekten Pfad an, falls Sie den Robots-Agenten nicht im Standardverzeichnis installiert haben.
- Führen Sie den folgenden Befehl aus, um den RSA-Schlüssel von Robots-Agent aus der Zip-Datei zu extrahieren und in den Microsoft KeyStore auf Server 2 zu importieren:
EncryptionKeyCLI.exe import RSAKeyfile
Wenn Sie nicht RSAKeyfile als Namen der Zip-Datei verwendet haben, ersetzen Sie ihn durch den Namen, den Sie verwendet haben.
Registrierungsschlüsseldatei auf Server 2 kopieren
Kopieren Sie die Registrierungsschlüsseldatei (registration.key) aus dem Robots-Agent-Installationsverzeichnis auf Server 1 in das Robots-Agent-Installationsverzeichnis auf Server 2.
Das Standardverzeichnis der Installation ist C:\Programme (x86)\ACL Software\Robots Agent\agent.
Robots-Agent-Dienst auf Server 2 neu starten
Öffnen Sie auf Server 2 den Windows-Dienst-Manager und starten Sie den Robots-Agent-Dienst neu (oder starten Sie ihn).
Überprüfen, ob der zusätzliche Agent erfolgreich registriert wurde
Navigieren Sie in der Robots-App zum Bildschirm Agentenverwaltung und drücken Sie F5, um die Seite neu zu laden. Wenn der zusätzliche Robots-Agent in der Liste mit dem Status Online angezeigt wird, war die Registrierung erfolgreich. Der Agent ist jetzt Teil des Agenten-Clusters, der für die Verarbeitung von Analysen und den Lastausgleich verwendet wird.