ПринтМенеджер
- ПринтМенеджер — справка по компоненту
- Как Принтум использует CUPS
- Как работают правила печати
- Как устроена очередь заданий
- Драйверы и печатный конвейер в Принтум
- Теневое копирование и архив заданий
ПринтМенеджер — справка по компоненту
Назначение
ПринтМенеджер — опциональный модуль управления печатью. Подключается к Мониторингу и обеспечивает управление заданиями, авторизацию на МФУ, правила, квоты, архив документов.
Основные функции
- Хранение заданий в персональной очереди пользователя
- Авторизация на МФУ по карте, PIN или доменной учётной записи
- Сбор статистики печати, копирования, сканирования по пользователям и отделам с последующей отправкой в Мониторинг
- Зашифрованный архив документов
- Правила печати и квоты
- Сканирование в почту и сетевую папку
Где настраивается
Панель администратора ПринтМенеджера:
https://<адрес>:8080/config/
Учётные данные по умолчанию
- Логин: printum / Пароль: printum
Путь установки и ключевые файлы
| Файл | Назначение |
|---|---|
| /opt/printmanager/.env | Переменные окружения |
| /opt/printmanager/.version | Версия ПринтМенеджера |
| /opt/printmanager/docker-compose.yml | Docker-стек |
| /opt/printmanager/logs.sh | Скрипт сбора логов |
| /opt/printmanager/backup.sh | Скрипт создания бэкапа |
Контейнеры Docker
| Контейнер | Роль |
|---|---|
| printmanager_web | Панель администратора, NGINX. |
| printmanager-app | Выполнение приложений ПМ, django-приложение панели администратора. |
| printmanager-celery | Фоновые задачи: синхронизация, импорт, статистика. |
| printmanager-celery-print-queue | Обработка прямой и отложенной очереди бесклиентской печати. |
| printmanager-cups | Сервер печати CUPS — обработка и отправка заданий. |
| printmanager-scheduler | Планировщик задач. |
| printmanager-redis | Redis-брокер. |
| printmanager-redis-sentinel | Часть Redis, существует только в схеме с балансировкой. |
| printmanager-converter-server | TCP-конвертер сервер для работы внешней авторизации. |
| printmanager-ftpd | Временное хранилище для обмена файлами сканирования\копирования с некоторыми принтерами. |
| printmanager-db | База данных PostgreSQL. |
Когда используется
ПринтМенеджер устанавливается для управления процессами авторизации во встроенных приложениях, печати, копирования и сканирования, сбора статистики по пользователям и отделам, архиву документов, квотам и правилам.
Может работать совместно с Мониторингом на одном сервере (конфигурация Сингл) или на отдельном сервере (Сплит). Для высокой доступности — несколько узлов в конфигурации Кластер Active-Active. Для удалённых площадок — Филиальный ПМ.
Связанные компоненты
- Мониторинг — управляющий центр; ПринтМенеджер синхронизируется с ним раз в час.
- Клиент ПМ — устанавливается на рабочие станции, отправляет задания на ПМ.
- Docker — среда выполнения контейнеров ПМ.
- HAProxy — балансировщик нагрузки в кластерной конфигурации.
- NFS — общее хранилище заданий в кластерной конфигурации.
Типовые проблемы
| Проблема | Причина | Решение |
|---|---|---|
| Задания не появляются в очереди печати | Клиент ПМ не подключается к серверу, неверный токен доступа | Проверить PM_ACCESS_TOKEN в настройках Клиента ПМ; убедиться, что порт 8080 доступен |
| Файл недоступен при отложенной печати (кластер) | NFS-хранилище недоступно или неверно настроено | Проверить DRIVER_OPTS_DEVICE, DRIVER_OPTS_O, DRIVER_OPTS_TYPE в /opt/printmanager/.env |
| FATAL: sorry, too many clients already | Превышен лимит подключений к PostgreSQL | Увеличить max_connections по формуле: (3×N + 70) × T |
Что диагностировать перед эскалацией
- Уточнить версию ПринтМенеджера:
cat /opt/printmanager/.version
- Проверить статус контейнеров (активны, неактивны, перезапускаются):
cd /opt/printmanager && docker-compose ps
- Собрать логи:
sudo bash /opt/printmanager/logs.sh
- Проверить свободное место на диске сервера и самые объёмные каталоги в разделе /:
sudo df -h
sudo du -h --max-depth=1 / | sort -hr
- Доступность БД и NFS (в кластерной конфигурации)
Связанные страницы
Как Принтум использует CUPS
Описание
CUPS (Common Unix Printing System) используется ПринтМенеджером для приёма и передачи заданий печати на устройства. CUPS является частью пути задания при прямой и отложенной печати в обоих сценариях — через Клиент ПМ и при бесклиентской печати. Где участвует CUPS:
- При бесклиентской печати — принимает PostScript-задание с рабочей станции.
- При прямой печати — передаёт задание на устройство.
- При печати отложенного задания — передаёт задание на устройство после авторизации пользователя.
Как задания попадают в CUPS
- При бесклиентской печати — универсальный драйвер на рабочей станции отправляет PostScript-задание напрямую в CUPS ПринтМенеджера.
- При печати через Клиент ПМ — после обработки задания ПринтМенеджер (отложенная печать) или Клиент (прямая печать) ПМ отправляет итоговое задание в CUPS.
Как ПринтМенеджер работает с CUPS
ПринтМенеджер периодически опрашивает устройства в CUPS на наличие новых заданий. При обнаружении нового задания — анализирует и применяет правила печати. После обработки передаёт итоговое задание обратно в CUPS. CUPS отправляет задание на физическое устройство.
Диагностика через веб-интерфейс CUPS
- Веб-интерфейс CUPS доступен по адресу: https://<ip_сервера_ПМ>:1631
- Что проверять при диагностике:
- наличие задания в очереди на целевом устройстве;
- статус задания;
- ошибки передачи;
- доступность устройства.
Типовые проблемы
| Симптом | Возможная причина |
|---|---|
| Задание не появляется в CUPS | Проблема драйвера или сетевого подключения. |
| Задание зависло в CUPS | Проблема самого устройства или драйвера этого устройства в CUPS. |
| Задание не передаётся на МФУ | Проблема сетевой доступности АРМ и сервера ПринтМенеджера или драйвера устройства. |
Связанные страницы
- Путь задания при бесклиентской печати
- Путь задания при печати через Клиент ПМ
- Как диагностировать проблемы печати по этапам
Как работают правила печати
Описание
Правила печати — механизм автоматической обработки заданий в ПринтМенеджере. Правила применяются до отправки задания на устройство и могут изменять параметры задания, ограничивать или разрешать печать, управлять очередью. После применения правил ПринтМенеджер формирует итоговое задание и либо сохраняет его в очереди (отложенная печать), либо сразу отправляет в CUPS (прямая печать).
Когда применяются правила
После получения задания ПринтМенеджер:
- Анализирует параметры задания;
- Применяет правила печати;
- Формирует итоговое задание.
Какие параметры задания анализируются
- Формат
- Двусторонняя печать
- Количество страниц
- Цветность
- Ориентация
- Разбор по копиям
- Финишные опции
Что правила могут сделать с заданием
В зависимости от настроек ПринтМенеджер может:
- изменить параметры обработки (например, принудить задание к двусторонней печати);
- применить ограничения (например, запретить цветную печать);
- удалить образ документа после печати.
Влияние правил на формат задания (PostScript vs PDF)
При бесклиентской печати может быть включена настройка USE_PS_PRINTING. Если включены правила с условиями по количеству страниц, цветности или автоудалению — ПринтМенеджер принудительно конвертирует задание в PDF, даже если USE_PS_PRINTING включена. Если таких правил нет — задание может обрабатываться в PostScript без конвертации.
Типовые проблемы
| Симптом | Возможная причина |
|---|---|
| Ограничения по страницам не работают | Проблема настройки правил (условия\действия) или количества страниц в документе |
| Цветность определяется неверно | Проблема обработки задания |
| Образ документа не удаляется после печати | Правило автоудаления образа документа не применено на пользователя |
| Задание обрабатывается медленно | Выполняется конвертация в PDF |
Связанные страницы
- Путь задания при бесклиентской печати
- Путь задания при печати через Клиент ПМ
- Как устроена очередь заданий
Как устроена очередь заданий
Описание
Очередь заданий — хранилище документов в ПринтМенеджере, ожидающих печати. В очереди находятся задания прямой печати (до передачи в CUPS), отложенной печати (до авторизации пользователя на МФУ), а также задания в процессе обработки.
Когда создаётся задание
Задание создаётся после получения документа ПринтМенеджером. Затем:
- выполняется анализ задания;
- извлекаются атрибуты;
- применяются правила печати;
- формируется внутреннее задание системы.
Что хранится в очереди
- Документ (образ в формате PDF или PostScript).
- Параметры печати.
- Принадлежность пользователю.
- Текущее состояние задания.
Как пользователь получает очередь на МФУ
При отложенной печати:
- Пользователь авторизуется на МФУ через встроенное приложение;
- Встроенное приложение запрашивает у ПринтМенеджера список заданий пользователя;
- Очередь отображается на экране МФУ.
Пользователь видит только свои задания и те, которые доступны ему в рамках делегирования заданий от других пользователей..
Когда задание отправляется на печать
Прямая печать
Задание сразу передаётся в CUPS и далее на устройство.
Отложенная печать
Задание остаётся в очереди до подтверждения пользователем на МФУ.
Когда задание покидает очередь
После успешной печати ПринтМенеджер:
- Переводит задание в архив;
- Обновляет статистику;
- Удаляет активное задание из очереди.
Задание также может быть удалено правилами печати (например, правилом автоудаления).
Типовые проблемы
| Симптом | Возможная причина |
|---|---|
| Пользователь не видит задания на МФУ | Проблема очереди или авторизации |
| Задание не удаляется из очереди | Проблема обработки или зависание задания |
| Задание исчезло после печати | Нормальное поведение — задание переведено в архив |
| Очередь пустая, хотя задание было отправлено | Задание не достигло ПринтМенеджера |
Связанные страницы
Драйверы и печатный конвейер в Принтум
Описание
Эффективная печать зависит от правильного выбора драйвера и схемы передачи задания на сервер. Принтум использует гибкую модель, позволяя назначать различные драйверы для каждого устройства, а в бесклиентской печати оптимизировать обработку за счёт PostScript-файлов. Изменение драйвера выполняется в Личном кабинете Мониторинга.
Generic PostScript как драйвер по умолчанию
При импорте МФУ из Мониторинга в ПринтМенеджер всем устройствам назначается драйвер Generic PostScript. Этот драйвер является универсальным и обеспечивает совместимость с большинством моделей. Его преимущества:
- Отсутствие зависимости от конкретного производителя.
- Корректная передача основных атрибутов задания (формат бумаги, двусторонность, цветность).
- Минимальные проблемы при установке и обслуживании.
Однако в некоторых ситуациях Generic PS может привести к плохо распечатанным документам (артефакты в содержимом документа, некорректные цвета, страницы с ошибками драйвера) или неоптимальной скорости. В таких случаях администратор может переключить устройство на другой драйвер.
Альтернативные драйверы
- Generic PCL – другой универсальный драйвер, основанный на протоколе PCL. Может быть полезен, если МФУ поддерживают PCL и возникли проблемы с PostScript.
- Generic PDF – позволяет передавать в печатный конвейер PDF-файлы. Используется в бесклиентской схеме для оптимизации скорости (см. ниже).
- Драйверы производителей – для конкретных моделей или брендов (например, Canon, Xerox, Kyocera). Иногда даёт лучшее качество печати, полный контроль над финишными опциями (скрепки, брошюрирование и т.д.), но увеличивает число устанавливаемых драйверов и сложность поддержки.
Бесклиентская печать и PostScript-конвейер
В схеме бесклиентской печати со включенной функцией USE_PS_PRINTING сервер ПМ получает PostScript-файлы задания напрямую. Это позволяет пропустить шаг преобразования, который выполняет клиент и ускорить обработку больших заданий. Причины:
- Сервер сразу получает PostScript-код, который можно отправить на МФУ без повторного преобразования;
- Разделение конвейера: сканирование, распаковка, конвертация и отправка выполняются параллельно.
Рекомендации
- Используйте Generic PostScript как стандарт. Он обеспечивает максимальную совместимость. Переключайтесь на Generic PCL или драйвер производителя, если наблюдаются проблемы: некорректная печать, необычно длинные задержки.
- Для больших документов (сотни страниц) используйте бесклиентскую схему и PostScript-конвейер. Это ускоряет обработку заданий.
- Тестируйте новые модели МФУ с разными драйверами и фиксируйте результаты. Это поможет при масштабировании системы.
Теневое копирование и архив заданий
Описание
Принтум позволяет не только управлять заданиями в очередях, но и хранить копии документов, которые пользователи печатали, копировали и сканировали. Этот функционал называется теневым копированием. Он полезен для выполнения нормативных требований информационной безопасности, контроля содержимого и анализа инцидентов. По умолчанию хранение теневых копий включено в ПринтМенеджере по соображениям безопасности, но его можно отключить для всех или включить для конкретных пользователей\подразделений. В случае обязательного хранения теневых копий объём хранилища, внутреннего или внешнего, должен быть заранее спланирован, с учётом глубины хранения образов.
Метод работы
- В случае печати сервер сохраняет PDF-образ задания.
- При копировании устройство вместо обычной функции «копировать» выполняет «сканирование + печать»:
- Пользователь кладёт документ в АПД или на стекло, нажимает «Копия».
- Встроенное приложение сканирует документ, отправляет его на сервер и одновременно запускает печать на устройстве.
- Отсканированный образ сохраняется на сервере как теневая копия.
- При сканировании встроенное приложение сохраняет образ сканируемого документа на сервер ПринтМенеджера, после чего отправляет его по целевому пути сканирования, в почту или сетевую папку пользователя.
Когда использовать
- Нормативные требования
- Некоторые организации обязаны сохранять копии распечаток и копирований (например, в сфере финансов или медицины).
- Защита информации
- Теневые копии помогают расследовать утечки и контролировать соблюдение политики использования печатающих устройств.
- Аналитика -Анализ содержимого может выявлять типы документов, чаще всего печатаемые в компании и оптимизировать процессы.
Управление и доступ
Конфиденциальность
Теневые копии содержат реальные документы, поэтому доступ к ним ограничивается ролевой моделью. По умолчанию в Мониторинге есть преднастроенная роль "Сотрудник ИБ", дающая пользователю доступ на просмотр образов напечатанных, скопированных и отсканированных документов других пользователей.
Аудит
Каждое сохранённое задание привязывается к пользователю, времени, устройству и параметрам печати. Это упрощает расследование инцидентов.
Большие документы
При сканировании в почту документов большого объёма (например, с размером файла >100 МБ) предусмотрено автоматическое разбиение на несколько файлов по следующим алгоритмам:
- Отправка, независимо от размера файла
- Отправка ссылки на скачивание
- Отправка в сетевую папку
- Разделение на по страницам
- Разделение на zip-файлы
Ограничения
Теневое копирование в сценариях копирования и сканирования документов доступно только на устройствах, где установлено встроенное приложение. Для обычных МФУ без приложения и принтеров сохраняются только печатные задания.