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

Цель

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

Предусловия

• Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
• Сервер имеет выход в интернет и доступ к https://s3.printum.io.
• Подключение к серверу по SSH под пользователем с правами sudo.
• Установлен curl.
• Подготовлены собственные SSL-сертификаты.

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

• IP-адрес сервера или доменное имя (хостнейм).
• Файл сертификата: <client.crt>.
• Ключ сертификата: <client.key>.
• СА сертификат: <ca.crt>.
• При желании — пароль для суперпользователя.

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

Шаг 1. Подключиться к серверу по SSH

ssh username@ip_address

Где username —логин пользователя на сервере, а ip_address — адрес удаленного сервера.

После ввода этой команды нужно будет ввести пароль от учетной записи для подключения.

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

export PM_ADMIN_PASSWORD=<пароль>

Шаг 3. Запустить установку с собственными сертификатами

Можно указать полный путь к файлу или только имя файла, если запускаете установку из директории с сертификатами.

Установка с адресацией по IP-адресу и с собственными сертификатами:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip> SSL_CERT=client.crt SSL_KEY=client.key SSL_CERT_CA=ca.crt bash

Установка с адресацией по доменному имени и с собственными сертификатами:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<hostname> SSL_CERT=client.crt SSL_KEY=client.key SSL_CERT_CA=ca.crt bash

Шаг 4. (Опционально) Установка на выделенный сервер

Для установки ПринтМенеджера на выделенный сервер добавьте переменную MONITORING_ADDRESS:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E MONITORING_ADDRESS=<mon_hostname_or_ip> PM_HOSTNAME=<hostname> bash

где <mon_hostname_or_ip> — доменное имя или IP-адрес сервера мониторинга.

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

Шаг 5. Дождаться завершения установки

При установке автоматически происходит сравнение чек-суммы (алгоритм sha512) скачанного архива. Среднее время установки — 10–20 минут.

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

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

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

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

Примечание

• По окончании срока действия сертификат потребуется заменить. Инструкция в разделе «Обновление сертификатов».

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

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

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

• Браузер сообщает об ошибке сертификата — убедиться, что CA-сертификат добавлен в доверенные на клиентских машинах; при использовании разных серверов обязателен единый корневой CA для Мониторинга и ПринтМенеджера.
• Нет доступа к https://s3.printum.io — проверить интернет-соединение; при отсутствии доступа использовать офлайн-установку.
• Авторизация не проходит — если задавался PM_ADMIN_PASSWORD, использовать его вместо printum.
• Установка на отдельный сервер (не на тот же, что Мониторинг) — обязательно добавить переменную MONITORING_ADDRESS=<mon_hostname_or_ip> в команду установки.

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

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