ПО МАРТА — Списки Инсайдеров

Инструкция по установке

1. Системные требования

1.1. Сервер базы данных

Минимальные требования к аппаратным ресурсам сервера БД:

2 CPU
6 GB RAM
HDD (см. формулу ниже)

Необходимый объём свободного места в БД (МБ): 500 + 0.4 * I

  • I — количество инсайдеров в системе

1.2. Сервер приложений

Минимальные требования:

2 CPU
4 GB RAM
HDD 2 GB

Необходимый объём свободного места на диске (ГБ): 20 + l * K + F

  • l — средний объём лог-файлов за один день (от 200 Кб до 50 Мб)
  • K — количество дней хранения лог-файлов (по умолчанию не ограничен)
  • F — общий объём приложенных файлов к контрагентам

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

СУБД: PostgreSQL (в т.ч. PostgreSQL Pro Standard или Enterprise) версии 11.6 и выше. Рекомендуется версия 14.5 и выше.

Сервер приложений — одна из следующих конфигураций:

  1. ОС Linux с ядром 5.x и выше + systemd + Java (JRE или JDK) версии 21. Рекомендуется дистрибутив Axiom JDK.
  2. ОС Linux с ядром 5.x и выше + Docker версии 21 и выше + Docker Compose версии 2.x.
  3. ОС Windows + Java (JRE или JDK) версии 21. Рекомендуется дистрибутив Axiom JDK.

2. Состав дистрибутива

Дистрибутивы полной установки сервиса МАРТА (директория installation) включают в себя следующие директории:

  • 1-database — скрипты БД для начального создания и инициализации базы данных, а также Docker-образ БД с включёнными скриптами инициализации.
  • 2-marta — дистрибутивы сервиса МАРТА для установки в качестве Docker-контейнера, сервиса systemd Linux или сервиса Windows.
  • 3-data — набор файлов с данными для первоначальной загрузки в сервис.
  • 4-license — файл с лицензией.

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

Шаг 1. Выбор способа установки сервиса

Выберите один из вариантов развёртывания:

  • Docker-контейнер — рекомендуемый вариант для Linux.
  • Linux daemon (systemd) — установка как системного сервиса Linux без Docker.
  • Windows сервис — установка в операционной системе Windows.

Шаг 2. Выбор СУБД

Выберите один из вариантов развёртывания базы данных:

  • Отдельно стоящая СУБД PostgreSQL — СУБД уже установлена и настроена на отдельном сервере (см. пункт 4, вариант А).
  • Развёртывание СУБД из приложенного Docker-образа — БД разворачивается в Docker вместе с МАРТА (см. пункт 4, вариант Б).

4. Создание базы данных (Шаг 3)

3.А. Инициализация отдельной базы данных

⚠Предполагается, что СУБД PostgreSQL уже установлена и настроена на отдельном сервере.
  1. Создайте пустую базу данных:
    create database МАРТА encoding 'UTF-8';
  2. Выполните все скрипты из директории installation/1-database/sql в порядке возрастания их имени в созданной БД.
  3. Выполните иные скрипты, предоставленные компанией Мар Солюшенз (при наличии), для установки первоначальных настроек.
  4. При необходимости добавьте пользователей в созданную роль МАРТА_service.

3.Б. Установка базы данных в Docker вместе с МАРТА

Дополнительных действий не требуется — БД будет развёрнута автоматически в ходе установки сервиса.

ℹ
Параметры подключения к БД по умолчанию:
Адрес сервера: соответствует адресу сервера МАРТА
Порт: 5432  |  Имя БД: МАРТА  |  Пользователь: postgres  |  Пароль: postgres

5. Установка сервиса МАРТА (Шаг 4)

⚠Важно! После установки сервис не запускать — сначала выполните шаги 6 и 7.
🔥Рекомендуем прочесть всю инструкцию перед установкой.
!Требуется Docker 21+ и Docker Compose 2+.
!Скрипты разработаны для bash. Требуются root-привилегии (пакет sudo).
ℹПуть установки: /opt/MARTA. Файлы БД (при совместной установке): /opt/MARTA/db.
  1. Скопируйте директорию installation на сервер.
  2. Проверьте наличие отдельного пользователя и группы для работы сервиса. Рекомендуемые UID/GID: 1024.
  3. sudo chown -R root:root {путь к директории installation}
  4. sudo chmod +x {путь к installation/2-MARTA/docker/install.sh}
  5. sudo bash {путь к installation/2-MARTA/docker/install.sh}
  6. Следуйте инструкциям скрипта:
    • y/Y — да; n/N — нет; ответы по умолчанию — в скобках.
    • На вопрос об установке БД в Docker ответьте согласно выбранному варианту.
  7. После выполнения скрипта:
    • Проверьте корректность настроек в /opt/MARTA/docker-compose.yml.
  8. sudo rm -rf {путь к директории installation}
⚠Сервис на этом этапе не запускать.
🔥Рекомендуем прочесть всю инструкцию перед установкой.
!Требуется Java 21 (рекомендуется Axiom JDK). Скрипты для bash. Нужны root-привилегии.
!Скрипты разработаны для bash. Требуются root-привилегии (пакет sudo).
ℹПуть установки: /opt/MARTA.
  1. Скопируйте директорию installation.
  2. Проверьте наличие отдельного пользователя и группы для работы сервиса. Рекомендуемые UID/GID: 1024.
  3. sudo chown -R root:root {путь к директории installation}
  4. sudo chmod +x {путь к installation/2-MARTA/linux_daemon/install.sh}
  5. sudo bash {путь к installation/2-MARTA/linux_daemon/install.sh}
  6. Следуйте инструкциям. Рекомендуемые UID/GID: 1024.
  7. sudo rm -rf {путь к директории installation}
⚠Сервис на этом этапе не запускать.
🔥Рекомендуем прочесть всю инструкцию перед установкой.
!Требуется Java 21 (рекомендуется Axiom JDK).
ℹПуть установки: C:\Program Files\MARTA. Рабочая директория: C:\MARTA.
  1. Скопируйте директорию installation.
  2. Если Java не создаёт системных переменных — в файле installation\2-MARTA\windows_service\resources\install_service.bat задайте путь к jvm.dll (параметр Jvm). По умолчанию auto.
  3. Запустите install.bat из installation\2-MARTA\windows_service.
  4. Задайте параметры БД (spring.datasource.*) в конфигурационном файле C:\Program Files\МАРТА\config\МАРТА.properties
  5. Удалите директорию installation.
⚠Сервис на этом этапе не запускать.

6. Копирование тестовых данных (Шаг 5)

Скопируйте все файлы из директории installation/3-data в папку {директория установки сервиса}/input.

sudo cp -r installation/3-data/* /opt/МАРТА/input/
sudo chown -R <пользователь_сервиса>:<группа_сервиса> /opt/МАРТА/input/
⚠При копировании в Linux необходимо корректно задавать владельца и группу файлов, чтобы у сервиса был к ним доступ.
xcopy installation\3-data\* "C:\МАРТА\input\" /E /Y

7. Копирование файла лицензии (Шаг 6)

Скопируйте файл лицензии из директории installation/4-license в папку {директория установки сервиса}/license.

sudo cp installation/4-license/* /opt/МАРТА/license/
sudo chown -R <пользователь_сервиса>:<группа_сервиса> /opt/МАРТА/license/
xcopy installation\4-license\* "C:\МАРТА\license\" /E /Y

8. Запуск сервиса (Шаг 7)

Запуск сервиса МАРТА:

sudo docker compose -f /opt/МАРТА/docker-compose.yml up -d

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

  • Остановить и удалить: sudo docker compose -f /opt/МАРТА/docker-compose.yml down
  • Запустить ранее созданный: sudo docker compose -f /opt/МАРТА/docker-compose.yml start
  • Остановить: sudo docker compose -f /opt/МАРТА/docker-compose.yml stop

Запуск сервиса МАРТА:

sudo systemctl start МАРТА

Прочие команды:

  • Проверить состояние: systemctl status МАРТА
  • Остановить: systemctl stop МАРТА
  • Включить автозапуск: systemctl enable МАРТА
  • Отключить автозапуск: systemctl disable МАРТА

Запустите сервис МАРТА с помощью компонента управления Службами Windows.

9. Вход в систему (Шаги 8–9)

Откройте веб-браузер и перейдите по адресу http://localhost:8080.

Для входа используйте следующие учётные данные:

Логин: test

Пароль: test

10. Начало работы со списком инсайдеров (Шаг 10)

  1. Дождитесь завершения импорта тестовых данных (статус можно отслеживать в интерфейсе системы).
  2. Перейдите в раздел «Списки инсайдеров» и начните работу с загруженными данными.
✓Установка завершена! Для ознакомления с функциональностью модуля ПО МАРТА обратитесь к Руководству пользователя.
Все права защищены. ООО «МАР Солюшенз».