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

Opmerking

Configuratie-instellingen in het Agentbeheer-scherm hebben voorrang op instellingen in het Agent.exe.config-bestand.

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.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. 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 van welke aard dan ook worden geüpload door scripts of handmatig door gebruikers. Analysescripts met //RESULT FILE- of //RESULT LOG-tags worden niet uitgevoerd.

  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

      Windows-server of netwerkdirectory voor Analytics-resultaattabellen die worden uitgevoerd door analytische scripts met een //RESULT TABLE-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. Voor meer informatie raadpleegt u 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

Sleutel Waarde
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 standaard basismap 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 taakmap 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 standaard basismap 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 gegevensbestandenmap met een door de gebruiker geconfigureerde basismap: D:\acl\robots\data\Production\Robot12\Data

Opmerking

De waarde DataBasePath wordt niet gebruikt als er een andere waarde wordt weergegeven in de configuratie-instelling Gegevensopslag in het scherm Agentbeheer in Robots.

Voor meer informatie raadpleegt u Configureer instellingen in het scherm voor Agent-beheer.
ResultsBasePath

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

De standaard basismap is C:\acl\robots\data\

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

Opmerking

De ResultsBasePath-waarde wordt niet gebruikt als er een andere waarde verschijnt in de instelling Resultatenpad in het scherm Agentbeheer in Robots.

Voor meer informatie raadpleegt u Configureer instellingen in het scherm voor Agent-beheer.
AclSEProfileBase

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

De standaard basismap is C:\acl\robots\aclse\
LogFile

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

Het standaardpad en de standaardnaam is 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.

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

  • onwaar de 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

Specificeert hoe de Robots Agent de EXECUTE-opdracht afhandelt wanneer deze in een analysescript wordt aangetroffen:

  • waar de opdracht EXECUTE wordt verwerkt

  • onwaar de opdracht EXECUTE wordt niet verwerkt en het script dat de opdracht bevat, 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, enzovoort.
SkipPathAccessCheck

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

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

  • onwaar Maptoegang 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. Voor meer informatie raadpleegt u Gegevenstabellen delen en koppelen in ACL-robots.

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 sectie 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:

Bestandsnaam Configuratiegegevens
Agent.exe.config

Werk dit bestand bij door de sectie <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>