b. В выпадающем меню выбрать realm "Robin"
RAM не менее 4Gb, свободное место на диске от 5 Gb
RED OS 7.3.2 / 64, с базовыми настройками профилей безопасности (без ввода в домен Windows)
Учетная запись с правами администратора (sudo). Внимание. Прямая установка в сеансе root (когда в терминале отображается подсказка root@<host>) может привести к непредсказуемым последствиям и потому недопустима. Проводите установку в сеансе пользователя, у которого доступно выполнение команд через sudo.
Устойчивое подключение к официальным репозиториям RED OS (доступ в интернет либо к локальным зеркалам репозиториев пакетов RED OS)
Для работы с автоматизацией браузера - необходимо убедиться в наличии одного из браузеров, при необходимости - установить один из поддерживаемых в текущем релизе:
Yandex-Browser 22.9
Yandex-Browser 22.5
Yandex-Browser 22.7
Yandex-Browser 23.3
Chromium 94
Chromium 101
Firefox 31
Firefox 30
Примечание. Если в комплекте поставки присутствуют роботы, разработанные по заказу, то для работы этих роботов может потребоваться определенная версия браузера (в этом случае необходимо проконсультироваться с разработчиком роботов).
Необходимые материалы и информация:
Распакуйте полученный архив с фалами дистрибутива в новую директорию внутри вашей домашней директории (например, ~/dist). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.
mkdir -p ~/dist
tar -xvzf <имя архива> -C ~/dist
Перейдите внутрь директории с распакованным архивом.
cd ~/dist
Рекомендуется использовать сценарий автоматической установки и конфигурации.
Примечание. При наборе команд и имен в терминале можно использовать клавишу Tab, которая завершает имя после набора первых трех символов, если иных совпадений нет.
В директории, вместе с установочными пакетами, должны присутствовать следующие файлы:
rpa-robin-install-deb-std.sh
rpa-robin-check-user-group.sh
Для установки выполните команду
sudo ./rpa-robin-install-redos-ent.sh ./Robin.Agent.cfg <адрес хоста>
Если вам был предоставлен только адрес хоста или только файл конфигурации, укажите их в качестве аргумента при вызове сценария установки (тип параметра распознается автоматически).
Следите за сообщениями на экране. Процесс установки может занять несколько минут.
В ходе установки у Вас будет запрошен ключ ClientSecret. Введи его значение, если он Вам известен, либо сразу нажмите клавишу "Ввод" для продолжения установки без нового ключа.
Получение ClientSecret для аутентификации Robin.Agent через Keycloak
а. Зайти в панель администратора в Keycloak (по адресу https://serverhost:8443/, указать указать свой адрес вместо serverhost)
Логин/пароль по умолчанию: admin/Qwerty123
b. В выпадающем меню выбрать realm "Robin"
c. Получить Secret для агента
Выбрать Clients → Robin.Agent → Credentials → Client secret
Пример полученной записи: BDsArvgg7R9lKXJHe6fSKU4dRB8xBlY4
По окончанию установки проверьте, не присутствует ли текущий пользователь в группе rpa-robin для работы с роботами. Для этого можно воспользоваться приложенной утилитой:
./rpa-robin-check-user-group.sh
Если пользователь не присутствует в группе - вы можете сделать это с помощью команды:
sudo usermod -aG rpa-robin $USER
Внимание. Чтобы участие пользователя в группе вступило в силу, рекомендуется перезапустить операционную систему.
Без участия в группе rpa-robin, пользователь не сможет выполнять роботов.
Внимание. Пользователь окажется в группе только в следующем сеансе, если его учетная запись не была включена в группу rpa-robin в ходе предыдущих инсталляций. Чтобы участие пользователя в группе вступило в силу, необходимо завершить сеанс пользователя в операционной системе и открыть новый сеанс.
Выполнить команду для первоначальной настройки драйверов для web-браузеров (выполняется однократно для пользователя):
cli-robin webdrivers-bootstrap
Если в системе уже существует файл конфигурации, высветится подтверждение о перезаписи. Рекомендуется перезаписать файл после инсталляции платформы.
Для начала работы выполните в терминале команду:
rpa-connector
Минимизируйте окно терминала, не закрывая процесс
Откройте Web-интерфейс Оркестратора
В случае, если ваша учетная запись не зарегистрирована на Оркестраторе, зарегистрируйте ее. Имя учетной записи на Оркестраторе должно совпадать с именем учетной записи на РЕДОС. При регистрации укажите (как минимум) следующие роли: "Исполнитель задач", "Пользователь Robin Player".
Добавление рабочей станции возможно после установки и запуска Robin Robot на рабочей станции.
Проверьте наличие хоста в списке оркестратора:
Если имя рабочей станции в списке отсутствует - добавьте его, при этом в выпадающем списке учетных записей выбрать Вашу текущую учетную запись на рабочей станции.
Проверить соединение хоста и оркестратора можно после нажатия на кликабельное имя хоста, откроется форма с информацией, при этом индикатор состояния под именем хоста должен быть зеленым (Online):
Для более подробной информации о работе с Оркестратором обратитесь к документации на Оркестратор.
Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.
Робот может быть запущен 2 способами:
Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player"; либо по двойному клику мышкой на пиктограмме файла
В терминале: robinplayer <путь к файлу либо имя файла если в текущей директории>
При запуске робота откроется терминальное окно с сообщениями о ходе выполнения. После успешного выполнения окно закроется автоматически, в случае критичной ошибки робота - останется открытым для просмотра, закрыть его можно через сочетание клавиш Ctrl+C
Примечание. Запуск робота из робота может не работать из домашней директории пользователя, - в этом случае для них понадобится явная установка группы-владельца rpa-robin и прав на чтение участниками группы rpa-robin.
Обратитесь к документации на Оркестратор
Если в системе работает несколько различных пользователей, и запускают одних и тех же роботов, могут быть конфликты на уровне временных файлов в общей директории /tmp.
Во избежание конфликтов, на компьютерах, в которых работает несколько пользователей, рекомендуется очищать временные файлы в директории /tmp которых после завершения работы и перед выходом из системы.
Команда очистки:
rm -f /tmp/*.robin*
Если в ходе эксплуатации Вам понадобится обновить ключ, вы можете сделать это в терминале, введя команду:
cli-robin setup-secret
Ввод значения маскируется, значение ключа не будет отображаться на экране
Если в ходе эксплуатации Вам понадобится изменить пароль для соединения с RabbitMQ, вы можете сделать это в терминале, введя команду:
sudo /usr/local/bin cli-robin config-update Agent Admin -k RabbitPassword -v <значение пароля>
В случае необходимости обновления драйверов браузера, можно самостоятельно скачать необходимую версию драйвера (с ресурса разработчика драйвера либо браузера). Структура каталогов с драйверами внутри установленной платформы Робин внутри директории /opt/RobinPlatform/2.0.0/drivers/browser имеет следующую структуру (директория с названием браузера, затем директория с именем и версией драйвера, внутри которой находится сам драйвер):
Добавлен инструмент для просмотра журналов. На инструментальном стержне вверху окна можно переключиться на вкладки журналов Агента, действий на Java и действий на Python. В таблицу выводится до 1000 последних записей журнала. После запуска робота для загрузки новых записей можно нажать кнопку Update/Обновить.
Запуск инструмента - из командной строки в сеансе обычного пользователя:
gui-robin
Окно с инверсией цвета (черный фон):
gui-robin --dark
В случае необходимости деинсталяции Платформы Робин, можно воcпользоваться штатными командами операционной системы (dnf)
Удаление (деинсталляция)
sudo dnf remove -y rpa-robin-core