Requirements for the installation environment

  1. RAM not less than 4Gb, free space on disc from 5 Gb
  2. Astra Linux 1.7.2, with basic settings of security profiles (without entering the Windows domain)
  3. An account with administrator rights (sudo)
  4. Availability of dotnet-sdk-6.0 installed. Installation instructions from Astra Linux OS developer: https://wiki.astralinux.ru/pages/viewpage.action?pageId=41192241. Another installation method is discussed in Appendix 1.
  5. Stable connection to official Astra Linux repositories (access to the Internet or to local mirrors of RED OS package repositories)
  6. To work with browser automation - it is necessary to make sure that one of the browsers is available, if necessary - install one of the supported in the current release:
    • Yandex-Browser 22.9
    • Yandex-Browser 22.5
    • Yandex-Browser 22.7
    • Yandex-Browser 23.3
    • Chromium 94
    • Chromium 101
    • Firefox 31
    • Firefox 30.
Note! If custom-designed robots are included, these robots may require a specific browser version to perform (in this case, consult the robot developer).

Installation process

If ROBIN Robot components have been previously installed, it is recommended to remove them before starting the installation.

Before installing, check that Robin distribution packages are not already installed on the computer:

dpkg -l | grep robin

If they are present, a list of packages to be removed will be displayed.

To remove these packages, run the following command:

sudo apt remove -y <package name>

Note! When typing commands and names in the terminal, you can use the Tab key, which completes the name if no other matches are available.

Installation

Download or copy the provided archive with the installation packages and unpack it into a separate directory.

The following files must be present in the directory along with the installation packages:

rpa-robin-install-deb-std.sh

rpa-robin-check-user-group.sh

If you already have a previous version of the platform installed on this computer, it is recommended that you uninstall it.

For installation, run the command

sudo ./rpa-robin-install-deb-std.sh

Monitor the messages on the screen.

Set the Agent service to load permanently:

sudo systemctl enable robinagent.service

Launch the service

sudo systemctl restart robinagent.service

Adding the current user to the rpa-robin group

After the installation is complete, check if the current user is in the rpa-robin group to work with robots. You can use the attached utility to do this:

./rpa-robin-check-user-group.sh

If the user is not present in the group - you can do this with the command:

sudo usermod -aG rpa-robin $USER

Warning! For a user's participation in the group to take effect, you must terminate the user's session in the operating system and open a new session.

Without participation in the rpa-robin group, the user will not be able to execute robots.

Warning! The user will only be in the group in the next session if their account was not included in the rpa-robin group during previous installations. For the user's participation in the group to take effect, you must terminate the user's session in the operating system and open a new session.

Execute the command for initial configuration of drivers for web browsers (executed once for the user):

cli-robin webdrivers-bootstrap

If a configuration file already exists in the system, a confirmation of overwriting will be displayed. It is recommended to overwrite the file after installing the platform.

Launching robots

For a successful robot execution, it is necessary that the versions of the actions used in the robot are present in the installed platform.

The robot can be launched in 2 ways:

  1. From the file manager - by right-clicking - "Open in Robin Player" element at the top of the context menu; or by double-clicking on the file icon.
  2. In the terminal: robinplayer <path to the file or file name if in the current directory>

When launching the robot, a terminal window with progress messages will open. After successful execution the window will close automatically, in case of a critical robot error it will remain open for viewing, it can be closed using the keyboard shortcut Ctrl+C

Note! Launching the robot from the robot may not work from the user's home directory - in this case, they will require explicit installation of the rpa-robin group-owner and read permissions for members of the rpa-robin group.

If you need to uninstall the Robin Platform, you can use the standard operating system commands (apt, apt-get)

Uninstall

sudo apt remove -y rpa-robinplatform...

(Press Tab at the end of typing the name instead of the dotted line - the exact package name will be displayed)

sudo apt remove -y rpa-robin-driver...

(Press Tab at the end of typing the name instead of the dotted line - the exact package name will be displayed)

Working in a multi-user environment

If several different users are running on the system and launching the same robots, there may be conflicts at the level of temporary files in the shared /tmp directory.

To avoid conflicts, on computers with multiple users, it is recommended to clear the temporary files in the /tmp directory of which after finishing work and before logging out.

The cleanup command:

rm -f /tmp/*.robin*

Updating browser drivers

If you need to update your browser drivers, you can download the required driver version yourself (from the driver developer's or browser developer's website). The structure of directories with drivers inside the installed Robin platform within the /opt/RobinPlatform/2.0.0/drivers/browser directory has the following structure (a directory with the browser name, followed by a directory with the driver name and version, with the driver itself inside):

  1. Download the driver, unzip if it is archived, place it in a directory named in the format "name-version"
  2. Make sure it is an executable file for everyone:
    chmod +x yandexdriver
  3. Copy the directory with the driver to the desired path, for example:
    sudo  cp -a yandexdriver-23.3.1.755  /opt/RobinPlatform/2.0.0/drivers/browser/yandex/
  4. Add an entry to the configuration file ~/.robin/env/cfg similar to the existing entries in the file (note that for the Yandex version only three digits without a dot are specified on the left side of the lines - e.g. 229 instead of 22.9.1.1110):


Robot log view console

Added a toolbar for viewing logs. From the tool bar at the top of the window, you can switch to the Agent, Java actions, and Python actions log tabs. Up to 1000 recent log entries are displayed in a table. After launching the robot, you can click the Update button to download new entries.

Launch the tool - from the command line in a regular user session:

gui-robin

Window with colour inversion (black background):

gui-robin --dark

Attachment 1. .NET installation option

.NET installation:

sudo apt install -y curl

cd ~

curl -L https://download.visualstudio.microsoft.com/download/pr/e77438f6-865f-45e0-9a52-3e4b04aa609f/024a880ed4bfbfd3b9f222fec0b6aaff/dotnet-runtime-6.0.25-linux-x64.tar.gz -o dotnet-runtime-6.0.25-linux-x64.tar.gz

sudo mkdir -p /opt/vendor/dotnet

sudo tar xzf ./dotnet-runtime-*.tar.gz -C /opt/vendor/dotnet/

sudo ln -sf /opt/vendor/dotnet/dotnet /usr/local/bin/dotnet

  • Нет меток