Установка ПринтМенеджера — офлайн, автоматические сертификаты

Цель

Установить ПринтМенеджер на сервер без выхода в интернет с использованием автоматически генерируемых системой SSL-сертификатов.

Предусловия

Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
Подключение к серверу по SSH под пользователем root.
Доступен компьютер с выходом в интернет для скачивания дистрибутива.
Установлен scp или другой инструмент для передачи файлов.

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

Дистрибутив ПринтМенеджера: printmanager-x.y.z.tar.gz и printmanager-x.y.z.tar.gz.sha512.
IP-адрес сервера или доменное имя (хостнейм).
При желании — пароль для суперпользователя.

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

Шаг 1. Скачать дистрибутив

Скачайте дистрибутив с нужной версией на компьютер с выходом в интернет.

Шаг 2. Создать папку на сервере и передать файлы

Зайдите на сервер по SSH и создайте папку:

mkdir /root/dist_pm

Перепишите файлы со своего компьютера на сервер:

scp printmanager-x.y.z.tar.gz root@<ip>:/root/dist_pm
scp printmanager-x.y.z.tar.gz.sha512 root@<ip>:/root/dist_pm

где <ip> — IP-адрес вашего сервера, x.y.z — версия ПринтМенеджера.

Шаг 3. Проверить целостность архива

Зайдите на сервер по SSH от имени root и выполните:

cd /root/dist_pm
sha512sum -c printmanager-x.y.z.tar.gz.sha512

Команда sha512sum проверит целостность скачанного архива. Убедитесь, что команда вывела на экран printmanager-x.y.z.tar.gz: OK, иначе остановите подготовку к установке и обратитесь в службу технической поддержки.

Шаг 4. Распаковать архив и подготовить скрипт

tar xvf printmanager-x.y.z.tar.gz
cd printmanager-x.y.z
chmod u+x ./install.sh

где x.y.z — ваша версия ПринтМенеджера.

Шаг 5. (Опционально) Задать пароль суперпользователя

export PM_ADMIN_PASSWORD=x

где x — новый пароль.

Шаг 6. (Опционально) Задать нестандартные порты

export PM_HTTP_PORT=x

где x — порт для протокола http.

export PM_HTTPS_PORT=x

где x — порт для протокола https.

Шаг 7. Запустить установку

Установка с адресацией по IP-адресу и с использованием автоматических сертификатов:

sudo PM_HOSTNAME=<ip> ./install.sh

где <ip> — IP-адрес сервера. Не используйте адреса из пула 10.28.32.0/26, они нужны внутренней сети.

Установка с адресацией по доменному имени и с использованием автоматических сертификатов:

sudo PM_HOSTNAME=<hostname> ./install.sh

где <hostname> — доменное имя сервера.

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

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

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

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

Next steps

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

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

sha512sum выдал ошибку — архив повреждён при передаче; скачать заново и повторить проверку; при повторной ошибке обратиться в службу технической поддержки.
Permission denied при запуске install.sh — выполнить chmod u+x ./install.sh перед запуском установки.
Авторизация на панели администратора не проходит — если при установке задавался PM_ADMIN_PASSWORD, использовать его вместо пароля по умолчанию printum.
Адрес из пула 10.28.32.0/26 — эти адреса используются внутренней сетью; выбрать другой IP-адрес сервера.