Общая информация

Программное обеспечение OdgAssist (EQMS) предназначено для автоматизации и управления документацией в области качества. Под документацией понимаются:

• бумажные документы – заполняемые формы, бумажные журналы;
• электронные текстовые документы – инструкции, процедуры и т.д;
• электронные документы с функцией контроля – отклонения, изменения, CAPA и т.д.

Основная задача, которую решает odgAssist: контроль за правильной реализацией всех процессов, обеспечение актуальности информации и контроль за исполнением.

Рекомендуемые системные требования для программного комплекса odgAssist

Требования к аппаратному обеспечению сервера:

Рекомендовано использование RAID для обеспечения резервирования и повышения производительности базы данных.

Требования к программному обеспечению сервера:

• Операционная система: Linux Ubuntu 24.04 и выше
• Сервер базы данных: Postgresql 16 +
• Виртуальная машина: OpenJDK 8u502 +
• WEB сервер: Nginx 1.24.0 +
• Менеджер управления процессами: Supervisor 4.2.5 +
• Интерпретатор языка Python: Python 3.12.3

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

• Процессор: 4-х ядерный, 2ГГц
• Оперативная память 4ГБ
• Жесткий диск (SATA): 50Гб
• Операционная система: Windows 8/10/11
• Браузер: Google Chrome 154.0.8037.97 +
• Microsoft Office: Word, Excell 2016 +

+ допустима версия ПО выше указанной

Для обслуживания сервера сотрудниками исполнителя к нему необходим прямой доступ по ssh. Сервер должен иметь доступ в интернет.

Для работы приложения odgassist необходимы следующие программы:
-Postgres 16
-Nginx
-Supervisor
-Open jdk 8

Команды для установки требуемого программного обеспечения:
Обновить и установить пакеты программного обеспечения:

sudo apt-get update &&  sudo apt-get -y upgrade;

Установить openjdk:

sudo apt-get install -y openjdk-8-jdk

Проверить

 java -version 

Проверить наличие русской локали:

 locale -a | grep ru_RU  

Если локали нет — установить языковой пакет

  sudo apt-get install language-pack-ru;  

Сгенерировать локаль:

 sudo locale-gen ru_RU.UTF-8 

Перезапустить сервер для обновления локали.

 sudo apt install -y postgresql-16 postgresql-client-16 

Проверить статус

 sudo systemctl status postgresql 

Добавить базу данных для odgassist:

sudo -u postgres psql -c "CREATE DATABASE \"odgassist\" WITH OWNER \"postgres\" ENCODING 'UTF8' LC_COLLATE = 'ru_RU.UTF-8' LC_CTYPE = 'ru_RU.UTF-8' TEMPLATE template0;"
sudo -u postgres psql -c "ALTER USER postgres PASSWORD 'ваш_пароль';"

Установить nginx:

 sudo apt install -y nginx  

Проверить:

 sudo systemctl status nginx 

Установить supervisor:

 sudo apt -y install supervisor; 

Проверить статус:

 sudo systemctl status supervisor 

Добавьте пользователя runner:

sudo useradd -m -p $(openssl rand -base64 12) runner 

Добавьте необходимые директории для работы приложения odgassist:

sudo mkdir /home/dumps && chmod 777 /home/dumps;
sudo mkdir /etc/ssl/cuba && mkdir /etc/ssl/odg;
sudo mkdir /home/runner/cuba && chown runner:runner /home/runner/cuba;
sudo mkdir /home/cuba_jar && chmod 777 /home/cuba_jar;

Скачайте необходимые файлы для работы приложения odgassist:

wget https://wiki.odgassist.ru/lib/exe/fetch.php/odg_assist_5.0:app.jar
;
mv odg_assist_5.0:app.jar /home/runner/cuba/app.jar && chown runner:runner /home/runner/cuba/app.jar && chmod +x /home/runner/cuba/app.jar;
 wget https://wiki.odgassist.ru/lib/exe/fetch.php/odg_assist_5.0:nofileonserver.docx && mv odg_assist_5.0:nofileonserver.docx /srv/assist/nofileonserver.docx && sudo chown runner:runner /srv/assist/nofileonserver.docx ;

chown runner:runner /srv/assist/nofileonserver.docx;

nofileonserver.docx

Добавьте в конфигурацию supervisor файл /etc/supervisor/conf.d/cubaodg.conf:

[program:cuba]
command=java -Xms5G -Xmx5G -jar app.jar -port 9090
directory=/home/runner/cuba
stdout_logfile=/var/log/supervisor/cuba.log
stderr_logfile=/var/log/supervisor/cuba.log
autostart=true
user=runner

Обновите конфигурацию supervisor:

sudo supervisorctl reread && sudo supervisorctl update;
sudo supervisorctl status;

Статус приложения cuba должно быть RUNNING

После запуска приложения подождите 5 минут пока производится настройка базы данных.

Затем переходите к следующему этапу.