8. Справочник

Переменные, порты, драйверы, форматы, атрибуты

Атрибуты доменов

Назначение

Справочник атрибутов LDAP для сопоставления с полями пользователей Printum. Используйте эту таблицу при настройке раздела «Атрибуты» в карточке домена (Настройки → Интеграции → Домены).

Таблица атрибутов по контроллерам домена

Поле Printum Active Directory FreeIPA / Samba DC / РЕД АДМ ALD Pro
Логин (username) sAMAccountName uid uid
Идентификатор в домене (unique_id) objectSid uidNumber uidNumber
Фамилия (last_name) sn sn sn
Имя (first_name) givenName givenName givenName
Отчество (patronymic) personalTitle personalTitle rbtamiddlename
Email (email) mail mail mail
Доменные группы (domain_groups) memberOf memberOf memberOf
Должность (position) title title title
Путь к папке (smb_path) homeDirectory homeDirectory homeDirectory
Срок действия аккаунта (account_expires_at) accountExpires krbPrincipalExpiration krbPasswordExpiration
Параметры УЗ (user_account_control) UserAccountControl — —
Аккаунт заблокирован (account_lock) — nsAccountLock nsAccountLock

Примечания

Справочник переменных .env

Справочник переменных .env

Справочник переменных .env Мониторинга

Описание

Файл конфигурации Мониторинга находится по пути /opt/printum/.env. Переменные задаются при установке через параметры команды install.sh и могут быть изменены вручную после установки с последующим перезапуском контейнеров.

Подключение к базам данных

Переменная Значение по умолчанию Описание
POSTGRESQL_HOST встроенный Адрес сервера PostgreSQL (при подключении к внешней БД)
POSTGRESQL_PORT 5432 Порт PostgreSQL
POSTGRESQL_DATABASE printum Имя базы данных
POSTGRESQL_USER postgres Пользователь PostgreSQL
POSTGRESQL_PASSWORD — Пароль пользователя PostgreSQL
POSTGRESQL_SSLMODE — Режим SSL-соединения: allow,prefer,require,verify-ca,verify-full
POSTGRESQL_CERT_CA — Абсолютный путь до CA-сертификата (при verify-ca или verify-full)
CLICKHOUSE_HOST встроенный Адрес сервера ClickHouse (при подключении к внешней БД)
CLICKHOUSE_PORT 9000 Порт ClickHouse
CLICKHOUSE_DATABASE printum Имя базы данных ClickHouse
CLICKHOUSE_USER default Пользователь ClickHouse
CLICKHOUSE_PASSWORD — Пароль пользователя ClickHouse
CLICKHOUSE_SSL False Включить SSL для подключения к ClickHouse (True / False)
CLICKHOUSE_CERT_CA — Путь до CA-сертификата ClickHouse

Сетевые настройки и hostname

Переменная Значение по умолчанию Описание
MON_HOSTNAME — IP-адрес или hostname сервера Мониторинга. Используется при установке по доменному имени
IP_ADDRESS — IP-адрес сервера. Используется при установке по IP-адресу (альтернатива MON_HOSTNAME)

Диагностика и логирование

Переменная Значение по умолчанию Описание
LOG_LEVEL WARNING Уровень детализации логов: DEBUG, INFO, WARNING, ERROR

Смена паролей

При смене паролей необходимо обновить соответствующие переменные в .env файле и перезапустить контейнеры:

sudo docker-compose down
sudo docker-compose up -d
Переменная Описание
CLICKHOUSE_PASSWORD Пароль ClickHouse
REDIS_URL Строка подключения Redis с паролем: redis://:NEW-PASSWORD@redis:6379/0
REDIS_PASSWORD Пароль Redis
CACHEOPS_REDIS Строка подключения Redis для кэша: redis://:NEW-PASSWORD@redis:6379/1
Справочник переменных .env

Справочник переменных .env ПринтМенеджера

Описание

Файл конфигурации ПринтМенеджера находится по пути /opt/printmanager/.env. Просмотреть текущее содержимое:

sudo cat /opt/printmanager/.env

Подключение к базе данных PostgreSQL

Переменная Пример значения Описание
DATABASE_URL postgres://<login>:<password>@<host>:<port>/<database> Строка подключения к PostgreSQL в формате URL
DATABASE_HOSTNAME 127.0.0.1 IP-адрес или доменное имя сервера PostgreSQL
DATABASE_PORT 5432 Порт PostgreSQL
DATABASE_TABLESPACE — Табличное пространство (если отличается от значения по умолчанию)

Redis

Переменная Пример значения Описание
REDIS_URL redis://<password>:6379/0 Строка подключения к Redis
REDIS_PASSWORD redis Пароль Redis (при смене)
REDIS_ROLE master Роль узла Redis: master или slave
REDIS_SENTINEL_LIST 10.10.130.1,10.10.130.2,10.10.130.3 Список адресов Redis Sentinel (через запятую)
REDIS_MASTER_HOSTNAME 10.10.130.1 Адрес мастер-узла Redis
REDIS_MASTER_PORT 6379 Порт мастер-узла Redis

NFS (кластерная конфигурация)

Переменная Пример значения Описание
VOLUME_PATH /opt/printmanager/volumes Путь к директории томов
DRIVER_OPTS_TYPE nfs Тип драйвера хранилища: nfs или none
DRIVER_OPTS_O port=2049,nfsvers=4.2,addr=10.10.130.4,clientaddr=10.10.130.10,nolock,soft,rw Опции монтирования NFS. Для принудительного указания версии протокола добавить nfsvers=4
DRIVER_OPTS_DEVICE :/scratch Путь к директории на NFS-сервере (с ведущим :)

Сетевые настройки

Переменная Пример значения Описание
EXT_HOSTNAME pm.test Домен или адрес балансировщика (внешний адрес ПринтМенеджера)
PM_HOSTNAME 10.10.130.1 Адрес текущего сервера ПринтМенеджера
PM_HTTP_PORT 8010 Порт HTTP-подключения к панели администрирования ПМ
PM_HTTPS_PORT 8080 Порт HTTPS-подключения к панели администрирования ПМ

Смена паролей

После изменения переменных необходимо перезапустить контейнеры:

sudo docker-compose down
sudo docker-compose up -d
Переменная Описание
DATABASE_URL Обновить строку подключения: postgres://postgres:NEW-PASSWORD@db:5432/printmanager
CUPS_PASSWORD Пароль CUPS
FTP_SCAN_PASSWORD Пароль FTP для доставки сканов

Справочник контейнеров — где искать логи

Когда использовать

При диагностике проблем в Принтум — чтобы быстро определить, логи какого контейнера смотреть в зависимости от симптома.

Мониторинг

Контейнеры расположены в /opt/printum/. Команда для просмотра логов:

cd /opt/printum && sudo docker-compose logs <контейнер> --tail=200
Контейнер Назначение Когда смотреть Что искать в логах
printum_nginx HTTP/TCP-прокси; проксирует все соединения к приложению, отдаёт статику Ошибки при загрузке Личного кабинета или панели администратора; МФУ не добавляются в Мониторинг; нет синхронизации с ПринтМенеджером URL с ошибками; коды 4xx/5xx; ошибки запросов от Сетевого агента и ПринтМенеджера
printum_dashboard Личный кабинет (фронтенд) Ошибки при открытии Личного кабинета в браузере URL с ошибками; коды ответов; IP-адреса, вызывающие ошибки
printum_worker-default
printum_worker-high
printum_worker-low		 Celery-воркеры — фоновые задачи Мониторинга: отправка писем, обработка данных от МФУ Не приходят письма; не обновляется статус МФУ или ресурс деталей; данные появляются с задержкой; нет синхронизации с ПринтМенеджером Время запуска и завершения задач; ошибки периодических задач; задачи без завершения
printum_scheduler Планировщик Celery — отправляет задачи в очереди по расписанию Задачи по расписанию не выполняются (синхронизация с доменом, уведомления, обновление данных) Факт запуска задачи по расписанию; ошибки постановки в очередь
printum_backend API Мониторинга — все синхронные запросы Ошибки в Личном кабинете (действия не выполняются); проблемы с локациями; обмен данными с Локальным агентом Ошибки API-запросов; коды 4xx/5xx; проблемы валидации или логики
printum_clickhouse ClickHouse — аналитическая БД Нет статистики печати; проверка запуска сервиса Ошибки запуска БД
printum_redis Redis — брокер сообщений Мониторинга Проверка работоспособности сервиса Ошибки запуска сервиса
printum_postgres PostgreSQL — основная БД Мониторинга Проверка работоспособности сервиса Ошибки запуска БД

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

Контейнеры расположены в /opt/printmanager/. Команда для просмотра логов:

cd /opt/printmanager && sudo docker-compose logs <контейнер> --tail=200
Контейнер Назначение Когда смотреть Что искать в логах
printmanager_web Nginx — панель администратора ПринтМенеджера Нет синхронизации с Мониторингом URL с ошибками; коды 4xx/5xx
printmanager-celery Celery — фоновые задачи ПринтМенеджера: импорт МФУ, статистика, печать МФУ не импортируются из Мониторинга; задания печатаются с задержкой или не печатаются; ошибки установки Встроенного приложения Ошибки интеграции с Мониторингом; ошибки печати; ошибки соединения с CUPS
printmanager-celery-print-queue Очередь бесклиентской печати — опрашивает CUPS на наличие новых заданий Задания не попадают в очередь или попадают с задержкой Ошибки соединения с CUPS; ошибки обработки заданий из CUPS
printmanager-scheduler Планировщик Celery ПринтМенеджера Задания перестали приходить в очередь; задания гостевой или почтовой печати не обрабатываются; образы документов не появляются Факт запуска задачи; ошибки постановки в очередь
printmanager-app Основной контейнер — Django-приложение; обрабатывает все HTTP-запросы, авторизацию, МФУ, Клиент ПМ Проблемы с печатью, сканированием, копированием; проблемы с авторизацией; задания не доходят до МФУ; обмен с Клиентом ПМ Ошибки API-запросов; коды 4xx/5xx; ошибки валидации/логики/БД
printmanager-converter-server TCP-конвертер — принимает TCP-запросы и передаёт в printmanager-app по HTTP Проблемы с авторизацией по TCP (считыватели карт) Приходит ли сообщение от конвертера; номер карты от конвертера
printmanager-ftpd Временное FTP-хранилище файлов сканирования/копирования Задание копирования выполнено, но не распечатано; образ задания сканирования не появился в ПринтМенеджере Ошибки обработки образа документа
printmanager-db PostgreSQL — БД ПринтМенеджера Проверка работоспособности сервиса Ошибки запуска БД
printmanager-cups CUPS — сервер печати; обрабатывает всю отложенную печать Задания не распечатываются; недоступна панель CUPS (порт 1631) Ошибки работы сервиса; ошибки МФУ в CUPS. Примечание: Unable to encrypt connection: A TLS fatal alert — не ошибка системы, означает что клиент не является доверенным
printmanager-redis Redis — брокер ПринтМенеджера Single: проверка сервиса. HA: ноды ПринтМенеджера недоступны Single: ошибки запуска. HA: ошибки переключения master→slave
printmanager-redis-sentinel Redis Sentinel — только в схеме с балансировщиком Ноды ПринтМенеджера недоступны Ошибки переключения master→slave

Агенты и Клиент ПМ

Компонент Назначение Когда смотреть Где логи
Сетевой агент Сканирование сети и сбор данных с МФУ по SNMP МФУ не появляется в разделе «Инвентаризация → Устройства» journalctl -u printum-network-agent (Linux)
Локальный агент (Windows) Мониторинг заданий печати на Windows МФУ не появляется в Личном кабинете; нет статистики Просмотр событий Windows → Приложение
Локальный агент (Linux) Мониторинг заданий печати на Linux МФУ не появляется в Личном кабинете; нет статистики journalctl -u printum-local-agent
Клиент ПМ (Windows) Отправка заданий на печать с Windows АРМ Задание не появляется в очереди; МФУ не появляются на АРМ C:\ProgramData\printum\logs\
Клиент ПМ (Linux) Отправка заданий на печать с Linux АРМ Задание не появляется в очереди; МФУ не появляются на АРМ /var/log/printum/printmanager_client.log

Что приложить к заявке в ТП

Команды для сбора всех логов одной копипастой:

Мониторинг:

cd /opt/printum
bash logs.sh
# Или вручную:
sudo docker-compose logs --tail=500 > /tmp/monitoring_logs_$(date +%Y%m%d_%H%M).txt 2>&1
cat .version

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

cd /opt/printmanager
bash logs.sh
# Или вручную:
sudo docker-compose logs --tail=500 > /tmp/pm_logs_$(date +%Y%m%d_%H%M).txt 2>&1
cat .version

Конкретный контейнер:

# Мониторинг
cd /opt/printum && sudo docker-compose logs <контейнер> --tail=500

# ПринтМенеджер
cd /opt/printmanager && sudo docker-compose logs <контейнер> --tail=500

Клиент ПМ (Linux):

cat /var/log/printum/printmanager_client.log

К заявке приложить:

Карта системы Принтум

Описание

Большинство неисправностей в Printum связаны не с отдельным компонентом, а с разрывом потока данных между компонентами.

При диагностике необходимо сначала определить, к какой из областей относится проблема, а затем локализовать участок цепочки, на котором нарушена передача данных.

1. Путь задания печати

Используется для диагностики:

Печать через Клиент ПМ

Приложение
→ Локальная очередь печати
→ Клиент ПМ
→ ПринтМенеджер
→ Очередь заданий
→ CUPS
→ МФУ
→ Статистика в ПринтМенеджере
→ Статистика в Мониторинге

Бесклиентская печать

Приложение
→ Универсальный драйвер
→ CUPS ПринтМенеджера
→ ПринтМенеджер
→ Очередь заданий
→ CUPS
→ МФУ
→ Статистика в ПринтМенеджере
→ Статистика в Мониторинге

Что проверять по цепочке

Доходит ли задание до ПринтМенеджера?

Проверьте:

Если задания нет, проверьте:

Обработал ли задание ПринтМенеджер?

Проверьте:

Передал ли CUPS задание на устройство?

Проверьте:

Напечатало ли устройство задание?

Проверьте:

Обновилась ли статистика?

Проверьте:

2. Пользователи и права

Используется для диагностики:

Цепочка

Домен
→ Мониторинг
→ Пользователь + Роль + Правила
→ ПринтМенеджер
→ Принтер

Что проверять по цепочке

Видит ли Мониторинг пользователя?

Проверьте:

Попал ли пользователь в ПринтМенеджер?

Проверьте:

Назначилась ли роль?

Проверьте:

Применились ли правила?

Проверьте:

Выдались ли принтеры?

При использовании Клиента ПМ проверьте:

3. Мониторинг устройств

Используется для диагностики:

Цепочка

Устройство
→ SNMP
→ Сетевой агент
→ ClickHouse
→ Обработка данных
→ PostgreSQL
→ Личный кабинет
→ Отчёты

Что проверять по цепочке

Отвечает ли устройство по SNMP?

Проверьте:

Нашёл ли устройство агент?

Проверьте:

Попали ли данные на сервер?

Проверьте:

Обработались ли данные?

Проверьте:

Попали ли данные в интерфейс?

Проверьте:

4. Авторизация на МФУ

Используется для диагностики:

Цепочка авторизации по карте во встроенном приложении

Карта
→ Считыватель
→ Embedded App
→ ПринтМенеджер
→ Пользователь
→ Очередь заданий

Цепочка авторизации по карте через внешнее устройство автризации

Карта
→ Считыватель
→ TCP-конвертер
→ ПринтМенеджер
→ Пользователь
→ Очередь заданий

Цепочка авторизации по PIN

PIN
→ Embedded App
→ ПринтМенеджер
→ Пользователь
→ Очередь заданий

Что проверять по цепочке

Доходит ли идентификатор пользователя?

Для карты проверьте:

Для PIN проверьте:

Существует ли пользователь?

Проверьте:

Успешна ли авторизация?

Проверьте:

Получает ли пользователь очередь печати?

Проверьте:

Выполняется ли Fast Release?

Проверьте:

4. Сканирование в почту и сетевую папку

Используется для диагностики:

Цепочка сканирования в почту

Пользователь
→ Авторизация в Embedded App
→ Сканирование в почту
→ ПринтМенеджер
→ Почтовый сервер
→ Статистика в Мониторинге

Цепочка сканирования в сетевую папку

Пользователь
→ Авторизация в Embedded App
→ Сканирование в сетевую папку
→ ПринтМенеджер
→ Сервер сетевого хранилища файлов
→ Статистика в Мониторинге

Что проверять по цепочке

Существует ли пользователь?

Проверьте:

Успешна ли авторизация?

Проверьте:

Есть ли у пользователя доступ к приложению сканирования в почту\сетевую папку?

Проверьте:

Есть ли сетевая доступность между ПринтМенеджером и почтовым сервером\сервером хранилища файлов?

Проверьте:

Есть ли сетевая и ролевая доступность между пользователем и почтовым сервером\сервером хранилища файлов?

Проверьте:

Обновилась ли статистика?

Проверьте:

Поддерживаемые операционные системы

Назначение

Единый справочник поддерживаемых операционных систем для всех компонентов Printum. Требования к CPU/RAM/диску и остальные требования к инфраструктуре — в профильных статьях по каждому компоненту (ссылки в конце статьи).

Поддерживаются:

Серверные ОС

Серверные компоненты Printum (Мониторинг, ПринтМенеджер и HAProxy) поддерживаются только на Linux-системах из списка ниже.

Операционная система Версия
Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS
Astra Linux Special Edition 1.7 «Орёл» и 1.8 «Орёл»¹
Ред ОС 7.3 «МУРОМ», 8
Альт Сервер 10

¹ Ядро linux-5.10-generic или linux-5.15-generic; для конфигурации, где на сервере установлен только Мониторинг, дополнительно поддерживаются ядра linux-6.1.*-generic, linux-6.12.*-generic.

Рабочие станции — Клиент ПМ

Операционная система Версии
Windows 10, 11
Ред ОС 7.3 «МУРОМ», 8
Astra Linux Special Edition 1.7 «Орёл»
Альт Рабочая станция 10
macOS Catalina, Monterey

Рабочие станции — Локальный агент

Операционная система Версии
Windows 10, 11
Astra Linux Special Edition 1.7 «Орёл»¹
Ред ОС 7.3 «МУРОМ», 8
Альт Рабочая станция 10

¹ Ядро linux-X.X-generic.

ВМ для выделенного сетевого агента мониторинга

Операционная система Версии
Windows 7 x64 и выше
Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS
Astra Linux Special Edition 1.7 «Орёл»¹
Ред ОС 7.3 «МУРОМ», 8
Альт Сервер 10

¹ Ядро linux-X.X-generic.

Связанные статьи

Требования к серверам и сайзинг

Назначение

Сколько CPU, RAM и места на диске нужно серверам Printum зависит от компонента, конфигурации и нагрузки. Требования к подготовке инфраструктуры (репозитории, права доступа, сертификаты, снапшоты и т.д.) — в статье Подготовка инфраструктуры к установке. Список поддерживаемых серверных ОС — в статье Поддерживаемые операционные системы.

Поддерживаются три схемы установки, которые по-разному комбинируют компоненты из таблиц ниже:

Минимальные требования по компонентам

Сингл

Подходит для небольших инсталляций и пилотных внедрений.

Параметр Требование
CPU 8-ядерный 64-бит, с поддержкой SLAT, 2 ГГц или выше
RAM 16 ГБ; не менее 2 ГБ ОЗУ на каждое ядро CPU
Диск (корневой раздел) Не менее 160 ГБ

Мониторинг (отдельный сервер)

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

Параметр Требование
CPU 4-ядерный 64-бит, с поддержкой SLAT, 2 ГГц или выше
RAM 8 ГБ; не менее 2 ГБ ОЗУ на каждое ядро CPU
Диск (корневой раздел) Не менее 80 ГБ

ПринтМенеджер (отдельный сервер)

Используется для второго и последующих узлов в конфигурации Кластер Active-Active, а также для сервера на каждую локацию в конфигурации Филиальная сеть.

Параметр Требование
CPU 6-ядерный 64-бит, с поддержкой SLAT, 2 ГГц или выше
RAM 12 ГБ; не менее 2 ГБ ОЗУ на каждое ядро CPU
Диск (корневой раздел) Не менее 160 ГБ

HAProxy (балансировщик нагрузки)

Используется в конфигурации Кластер Active-Active.

Параметр Требование
CPU 2-ядерный
RAM 2 ГБ
Диск (корневой раздел) Не менее 32 ГБ
ОС Серверная ОС в минимальной конфигурации, без дополнительного ПО

Сайзинг Мониторинга по количеству устройств

Рекомендуемые ресурсы сервера и встроенных БД в зависимости от количества контролируемых устройств печати.

При необходимости базы данных могут быть вынесены на отдельные серверы.

Устройств CPU сервера RAM сервера CPU ClickHouse RAM ClickHouse CPU PostgreSQL RAM PostgreSQL
До 1 000 4 8 ГБ 4 8 ГБ 4 8 ГБ
1 000 — 4 999 6 12 ГБ 4 8 ГБ 4 8 ГБ
5 000 и более 8 16 ГБ 4 8 ГБ 4 8 ГБ

Сайзинг ПринтМенеджера по нагрузке

Single — односерверная конфигурация (Сингл). Cluster — конфигурация Кластер Active-Active.

Один сервер, соответствующий минимальным требованиям, обрабатывает до 100 среднестатистических заданий печати в минуту (PDF-файлы объёмом 2–3 страницы).

Конфигурация Заданий/мин Страниц/мин CPU ПМ RAM ПМ CPU PostgreSQL RAM PostgreSQL CPU HAProxy RAM HAProxy CPU NFS RAM NFS
Single 6 100 300 6 12 ГБ 4 8 ГБ — — — —
Single 8 130 390 8 16 ГБ 4 8 ГБ — — — —
Single 12 200 600 12 24 ГБ 6 12 ГБ — — — —
Single 16 260 780 16 32 ГБ 8 16 ГБ — — — —
Cluster 3×6 250 750 6 12 ГБ 10 20 ГБ 2 4 ГБ 4 8 ГБ
Cluster 3×8 330 990 8 16 ГБ 12 24 ГБ 2 4 ГБ 4 8 ГБ
Cluster 3×12 500 1 500 12 24 ГБ 18 36 ГБ 2 4 ГБ 4 8 ГБ
Cluster 3×16 665 1 995 16 32 ГБ 24 48 ГБ 2 4 ГБ 4 8 ГБ

Внешние базы данных

По умолчанию используются собственные БД: ClickHouse и PostgreSQL — для Мониторинга, PostgreSQL — для ПринтМенеджера. При необходимости поддерживается подключение к внешним БД.

Компонент БД Версия
Мониторинг PostgreSQL / Postgres PRO 15
Мониторинг ClickHouse 20
Мониторинг ADQM 24
ПринтМенеджер PostgreSQL / Postgres PRO 11.4

Внешняя база данных должна обеспечивать время отклика от серверов Printum в пределах 2–5 мс.

Связанные статьи

Требования к рабочим станциям пользователей

Назначение

Минимальные требования к рабочим станциям пользователей для установки Клиента ПМ и Локального агента, а также список ПО, конфликтующего с компонентами Printum. Перечень поддерживаемых ОС для обоих компонентов — в статье Поддерживаемые операционные системы.

Клиент ПМ

Клиент ПМ устанавливается на АРМ пользователя для печати через сервер управления печатью.

Параметр Требование
CPU Не менее 1 ГГц
RAM 4 ГБ для 64-разрядной системы
Диск 2 ГБ свободного места
ОС См. Поддерживаемые операционные системы

Локальный агент

Локальный агент устанавливается на АРМ пользователя для опроса локально подключённых (USB) устройств печати.

Параметр Требование
CPU Не менее 1 ГГц
RAM 4 ГБ для 64-разрядной системы
ОС См. Поддерживаемые операционные системы

Дополнительные требования для Windows

Конфликтующее ПО — удалить или отключить перед установкой

Клиент ПМ и Локальный агент могут конфликтовать со сторонними продуктами по управлению печатью. Перед установкой такое ПО следует удалить или полностью отключить:

Связанные статьи

Требования к ВМ для выделенного сетевого агента мониторинга

Назначение

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

Минимальные требования к ВМ

Параметр Требование
CPU 64-разрядный, от 1 ГГц
RAM 2 ГБ
Диск 200 МБ свободного места
ОС См. Поддерживаемые операционные системы

Требования к сетевой доступности

Требования к соединениям выделенного сетевого агента приведены в статье Требования к сетевой доступности и портам.

Примечания

Связанные статьи

Требования к сетевой доступности и портам

Назначение

Следующие сетевые соединения должны быть доступны для работы Printum:

Описание компонентов системы (Мониторинг, ПринтМенеджер, Сетевой агент, Клиент ПМ, HAProxy и т.д.) и типовых схем установки (Сингл, Кластер, Филиальная сеть) — в отдельной статье «Архитектурная схема и компоненты системы» (готовится, ссылка появится после публикации).

Дополнительно все используемые внешние ресурсы (базы данных семейства ClickHouse и PostgreSQL, домены, NFS-папка) должны иметь доступное соединение и открытые порты для подключения серверов Printum к ним.

Не используйте адреса из пула 10.28.32.0/26 — они зарезервированы внутренней сетью Printum.

Основные порты

Порт Направление Протокол Назначение в Printum
80 От пользовательских АРМ — к серверу HTTP Личный кабинет (нешифрованный)
443 От пользовательских АРМ — к серверу HTTPS Личный кабинет (шифрованное подключение)
80 От сервера — к принтерам и МФУ HTTP Установка и настройка встроенных приложений на МФУ
443 От сервера — к принтерам и МФУ HTTPS Установка и настройка встроенных приложений на МФУ (шифрованное подключение)
8000 От АРМ — к серверу; от ПринтМенеджера — к Мониторингу HTTP Панель администратора Мониторинга, синхронизация между компонентами
8001 От АРМ — к серверу; от ПринтМенеджера — к Мониторингу HTTPS Панель администратора Мониторинга, синхронизация (шифрованное подключение)
8010 От АРМ, МФУ — к серверу; от Мониторинга — к ПринтМенеджеру HTTP Панель администратора ПринтМенеджера, встроенные приложения, синхронизация
8080 От АРМ, МФУ — к серверу; от Мониторинга — к ПринтМенеджеру HTTPS Панель администратора ПринтМенеджера, встроенные приложения, синхронизация (шифрованное подключение)
1631 От АРМ — к серверу ПМ IPP Веб-интерфейс CUPS в ПринтМенеджере, отправка «прямой» печати на устройство
161, 162 От сервера — к принтерам и МФУ (UDP, двунаправленно) SNMP Опрос устройств Сетевым агентом, настройка встроенных приложений
20, 21 От МФУ — к серверу FTP (активный режим) Доставка заданий сканирования на сервер
30000–30199 От МФУ — к серверу FTP (пассивный режим) Доставка заданий сканирования на сервер
631 От сервера — к устройствам IPP Взаимодействие сервера управления печатью и МФУ
9100 От сервера — к устройствам RAW / JetDirect Взаимодействие сервера управления печатью и МФУ (альтернативный протокол печати)
8090 Внутрисерверное или между серверами Printum HTTP Прямое скачивание файлов из CUPS (нешифрованное)
8091 Внутрисерверное или между серверами Printum HTTPS Прямое скачивание файлов из CUPS (шифрованное)
22 От АРМ администратора — к серверу SSH Установка, обновление, диагностика, удалённое администрирование
25 От сервера — к почтовому серверу SMTP Отправка писем и уведомлений
993 От сервера — к почтовому серверу IMAP Гостевая печать через почтовый ящик
514, 1514, 1468 От сервера Мониторинга — к серверу syslog TCP/UDP Выгрузка событий журнала ИБ в syslog
32768–60999 От сервера — к любым внешним компонентам, включая другие серверы Printum TCP (эфемерные) Динамические порты для исходящих соединений (инициатор соединения)

Дополнительные порты для встроенных приложений и авторизации

Встроенные приложения (HP, Konica Minolta)

Порт Направление Протокол Вендор
7627 От сервера — к МФУ SOAP через HTTP HP
57627 От сервера — к МФУ Произвольный порт HP
50003 От сервера — к МФУ Произвольный порт Konica Minolta
50443 От сервера — к МФУ Произвольный порт Konica Minolta

TCP-конвертер

TCP-конвертер — это не встроенное приложение, а внешнее сетевое устройство для авторизации пользователей по карте на МФУ, у которых нет встроенного приложения.

Порт Направление Протокол Назначение
7776, 7777 От TCP-конвертеров — к серверу TCP/WS Авторизация встроенных приложений на МФУ через TCP-конвертер

Дополнительные порты для отказоустойчивой конфигурации с балансировкой нагрузки

Порт Направление Протокол Назначение в Printum
6379, 26379 Между серверами ПринтМенеджер TCP Redis Sentinel — кластер хранилища задач
7000 От АРМ администратора — к серверу с балансировщиком HTTPS Просмотр технической панели HAProxy

Требования к SNMP

Диагностика сети

Что открыть на firewall при внедрении

Набор портов зависит от схемы установки — см. таблицы выше.

Связанные статьи

Требования к сертификатам безопасности

Назначение

Состав, формат и обязательные атрибуты SSL-сертификатов для установки Printum. Набор файлов зависит от схемы установки:

Конфигурация Что требуется
Сингл Один комплект сертификатов (корневой + серверный + ключ) на весь сервер.
Кластер Active-Active Отдельный сертификат и ключ на каждый сервер, корневой сертификат общий.
Филиальная сеть Собственный сертификат на сервере каждого филиального ПринтМенеджера, корневой сертификат общий.

Использование автоматических сертификатов

Мониторинг и ПринтМенеджер могут генерировать самоподписанные сертификаты при установке, если не указано использование собственных. Использование автоматических сертификатов допустимо только для конфигурации Сингл.

При их использовании веб-браузеры будут показывать предупреждение о недоверии при входе в Личный кабинет и панели администратора. Для Кластера и Филиальной сети такие сертификаты не подходят — там требуется отдельный сертификат на каждый сервер (см. ниже).

Состав сертификатов

Сингл

Нужны три файла:

Файл Описание
ca.crt Корневой сертификат (CA)
server.crt Сертификат сервера
server.key Закрытый ключ сертификата сервера

Если используется промежуточный CA сертификат — он тоже должен быть передан отдельным файлом.

Кластер

Отдельный сертификат и ключ для каждого сервера (HAProxy, Мониторинг, каждый ПринтМенеджер, сервер БД + NFS). Все сертификаты должны быть выпущены одним корневым удостоверяющим центром (CA).

Требования к сертификатам для кластера

Пример комплекта сертификатов для развёртывания системы в конфигурации с балансировщиком, состоящей из 6 серверов:

Сервер Роль
Сервер 1 Балансировщик
Сервер 2 Мониторинг
Сервер 3 ПринтМенеджер №1
Сервер 4 ПринтМенеджер №2
Сервер 5 ПринтМенеджер №3
Сервер 6 База данных и NFS-хранилище

Необходимые файлы:

Филиальная сеть

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

Привязка сертификата

Должно соблюдаться соответствие между адресом сервера и адресом в выпускаемом сертификате: если система установлена по FQDN, а сертификат выпущен на IP или наоборот — возникнет ошибка Hostname mismatch.

Обязательные атрибуты

SSL-сертификат сервера должен соответствовать следующим требованиям:

Пример SAN для одного сервера:

DNS:server1.example.com
DNS:server1
IP:10.0.0.1

В кластере у каждого сервера — свой сертификат с собственным набором SAN (свои DNS-имена и IP); общий сертификат с одним SAN на весь кластер не используется.

Без SAN будет ошибка unable to get local issuer certificate.

Корневой сертификат (CA):

Формат

Типовые ошибки и их причины

Ошибка в логах Причина
Hostname mismatch Адрес сервера не совпадает с CN или SAN сертификата
ERR_CERT_COMMON_NAME_INVALID Адрес сервера не совпадает с CN или SAN сертификата
self signed certificate in certificate chain Содержимое CA включено в server.crt
unable to get local issuer certificate Отсутствует поле SAN в сертификате

Связанные статьи

Подготовка Astra Linux к установке Принтум

Назначение

Эта статья описывает, что дополнительно нужно сделать на сервере с Astra Linux Special Edition перед установкой Printum: настроить репозитории и установить необходимые пакеты. Статья дополняет общий чек-лист подготовки инфраструктуры — см. Подготовка инфраструктуры к установке, шаг 7.

Шаги подготовки

Настройте репозитории

Перед установкой Printum сервер должен иметь доступ к репозиториям Astra Linux. Откройте файл с настройками репозиториев:

sudo nano /etc/apt/sources.list

Закомментируйте строку, начинающуюся со слова cdrom, и раскомментируйте все остальные репозитории.

Если не удаётся сохранить /etc/apt/sources.list Причина — уровень целостности сессии терминала. Решение: выйдите из терминала, зайдите повторно и на вопрос Integrity Level укажите 63.

Установите пакеты

Установите пакеты для диагностики и администрирования сервера — они нужны независимо от способа установки:

sudo apt update
sudo apt install -y openssh-server htop mc curl wget

Если используете онлайн-установку Через curl сервер обращается к репозиторию Printum (https://download.printum.io) — убедитесь, что пакет установлен и есть сетевой доступ к этому адресу. При офлайн-установке пакеты ставятся из локального зеркала, настроенного на шаге выше.

Сделайте снапшот ВМ

После подготовки сервера рекомендуется создать снапшот виртуальной машины. Это позволит быстро вернуть систему в исходное состояние в случае ошибок при установке или настройке.

Связанные статьи

Подготовка к установке кластера Active-Active

Назначение

Подготовка инфраструктуры для установки отказоустойчивого кластера ПринтМенеджеров в конфигурации Active-Active.

Схема конфигурации

Балансировщик нагрузки

Для распределения нагрузки между узлами ПринтМенеджера используется внешний балансировщик. По умолчанию применяется HAProxy; при необходимости — сторонний балансировщик.

Серверы ПринтМенеджеров

Для отказоустойчивости при выходе из строя одного сервера требуется минимум три узла ПринтМенеджера. Количество серверов также зависит от ожидаемой нагрузки — подробный сайзинг см. в статье Требования к серверу и сайзинг.

Примечание: минимальное количество узлов рассчитывается по формуле T = 2F + 1, где T — общее количество серверов, F — число серверов, которые могут выйти из строя.

База данных и NFS-хранилище

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

Подготовьте актуальные дистрибутивы:

Шаги подготовки

Шаг 1. Создать серверы и назначить роли

Ниже приведён пример конфигурации кластера с тремя серверами ПринтМенеджера. Для других конфигураций подготовка выполняется аналогично, с добавлением новых серверов и указанием их адресов.

Создайте серверы на операционных системах, поддерживаемых Printum. Убедитесь, что каждый сервер соответствует минимальным техническим требованиям.

Каждый сервер предназначен для выполнения одной из следующих ролей:

Роль Адрес ПО
Балансировщик BALANCER_ADR HAProxy
Мониторинг и ПринтМенеджер 1 MPM_1 Мониторинг + ПринтМенеджер
ПринтМенеджер 2 PM_2 ПринтМенеджер
ПринтМенеджер 3 PM_3 ПринтМенеджер
База данных PostgreSQL и NFS-хранилище DB_NFS PostgreSQL + NFS

Шаг 2. Подготовить сертификаты

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

Шаг 3. Настроить DNS

Настройте DNS-имя для сервера балансировщика, указывающее на виртуальный IP-адрес (VIP).

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

После выполнения этой инструкции:

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

Установка компонентов кластера описана в разделе базы знаний «Установка» — статьи по базе данных и NFS, балансировщику, Мониторингу и ПринтМенеджерам.

Связанные статьи