Table of Contents

Check if your tenant has active licences

Before installation of unattended robot check if your tenant has active licences.
To do that go to see how many licences your tenant have and how many of them are available in About dialog.

  1. Log to your tenants HQ.
  2. Click on the user icon in right corner.
  3. From dropdown menu choose „About“.
  4. The dialog with licence number should show up.

Unattended Robot Installation

  1. Install FTP client (FileZila – https://filezilla-project.org/)
  2. After installation is done, start FTP client and enter following credentials and press Quickconnect:
    – Host: u260112.your-storagebox.de
    – Username: u260112-sub3
    – Password: MSZnxJLfqmkPlFBw
  3. In popup window click OK.
  4. Find file number – please choose latest from the list (currently at the picture it is 2896)
  5. Right click on file (latest version) enables download (it takes cca. 4 to 5 minutes). Remember destination path where files will be saved (marked red).
  6. After installation is done, go to destination path from step 5. Find folder with the number latest -> Setup -> en-us -> RecorderRobotSetup.msi (double click) and it opens the Wizard
  7. Start RecorderRobotSetup.msi Wizard by clicking the “Next” button.
  8. Accept the terms in the “End-User Licence Agreement“ and press Next.
  9. Choose installation folder and press Next.
  10. Choose “Unattended Robot” option and press Next.
  11. Click Next. In new dialog fields “HQ Server” and “Rabbit MQ Hostname” will be automatically filled.
  12. To get Tenant ID go to HQ Settings -> Tenant.

    Hover on icon to show Tenant ID and click on it to clipboard copy.
  13. To get Robot ID, robot registration is required. Go to HQ Settings -> Robots

    Click “Add robot”:

    In dialog box “Robot name” enter the name of the robot by your choice but make sure that it is only one word for the “RobotName” without white spaces. Also, robot name should be new, not the same as the previous one. Than choose “Generate certificate“ option “Yes”. Choose number of licenses and their type and press Save.
  14. After successful Robot registration, in few minutes an e-mail will arrive to user mailbox with further steps. Robot client certificate is marked with red box.
  15. Search robot by previously written “Robot name” in search field. Click on icon marked red and download certificate for “Robot name” which has the extension .p12
  16. To get Robot ID you need to click on “+“ in the ID column.
    Robot ID will be saved to Clipboard. You need to paste that Robot ID saved in Clipboard to Robot ID field:

    For Robot Username type username for connecting to that virtual machine. Press Next button and dialog will open.

    • In field “RMQ MTLS Server Root certificate path” you should upload “cawithroot.crt” file by pressing “Browse” button marked red in picture 14. The file is in setup folder.
    • In field “RMQ MTLS Server certificate path” you should upload “cac.crt” file by pressing “Browse” button marked blue in picture 14. The file is in setup folder.
    • Press Browse button for “Client certificate path” and Browse Dialog will pop up.
      Choose previously downloaded certificate for “Robot name” with extension .p12.
      This file is usually downloaded in your Downloads.During robot installation you already received e-mail with password as shown below:

      That password needs to be entered in below field “Password”.

      and press Next.
  17. Dialog will be opened:

    Press Install button.
  18. After successful installation, the robot has status “Waiting for login credentials”. In this step press “CHANGE” to enter robot credentials. After pressing “Save credentials” button the robot will change its status to “Active”.
    The password provided by the user is encrypted locally (in browser) using Public Key generated on robot machine, so robot passwords stored in database are not human readable.
    Field Username will be automatically filled with username you have provided in step 16.
  19. Please note that before scheduling jobs to robot, assigning “Dedicated resources” is needed:
  20. When you enter process editor, if something went wrong during the installation, you will notice red triangle.

    By clicking on it, the dialog will show up. You should provide the data from Handler Monitoring tool. It is an app that is up and running right after login to the machine.

  21. Please make sure that everything is working properly. In case if you encounter some issues, check log (procedure for checking the log is at the end of this Instruction). If in log you encounter this error:
    Exception details are:RabbitMQ.Client.Exceptions.BrokerUnreachableException: None of the specified endpoints were reachable
    ---> System.AggregateException: One or more errors occurred. (Authentication failed because the remote party sent a TLS alert: 'HandshakeFailure'.)
    ---> System.Security.Authentication.AuthenticationException: Authentication failed because the remote party sent a TLS alert: 'HandshakeFailure'.
    ---> System.ComponentModel.Win32Exception (0x80090326): The message received was unexpected or badly formatted.
    --- End of inner exception stack trace ---
    at System.Net.Security.SslStream.ForceAuthenticationAsync[TIOAdapter](TIOAdapter adapter, Boolean receiveFirst, Byte[] reAuthenticationData, Boolean isApm)
    at RabbitMQ.Client.Impl.SslHelper.<>c__DisplayClass2_0.<TcpUpgrade>b__0(SslOption opts)
    at RabbitMQ.Client.Impl.SslHelper.TcpUpgrade(Stream tcpStream, SslOption options)
    at RabbitMQ.Client.Impl.SocketFrameHandler..ctor(AmqpTcpEndpoint endpoint, Func`2 socketFactory, TimeSpan connectionTimeout, TimeSpan readTimeout, TimeSpan writeTimeout)
    at RabbitMQ.Client.Framing.Impl.IProtocolExtensions.CreateFrameHandler(IProtocol protocol, AmqpTcpEndpoint endpoint, Func`2 socketFactory, TimeSpan connectionTimeout, TimeSpan readTimeout, TimeSpan writeTimeout)
    at RabbitMQ.Client.ConnectionFactory.CreateFrameHandler(AmqpTcpEndpoint endpoint)
    at RabbitMQ.Client.EndpointResolverExtensions.SelectOne[T](IEndpointResolver resolver, Func`2 selector)

    Please make sure that you have two necessary certificates in Cert Manager:
    In Windows Search field enter “certlm” and it will automatically offer you “Manage computer certificates”, click on that “Manage computer certificates”
    It will open the window and in the left menu bar find folder “Trusted Root Certification Authorities”, and subfolder “Certificates”. When you click on “Certificates” in the right side menu find Robotiq.ai two certificates as in picture below:

    If you cannot find these two certificates, you should add them manually.
  22. Right click on subfolder “Certificates” in the left menu, shoose All tasks, than Import – it will open the Wizard. You should click Next, and then click Browse:

    Choose the installation path -> Setup -> en-us -> cawithroot
    First choose certificate: “cawithroot”

    And in Wizard click: Next, Next and Finish.

    To add the second (last) certificate named “cac”, please repeat all steps from 23. but this time choose certificate named “cac”:

  23. When you added these two certificates manually, please restart Gatekeeper as follows:
    In Windows search write: “services”, click on “Services” and the window will open. Please find “Robotiq.ai Gatekeeper”:

    Click on (mark) Robotiq.ai Gatekeeper and than click at the left corner “Start” marked in red.

Logs

Recorder, Robot and Handler logs can be found by typing: %appdata%

then: Robotiq -> logs

Gatekeeper logs can be found at %ApplicationInstallDir% -> Gatekeeper\logs