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
Примечание. Если в комплекте поставки присутствуют роботы, разработанные по заказу, то для работы этих роботов может потребоваться определенная версия браузера (в этом случае необходимо проконсультироваться с разработчиком роботов).
Процесс установки
Необходимые материалы:
- Архив с пакетами дистрибутива в формате *.tar.gz
- Файл с лицензией в формате *.lic либо *.licx
Распакуйте полученный архив с фалами дистрибутива в новую директорию внутри вашей домашней директории (например, ~/dist). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.
mkdir -p ~/dist
tar -xvzf <имя архива> -C ~/dist
Перейдите внутрь директории с распакованным архивом.
cd ~/dist
Рекомендуется использовать сценарий автоматической установки и конфигурации.
Примечание. При наборе команд и имен в терминале можно использовать клавишу Tab, которая завершает имя после набора первых трех символов, если иных совпадений нет.
Установка
В директории, вместе с установочными пакетами, должны присутствовать следующие файлы:
rpa-robin-install-redos-std.sh
rpa-robin-check-user-group.sh
Установка с готовой лицензией
Если вам был предоставлен готовый файл лицензии, то для установки выполните команду
sudo ./rpa-robin-install-redos-std.sh ./<имя файла лицензии>
Следите за сообщениями на экране. Процесс установки может занять несколько минут.
Установка без лицензии
Для установки выполните команду
sudo ./rpa-robin-install-redos-std.sh
Следите за сообщениями на экране. Процесс установки может занять несколько минут.
По завершению установки, в текущей директории у вас появится автоматически созданный файл запроса лицензии - envId.txt. Полученный файл запроса лицензии envId.txt отправьте в службу технической поддержки.
После получения файла постоянной лицензии, установите его (скопируйте файл лицензии в текущую директорию):
sudo cp ./<имя файла лицензии> /opt/RobinPlatform/2.0.0/Agent/
sudo chmod 0644 /opt/RobinPlatform/2.0.0/Agent/<имя файла лицензии>
sudo cp ./<имя файла лицензии> /opt/RobinPlatform/2.0.0/RobotPlayer/
sudo chmod 0644 /opt/RobinPlatform/2.0.0/RobotPlayer/<имя файла лицензии>
Добавление текущего пользователя в группу rpa-robin
По окончанию установки проверьте, не присутствует ли текущий пользователь в группе rpa-robin для работы с роботами. Для этого можно воспользоваться приложенной утилитой:
./rpa-robin-check-user-group.sh
Если пользователь не присутствует в группе - вы можете сделать это с помощью команды:
sudo usermod -aG rpa-robin $USER
Внимание. Чтобы участие пользователя в группе вступило в силу, рекомиендуется перезапустить операционную систему.
Без участия в группе rpa-robin, пользователь не сможет выполнять роботов.
Внимание. Пользователь окажется в группе только в следующем сеансе, если его учетная запись не была включена в группу rpa-robin в ходе предыдущих инсталляций. Чтобы участие пользователя в группе вступило в силу, необходимо завершить сеанс пользователя в операционной системе и открыть новый сеанс.
Выполнить команду для первоначальной настройки драйверов для web-браузеров (выполняется однократно для пользователя):
cli-robin webdrivers-bootstrap
Если в системе уже существует файл конфигурации, высветится подтверждение о перезаписи. Рекомендуется перезаписать файл после инсталляции платформы.
Запуск роботов
Локальный запуск роботов (файл робота на рабочей станции)
Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присуствовали в установленной платформе.
Робот может быть запущен 2 способами:
Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player"; либо по двойному клику мышкой на пиктограмме файла
В терминале: robinplayer <путь к файлу либо имя файла если в текущей директории>
При запуске робота откроется терминальное окно с сообщениями о ходе выполнения. После успешного выполнения окно закроется автоматически, в случае критичной ошибки робота - останется открытым для просмотра, закрыть его можно через сочетание клавиш Ctrl+C
Примечание. Запуск робота из робота может не работать из домашней директории пользователя, - в этом случае для них понадобится явная установка группы-владельца rpa-robin и прав на чтение участниками группы rpa-robin.
Работа в многопользовательском окружении
Если в системе работает несколько различных пользователей, и запускают одних и тех же роботов, могут быть конфликты на уровне временных файлов в общей директории /tmp.
Во избежание конфликтов, на компьютерах, в которых работает несколько пользователей, рекомендуется очищать временные файлы в директории /tmp которых после завершения работы и перед выходом из системы.
Команда очистки:
rm -f /tmp/*.robin*
Обновление драйверов браузера
В случае необходимости обновления драйверов браузера, можно самостоятельно скачать необходимую версию драйвера (с ресурса разработчика драйвера либо браузера). Структура каталогов с драйверами внутри установленной платформы Робин внутри директории /opt/RobinPlatform/2.0.0/drivers/browser имеет следующую структуру (директория с названием браузера, затем директория с именем и версией драйвера, внутри которой находится сам драйвер):
- Скачать драйвер, распаковать если он заархивирован, поместить в директорию, названную в формате "имя-версия"
- Убедиться, что он является исполняемым файлом для всех:
chmod +x yandexdriver - Скопировать директорию с драйвером по нужному пути, например:
sudo cp -a yandexdriver-23.3.1.755 /opt/RobinPlatform/2.0.0/drivers/browser/yandex/ - Добавить запись в файл конфигурации ~/.robin/env/cfg по подобию существующих записей в файле (обратите внимание что для версии Yandex в левой части строк указываются только три цифры без точки - например 229 вместо 22.9.1.1110):
Консоль просмотра журнала роботов
Добавлен инструмент для просмотра журналов. На инструментальном стержне вверху окна можно переключиться на вкладки журанлов Агента, действий на Java и действий на Python. В таблицу выводится до 1000 последних записей журнала. После запуска робота для загрузки новых записей можно нажать кнопку Update/Обновить.
Запуск инструмента - из командной строки в сеансе обычного пользователя:
gui-robin
Окно с инверсией цвета (черный фон):
gui-robin --dark
Деинсталляция
В случае необходимости деинсталяции Платформы Робин, можно воcпользоваться штатными командами операционной системы (dnf)
Удаление (деинсталляция)
sudo dnf remove -y rpa-robin-core