...

Требования к Оркестратору

1. Оркестратор должен быть настроен и запущен в вашей локальной сети, должна быть обеспечена его сетевая доступность для рабочих станций. Уточните адрес (URL) Оркестратора у вашего системного администратора.
2. Версия 2.5.0
   
3. Наличие сертификата, заверенного ЦС, включенного в доверенные сертификаты на рабочих станциях. Самоподписанные сертификаты могут использоваться только для пробных запусков и не гарантируют надежной работы

Требования к рабочей станции

1. RAM не менее 4Gb, свободное место на диске от 5 Gb

2. ALT Linux WS 10 / 64, с базовыми настройками профилей безопасности (без ввода в домен Windows)

3. Учетная запись с правами администратора (sudo). Внимание. Прямая установка в сеансе root (когда в терминале отображается подсказка root@<host>) может привести к непредсказуемым последствиям и потому недопустима. Проводите установку в сеансе пользователя, у которого доступно выполнение команд через sudo. Для активации возможности использовать sudo для обычных пользователей может потребоваться выполнение: "su -", затем "control sudowheel enabled" или добавление пользователя в группу wheel: "sudo usermod -aG wheel $USER"

4. Устойчивое подключение к официальным репозиториям ALT Linux (доступ в интернет либо к локальным зеркалам репозиториев пакетов ALT Linux)

5. Для работы с автоматизацией браузера - необходимо убедиться в наличии одного из браузеров, при необходимости - установить один из поддерживаемых в текущем релизе:

• Yandex-Browser 22.9

• Yandex-Browser 22.5

• Yandex-Browser 22.7

• Yandex-Browser 23.3

• Chromium 94

• Chromium 101

• Firefox 31

• Firefox 30

Примечание. Если в комплекте поставки присутствуют роботы, разработанные по заказу, то для работы этих роботов может потребоваться определенная версия браузера (в этом случае необходимо проконсультироваться с разработчиком роботов).

...

Необходимые материалы и информация:

1. Архив с пакетами дистрибутива в формате *.tar.gz
2. Файл конфигурации Агента с настройками - Robin.Agent.cfg (необязательно, но это позволит упростить настройки после установки, можно уточнить у администратора Оркестратора Робин).
3. Значение ключа ClientSecret для соединения с Оркестратором если он отличается от значения в Robin.Agent.cfg либо этот файл не предоставлен (эти данные необязательны, но это позволит упростить настройки после установки, можно уточнить у администратора Оркестратора Робин).
4. Адрес хоста Оркестратора Робин, установленного в вашей корпоративной сети (можно уточнить у администратора Оркестратора Робин). Адрес хоста должен быть в полном формате со схемой (http/https) и портом, если он отличается от стандартных для схемы значений (http - 80, https - 443). Пример правильного значения: https://orc.robin.corp:8443

Распакуйте полученный архив с фалами дистрибутива в новую директорию внутри вашей домашней директории (например, ~/dist). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.

...

а. Зайти в панель администратора в Keycloak (по адресу https://serverhost:8443/, указать указать свой адрес вместо serverhost)
Логин/пароль по умолчанию: admin/Qwerty123

Image ModifiedROBIN > ROBIN Robot 2.25.0 (Enterprise) / ALT Linux WS 10 - инструкция по установке > image2024-2-14_10-5-50.png
b. В выпадающем меню выбрать realm "Robin"

Image RemovedROBIN > ROBIN Robot 2.25.0 (Enterprise) / ALT Linux WS 10 - инструкция по установке > image2024-2-14_10-6-5.png

c. Получить Secret для агента

Выбрать Clients → Robin.Agent → Credentials → Client secret

Image RemovedROBIN > ROBIN Robot 2.25.0 (Enterprise) / ALT Linux WS 10 - инструкция по установке > image2024-2-14_10-16-51.png

Image RemovedROBIN > ROBIN Robot 2.25.0 (Enterprise) / ALT Linux WS 10 - инструкция по установке > image2024-2-14_10-17-9.png

...

Пример полученной записи: BDsArvgg7R9lKXJHe6fSKU4dRB8xBlY4

Добавление текущего пользователя в группу 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

Если в системе уже существует файл конфигурации, высветится подтверждение о перезаписи. Рекомендуется перезаписать файл после инсталляции платформы.

Для начала работы выполните в терминале команду:

rpa-connector

Минимизируйте окно терминала, не закрывая процесс

Настройка рабочей станции на Оркестраторе

Откройте Web-интерфейс Оркестратора

В случае, если ваша учетная запись не зарегистрирована на Оркестраторе, зарегистрируйте ее. Имя учетной записи на Оркестраторе должно совпадать с именем учетной записи на ALT Linux. При регистрации укажите (как минимум) следующие роли: "Исполнитель задач", "Пользователь Robin Player".

Image Removed

Добавление рабочей станции возможно после установки и запуска Robin Robot на рабочей станции.

Проверьте наличие хоста в списке оркестратора:

Image Removed

Если имя рабочей станции в списке отсутствует - добавьте его,  при этом в выпадающем списке учетных записей выбрать Вашу текущую учетную запись на рабочей станции.

Image Removed

Image Removed

Проверить соединение хоста и оркестратора можно после нажатия на кликабельное имя хоста, откроется форма с информацией, при этом индикатор состояния под именем хоста должен быть зеленым (Online):

Image Removed

Для более подробной информации о работе с Оркестратором обратитесь к документации на Оркестратор.

Запуск роботов

Локальный запуск роботов (файл робота на рабочей станции)

Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.

Робот может быть запущен 2 способами:

1. Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player"; либо по двойному клику мышкой на пиктограмме файла

2. В терминале: robinplayer <путь к файлу либо имя файла если в текущей директории>

Image RemovedROBIN > ROBIN Robot 2.25.0 (Enterprise) / ALT Linux WS 10 - инструкция по установке > redos-robot-file-ctx-menu.png

При запуске робота откроется терминальное окно с сообщениями о ходе выполнения. После успешного выполнения окно закроется автоматически, в случае критичной ошибки робота - останется открытым для просмотра, закрыть его можно через сочетание клавиш Ctrl+C

Примечание. Запуск робота из робота может не работать из домашней директории пользователя, - в этом случае для них понадобится явная установка группы-владельца rpa-robin и прав на чтение участниками группы rpa-robin.

Удаленный запуск роботов (файл робота на Оркестраторе)

Обратитесь к документации на Оркестратор

Работа в многопользовательском окружении

Если в системе работает несколько различных пользователей, и запускают одних и тех же роботов, могут быть конфликты на уровне временных файлов в общей директории /tmp.

Во избежание конфликтов, на компьютерах, в которых работает несколько пользователей, рекомендуется очищать временные файлы в директории /tmp которых после завершения работы и перед выходом из системы.

Команда очистки:

rm -f /tmp/*.robin*

Изменение ключа ClientSecret

Если в ходе эксплуатации Вам понадобится обновить ключ, вы можете сделать это в терминале, введя команду:

cli-robin setup-secret

Ввод значения маскируется, значение ключа не будет отображаться на экране

Изменение пароля RabbitMQ

Если в ходе эксплуатации Вам понадобится изменить пароль для соединения с RabbitMQ, вы можете сделать это в терминале, введя команду:

sudo /usr/local/bin cli-robin config-update Agent Admin -k RabbitPassword -v  <значение пароля>

Обновление драйверов браузера

...

1. Скачать драйвер, распаковать если он заархивирован, поместить в директорию, названную в формате "имя-версия"
2. Убедиться, что он является исполняемым файлом для всех:
   chmod +x yandexdriver
3. Скопировать директорию с драйвером по нужному пути, например:
   sudo  cp  -a  yandexdriver-23.3.1.755   /opt/RobinPlatform/2.0.0/drivers/browser/yandex/
4. Добавить запись в файл конфигурации ~/.robin/env/cfg по подобию существующих записей в файле (обратите внимание что для версии Yandex в левой части строк указываются только три цифры без точки - например 229 вместо 22.9.1.1110):

...

Консоль просмотра журнала роботов

Добавлен инструмент для просмотра журналов. На инструментальном стержне вверху окна можно переключиться на вкладки журналов Агента, действий на Java и действий на Python. В таблицу выводится до 1000 последних записей журнала. После запуска робота для загрузки новых записей можно нажать кнопку Update/Обновить.

Image RemovedROBIN > ROBIN Robot 2.25.0 (Enterprise) / ALT Linux WS 10 - инструкция по установке > Screenshot_2023-12-05_17-21-59.png

Запуск инструмента - из командной строки в сеансе обычного пользователя:

gui-robin

Окно с инверсией цвета (черный фон):

gui-robin --dark

Деинсталляция

В случае необходимости деинсталяции Платформы Робин, можно воcпользоваться штатными командами операционной системы (apt-get)

Удаление (деинсталляция)

...