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.

  1. 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.

  2. Wählen Sie im Dialogfeld Eigenschaften von Agent.exe die Registerkarte Digitale Signaturen.
  3. In der Signaturliste doppelklicken Sie auf Diligent Corporation und klicken dann einmal auf Zertifikat anzeigen.
  4. 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.

  5. Auf der Registerkarte Zertifizierungspfad im Dialogfeld Zertifikat gehen Sie wie folgt vor:
    1. Wählen Sie diese Einträge zum Zertifizierungspfad aus:
      • DigiCert Trusted Root G4
      • DigiCert Trusted G4 Code Signing...
    2. Klicken Sie bei jedem Eintrag auf Zertifikat anzeigen.
    3. 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.

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.

  1. Melden Sie sich bei Diligent One (www.highbond.com) an.
  2. Wählen Sie auf der Startseite von Launchpad unter Audit und Analyse die Robots-App aus.
  3. Klicken Sie in der oberen rechten Ecke des Dashboards auf Einstellungen.
  4. Vergewissern Sie sich, dass im linken Fensterbereich die Option Agentenverwaltung ausgewählt ist.
  5. Wenn Ihre Instanz von Robots aktuell einen cloudbasierten Robots-Agenten verwendet, tun Sie Folgendes:
    1. Klicken Sie auf Cloud-Agent ersetzen.
    2. Klicken Sie auf Agent registrieren und Schlüssel generieren.
  6. Wenn Ihre Instanz von Robots aktuell einen lokalen Robots-Agenten verwendet oder wenn kein Robots-Agent festgelegt wurde, tun Sie Folgendes:
    1. Klicken Sie auf Neuen Registrierungsschlüssel generieren.

      Das angezeigte Warndialogfeld trifft auf Sie zu, wenn Sie bereits einen oder mehrere Agenten lokal installiert haben.

    2. Klicken Sie auf Neuen Registrierungsschlüssel generieren.

  7. Klicken Sie auf Schlüsseldatei herunterladen und schließen.

    Achtung

    Schließen Sie das Browser-Fenster erst, nachdem Sie die Schlüsseldatei heruntergeladen haben.

  8. 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.

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.

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.

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.