Requirements for the installation environment:

  1. RAM at least 4Gb, free disc space from 5 Gb
  2. RED OS 7.3.2 / 64, with basic security profile settings (no entry into the Windows domain).

  3. An account with administrator rights (sudo).

    Warning! Direct installation in the root session (when the root@<<host> prompt is displayed in the terminal) can lead to unpredictable consequences and is therefore unacceptable. Do the installation in the session of a user who has access to sudo commands.


  4. Stable connection to official RED OS repositories (access to the Internet or local mirrors of RED OS package repositories).
  5. 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 browsers in the current release:
Note! If custom-designed robots are included, these robots may require a specific browser version (in this case, consult the robot developer).

Installation process

Uninstalling the previous version

In case you have previously installed an earlier version of Robin Robot, it is recommended to uninstall it before starting the installation.

Before installation, check that there are no Robin distribution packages already installed on your computer:

rpm -qa | grep rpa-robin

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

To remove these packages, run the following command:

sudo dnf 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 should be present in the directory along with the installation packages:

rpa-robin-install-redos-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 to uninstall it.

To install it, run the command

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

Watch the messages on the screen.

Adding the current user to the rpa-robin group

Once the installation is complete, check to see 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 will be displayed to overwrite the file. It is recommended to overwrite the file after the installation of the platform.

Launching robots

For the successful execution of the robot, 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" item 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 (dnf)

Uninstall

sudo dnf remove -y rpa-robin-core

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 a usable file for everyone:
    chmod +x yandexdriver
  3. Сopy 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 normal user session:

gui-robin

Window with color inversion (black background):

gui-robin --dark