Een Robots Agent ter plaatse configureren

De standaardconfiguratie van de Robots Agent wordt ingesteld tijdens de installatie. Voordat u de Robots Agent gebruikt, dient u de configuratie-instellingen te controleren en ervoor te zorgen dat deze geschikt zijn voor uw organisatie. Zorg er in het bijzonder voor dat Toegestane bestandsuploads op de juiste manier is ingesteld.

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.

Waar configuratie-instellingen opgeven

U specificeert de configuratie-instellingen van Robots Agent op twee locaties:

  • het Agentbeheer-scherm in Robots

  • het Agent.exe.config-bestand in de installatiemap van de Robots Agent op de Windows-server

Configureer instellingen in het scherm voor Agent-beheer

Opmerking

Configuratie-instellingen in het scherm Agentbeheer zijn van toepassing op alle agents in een multi-agent cluster.

  1. Selecteer vanaf de startpagina van Launchpad (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 onder Configuratie de juiste optie voor Toegestane bestandsuploads.

    Toegestane bestandsuploads bepaalt of uitvoerresultaten worden geüpload van de Robots Agent naar de Robots-app in de cloud

    • Alleen resultaatbestanden en logboekbestanden

      Indien gespecificeerd in een analysekop, worden resultaatbestanden (zoals Excel) en logboeken geüpload. U kunt gerelateerde bestanden ook handmatig uploaden naar het tabblad Invoer/uitvoer voor robots.

    • Resultaattabellen, bestanden en logboeken

      Indien gespecificeerd in een analysekop, worden Analytics-resultaattabellen, resultaatbestanden (zoals Excel) en logboeken geüpload. U kunt gerelateerde bestanden ook handmatig uploaden naar het tabblad Invoer/uitvoer voor robots.

    • Bestandsuploads zijn niet toegestaan

      Er kunnen geen bestanden worden geüpload door scripts of handmatig door gebruikers. Analytische scripts met //RESULT FILE- of //RESULT LOG-tags worden niet uitgevoerd.

      Om te voorkomen dat bestanden worden geüpload, moet u in elke situatie ook de configuratie-instelling AllowUploadsOnFailure in de Robots Agent instellen op false.

    Opmerking

    Ongeacht welke optie u selecteert in Toegestane bestandsuploads, wordt het uploaden van een logbestand na een mislukte robottaak geregeld door de configuratie-instelling AllowUploadsOnFailure in de Robots Agent. Zie voor meer informatie.

  5. Geef onder Configuratie de juiste mappen op bij Padenconfiguratie en klik vervolgens op Opslaan.

    • Gegevensopslag

      De Windows-server of netwerkdirectory voor permanente opslag van Analytics-gegevenstabellen die worden uitgevoerd door analytische scripts met een //DATA-tag.

      Een aparte directory voor gegevenstabellen stelt u in staat een meer economische, koude opslaglocatie op te geven voor grote bestanden die slechts periodiek worden geraadpleegd.

    • Resultatenpad

      De Windows-server of netwerkdirectory voor Analytics-resultaattabellen die worden uitgevoerd door analytische scripts met een //RESULT TABLE tag.-tag.

    Belangrijk

    De map of mappen die u opgeeft onder Configuratie moeten toegankelijk zijn voor de Robots Agent, of voor alle agents als u een multi-agent cluster gebruikt. Voor elke gespecificeerde map moet het serviceaccount dat de agent uitvoert over lees-, schrijf- en lijstmachtigingen beschikken. Zie voor meer informatie Beveiliging van Robots Agent ter plaatse.

Configureer instellingen in het Agent.exe.config-bestand

Om configuratie-instellingen bij te werken, bewerkt u het bestand Agent.exe.config in de installatiemap van de Robots Agent en start u vervolgens de Robots Agent Windows-service opnieuw op.

De standaardlocatie van het configuratiebestand is:

C:\Program Files (x86)\ACL Software\Robots Agent\agent\Agent.exe.config.

Opmerking

U moet de Robots Agent-service opnieuw starten om eventuele wijzigingen van kracht te laten worden.

Voor installaties met meerdere agents moet u het bestand Agent.exe.config bijwerken en de service Robots Agent opnieuw opstarten op elke Windows-server. De configuratie-instellingen voor elke agent kunnen identiek zijn of verschillen, afhankelijk van uw specifieke behoeften.

Configuratie-eigenschappen in Agent.exe.config

SleutelWaarde
RuntimeBasePath

De basismap voor:

  • tijdelijke analysetaakmappen

  • niet-Analytics-resultaatbestanden die worden uitgevoerd door analysescripts met een //RESULT FILE-tag

  • Analytics-logbestanden uitgevoerd door analytische scripts met een //RESULT LOG-tag

  • Analytics-logbestanden uitgevoerd door mislukte analysescripts

De standaardbasismap is C:\acl\robots\data\

Een aparte uitvoeringsmap voor runtime stelt u in staat om de verwerking van analytische taken te plaatsen op een sneller apparaat met hoge prestaties, zoals een solid state drive (SSD).

Voorbeeld van een volledig pad naar een analytische opdrachtmap met een door de gebruiker geconfigureerde basismap: E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp

DataBasePath

De basismap voor permanente opslag van Analytics-gegevenstabellen die worden uitgevoerd door analytische scripts met een //DATA-tag.

De standaardbasismap is C:\acl\robots\data\

Een aparte basismap voor Analytics-gegevenstabellen stelt u in staat een zuinigere opslaglocatie voor koude opslag te specificeren voor grote bestanden die slechts periodiek worden geraadpleegd.

Voorbeeld van een volledig pad naar een map met gegevensbestanden met een door de gebruiker geconfigureerde basismap: D:\acl\robots\data\Production\Robot12\Data

Opmerking

Als de instellingen DataBasePath en Data Storage in het scherm Agentbeheer in Robots verschillende waarden opgeven, heeft de waarde in het scherm Agentbeheer voorrang.

Zie voor meer informatie.

ResultsBasePath

De basismap voor Analytics-resultaattabellen die door analytische scripts met een //RESULT TABLE-tag worden gegenereerd.

De standaardbasismap is C:\acl\robots\data\

Voorbeeld van een volledig pad naar een map met resultaten met een door de gebruiker geconfigureerde basismap: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions

Opmerking

Als de instellingen ResultsBasePath en Resultatenpad in het scherm Agentbeheer in Robots verschillende waarden opgeven, heeft de waarde in het scherm Agentbeheer voorrang.

Zie voor meer informatie.

AclSEProfileBase

De basismap voor het werken met tabellen bij het verbinden vanuit Analytics met de Robots Agent via de Robots Data Service.

De standaardbasismap is C:\acl\robots\aclse\

LogFile

Het bestandspad en de naam van het logbestand van de Robots Agent.

Het standaardpad en de standaardnaam zijn C:\acl\robots\logs\application.log

EnginePath

Het bestandspad van het uitvoerbare bestand dat taken uitvoert.

De standaardlocatie is C:\Program Files (x86)\ACL Software\Robots Agent\AclScript.exe

KeepJobFolder

Specificeert of de tijdelijke analysetaakmap wordt behouden wanneer een robottaak mislukt.

  • waarde tijdelijke map voor de analysetaak wordt behouden na een mislukte taak

  • niet waarde tijdelijke map voor de analysetaak wordt verwijderd na het mislukken van de taak

    De standaardwaarde is onwaar.

Opmerking

De instelling KeepJobFolder heeft geen effect wanneer een robottaak succesvol is. Na succesvolle uitvoering van een taak wordt de tijdelijke map voor de analysetaak automatisch verwijderd.

Let op

U kunt de waarde instellen op waar om bestanden te behouden voor het oplossen van problemen. Het permanent op waar laten staan van de waarde kan ertoe leiden dat de harde schijf van de server, of een solid state drive, vol raakt.

AllowExecuteCommand

Hiermee geeft u op hoe de Robots Agent twee ACLScript-opdrachten, EXECUTE en AICOMMAND, verwerkt wanneer deze in een analytisch script voorkomen.

  • waarde opdrachten worden verwerkt

  • niet waarde opdrachten worden niet verwerkt en een script met een van beide opdrachten mislukt

    De standaardwaarde is onwaar.

    Er wordt een bericht in het logboek geschreven waarin de reden voor de mislukking wordt uitgelegd.

MaxLogSizeKB

De maximale grootte van het logbestand van de Robots Agent voordat het bestand wordt gearchiveerd en er een nieuw logbestand wordt gemaakt.

De standaardwaarde is 102400 (100 MB).

Het huidige logbestand is application.log. Gearchiveerde logbestanden worden opgeslagen in dezelfde map als het huidige logbestand en krijgen een oplopend numeriek achtervoegsel: application.0.log, application.1.log, etc.

SkipPathAccessCheck

Bepaalt welke mappen de Robots Agent kan openen bij het lezen of schrijven van tabellen of bestanden.

  • waarEr wordt niet gecontroleerd op maptoegang. Scripts die door de Robots Agent worden uitgevoerd, kunnen tabellen of bestanden in elke ACL-robot lezen of schrijven.

  • niet waarMaptoegang wordt gecontroleerd. Scripts die door de Robots Agent worden uitgevoerd, kunnen alleen tabellen of bestanden in dezelfde robot als het script lezen of schrijven.

    De standaardwaarde is onwaar.

Het instellen van de waarde op waar en het overslaan van de controle op toegang tot de map kan in bepaalde omgevingen de prestaties van de Robots Agent bij het uitvoeren van scripts verbeteren. U hebt ook de mogelijkheid om lees- of schrijfbewerkingen uit te voeren voor meerdere robots.

Let op

Het beperken van de toegang van een script tot bepaalde mappen is een beveiligingsfunctie van Robots die onbedoelde of opzettelijke schendingen van gegevenstoegang voorkomt. Stel de waarde alleen in op waar als u er zeker van bent dat het toestaan van ACL-scripts om tabellen of bestanden in een ACL-robot te lezen of te schrijven geen beveiligingsrisico vormt.

Opmerking

De SkipPathAccessCheck-instelling heeft geen invloed op de mogelijkheid om specifieke Analytics-gegevenstabellen tussen robots te delen en te koppelen. Raadpleeg Gegevenstabellen delen en koppelen in ACL-robots voor meer informatie.

AllowUploadsOnFailure

Als een robottaak mislukt, wordt aangegeven of een Analytics-resultatenlogboek wordt geüpload van de Robots-agent naar de Robots-app in de cloud.

  • waarer wordt een logbestand geüpload nadat de taak is mislukt

  • niet waarer wordt geen logbestand geüpload nadat de taak is mislukt

    De standaardwaarde is waar.

Opmerking

Als de eigenschap AllowUploadsOnFailure niet aanwezig is in het Agent.exe.config-bestand, voegt u dit handmatig toe en stelt u de waarde in op waar of niet waar, afhankelijk van de voorwaarden van uw organisatie.

Bijvoorbeeld:

<add key="AllowUploadsOnFailure" value="true"> </add>

Configureer de Robots Agent om met een specifieke proxyserver te werken

U kunt de Robots Agent handmatig configureren om via een door u aangewezen proxyserver verbinding te maken met de Robots-app. Voer de volgende stappen uit om de configuratie handmatig in te stellen:

  • Voeg een extra gedeelte toe aan het bestand Agent.exe.config

  • Werk twee aanvullende configuratiebestanden bij, AgentService.exe.config en Worker.exe.config

Stappen

  1. Ga op de server waarop de Robots Agent is geïnstalleerd naar de installatiemap van de Robots Agent.

    De standaardlocatie van de installatiemap is:

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

  2. Raadpleeg de onderstaande tabel om de configuratiebestanden in de submap \agent bij te werken.

  3. Nadat u alle bestanden hebt opgeslagen, start u de Robots Agent Windows-service opnieuw op om de communicatie tussen de Robots Agent en de Robots-app via uw aangewezen proxyserver te beginnen.

Opmerking

Verschillende configuratie-instellingen voor proxyservers zijn mogelijk. Het onderstaande configuratievoorbeeld komt mogelijk niet exact overeen met uw vereisten. Raadpleeg voor meer informatie de technische documentatie van Microsoft:

BestandsnaamConfiguratiegegevens
Agent.exe.config

Werk dit bestand bij door het gedeelte <system.net> toe te voegen op de locatie die in het voorbeeld wordt getoond.

  • Vervang het juiste proxy-serveradres en de juiste poort voor uw organisatie.

  • useDefaultCredentials="true" geeft aan dat de inloggegevens voor het account dat de Robots Agent Windows-service uitvoert, worden gebruikt om toegang te krijgen tot de proxyserver.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

In beide bestanden dient u het <defaultProxy>-gedeelte aan te passen volgens het onderstaande voorbeeld.

  • Vervang het juiste proxy-serveradres en de juiste poort voor uw organisatie.

  • useDefaultCredentials="true" geeft aan dat de inloggegevens voor het account dat de Robots Agent Windows-service uitvoert, worden gebruikt om toegang te krijgen tot de proxyserver.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>