Environment requirements for installation
Workstation requirements
RAM not less than 4Gb, free disk space from 5 Gb
RED OS 7.3.2 / 64, with basic security profile settings (no Windows domain entry)
Account with administrator rights (sudo).
Attention!
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.
Stable connection to official RED OS repositories (access to the Internet or local mirrors of RED OS package repositories)
To work with browser automation - you need to make sure you have one of the browsers, if necessary - install one of the supported ones 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 operate (in this case, consult with the robot developer).
Installation process
Required materials:
- Archive with distribution packages in *.tar.gz format
- License file in *.lic or *.licx format
Extract the archive with the distribution files to a new directory inside your home directory (e.g. ~/dist). To do this, open the directory with the archive in File Manager, launch Terminal from it and execute the commands.
mkdir -p ~/dist
tar -xvzf <archive name> -C ~/dist
Go inside the directory with the extracted archive.
cd ~/dist
It is recommended that you use the automatic installation and configuration script.
Note!
When typing commands and names in the terminal, you can use the Tab key, which completes the name after typing the first three characters if there are no other matches.
Installation
The following files must be present in the directory, along with the installation packages:
rpa-robin-install-redos-std.sh
rpa-robin-check-user-group.sh
Installation with ready license
If you were provided with a ready-made license file, run the command to install it:
sudo ./rpa-robin-install-redos-std.sh ./<license file name>
Watch the messages on the screen. The installation process may take a few minutes.
Installation without license
To install, run the command:
sudo ./rpa-robin-install-redos-std.sh
Watch the messages on the screen. The installation process may take a few minutes.
When the installation is complete, you will have an automatically created license request file - envId.txt - in the current directory. Send the resulting envId.txt license request file to Technical Support.
After receiving the permanent license file, install it (copy the license file to the current directory):
sudo cp ./<license file name> /opt/RobinPlatform/2.0.0/Agent/
sudo chmod 0644 /opt/RobinPlatform/2.0.0/Agent/<license file name>
sudo cp ./<license file name> /opt/RobinPlatform/2.0.0/RobotPlayer/
sudo chmod 0644 /opt/RobinPlatform/2.0.0/RobotPlayer/<license file name>
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
Attention!
It is recommended to restart the operating system for the user's participation in the group to take effect.
Without participation in the rpa-robin group, the user will not be able to execute robots.
Attention!
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 installing the platform.
Launching robots
Local launch of robots (robot file on the workstation)
The versions of the actions used in the robot must be present in the installed platform for the robot to execute successfully.
The robot can be launched in 2 ways:
From the file manager - by right-clicking - the item Open in Robin Player at the top of the context menu; or by double-clicking the file icon with the mouse
In terminal: robinplayer <path to file or file name if in 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.
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 it is required to update the browser drivers, it is possible to download the necessary driver version (from the driver or browser developer's resource). The structure of directories with drivers inside the installed Robin platform inside the directory
/opt/RobinPlatform/2.0.0/drivers/browser
has the following structure (the directory with the browser name, then the directory with the driver name and version, inside which the driver itself is located):
- Download the driver, unzip if it is archived, place it in a directory named in the format name-version
- Make sure it is a usable file for everyone:
chmod +x yandexdriver - С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/ - 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
A tool for viewing logs has been added. On the tool bar at the top of the window, you can switch to the tabs for Agent logs, Java actions, and Python actions. Up to 1000 recent log entries are displayed in a table. After starting 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
Uninstallation
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
Обзор
Инструменты контента