ПО МАРТА — Контроль Операций

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

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

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

Рекомендуется выделенный сервер БД. Минимальные требования зависят от среднего количества операций (заявки + сделки) в день:

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

При объёме свыше 100 тыс. в день — требуется отдельное согласование.
Необходимый объём свободного места в БД (МБ): 500 + (Op/3 + 100*M + 150) * D

  • Op — среднее число операций в день (тыс.)
  • M — количество рынков, по которым загружаются данные
  • D — количество рабочих дней хранения данных в базе

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

4 CPU
8 GB RAM
HDD 80 GB
4 CPU
10 GB RAM
HDD 100 GB
6 CPU
12 GB RAM
HDD 120 GB

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

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

1.3. Программное обеспечение

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

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

  1. Linux (ядро 5.x+) + systemd + Java 21 (рекомендуется Axiom JDK)
  2. Linux (ядро 5.x+) + Docker 21+ + Docker Compose 2.x
  3. Windows + Java 21 (рекомендуется Axiom JDK)

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

2.1. Дистрибутив МАРТА

Директория installation содержит:

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

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

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

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

Шаг 2. Вариант СУБД

  • Вариант А — отдельно стоящий PostgreSQL (уже установлен и настроен)
  • Вариант Б — СУБД в Docker вместе с МАРТА

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

3.А. Инициализация отдельной БД

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

3.Б. БД в Docker

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

ℹ
Параметры по умолчанию:
Порт: 5432 | БД: MARTA | Пользователь: 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/MARTA/input/
sudo chown -R <user>:<group> /opt/MARTA/input/
⚠Убедитесь, что у сервиса есть права на чтение файлов.
xcopy installation\3-data\* "C:\MARTA\input\" /E /Y

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

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

sudo cp installation/4-license/* /opt/MARTA/license/
sudo chown -R <user>:<group> /opt/MARTA/license/
xcopy installation\4-license\* "C:\MARTA\license\" /E /Y

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

МАРТА:

sudo docker compose -f /opt/MARTA/docker-compose.yml up -d

МАРТА Data Agent:

sudo docker compose -f /opt/MARTA-data-agent/docker-compose.yml up -d

Управление: down / start / stop — передайте как последний аргумент вместо up -d.

МАРТА:

sudo systemctl start MARTA

МАРТА Data Agent:

sudo systemctl start MARTA-data-agent
  • Состояние: systemctl status MARTA
  • Остановить: systemctl stop MARTA
  • Автозапуск: systemctl enable MARTA

Запустите сервисы МАРТА и МАРТА Data Agent через компонент Службы Windows.

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

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

Логин: test

Пароль: test

10. Первоначальный анализ (Шаг 10)

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