Lokalen Robots-Agenten manuell registrieren

Der Robots-Agent muss mit einer Schlüsseldatei (registration.key) registriert werden. In der Regel registrieren Sie den Robots-Agenten während der Installation. In den folgenden Fällen müssen Sie den Robots-Agenten aber unabhängig von der Installation manuell oder erneut registrieren.

Für die manuelle Registrierung eines Robots-Agenten müssen zwei Schritte ausgeführt werden:

  1. Registrierungsschlüsseldatei generieren und herunterladen
  2. Registrierungsschlüsseldatei in der Verzeichnisstruktur des Robots-Agenten manuell installieren und den Robots-Agent-Dienst starten bzw. erneut starten

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.

Manuelle Registrierung erforderlich

Die manuelle oder erneute Registrierung des Robots-Agenten ist in den folgenden Fällen erforderlich:

  • Änderung des Dienstkontos nach der Installation Bei der Installation des Robots-Agenten lassen Sie die Option zum Kopieren der Registrierungsdatei deaktiviert. Nach Abschluss der Installation möchten Sie das Konto für die Ausführung des Robots-Agent-Dienstes sofort aktualisieren.
  • Änderung der Server-IP Die IP-Adresse des Windows-Servers mit dem Robots-Agenten wird geändert.
  • Problem mit einer Schlüsseldatei Es gibt ein Problem mit der bestehenden Registrierungsschlüsseldatei.

Keine manuelle Registrierung erforderlich

In den folgenden Situationen sollten Sie nicht einen vorhandenen Robots-Agenten manuell registrieren oder eine neue Registrierungsschlüsseldatei generieren:

  • Änderung eines Dienstkontos in der Produktion Sie müssen das Dienstkonto ändern, das einen installierten Robots-Agenten ausgeführt hat. Weitere Informationen finden Sie unter Robots-Agent-Dienstkonto ändern.
  • Upgrade des Robots-Agenten Die Registrierungsschlüsseldatei ist nicht am Upgrade des Robots-Agenten beteiligt.

In diesen Situationen ist die Generierung einer neuen Registrierungsschlüsseldatei unnötig. Außerdem kann sie die Konfiguration der Robots-Instanz Ihrer Organisation beeinträchtigen.

Auswirkungen des erneuten Generierens eines Registrierungsschlüssels

Wenn Sie bereits einen Robots-Agenten verwenden, wirkt sich das erneute Generieren eines Registrierungsschlüssels wie folgt aus:

  • Alle gespeicherten Kennwörter in Robot-Aufgaben werden gelöscht und müssen erneut eingegeben werden.
  • Alle Agenten werden im Bildschirm Agentenverwaltung aus der Agentenliste entfernt.
  • Alle Agenten müssen wieder registriert werden. Dies beinhaltet die Migration des RSA-Schlüssels von Robots-Agenten zwischen Servern bei der Installation mehrerer Agenten.

Registrierungsschlüsseldatei des Robots-Agenten generieren

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.

Schlüsseldatei für die Registrierung von Hand installieren

  1. Kopieren Sie auf dem Windows-Server, auf dem der Robots-Agent ausgeführt wird, die Registrierungsschlüsseldatei aus dem Pfad, unter dem Sie ihn gespeichert haben.
  2. 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.

  3. Starten Sie im Windows-Dienst-Manager den Robots-Agent-Dienst neu.

    Hinweis

    Wenn Sie den Dienst nicht neu starten, werden Analyseskripts nicht ausgeführt.

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

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