Установка и активация RPAbot MultiOS на Линукс

Инструкция по установке RPAbot MultiOS Studio Среда разработки на ОС Astra #Linux

1. Базовые требования для установки RPAbot MultiOS в ОС Astra Linux

1. Система должна быть 64-х разрядная (x86_64);

2. Для установки RPAbot MultiOS пользователь должен быть администратором (root);

3. Если задачи связаны с работой в сети интернет, нужен неограниченный доступ в интернет или ограниченный к тем сайтам, с которыми работает Робот. Для активации RPAbot, управление лицензией, скачивания новых версий RPAbot и работы с документацией необходим доступ к сайту rpa-bot.ru. Активация RPAbot доступна по протоколу TCP по адресу https://rpa-bot.ru:443/;

4. Для технической поддержки и разработки Роботов, техподдержки и настройки приложения RPAbot MultiOS необходим доступ с графическим сеансом на компьютер с помощью: RDP, VNC, Anydesk, TeamViewer (или другие варианты);

5. Требуется от 7 Gb свободного места на диске (SSD) (на один экземпляр программы для одного робота).

2. Где скачивать файл установщик программы RPAbot для Linux?

Варианты ссылок для скачивания файла установщика:

На рисунке страница личного кабинета сайта rpa-bot.ru

На рисунке страница сайта rpa-bot.ru для скачивания файлов для установки. Маркером выделена ссылка для скачивания файла-установщика RPAbot MultiOS Среда разработки

3. Инструкция для установки RPAbot MultiOS Studio на Linux

Примечание: здесь и далее в описании речь идет о графическом установщике RPAbot MultiOS Studio (сокр. RPAbot MultiOS).

3.1. Скачать файл-установщик

Скачать файл-установщик программы RPAbot MultiOS с сайта rpa-bot.ru в домашнюю папку пользователя по пути /home/<Имя Пользователя>/Загрузки/.

3.2. Изменить атрибуты доступа

Изменить атрибуты доступа у файла-установщика на «Выполнение», чтобы дать права "на выполнение" текущему Пользователю ОС.

Для файлов скаченных из сети Интернет, атрибуты доступа на выполнение всегда имеют значение «запрещено».

Чтобы изменить атрибуты доступа на «Выполнение»:

- вызвать форму «Свойства» с помощью контекстного меню кликом по правой клавише мыши на файле-установщике и выборе опции «Свойства»;

- в форме «Свойства» перейти во вкладку «Дискреционные атрибуты»;

- в форме «Свойства» во вкладка «Дискреционные атрибуты» установить кликом левой клавиши мыши переключатели (чек-боксы) в положение «включено» и нажать кнопку «Да», чтобы подтвердить внесённые изменения.

На рисунке форма «Свойства» вкладка «Дирекционные атрибуты». Маркером выделены атрибуты «Выполнения».

3.3. Запуск файла установщика

Запуска файла установщика RPAbot MultiOS необходимо выполнять от Пользователя ОС с правами Администратор

Если безопасность ОС настроена на запуск исполняемых файлов с вводом пароля Администратора, то запуск файла необходимо выполнять с использованием Терминала.

Чтобы запустить Терминал ОС следует выбрать в меню «Пуск» "Терминал Fly": Пуск –> Системные –> Терминал Fly

На рисунке выбор меню «Пуск» указан «Терминал Fly».

Альтернативный способ вызова Терминала ОС в окне «Менеджера файлов» в главном меню выбрать «Сервисы» -> «Открыть Терминал» (командная строка будет указывать на текущий каталог, который был открыт в «Менеджере файлов»).

На рисунке выбор меню в «Менеджере файлов» выбора «Терминала».

В Терминале выполнить команду, чтобы выполнить выбор в папки «Загрузки» в домашней папке Пользователя в качестве текущей (в эту папку ранее был загружен файл-установщик):

cd ~/Загрузки/

Формат команды в Терминале для запуска файла-установщика с помощью утилиты sudo в этом формате:

sudo ./RPAbotStudioInstall_<версия RPA-bot>.run -d

Где:

sudo – это имя модуля для выполнения команды в режиме «Администратора»;

./RPAbotStudioInstall_<версия RPA-bot>.run – это относительный путь к файлу для запуска;

-d – это параметр для включения более подробного вывода сообщений о ходе процесса установки в окно Терминала в процессе установки RPAbot (это необязательный параметр, может потребоваться если в процессе установки произошли ошибки и требуется получить лог установки).

Примечание: допускается вызывать запуск файла-установщика используя в команде абсолютный путь к файлу. Абсолютный путь к файлу можно получить в «Менеджере файлов» с помощью контекстного меню вызываемое при клике правой кнопкой мыши на файле.

На рисунке контекстное меню для файла в «Менеджере файлов» опция «Копировать путь».

В Терминале выполнить команду запуск файла-установщика:

sudo ./RPAbotStudioInstall_8.0.4.run -d

Примечание: если утилита sudo запросит пароль в терминале – ввести пароль и нажать Enter.

Примечание: Если ОС настроена на запуск файлов на исполнения без необходимости ввода пароля Администратора, то файл-установщик можно запустить двойным кликом из «Менеджера файлов» и выполнить дальнейшие действия без Терминала (далее запуск с использованием Терминала).

  • Диалог процесса установки

В результате выполнения команды запуска файла-установщика RPAbot появится окно «Установка RPAbot».

В окне «Установка RPAbot» в диалоге «Каталог установки» указать путь к папке установки файлов и папок приложения RPAbot и нажать на кнопку «Далее».

Важно: папка для установки RPAbot должна быть пустой.

На рисунке окно «Установка RPAbot» диалог выбора «Каталог установки».

В окне «Установка RPAbot» в диалоге «Выбор компонентов» выбрать компоненты для установки для приложения RPAbot и нажать на кнопку «Далее».

Важно: для первичной установки версии следует выбирать все компоненты. Рекомендуется выбирать все указанные компоненты для установки.

Важно: Сообщения о ходе процесса установки (лог) сохраняются в файл InstallationLog.txt по в корневой папке установленного приложения RPAbot. Файл InstallationLog.txt нужно приложить к заявке по технической поддержке RPAbot в случае обнаружения ошибки в процессе установки.

Важно: если имя пользователя (или любая часть пути к папке) содержит специальные символы, например, символ @, в домашнюю папку установка приложения RPAbot не может быть выполнена.

В таком случае можно установить приложение в папку /tmp/ или /opt/, после чего, можно папку приложения целиком скопировать в домашнюю папку.

Пример имени пользователя, в домашнюю папку установка не может быть выполнена:

test-rpa-user@domain.ru

Пример пути к папке, в домашнюю папку установка не может быть выполнена:

/home/test-rpa-user@domain.ru/RPAbot/Studio/

Важно: При установке в общие папки (/tmp/ или /opt/) надо отключать компонент Desktop Shortcut, который создаёт глобальный ярлык в меню “Пуск”.

На рисунке окно «Установка RPAbot» диалог «Выбор компонентов».

В окне «Установка RPAbot» в диалоге «Лицензионное соглашение» установит галочку «Я согласен(а) с лицензией» и нажать на кнопку «Далее».

На рисунке окно «Установка RPAbot» диалог «Лицензионное соглашение».

На рисунке окно «Установка RPAbot» процесс установки при запуске из «Терминала» без параметра -d.

На рисунке окно «Установка RPAbot» процесс установки при запуске из «Терминала» с параметром -d.

В окне «Установка RPAbot» по окончании выполнения операции установки нажать на кнопку «Далее».

На рисунке окно приложения «Установка RPAbot” при окончании выполнения процесса установки RPAbot.

В окне «Установка RPAbot» в разделе «Завершено» нажать на кнопку «Завершить».

Выполнение установки закончено.

На рисунке окно приложения «Установка RPAbot» по окончании выполнения операции установки RPAbot.

4. Ошибки при установке RPAbot MultiOS Studio на Linux
4.1. Выбранный каталог существует и содержит установленное приложение

Ошибка: в окне «Установка RPAbot» диалог выбора «Каталог установки» ошибка «Выбранный каталог существует».

Причина: папка (каталог) установки содержит файлы и папки.

Решение: очистить папку от файлов и папок или выполнить установку в другой каталог

На рисунке окно «Установка RPAbot» диалог выбора «Каталог установки» ошибка «Выбранный каталог не существует».

4.2. Ошибка аутентификации Пользователя ОС

Ошибка: в окне «Установка RPAbot» диалог выбора «Установки» ошибка «Error creating textual authentication agent…».

Причина: действие установки приложения RPAbot требует аутентификации Пользователя ОС, по правилам настройки безопасности ОС. Такое требование безопасности обычно принято для ОС в закрытых сетях организаций.

Решение: выполнить запуск файла-установщика из Терминала с помощью модуля sudo.

На рисунке окно «Установка RPAbot» диалог выбора «Установка» ошибка аутентификации Пользователя ОС.

5. Запуск RPAbot MultiOS Studio на Линукс

Для запуска переходим в корневую папку приложения RPAbot и запускаем файл с именем RPAbot.

На рисунке окно «Менеджер файлов» синим цветом выделена папка приложения RPAbot и файл для запуска.

Важно: при запуске приложение RPAbot назначает себе значение порта для хоста автоматически. Стартовое значение порта это 5002, если у текущего Пользователя или у других пользователей этой ОС запущены экземпляры приложения RPAbot, то будет выбран следующий по порядку свободный порт.

На рисунке окно приложения RPAbot. Синим цветом выделен адрес (хост) для работы этого экземпляра приложения RPAbot. Порт для работы 5003.

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

Важно: перед запуском необходимо убедится в том, что другой экземпляр приложения для той же папки не запущен. Для проверки, проверьте «Панель задач» или «Системный монитор» (для текущего Пользователя ОС искать папку запуска).

На рисунке «Панель задач» ОС, развернута часть панели со скрытыми значками. Если приложение RPAbot было уже запущено и свернуто, то в графическом интерфейсе его значок можно найти в этой панели.

Важно: для корректного завершения работы приложения RPAbot рекомендуется использовать команду «Выход» из главного меню приложения по пути Файл->Выход.

6. Создание экземпляра приложения RPAbot MultiOS (в отдельной папке) на основе существующей версии приложения RPAbot. Создание экземпляра приложения RPAbot для другого пользователя.

В этом разделе описана методика создание очередного экземпляра приложения RPAbot у другого пользователя текущей ОС. Исходные условия:

  • действия выполняется для двух пользователей и для одного компьютера User_1 и User_2;
  • у пользователя User_1 уже установлен и размещен в его домашней папке экземпляр приложения RPAbot;
  • для пользователя User_2 нужно создать и запустить новый экземпляр приложения RPAbot;
  • «действие для учетной записи пользователя» здесь и далее подразумевает, что этот пользователь подключен к графической сессии на компьютере с ОС Linux и имеет необходимые права для выполнения операции.

Папка приложения RPAbot — это папка, содержащая файл для запуска и другие компоненты. Пример:

/home/User_1/RPAbot/Studio_8.0.34/

Важно: подход по копированию папки можно использовать, если имя текущего пользователя содержит специальные символы (например @), которые недопустимы для названия «каталога установки» приложения. В таком случае, для установки можно использовать общую папку /opt/ (в отдельной подпапке) и после полной установки выполнить все действия по копированию для «домашней» папки пользователя. Копировать папку рекомендуется с помощью «Менеджера файлов» из-под пользователя, под которым будет работать RPAbot, в таком случае атрибуты доступа текущего Пользователя для папки приложения будут установлены корректно.

6.1. Действия для учетной записи пользователя User_1 по созданию копии исходной папки приложения RPAbot в общей папке компьютера tmp

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

Выполнить операцию копирования папки приложения RPAbot в общую папку /tmp/.

Это скопировать все файлы и папки приложения RPAbot в общую папку /tmp/.

Важно: при выполнении операции копирования приложение RPAbot не должно быть запущено!

Исключить при копировании:

- исключить папки с «номером порта». Пример: 5002, 5003, 5004 и так далее;

- исключить файлы в папке Settings: settings_v1.json и settings_v1.json.bak (некорректно устанавливается настройка пути к папке My_Roobots);

- исключить содержимое папки My_Robots (это файлы и папки Роботов, если они не требуются), кроме системных (нужны для работы приложения): Plugins, PluginsJS, PluginsPY, plugins.js, plugins.php, plugins.py;

- исключить содержимое папки /logs/, если файлы логов не актуальны;

- исключить содержимое папки /docker/.

6.2. Действия для учетной записи пользователя User_2 для получения копии исходной папки приложения RPAbot из общей папки компьютера tmp

Выполнить операцию копирования папки приложения RPAbot из общей папки /tmp/ в домашнюю папку. Пример пути папки: /home/User_2/RPAbot/Studio_8.0.34/

6.3. Пробный запуск и активация приложения RPAbot

Выполнить запуск приложения RPAbot. Выполнить активацию приложения с помощью лицензионного ключа (если требуется). Запустить любого Робота на исполнение. Проверить в «Панели отладки» ошибки.

7. Активация RPAbot MultiOS Studio на Linux

Примечание: перед активацией приложения RPAbot необходимо проверить права (атрибуты доступа) «на изменение» для корневой папки приложения. Для проверки прав Пользователя, в «Менеджере файлов» открыть корневую папку с файлами и папками приложения RPAbot (для текущего Пользователя, от имени которого будет запускаться приложение) и попробовать создать пустой файл test.txt в этой папке. Если файл был успешно создан (без возникновения ошибок), значит прав «на изменение» (в этой папке) у текущего Пользователя достаточно. Если файл создать не удалось, значит для данного Пользователя необходимо предоставить права на запись «на изменение» в папку (корректировать атрибуты доступа).

7.1. Активация RPAbot

Для активация необходимо приобрести Лицензию и получить данные для входа в Личный кабинет на сайте rpa-bot.ru.

Важно: для корректной работы механизма активации сайт rpa-bot.ru должен быть доступен в сети данного компьютера.

Важно: следует обращать внимание на срок годности лицензии.

Важно: корректно активированная программа выполняет запуск простого Робота без сообщений о ошибках активации в «Панели отладки».

7.1.1. Запустить экземпляр приложения RPAbot

Запустить экземпляр приложения RPAbot и ожидать полной загрузки приложения.

7.1.2. Диалог активации (запуск)

Найти и кликнуть в главном меню опцию «Активация» приложения RPAbot «Помощь-> Активация» программы RPAbot открываем диалог активации.

На рисунке окно RPAbot, развернуто Главное меню и выбрана опция «Активация».

На рисунке диалоговое окно «Активировать программу» приложения RPAbot.

7.1.4. Страница Лицензии. Личный кабинет на сайте rpa-bot.ru

Перейти на страницу сайт Личный кабинет (Профиль) https://rpa-bot.ru/personal/. Пройти авторизацию для входа под своими учетными данными.

7.1.5. Перейти в раздел сайта «Лицензии» https://rpa-bot.ru/personal/myshopping/

7.1.6. На странице сайта «Лицензии» выбрать строку в таблице лицензии строку требуемой лицензии и нажать на кнопку «Карточка лицензии» для редактирования, чтобы перейти в раздел Личного кабинета «Карточка лицензии».