ПринтМенеджер

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

Цель

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

Предусловия

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

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

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

ssh username@ip_address

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

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

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

Если требуется задать пароль администратора ПринтМенеджера на этапе установки:

export PM_ADMIN_PASSWORD=<пароль>

Пароль можно задать и позже.

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

Если требуется установить ПринтМенеджер с нестандартными портами:

export PM_HTTP_PORT=x

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

export PM_HTTPS_PORT=x

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

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

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

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

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

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

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

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

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

Для установки ПринтМенеджера на выделенный сервер (отдельно от Мониторинга) добавьте в команду установки переменную 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-адрес сервера мониторинга.

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

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

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

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

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

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

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

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

Цель

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

Предусловия

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

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

Шаг 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 минут.

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

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

Примечание

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

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

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

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

Цель

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

Предусловия

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

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

Шаг 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> — доменное имя сервера.

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

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

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

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

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

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

Цель

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

Предусловия

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

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

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

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

Зайдите на сервер по 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

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

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

Убедитесь, что команда вывела printmanager-x.y.z.tar.gz: OK.

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

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

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

Если вы устанавливаете систему с собственными сертификатами, то дополнительно укажите при установке параметры:

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

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

sudo PM_HOSTNAME=<ip> SSL_CERT=/home/user/client.crt SSL_KEY=/home/user/client.key SSL_CERT_CA=/home/user/ca.crt -E ./install.sh

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

sudo PM_HOSTNAME=<hostname> SSL_CERT=/home/user/client.crt SSL_KEY=/home/user/client.key SSL_CERT_CA=/home/user/ca.crt -E ./install.sh

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

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

sudo -E MONITORING_ADDRESS=<mon_hostname_or_ip> PM_HOSTNAME=<hostname> SSL_CERT=/home/user/client.crt SSL_KEY=/home/user/client.key SSL_CERT_CA=/home/user/ca.crt -E ./install.sh

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

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

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

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

Примечание

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

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

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

Установка ПринтМенеджера — подключение к внешней PostgreSQL

Цель

Установить ПринтМенеджер с подключением к внешней базе данных PostgreSQL вместо встроенной.

Предусловия

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

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

Шаг 1. Сформировать строку DATABASE_URL

Чтобы установить систему с подключением к внешней базе, помимо прочих параметров, добавьте в команду установки параметр DATABASE_URL. Это строка настроек для подключения к базе ПринтМенеджера PostgreSQL в формате URL.

Указывается в следующем формате:

DATABASE_URL=postgres://<POSTGRES_LOGIN>:<POSTGRES_PASSWORD>@<DB_HOST>:<PORT>/<BASE_NAME>?currentSchema=<POSTGRES_SCHEMA>

где:

Шаг 2. Добавить DATABASE_URL в команду установки

Добавьте параметр DATABASE_URL к выбранной команде установки (онлайн или офлайн, с автоматическими или собственными сертификатами). Пример для онлайн-установки с автоматическими сертификатами:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip> DATABASE_URL=postgres://<POSTGRES_LOGIN>:<POSTGRES_PASSWORD>@<DB_HOST>:<PORT>/<BASE_NAME> bash

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

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

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

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

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

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

Цель

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

Предусловия

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

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

Шаг 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. Ввести пароль повторно

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

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

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

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

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

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

Установка филиального ПринтМенеджера

Цель

Установить дополнительный филиальный сервер ПринтМенеджера, подключённый к центральному Мониторингу.

Предусловия

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

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

Шаг 1. Запустить установку филиального ПринтМенеджера

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

Для подключения дополнительных филиальных серверов необходимо использовать собственные сертификаты.

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

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

где:

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

Среднее время установки — 10–20 минут.

Шаг 3. Настроить синхронизацию

Филиальные ПМы получают информацию о пользователях при синхронизации с Мониторингом. Данные, импортированные из контроллера домена, также будут передаваться из Мониторинга в филиальный ПринтМенеджер (например, номера карт авторизации или адреса папок для сканирования). Если пользователи в филиале самостоятельно привязывают свои карты авторизации, то номера карт сохраняются в филиальном ПМе.

Для настройки синхронизации обратитесь к разделу «Интеграция с ПМами».

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

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

Примечание

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

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

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

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

Цель

Выполнить первый вход в систему после установки ПринтМенеджера и проверить корректность работы.

Предусловия

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

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

Среднее время установки приложения составляет 10–20 минут, в зависимости от выбранного способа установки и скорости сетевого соединения. После установки приложения выводится информация с URL-адресом панели администратора. Например:

Printum ПринтМенеджер has been successfully installed! Visit https://100.0.131.92:8080

Шаг 2. Открыть панель администратора

По указанной ссылке будет доступна техническая панель администратора ПринтМенеджера («зелёная админка»). Она доступна по адресу:

https://<ip_address>:8080/config/

Шаг 3. Авторизоваться в панели администратора

Авторизоваться в панели администратора ПринтМенеджера можно, используя логин и пароль от учётной записи администратора по умолчанию:

Если при установке был изменён пароль через переменную PM_ADMIN_PASSWORD, используйте этот пароль для входа под данным пользователем.

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

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

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

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

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