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-agentvoert geplande en ad-hoctaken van Robots uit
  • Robots-gegevensservicebiedt de connectiviteit waarmee gebruikers Robots-agenttabellen kunnen openen in Analytics

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, raadpleegt u 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-serviceAccount dat de service uitvoertPoort
Robots-agentservice

Domeinaccount dat is opgegeven tijdens installatie, of na installatie

443 alleen uitgaande communicatie
Robots-gegevensserviceLokaal systeemStandaard 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 standaardinstallatiemap is: C:\Program Files (x86)\ACL Software\Robots Agent\agent

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

  3. Dubbelklik in de Lijst met handtekeningen op Diligent Corporation en selecteer vervolgens 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. Selecteer voor elke vermelding 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-statusEen registratiesleutelbestand genereren
Nieuwe installatie van de Robots Agent, installatie van één agentJa
Nieuwe installatie van een extra instantie van de Robots Agent in een multi-agent cluster

Nee

Kopieer het bestaande registratiesleutelbestand

Raadpleeg voor meer informatie.

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-appJa
Wijziging van Windows-account dat een momenteel geïnstalleerde Robots Agent uitvoert

Nee

Het registratiesleutelbestand is niet betrokken bij de wijziging van het account

Zie Het wijzigen van het serviceaccount voor de Robots Agent voor meer informatie.

Opmerking

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

  1. Selecteer vanaf de startpagina van Platform (www.diligentoneplatform.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.

Download het installatieprogramma en start de installatie

  1. Download het installatiepakket van de Robots-agent (RobotsAgent19.exe) vanaf de startpagina van Platform:

    1. Meld u aan bij Diligent One (www.diligentoneplatform.com).

    2. Selecteer in Launchpad onder Audit en analyses de tegel Analyses om toegang te krijgen tot downloads.

    3. Selecteer in het bovenste menu Robots-agent.

    4. Selecteer Versie 19 downloaden.

      Het installatiepakket wordt naar uw computer gedownload. Kopieer, indien nodig, het installatiepakket naar de server waarop u de Robots-agent wilt installeren.

  2. Sluit alle andere Windows-toepassingen.

  3. Dubbelklik op het installatiepakket.

  4. Als er een dialoogvenster met een beveiligingswaarschuwing verschijnt, controleert u de weergegeven informatie en selecteert u Ja.

    Tip

    Het beveiligingswaarschuwingsvenster kan verborgen zijn achter andere vensters die u hebt geopend.

  5. Selecteer de taal die u voor uw installatie wilt gebruiken en selecteer OK.

De installatiebestanden uitpakken

Geef op de pagina Installatiemap selecteren de map op waar de installatiebestanden worden uitgepakt en selecteer Uitpakken.

U kunt Bladeren selecteren om een map te selecteren of de standaardlocatie accepteren:

C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent19

De installatiebestanden worden uitgepakt in de door u opgegeven doelmap. Nadat de bestanden zijn uitgepakt, start het installatieprogramma automatisch.

Opmerking

Als het installatieprogramma om welke reden dan ook niet automatisch start, kunt u Windows Verkenner gebruiken om naar de map te navigeren waar de installatiebestanden zijn uitgepakt en dubbelklikken op setup.exe.

Vereisten installeren, indien nodig

Als u wordt gevraagd de vereiste software te installeren, selecteert u Installeren. Nadat de vereisten zijn geïnstalleerd, gaat het installatieprogramma automatisch verder.

Zie Systeemvereisten voor Robots Agent ter plaatse voor een lijst met vereisten.

Configureer de installatie-eigenschappen

  1. Op de pagina Welkom selecteert u Volgende.

  2. Selecteer op de pagina Licentieovereenkomst de optie Ik ga akkoord met de bovenstaande voorwaarden en selecteer Volgende.

  3. Op de pagina Selectie Robots Agent-editie selecteert u de gewenste editie en selecteert u vervolgens Volgende:

    • Niet-Unicode

    • Unicode

    Let op

    Zorg ervoor dat de editie die u installeert de juiste editie is voor uw bedrijf. Om Robots Agent-tabellen in Analytics te openen, moeten de edities overeenkomen.

    Als u een multi-agent cluster instelt, moeten alle agents in het cluster van dezelfde editie zijn. Alle niet-Unicode, of alle Unicode.

    Voor meer informatie, zie Diligent Unicode-producten.

  4. Laat op de pagina Machine learning inschakelen de optie Inschakelen geselecteerd, tenzij u een reden hebt om de Python-engine niet te installeren, en selecteert u Volgende.

    Opmerking

    Als u ervoor kiest de Python-engine niet te installeren en u deze later wilt gebruiken voor het uitvoeren van machineleeropdrachten, moet u de Robots Agent verwijderen en opnieuw installeren.

  5. Op de pagina Robots Agent Services Settings vult u de volgende serviceaccountinstellingen in en selecteert u vervolgens Volgende:

    • Poortnummer Robots-gegevensserviceSpecificeer een poort voor de gegevensservice of gebruik de standaardwaarde van 10000.

      U kunt elke beschikbare poort tussen 0 en 65536 opgeven.

    • Robots Agent-serviceaccountGeef een bestaand domeinaccount op om de Robots-agentservice uit te voeren en voer het wachtwoord in.

      Het account moet een domeinaccount zijn, gespecificeerd in de vorm Domain\service_account_name. Het account heeft toestemming nodig om services uit te voeren op het Windows Server-besturingssysteem en volledige toegang tot de gegevensmap die u tijdens de installatie opgeeft. Zie voor meer informatie Beveiliging van Robots Agent ter plaatse.

      Opmerking

      Indien nodig kunt u het serviceaccount van de Robots Agent na de installatie wijzigen.

  6. Als u wordt gevraagd om het recht Aanmelden als een service toe te kennen aan het serviceaccount van de Robots-agent, selecteert u Ja en vervolgens OK.

  7. Vul op de pagina Doelmappen de volgende bestemming- en verbindingsinstellingen in en selecteer vervolgens Volgende:

    • Doelmappen voor Robots Agent

      • Selecteer een doelmap voor de installatie van de Robots Agent, of gebruik de standaardlocatie.

        Standaard: C:\Program Files (x86)\ACL Software\Robots Agent\

      • Selecteer een locatie voor de gegevensmap of gebruik de standaardlocatie.

        Standaard: C:\acl\robots\

        Opmerking

        Plaats de gegevensmap niet in de installatiemap of andersom. Dit kan gegevensverlies veroorzaken bij het verwijderen van de Robots Agent.

    • Locatie van registratiebestand Robots Agent

      • Selecteer Registratiebestand kopiëren en blader vervolgens naar de locatie waar u het bestand registration.key hebt opgeslagen, of voer het bestandspad handmatig in.

        Wanneer het installatieprogramma wordt uitgevoerd, kopieert het automatisch het sleutelbestand naar de juiste locatie in de mapstructuur van de Robots Agent.

        Opmerking

        Laat Registratiebestand kopiëren uitgeschakeld en specificeer geen registratiebestand als u van plan bent het serviceaccount van de Robots Agent te wijzigen na de installatie van de Robots Agent.

De installatie voltooien

  1. Selecteer op de pagina Gereed om het programma te installeren de optie Installeren.

    Robots Agent is geïnstalleerd.

  2. Wanneer het installatieproces is voltooid, selecteert u Voltooien.

Controleer of de Robots Agent-service actief is

De service van de Robots Agent moet actief zijn om de Robots Agent verbinding te laten maken met de Robots-app. Zonder verbinding kan de Robots Agent geen robottaken en -scripts verwerken.

Desgewenst kunt u op hetzelfde moment dat u controleert of de Robots Agent-service actief is, ook het bijbehorende serviceaccount wijzigen.

Gebruik de Robots Agent-serviceaccount die u tijdens de installatie hebt opgegeven

  1. Open de Windows Services-manager.

  2. Controleer of beide Windows-services van Robots Agent actief zijn:

    • Robots-agent

    • Robots-gegevensservice

    Start indien nodig een of beide services.

    Opmerking

    Als er een foutmelding verschijnt die aangeeft dat de Robots Agent-service is opgestart en vervolgens weer gestopt, is de registratie van de Robots Agent mogelijk mislukt.

    Controleer of het registratiesleutelbestand (registration.key) aanwezig is in de installatiemap van de Robots-agent. Als het registratiesleutelbestand er niet is, kopieert u het sleutelbestand handmatig van de locatie waar u het hebt opgeslagen naar de installatiemap. Probeer opnieuw om de Robots Agent-service te starten.

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

  3. Controleer het logbestand van de toepassing om te bevestigen dat de Robots Agent succesvol verbonden is met de Robots-app.

    Ga naar het einde van het logbestand en zoek naar een INFO|Connected vermelding met een datum en tijd die overeenkomt met de start van de Robots Agent-service.

    De standaardlocatie van het logbestand is: C:\acl\robots\logs\application.log

  4. Ga in de Robots Agent-app naar het scherm Agentbeheer en druk op F5 om de pagina opnieuw te laden.

    Als de Robots Agent wordt weergegeven met de status Online, is deze succesvol geregistreerd.

De serviceaccount van de Robots Agent wijzigen

Volg deze stappen als u tijdens de installatie van de Robots Agent niet de optie Registratiebestand kopiëren hebt aangevinkt en het serviceaccount van de Robots Agent wilt aanpassen.

Handmatig het registratiesleutelbestand installeren

  1. Kopieer het registratiesleutelbestand (registration.key) van de locatie waar u het hebt opgeslagen.

  2. Navigeer naar de Robots Agent-installatiedirectory en plak het registratiesleutelbestand in de agent-submap.

    De standaardinstallatiemap is:  C:\Program File (x86)\ACL Software\Robots Agent\agent

    Verwijder of overschrijf indien nodig een bestaand sleutelbestand.

De Robots Agent-service wijzigen naar een ander account

  1. Open de Windows Services-manager.

  2. Klik met de rechtermuisknop op de Robots Agent-service en selecteer Eigenschappen.

  3. Selecteer op het tabblad Aanmelden de optie Bladeren.

  4. In het dialoogvenster Gebruiker selecteren voert u in het veld Objectnaam invoeren om te selecteren de naam van het serviceaccount in dat u wilt gebruiken en selecteert u Namen controleren.

    De serviceaccount moet vooraf zijn ingevuld in het veld.

  5. Selecteer OK.

  6. Op het tabblad Aanmelden voert u het wachtwoord voor het serviceaccount in, bevestigt u dit en selecteert u OK.

  7. In de Windows Services-beheerder, herstart (of start) de Robots Agent-service.

  8. Start de Robots Data Service indien nodig.

Bevestig dat de Robots Agent succesvol is geregistreerd

  1. Controleer het logbestand van de toepassing om te bevestigen dat de Robots Agent succesvol verbonden is met de Robots-app.

    Ga naar het einde van het logbestand en zoek naar een INFO|Connected vermelding met een datum en tijd die overeenkomt met de start van de Robots Agent-service.

    De standaardlocatie van het logbestand is: C:\acl\robots\logs\application.log

  2. Ga in de Robots Agent-app naar het scherm Agentbeheer en druk op F5 om de pagina opnieuw te laden.

    Als de Robots Agent wordt weergegeven met de status Online, is deze succesvol geregistreerd.

Robots Agent-instellingen configureren in de Robots-app

Werk indien van toepassing voor uw organisatie de standaardwaarden bij van de volgende twee configuratie-instellingen in de Robots-app:

  • Toegestane bestandsuploadsbepaalt of uitvoerresultaten worden geüpload van de Robots Agent naar de Robots-app in de cloud.

  • Configuratie van padenspecificeert de Windows-server- of netwerkdirectory's voor gegevenstabellen en resultatentabellen van Analytics

Raadpleeg voor meer informatie Een Robots Agent ter plaatse configureren.

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. Raadpleeg voor meer informatie Een Robots Agent ter plaatse configureren.

Een Analytics-project maken en het testbestand downloaden

  1. Maak een nieuw Analytics-project met de naam Robots Agent test.acl.

  2. Klik met de rechtermuisknop op de onderstaande link en sla het bestand op in dezelfde map als het project dat u zojuist hebt gemaakt:

    Robots_Agent_test_file.txt

Testscript kopiëren

  1. Maak in het Analytics-project een nieuw script met de naam Robots_Agent_test_script.

  2. Selecteer de onderstaande koppeling om het testscript in een browser te openen:

    Robots_Agent_test_script.txt

  3. Druk op Ctrl+A om het hele script te selecteren en op Ctrl+C om het naar het klembord te kopiëren.

  4. Plak het script in Robots_Agent_test_script en selecteer Het open project opslaan .

Leg het script vast in Robots en maak direct een robot

  1. Selecteer in het Analytics-hoofdmenu Bestand > Scripts toepassen.

  2. Indien nodig dubbelklikt u in het dialoogvenster Bestemming selecteren op de juiste Diligent One-instantie.

    De Robot-verzameling verschijnt met de lijst van bestaande robots, als die al bestaan. Een robot is een container voor scripts, gegevens en geautomatiseerde taken.

  3. Typ Robot testen in het veld Nieuwe robot en selecteer Maken.

    De robot wordt gemaakt en een robot-ID wordt automatisch gegenereerd.

  4. Voer in het dialoogvenster Scripts toepassen een toepassingsbericht in zoals 'Testscript uploaden' en selecteer vervolgens OK.

    Het script wordt vastgelegd in Robots en bevindt zich in de robot die u zojuist hebt gemaakt.

  5. Selecteer in het dialoogvenster Toepassen van scripts gelukt de tweede koppeling.

    ResultaatDe Robots-app wordt geopend in een browservenster, met het tabblad Scriptversies geselecteerd. U moet zich mogelijk aanmelden bij Diligent One. U zou de scriptversie moeten zien die u zojuist hebt toegepast.

  6. Selecteer in Analytics OK om het dialoogvenster Toepassen van scripts gelukt te sluiten.

Het testbestand uploaden

  1. Selecteer in Robots het tabblad Invoer/Uitvoer.

  2. Selecteer kiezen vanaf uw computer en blader naar de locatie waar u Robots_Agent_test_file.txt hebt opgeslagen.

  3. Selecteer het bestand en selecteer Openen.

    ResultaatHet bestand is geüpload en verschijnt onder Bestanden in het tabblad Invoer/Uitvoer.

Een taak maken en het testscript uitvoeren

  1. Selecteer het tabblad Taken en klik op Taak maken.

  2. Typ de naam Testtaak in voor de taak en selecteer Opslaan.

  3. Selecteer Robots Agent-testscript en selecteer Naar einde > Bevestigen en taak maken.

  4. Selecteer op het tabblad Taken in Testtaak de optie > Nu uitvoeren.

    ResultaatDe taak met het testscript wordt uitgevoerd.

    Als de taak wordt voltooid met de status Geslaagd, werkt de Robots Agent ter plaatse die u hebt geïnstalleerd correct.

    Opmerking

    Als de taak mislukt, controleer dan of de Robots Agent-service actief is op de server waarop u de Robots Agent hebt geïnstalleerd. Start de service als deze niet actief is en probeer Testtaak opnieuw uit te voeren.

    Als de taak blijft mislukken, neem dan contact op met Diligent Support voor hulp.

Het scriptresultaat verifiëren

Controleer de volgende locaties in Robots om te verzekeren dat het testscript de juiste bestanden heeft uitgevoerd.

Locatie in RobotsBestanden uitgevoerd door testscript

Tabblad Taakuitvoeringen

Selecteer de Testtaak-vermelding.

In het Taakuitvoeringsdetails-zijpaneel, onder Uitvoer:

  • Table_metadata Analytics-resultatentabel

  • Robots Agent test script.log Analytics-logbestand

Tabblad Invoer/Uitvoer-tabblad

Selecteer de invoer Robots_Agent_test_file.

In de sectie Overige tabellen:

  • Robots_Agent_test_file Analytics-gegevenstabel

Selecteer Robots_Agent_test_file. In het Tabeldetails-zijpaneel, onder Velden:

U ziet Naam-, Type- en Grootte-informatie (lengte) voor drie velden:

  • Character_field

  • Numeric_field

  • Datetime_field

De Robots Agent upgraden

Gebruik het installatiepakket van de Robots-agent om een bestaande installatie van de Robots-agent te upgraden naar versie 19.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.

De Robots Agent Windows-services stoppen

  1. Open de Windows Services-beheerder op de Windows-server waarop de Robots Agent is geïnstalleerd.

  2. Stop beide Robots Agent Windows-services:

    • Robots-agent

    • Robots-gegevensservice

Download het installatieprogramma en start de upgrade

  1. Download het installatiepakket van de Robots-agent (RobotsAgent19.exe) vanaf de startpagina van Platform:

    1. Meld u aan bij Diligent One (www.diligentoneplatform.com).

    2. Selecteer in Launchpad onder Audit en analyses de tegel Analyses om toegang te krijgen tot downloads.

    3. Selecteer in het bovenste menu Robots-agent.

    4. Selecteer Versie 19 downloaden.

      Het installatiepakket wordt naar uw computer gedownload. Kopieer, indien nodig, het installatiepakket naar de server waarop u de Robots-agent wilt upgraden.

  2. Sluit alle andere Windows-toepassingen.

  3. Dubbelklik op het installatiepakket.

  4. Als er een dialoogvenster met een beveiligingswaarschuwing verschijnt, controleert u de weergegeven informatie en selecteert u Ja.

    Tip

    Het beveiligingswaarschuwingsvenster kan verborgen zijn achter andere vensters die u hebt geopend.

  5. Selecteer de taal die u voor uw installatie wilt gebruiken en selecteer OK.

Pak de installatiebestanden uit en bevestig de upgrade

  1. Geef op de pagina Installatiemap selecteren de map op waar de installatiebestanden worden uitgepakt en selecteer Uitpakken.

    U kunt Bladeren selecteren om een map te selecteren of de standaardlocatie accepteren:

    C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent19

    De installatiebestanden worden uitgepakt in de door u opgegeven doelmap. Nadat de bestanden zijn uitgepakt, start het installatieprogramma automatisch.

    Opmerking

    Als het installatieprogramma om welke reden dan ook niet automatisch start, kunt u Windows Verkenner gebruiken om naar de map te navigeren waar de installatiebestanden zijn uitgepakt en dubbelklikken op setup.exe.

  2. Selecteer Ja in de upgrade-prompt.

  3. Selecteer in het dialoogvenster Robots Agent Installer Information alleen op OK als u aan de vermelde vereisten hebt voldaan.

    Als u nog niet aan de vereisten hebt voldaan, doe dit dan nu voordat u verdergaat met de upgrade. Schakel indien nodig alle geplande robottaken tijdelijk uit.

Vereisten installeren, indien nodig

Als u wordt gevraagd de vereiste software te installeren, selecteert u Installeren. Nadat de vereisten zijn geïnstalleerd, gaat het installatieprogramma automatisch verder.

Zie Systeemvereisten voor Robots Agent ter plaatse voor een lijst met vereisten.

Configureer de installatie-eigenschappen

  1. Op de pagina Welkom selecteert u Volgende.

  2. Selecteer op de pagina Licentieovereenkomst de optie Ik ga akkoord met de bovenstaande voorwaarden en selecteer Volgende.

  3. Selecteer op de pagina Robots Agent Edition Selection de optie Volgende.

    Het installatieprogramma handhaaft de editie van de Robots Agent die u momenteel hebt geïnstalleerd (niet-Unicode of Unicode).

    Opmerking

    U kunt de editie niet wijzigen tijdens een upgrade. Om de editie te wijzigen, moet u de huidige versie van de Robots-agent verwijderen en vervolgens versie 19.0 installeren.

  4. Laat op de pagina Machine learning inschakelen de optie Inschakelen geselecteerd, tenzij u een reden hebt om de Python-engine niet te installeren, en selecteert u Volgende.

    Opmerking

    Als u ervoor kiest de Python-engine niet te installeren en u deze later wilt gebruiken voor het uitvoeren van machineleeropdrachten, moet u de Robots Agent verwijderen en opnieuw installeren.

  5. Op de pagina Robots Agent Services Settings vult u de volgende serviceaccountinstellingen in en selecteert u vervolgens Volgende:

    • Poortnummer Robots-gegevensserviceBehoud het bestaande poortnummer dat voor de gegevensservice is opgegeven of geef een ander poortnummer op.

      U kunt elke beschikbare poort tussen 0 en 65536 opgeven.

    • Robots Agent-serviceaccountBehoud het bestaande domeinaccount dat de Robots Agent-service uitvoert, of geef een ander account op. Geef het wachtwoord voor het account op.

      Het account moet een domeinaccount zijn, gespecificeerd in de vorm Domain\service_account_name. Voor het account zijn rechten vereist om services uit te voeren op het Windows Server-besturingssysteem en volledige toegang te krijgen tot de map met bestaande gegevens van de Robots Agent. Zie voor meer informatie Beveiliging van Robots Agent ter plaatse.

      Opmerking

      Als u het serviceaccount van de Robots Agent moet wijzigen, is het beter om dit na de upgrade te doen.

      Als u tijdens de upgrade het account in het installatieprogramma wijzigt, moet u de Robots Agent opnieuw registreren. Het opnieuw registreren van een geïnstalleerde agent kan mogelijk de configuratie van de Robots-instantie van uw organisatie verstoren.

      Zie Het wijzigen van het serviceaccount voor de Robots Agent voor meer informatie.

  6. Bekijk de configuratie-informatie op het volgende scherm en selecteer Volgende.

Upgrade voltooien

  1. Selecteer op de pagina Gereed om het programma te installeren de optie Installeren.

    Robots Agent is geüpgraded.

  2. Wanneer het upgradeproces is voltooid, selecteert u Voltooien.

  3. Selecteer Ja om de server opnieuw op te starten en de upgrade te voltooien.

  4. Controleer in de Windows Services-beheerder of beide Windows-services van Robots-agent worden uitgevoerd:

    • Robots-agent

    • Robots-gegevensservice

    Start indien nodig een of beide services.

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.

Belangrijk

Het installeren van meerdere agents vereist dat alle agents versie 15 of hoger zijn, en dat ze allemaal dezelfde codering gebruiken: allemaal niet-Unicode, of allemaal Unicode.

Alle agents moeten ook toegang hebben tot de map of mappen die u opgeeft voor scriptuitvoertabellen in het scherm Agentbeheer. Voor elke gespecificeerde map moet het serviceaccount dat de agent uitvoert over lees-, schrijf- en lijstmachtigingen beschikken. Raadpleeg voor meer informatie Een Robots Agent ter plaatse configureren.

Opmerking

U moet lokale beheerdersrechten hebben op elke Windows-server waarop u de Robots Agent installeert.

Deze instructies hebben betrekking op Server #1 en Server #2:

  • Server #1De Windows-server waarop u de eerste instantie van de Robots Agent heeft geïnstalleerd

  • Server #2Een extra Windows-server waarop u een extra instantie van de Robots Agent installeert

    Opmerking

    U kunt dit proces herhalen voor zoveel extra agents en servers als u nodig hebt.

Installeer de Robots Agent op Server #2

  1. Voer op Server #2 hetzelfde installatieproces uit dat u hebt gebruikt om de Robots Agent op Server #1 te installeren.

  2. In het installatieprogramma, op de pagina Doelmappen, schakelt u de optie Registratiebestand kopiëren uit en laat u het veld Locatie van het registratiebestand van Robots Agent leeg.

Zie voor de installatiestappen.

Haal de RSA-sleutelnaam op uit de Robots Agent-app

  1. Selecteer vanaf de startpagina van Platform (www.diligentoneplatform.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. Selecteer Extra agents toevoegen.

  5. Selecteer om de RSA-sleutelnaam naar het klembord te kopiëren.

  6. Plak de RSA-sleutelnaam in een tekstbestand voor tijdelijke opslag.

Verzamel de Robots Agent RSA-sleutel in een bestand

Gebruik het hulpprogramma EncryptionKeyCLI.exe op Server #1 om de RSA-sleutel van de Robots Agent in een bestand te bundelen.

Opmerking

Als u al een extra Robots Agent hebt geïnstalleerd en een zip-bestand met de RSA-sleutel hebt aangemaakt, kunt u het bestaande bestand gebruiken. U hoeft geen nieuwe kopie te maken.

  1. Open op Server #1 de Windows-opdrachtprompt als beheerder.

  2. Voer de volgende opdracht uit om naar de installatiemap van Robots Agent te gaan:

    cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

    Geef het juiste pad op als u de Robots Agent niet in de standaardmap hebt geïnstalleerd.

  3. Voer de volgende opdracht uit om de Robots Agent RSA-sleutel in een zipbestand te bundelen:

    EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX

    Vervang ACL_XXXXXXXX door de werkelijke RSA-sleutelnaam die u hebt gekopieerd van het scherm Agentbeheer in Robots.

    RSAKeyfile kan elke bestandsnaam zijn, zonder spaties, die u wilt specificeren. U kunt desgewenst een bestandspad naar een bestaande map op de server opgeven. Als het pad spaties bevat, plaats dan het volledige pad en de bestandsnaam tussen dubbele aanhalingstekens.

  4. Voer indien nodig Y in om een bestaand bestand te overschrijven.

    ResultaatDe RSA-sleutel is gebundeld in een zip-bestand en opgeslagen op de standaardlocatie (C:\ProgramData\robots\RSAKeyfile.zip) of op de locatie die u hebt opgegeven.

    Opmerking

    Als u de map ProgramData niet ziet, is deze mogelijk verborgen. Om de map zichtbaar te maken, selecteert u in Windows Verkenner Verborgen items in de hoofdmap C:\ (tabblad Weergave > Verborgen items).

Het RSA-sleutelbestand migreren naar Server #2

Gebruik het hulpprogramma EncryptionKeyCLI.exe op Server #2 om de RSA-sleutel van de Robots Agent uit het zip-bestand te extraheren en deze in de Microsoft-sleutelopslag te importeren.

  1. Kopieer RSAKeyfile.zip van Server #1 naar de installatiemap van de Robots Agent op Server #2.

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

  2. Open op Server #2 de Windows-opdrachtprompt als beheerder.

  3. Voer de volgende opdracht uit om naar de installatiemap van Robots Agent te gaan:

    cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

    Geef het juiste pad op als u de Robots Agent niet in de standaardmap hebt geïnstalleerd.

  4. Voer de volgende opdracht uit om de Robots Agent RSA-sleutel uit het zipbestand te extraheren en te importeren in de Microsoft-sleutelopslag op Server #2:

    EncryptionKeyCLI.exe import RSAKeyfile

    Als u RSAKeyfile niet als naam voor het zipbestand hebt gebruikt, vervangt u dit door de naam die u wel hebt gebruikt.

Kopieer het registratiesleutelbestand naar Server #2

Kopieer het registratiesleutelbestand (registration.key) van de Robots Agent-installatiedirectory op Server #1 naar de Robots Agent-installatiedirectory op Server #2.

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

Start de Robots Agent-service opnieuw op Server #2

Open op Server #2 de Windows Services-beheerder en start de Robots Agent-service opnieuw (of start deze).

Controleer of de extra agent succesvol is geregistreerd

Ga in de Robots Agent-app naar het scherm Agentbeheer en druk op F5 om de pagina opnieuw te laden. Als de extra Robots Agent in de lijst verschijnt met de status Online, is deze succesvol geregistreerd. De agent maakt nu deel uit van de agentcluster die wordt gebruikt voor analytische verwerking en taakverdeling.