Установка без использования Docker

Выбор варианта установки

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

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

Файлы из комплекта поставки

Cкопируйте на целевую машину файлы из комплекта поставки Primo RPA AI Server в соответствии с выбранным вариантом установки. Остальное ПО должно быть предустановлено в Astra Linux.

make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libedit-dev libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

Подготовка к установке

При установке Astra Linux на целевой машине необходимо создать пользователя-администратора. Для этого на экране «Настройка учетных записей и паролей» введите имя primo-admin для учетной записи администратора.

Установка дополнительного ПО и создание дополнительных пользователей описаны ниже.

Настройка дополнительного ПО

Выполните подключение целевой машины к репозиториям main, update, base и extended. В этом вам могут помочь статьи:

• Интернет-репозитории Astra Linux Special Edition x.7 .
• Создание репозиториев для операционной системы Astra Linux Special Edition x.7 в закрытом сегменте  — описывает настройку локальных зеркал данных репозиториев.

Рекомендуется выделить одну машину под управлением Astra Linux для размещения на ней сервера репозиториев.

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

sudo apt update

Репозитории main, update, base и extended должны присутствовать в выводе команды.

Установка агента

Выполняется одинаково для всех вариантов установки.

Настройка учетной записи

Для работы агента и IDP создайте общую группу:

sudo groupadd primo-ai

Для работы агента и IDP-ядра создайте учетную запись agent. Если будет использоваться вариант установки IDP-ядра B, то укажите расположение home-папки – в ней будут размещены инсталляции Python, а также все необходимые пакеты суммарным весом более 6 Гбайт.

В остальных случаях аргумент -d <custom_home_dir_location> не требуется.

sudo useradd -g primo-ai -m -s /bin/bash -d <custom_home_dir_location> agent

Установка и настройка агента

Разверните файлы агента на целевой машине. Файл Agent-linux.zip должен находиться в каталоге /srv/samba/shared/install.

sudo mkdir -p /app/Primo.AI /app/Primo.AI/Agent /app/Primo.AI/AgentData 

sudo unzip /srv/samba/shared/install/Agent-linux.zip -d /app/Primo.AI/Agent

sudo chmod -R 771 /app/Primo.AI/Agent /app/Primo.AI/AgentData

sudo chown -R agent:primo-ai /app/Primo.AI/Agent /app/Primo.AI/AgentData /app/Primo.AI/Agent

Для запуска и остановки агентом IDP-ядра без ввода пароля установите следующую настройку:

sudo sh -c "echo 'agent ALL=(%primo-ai) NOPASSWD: /app/Primo.AI/Agent/kill.sh, /app/Primo.AI/IDP/start_inference.sh, /app/Primo.AI/IDP/start_training.sh, /app/Primo.AI/IDP/start_evaluation.sh' > /etc/sudoers.d/agent"

Установите агент как службу и настройте автозапуск:

sudo cp /app/Primo.AI/Agent/Primo.AI.Agent.service /etc/systemd/system/

sudo systemctl daemon-reload

sudo systemctl enable /etc/systemd/system/Primo.AI.Agent.service

В конфигурационном файле appsettings.ProdLinux.json укажите:

• AgentId — уникальный идентификатор агента в виде значения с типом данных GUID. Идентификатор агента можно задать самостоятельно, а затем передать администратору вместе с IP-адресом, чтобы он добавил его в профиль целевой машины, либо наоборот — сначала создать целевую машину в разделе Настройки ➝ Целевые машины, скопировать автоматически заданный GUID и указать его в этом параметре.
• UserName — логин учетной записи агента.
• Password — пароль от учетной записи агента.
• Адрес Primo.AI.Api и его компонентов.

 	"Api": {
    		"AgentId": "{91E221E8-8E13-4100-8BCB-84EA318C32DA}", // Уникальный идентификатор агента 
			
    		"UserName": "agent",
    		"Password": "Xxxxxxxxxxxx",

    		"AuthBaseUrl": "https://primo-ai-api-server:44392",
    		"ApiBaseUrl": "https://primo-ai-api-server:44392",
    		"InferenceBaseUrl": "https://primo-ai-api-server:44392",
    		"LogsBaseUrl": "https://primo-ai-api-server:44392",
  },

Убедитесь, что в конфигурационном файле appsettings.ProdLinux.json правильно указан путь к стандартным скриптам, с помощью которых агент запускает процессы IDP:

"TrainProcess": {
  "ProcessFileName": "/app/Primo.AI/IDP/start_training.sh"
},
"InferenceProcess": {
  "ProcessFileName": "/app/Primo.AI/IDP/start_inference.sh"
},
"TestProcess": {
  "ProcessFileName": "/app/Primo.AI/IDP/start_evaluation.sh"
},

Запустите службы:

sudo systemctl start Primo.AI.Agent

Проверьте статус службы:

sudo systemctl status Primo.AI.Agent

Просмотрите журнал службы:

sudo journalctl -u Primo.AI.Agent

Настройка правила брандмауэра ufw

Для разрешения доступа к API агента выполните команду:

sudo ufw allow 5002/tcp

Установка IDP

Вариант установки A

Установка IDP при наличии в репозиториях apt целевой машины python3.10/3.11, выхода в интернет, а также GNU C Library (glibc) версии 2.33 и выше.

sudo mkdir -p /app/Primo.AI/IDP

sudo unzip /srv/samba/shared/install/A-IDP.zip -d /app/Primo.AI/IDP

sudo chmod -R 777 /app/Primo.AI/IDP

sudo apt install software-properties-common -y

sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt-get update | sudo apt install python3.11 python3.11-venv python3.11-dev libsm6 
libxext6 build-essential libssl-dev libffi-dev ffmpeg -y

python3.11 -m venv /app/Primo.AI/IDP/venv

source /app/Primo.AI/IDP/venv/bin/activate

python -m ensurepip --upgrade

pip3 install -r /app/Primo.AI/IDP/prequisites_xxx.txt	

sudo apt install git gcc g++

pip3 install 'git+https://github.com/facebookresearch/detectron2.git'

pip3 install -r /app/Primo.AI/IDP/requirements_xxx.txt

sudo chmod -R 771 /app/Primo.AI/IDP

sudo chown -R agent:primo-ai /app/Primo.AI/IDP

Вариант установки B

mkdir /tmp/pyenv

cd /tmp/pyenv 

sudo unzip /srv/samba/shared/install/B-pyenv.zip .

sudo chmod -R 771 .

sudo ./pyenv-installer.sh agent primo-ai  <custom_home_dir_location>

sudo rm  -r /tmp/pyenv

sudo mkdir /app/Primo.AI/IDP

cd /app/Primo.AI/IDP

sudo unzip /srv/samba/shared/install/B-IDP.zip 

sudo chmod -R 771 /app/Primo.AI/IDP

sudo ./idp-installer.sh agent primo-ai <custom_home_dir_location>

sudo chmod -R 771 /app/Primo.AI/IDP

sudo chown -R agent:primo-ai /app/Primo.AI/IDP

sudo rm -r /app/Primo.AI/IDP/idp-installer.sh /app/Primo.AI/IDP/venv.zip 

Вариант установки C

sudo mkdir -p install/idp-deps

yes | sudo unzip /srv/samba/shared/install/C-pkgs.zip -d install/idp-deps

sudo dpkg -i install/idp-deps/python3.11/*.deb

sudo dpkg -i install/idp-deps/python3.11-venv/*.deb

sudo dpkg -i install/idp-deps/python3.11-dev/*.deb

sudo dpkg -i install/idp-deps/ffmpeg/*.deb

which python3.11

sudo rm -r install/idp-deps

sudo mkdir /app/Primo.AI/IDP

cd /app/Primo.AI/IDP

sudo unzip /srv/samba/shared/install/C-IDP.zip 

python -m venv /app/Primo.AI/IDP/venv 

yes | sudo unzip /app/Primo.AI/IDP/venv.zip -d /app/Primo.AI/IDP/venv/

sudo rm /app/Primo.AI/IDP/venv.zip

sudo chmod -R 771 /app/Primo.AI/IDP

sudo chown -R agent:primo-ai /app/Primo.AI/IDP

Установка Tesseract

sudo apt policy tesseract-ocr
tesseract-ocr: 
 Установлен:                   (отсутствует) 
 Кандидат:   4.0.0-2~bpo9+1

sudo apt install tesseract-ocr

sudo mkdir -p install/idp-deps/tesseract-ocr

yes | sudo unzip /srv/share/C-pkgs.zip "tesseract-ocr/*" -d install/idp-deps/tesseract-ocr

sudo dpkg -i install/idp-deps/tesseract-ocr/*.deb

sudo rm -r install/idp-deps/tesseract-ocr

Проверка работоспособности

Создайте папку с тестовыми данными:

sudo mkdir -p install/idp-test

Распакуйте архивы с зависимостями:

yes | sudo unzip /srv/samba/shared/install/C-IDP-test.zip -d install/idp-test

Раздайте права:

sudo chown -R agent install/idp-test

sudo chmod -R 777 install/idp-test

Запустите IDP-процесс на тестовых данных:

/app/Primo.AI/IDP/start-inference.sh install/idp-test/Config/snils/1/config.json

Проверьте, что IDP-процесс сформировал корректные логи:

cat /app/Primo.AI/IDP/output.log

Теперь, когда IDP-модуль готов принимать изображения для распознавания, передайте ему тестовое изображение:

sudo cp install/idp-test/snils.jpg  install/idp-test/HotDir/snils/

Подождите немного, проверьте наличие файла с результатами:

cat install/idp-test/HotDir/snils/snils.jpg.result

Увеличение лимита потребления ресурсов

При большой нагрузке на целевую машину происходит открытие множества дескрипторов файлов, что приводит к ошибке – “Too many open files”. Необходимо увеличить системный лимит на количество дескрипторов, доступных пользователям. Для этого отредактируйте файл limits.conf:

sudo nano /etc/security/limits.conf

Добавьте туда следующие строки:

agent         hard    nofile      128000
agent         soft    nofile      128000

Что дальше

Выполните шаги, необходимые после установки компонентов.