Installeren of upgraden van een Robots Agent ter plaatse

De Robots Agent voert de taken uit die in de Robots-app zijn gepland. De agent voert de taken uit op de beveiligde lokale Windows-server van uw bedrijf, dicht bij de gegevensbron en binnen de beschermende grenzen van uw netwerk.

Opmerking

De informatie in dit onderwerp is alleen van toepassing op organisaties die een Robots-agent ter plaatse gebruiken om ACL-scripts uit te voeren in ACL-robots.

Personen en organisaties met ACL Robotics Professional Edition hebben geen Robots-agent ter plaatse. Python/HCL-scripts die in HighBond-robots of Workflowrobots worden uitgevoerd, maken geen gebruik van de Robots-agent.

Algemene informatie

Download het installatiepakket van de Robots Agent en gebruik het om de Robots Agent op een Windows-server te installeren. U kunt het installatiepakket ook gebruiken om een bestaande Robots Agent op de server te upgraden.

Sleutelbestanden

Tijdens de installatie registreert u de Robots Agent met behulp van een registratiesleutelbestand (registration.key). U genereert het sleutelbestand in de Robots-app en downloadt het naar de Windows-server waarop de Robots Agent is geïnstalleerd.

De registratiesleutel verifieert de eerste verbinding tussen de Robots Agent en de Robots-app. Vervolgverbindingen en gegevensstromen worden beveiligd door middel van encryptiesleutels (een RSA-paar van een openbare en privésleutel). Het RSA-sleutelpaar wordt automatisch gegenereerd wanneer u de Robots Agent-service start.

Het registratiesleutelbestand en de versleutelingssleutels zijn afzonderlijke objecten die in verschillende stadia van het registratie- en verbindingsproces worden gebruikt.

Als u de Robots Agent upgradet, is het registratiesleutelbestand niet betrokken en hoeft u geen nieuwe instantie van registration.key te genereren.

Meerdere agents

Om de analytische verwerkingscapaciteit te verhogen en de belasting te verdelen, kunt u extra instanties van de Robots Agent op bijkomende Windows-servers installeren.

Robots Agent Windows-services en -accounts

Wanneer u de Robots Agent installeert, worden er twee Windows-services op de server geïmplementeerd:

  • Robots Agent voert geplande en ad-hoctaken van Robots uit
  • Robots Data Service biedt de connectiviteit waarmee gebruikers Robots Agent-tabellen in Analytics kunnen openen

Als een van deze diensten niet beschikbaar is, kunt u geen gebruik maken van de functies die ze aanbieden.

Tip

Als taken lange tijd in de wachtrij blijven staan in Robots en vervolgens worden overgeslagen of mislukken, controleer dan of de Robots Agent-service actief is.

Als gebruikers een verbindingsfout krijgen bij een poging om een Robots Agent-tabel te openen in Analytics, controleer dan of de Robots Data Service actief is.

Serviceaccounts en -poorten

U gebruikt serviceaccounts om de twee Windows-services van Robots Agent uit te voeren. Voor gedetailleerde informatie over de aanmeldrechten en machtigingen die vereist zijn voor de accounts, zie Beveiliging van Robots Agent ter plaatse.

Opmerking

Als u de eigenschappen van een van de Windows-services wijzigt nadat u de Robots Agent hebt geïnstalleerd, moet u de service opnieuw starten om de wijziging van kracht te laten worden.

Windows-service Account dat de service uitvoert Poort
Robots-agentservice

Domeinaccount dat is opgegeven tijdens installatie, of na installatie

443 alleen uitgaande communicatie
Robots-gegevensservice Lokaal systeem Standaard 10000, te configureren tijdens en na installatie

Zorg ervoor dat de Robots Agent verbinding kan maken met de certificeringsinstantie

De Robots Agent gebruikt een digitaal certificaat om zijn authenticiteit en integriteit te valideren. Het certificaat vereist een internetverbinding met DigiCert, de externe certificeringsinstantie, zodat het certificaat kan worden geverifieerd. Als u de Robots Agent achter een netwerkfirewall installeert, moet de firewall zo worden geconfigureerd dat het certificaat verbinding kan maken met DigiCert. Zonder de vereiste verbinding werkt de Robots Agent niet.

Werk indien nodig samen met de IT-afdeling van uw organisatie om een netwerkfirewall of proxyserver te configureren om de verbinding tussen het certificaat en DigiCert mogelijk te maken. De digitale certificering in de Robots Agent gebruikt de volgende URL's om verbinding te maken met de certificaatintrekkingslijst en OCSP-server van DigiCert:

  • http://cacerts.digicert.com
  • http://crl3.digicert.com
  • http://crl4.digicert.com
  • http://ocsp.digicert.com

Voor meer gedetailleerde URL-informatie kunt u het geïnstalleerde certificaat inspecteren.

Het geïnstalleerde certificaat inspecteren

Na het installeren van de Robots Agent inspecteert u het geïnstalleerde certificaat om de URL's van de certificeringsinstantie te bekijken.

  1. Klik in de installatiemap van de Robots Agent met de rechtermuisknop op Agent.exe en selecteer Eigenschappen.

    De standaard installatiemap is: C:\Program Files (x86)\ACL Software\Robots Agent\agent

  2. Selecteer in het dialoogvenster Agent.exe Properties het tabblad Digitale handtekeningen.

  3. In de Lijst met handtekeningen, dubbelklikt u op Diligent Corporation en vervolgens klikt u op Certificaat weergeven.

  4. In het tabblad Details in het dialoogvenster Certificaat selecteert u elk van deze velden:

    • CRL-distributiepunten

    • Toegang tot autoriteitsinformatie

    Voor elk veld verschijnen URL's in het weergavegebied onder in het dialoogvenster.

  5. In het tabblad Certificeringspad in het dialoogvenster Certificaat doet u het volgende:

    1. Selecteer elk van deze certificeringspadonderdelen:

      • DigiCert Trusted Root G4

      • DigiCert Trusted G4 Code Signing...

    2. Klik voor elke vermelding op Certificaat weergeven.

    3. Selecteer op het tabblad Details elk van deze velden:

      • Toegang tot autoriteitsinformatie

      • CRL-distributiepunten

      Voor elk veld verschijnen URL's in het weergavegebied onder in het dialoogvenster.

Genereer het registratiesleutelbestand van de Robots Agent

Als u de Robots Agent voor het eerst installeert als nieuwe klant, dient u een registratiesleutelbestand (registration.key) te genereren. De registratiesleutel verifieert de eerste verbinding tussen de Robots Agent en de Robots-app.

Als u een bestaande klant bent en al een Robots Agent hebt geïnstalleerd en gebruikt, hoeft u in de meeste gevallen geen nieuw registratiesleutelbestand te genereren. Het genereren van een nieuw bestand is vaak onnodig en kan de configuratie van de Robots-instantie van uw organisatie verstoren.

Robots Agent-status Een registratiesleutelbestand genereren
Nieuwe installatie van de Robots Agent, installatie van één agent Ja
Nieuwe installatie van een extra instantie van de Robots Agent in een multi-agent cluster

Nee

Kopieer het bestaande registratiesleutelbestand

Voor meer informatie raadpleegt u Een extra instantie van de Robots Agent installeren.

Upgrade van een momenteel geïnstalleerde Robots Agent

Nee

Het registratiesleutelbestand is niet betrokken bij de upgrade

Probleem met een bestaand registratiesleutelbestand, Robots Agent kan geen verbinding maken met de Robots-app Ja
Wijziging van Windows-account dat een momenteel geïnstalleerde Robots Agent uitvoert

Nee

Het registratiesleutelbestand is niet betrokken bij de wijziging van het account

Voor meer informatie raadpleegt u Het wijzigen van het serviceaccount voor de Robots Agent.

Opmerking

U moet over de machtiging Agent beheren beschikken om een registratiesleutelbestand voor een Robots Agent te genereren. Voor meer informatie raadpleegt u Machtigingen Robots-app.

  1. Selecteer vanaf de startpagina van Launchpad (www.highbond.com) de Robots-app om deze te openen.

    Als u zich reeds in Diligent One bevindt, kunt u het navigatiemenu aan de linkerkant gebruiken om naar de Robots-app te switchen.

  2. Klik in de rechterbovenhoek van het dashboard op Instellingen.

  3. Zorg ervoor dat Agentbeheer in het linkerdeelvenster is geselecteerd.

  4. Als uw exemplaar van Robots momenteel een cloudgebaseerde Robots-agent gebruikt, doet u het volgende:

    1. Klik op Cloudagent vervangen.

    2. Klik op Agent registreren en sleutel genereren.

  5. Als uw exemplaar van Robots momenteel een Robots-agent ter plaatse gebruikt, of als er geen Robots-agent voor is opgegeven, doet u het volgende:

    1. Klik op Genereer een nieuwe registratiesleutel.

      Het waarschuwingsdialoogvenster dat wordt weergegeven, is op u van toepassing als u al een of meer bestaande agenten ter plaatse hebt geïnstalleerd.

    2. Klik op Genereer een nieuwe registratiesleutel.

  6. Klik op Download het sleutelbestand en sluit het.

    Let op

    Sluit het browservenster pas als u het sleutelbestand hebt gedownload.

  7. Sla het gedownloade sleutelbestand op een veilige locatie op de Windows-server op waar de Robots-agent wordt geplaatst.

    Opmerking

    Het genereren van een sleutelbestand is het eerste onderdeel van het registreren van een Robots-agent. Het registratieproces is voltooid wanneer u het sleutelbestand op de juiste locatie in de directorystructuur van de Robots-agent plaatst, de service Robots-agent start of herstart en verbinding maakt met de Robots-app.

De Robots Agent installeren

Gebruik het installatiepakket van de Robots Agent om een nieuwe installatie van de Robots Agent uit te voeren.

Opmerking

U moet lokale beheerdersrechten hebben op de Windows-server om de installatie te voltooien.

Als u verschillende Windows-accounts gebruikt om de Robots Agent te installeren en om de Robots Agent-service uit te voeren, zorg er dan voor dat u het wachtwoord voor het Robots Agent-serviceaccount hebt voordat u met de installatie begint.

De Robots Agent testen

Nadat u de Robots Agent heeft geïnstalleerd, kunt u een eenvoudig script vastleggen en uitvoeren om te testen of de Robots Agent correct werkt.

Opmerking

Deze test vereist dat het uploaden van bestanden naar Robots is toegestaan. Schakel indien nodig tijdelijk bestandsuploads in voor de test. Voor meer informatie raadpleegt u Een Robots Agent ter plaatse configureren.

De Robots Agent upgraden

Gebruik het installatiepakket van de Robots-agent om een bestaande installatie van de Robots-agent te upgraden naar versie 18.0.

Zorg er voor het uitvoeren van de upgrade voor dat er geen robottaken worden uitgevoerd, in de wachtrij staan of binnenkort zijn gepland om uitgevoerd te worden.

Opmerking

U moet over lokale beheerdersmachtigingen beschikken op de Windows-server om de upgrade te voltooien.

Een extra instantie van de Robots Agent installeren

Gebruik het installatiepakket van de Robots Agent om extra exemplaren van de Robots Agent op aanvullende Windows-servers te installeren.

Het installeren van meerdere agents stelt u in staat om de capaciteit voor het verwerken van analyses te vergroten en de belasting over de agents te verdelen. Wanneer u meerdere robot-taken tegelijkertijd uitvoert, wordt de verwerking van de analytische scripts automatisch verdeeld tussen de meerdere agents op meerdere Windows-servers. Deze functionaliteit stelt u in staat om meer taken uit te voeren in een kortere periode.

Opmerking

De mogelijkheid voor meerdere agents houdt geen verband met de ontwikkelings- en productiemodi in Robots. Bij het uitvoeren van taken hebben beide modi gelijke toegang tot alle agents.