Установка ПринтМенеджера — шифрование конфигурационного файла

Цель

Установить ПринтМенеджер с активацией шифрования конфигурационного файла для защиты чувствительных данных конфигурации.

Предусловия

• Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
• Подготовлены команды для онлайн- или офлайн-установки ПринтМенеджера.

Что потребуется

• IP-адрес сервера.
• Пароль шифрования для переменной ENV_VAULT_PASSWORD.

Шаги установки

Шаг 1. Выбрать способ установки и добавить переменную шифрования

Для активации шифрования конфигурационного файла при установке ПринтМенеджера необходимо дополнительно задать переменную ENV_VAULT_PASSWORD.

Шаг 2. Установка с шифрованием

Онлайн установка:

Подключитесь к серверу по SSH и выполните команду:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip> ENV_VAULT_PASSWORD=<password> bash

Офлайн установка: 

Перейдите в каталог с установочным скриптом и выполните команду:

sudo PM_HOSTNAME=<ip> ENV_VAULT_PASSWORD=<password> -E ./install.sh

Шаг 3. Ввести пароль повторно

В процессе установки необходимо будет повторно ввести пароль.

Ожидаемый результат

• Установка завершается без ошибок.
• Конфигурационный файл ПринтМенеджера зашифрован.
• Панель администратора («зелёная админка») доступна по адресу https://<ip_address>:8080/config/.

Как проверить установку

• Открыть в браузере URL панели администратора ПринтМенеджера.
• Авторизоваться с учётными данными по умолчанию: логин printum, пароль printum.

Следующие шаги

• «Завершение установки ПринтМенеджера — первый вход и проверка»
• «Обновление сертификатов»

Типовые ошибки

• Пароли не совпадают при повторном вводе — в процессе установки система запросит повторный ввод ENV_VAULT_PASSWORD; ввести точно тот же пароль.
• Пароль шифрования утерян — конфигурационный файл не может быть расшифрован без ENV_VAULT_PASSWORD; пароль необходимо сохранить в защищённом месте.
• sha512sum выдал ошибку (при офлайн-установке) — архив повреждён; скачать заново или обратиться в поддержку.

Связанные страницы

• Требования к серверу для установки Принтум
• Установка ПринтМенеджера — онлайн, автоматические сертификаты
• Установка ПринтМенеджера — офлайн, автоматические сертификаты
• Завершение установки ПринтМенеджера — первый вход и проверка