Install Robotic Services on target machines

ASG-Zenith Portal provides the ability to execute two types of bot: unattended and attended. You must install the Robotic Services components on every target machine using the specific installer provided for the type of bot that you want to execute on that machine.

Verify prerequisites

Operating system requirements

ASG-Zenith Robotic Services currently supports only the English version of the following operating systems:

  • Microsoft Windows 10 or higher
  • Microsoft Windows Server 2012 or higher

Hardware requirements

Your machine must meet the following minimum hardware requirements:

  • CPU: Dual Processor 2.0 GHz (Quad Core Processor 2.0 GHz recommended)
  • RAM: 16 GB
  • Hard drive space: 2 GB

Web browser requirements

Robotic Services components requires Chrome Driver, which is installed automatically by the installation file under the path C:\Program Files (x86)\ASG RPA BotEngine\Resources. Chrome Driver uses the same version number scheme as Chrome. Each version of Chrome Driver supports Chrome with matching major, minor, and build version numbers. For example, Chrome Driver 73.0.3683.20 supports all Chrome versions that start with 73.0.3683.

The current version of Robotic Services includes Chrome Driver version 85.0.4183. That means you should also upgrade your Chrome to version 85.0.4183.

If you want to use a different version of Chrome, ensure that you replace the chromedriver.exe file under the path C:\Program Files (x86)\ASG RPA BotEngine\Resources with the matching Chrome Driver version. Various versions of Chrome Driver are currently available for download at https://chromedriver.chromium.org/downloads.

Install

Follow these steps to install the Robotic Services components on every computer where you want to execute attended or unattended bots:

  1. Download the installation file (ASG_RPA_BotEngine_versionNumber_Unattended.exe for unattended bot execution, and ASG_RPA_BotEngine_versionNumber_Attended.exe for attended bot execution).
  2. Run the installer as administrator and accept the license agreement.
  3. Review the prerequisites and click Next. The following prerequisites will be installed if not already installed:
    • Microsoft Access Database Engine 2010 Redistributable
    • Microsoft .Net Framework 4.8 Runtime
    • Microsoft .Net Core SDK 3.1.101

    Then the following Robotic Services components will be installed:

    Component

    		Desktop shortcutUnattendedAttended
    ASG RPA Bot EngineRPABotEngine
    Vault ServiceASG.VaultService
    OCR ServiceASG.OCRService
    Zenith Certificate UtilityZenithCert.Utility
    Bot Execution Dashboardrpa-dashboard
    Recorder ServiceAsg.Recorder.Service
  4. Navigate to C:\Program Files (x86)\ASG RPA BotEngine and open the RPABotEngine.dll.config file. Then, locate the following line and replace localhost with the IP address of the server where ASG-Zenith Portal is running:

    <add key="BaseUrl" value="http://localhost:8521" />

  5. For unattended mode only: In the RPABotEngine.dll.config file, locate the following lines and replace localhost with the IP address of the server where ASG-Zenith Portal is running:

    <add key= "VaultServiceUrl" value="http://localhost:5001" />

    <add key= "VaultUrl" value="http://localhost:5001/api/vault" />

    <add key="NewOcrServiceBaseURL" value="http://localhost:5004/api" />

    <add key="OcrServiceUrl" value="http://localhost:5004/api/"/>

  6. Run RPABotEngine as administrator. You must always keep this tool running in the machine.
    The RPA Bot Engine runs in administrator mode only. If there are multiple administrator users on the computer, the user who started the RPA Bot Engine is considered as the administrator.

    If you want to stop the RPA Bot Engine, right click the system tray icon and click Exit.

  7. For attended mode only: Run ASG.VaultService and ASG.OCRService as administrator. You must always keep the terminal windows of these services open.

    If you want to stop any of these services, go to the respective terminal window and press Ctrl + C.

  8. Run ZenithCert.Utility as administrator and press Y to confirm all prompts in the terminal window. The SSL certificate named Zenith Self Signed CA will be installed on the computer.
  9. Run Asg.Recorder.Service as administrator. You must always keep the terminal window of this service open.

    If you want to stop this service, go to the terminal window and press Ctrl + C.