Установка

Получение поставочного пакета, запуск установщика, enrollment и проверка health всех 14 сервисов.

Способ развёртыванияКоманды на этой странице относятся к поставке Docker Compose. Откройте соответствующую процедуру для Kubernetes и Helm.

Получение пакета

Поставочный архив massaccess-compose.tar.gz выдаётся в панели управления по адресу https://massaccess.net/dashboard/on-premise. Архив содержит данные установки, лицензирования, скрипты установки и обновления.

Предупреждение о блокировке лицензииНе изменяйте служебные файлы пакета перед запуском и не запускайте один и тот же пакет с лицензией на дополнительных локальных или тестовых экземплярах — это может привести к блокировке лицензии.

Запуск установщика

Распакуйте архив, перейдите в каталог и запустите install.sh с указанием манифеста:

bash
tar -xzf massaccess-compose.tar.gz
cd massaccess-compose
chmod +x install.sh
bash install.sh --manifest ./manifest.json

Предварительная проверка (--dry-run)

Режим --dry-run выполняет проверку окружения без изменения Docker: версии Docker Engine и Compose, Linux kernel, Bash/Python/curl, свободное место и порты 10001, 10002, 10011.

bash
bash install.sh --manifest ./manifest.json --dry-run

Что проверяет установщик

Перед загрузкой образов install.sh проверяет Docker daemon, Docker Engine 24.0+, Docker Compose v2.24+, Linux kernel 5.x+, Bash, Python 3, curl, базовые команды, свободное место и порты. CPU и RAM проверяются отдельно: при несоответствии установщик выводит требуемые и фактические значения и запрашивает явное подтверждение. Критические ошибки выводятся одним списком, и до их устранения установщик не загружает образы и не запускает Compose.

Активация

Установщик активирует подключение к сервису лицензирования. При отказе администратору выводится причина (подробности в разделе Диагностика).

Учётные данные для первого входа

В каталоге установки создаётся файл .env (права 600). Он содержит учётные данные для первого входа в панель управления: ADMIN_EMAIL (email администратора компании) и ADMIN_PASSWORD. Пароль установщик генерирует автоматически и один раз выводит в терминале в процессе установки — сразу после проверок окружения, затем сохраняет его в .env. Панель управления доступна по локальному адресу http://localhost:10011/web/login. Файл .env также содержит пароли и секреты сервисов платформы — храните его в защищённом месте.

Проверка здоровья платформы

После установки проверьте состояние всех сервисов платформы скриптом healthcheck.sh, затем откройте панель управления по адресу http://localhost:10011/web/login и войдите с данными из раздела «Учётные данные для первого входа».

Предупреждение о блокировке лицензииНе запускайте установочный пакет с одной лицензией на нескольких экземплярах одновременно. Установщик не удаляет существующие контейнеры и volumes; если проект ms-onprem уже существует, установка завершается с ошибкой — для обновления используйте upgrade.sh.