ПринтМенеджер ПринтМенеджер — справка по компоненту Назначение ПринтМенеджер — опциональный модуль управления печатью. Подключается к Мониторингу и обеспечивает управление заданиями, авторизацию на МФУ, правила, квоты, архив документов. Основные функции Хранение заданий в персональной очереди пользователя Авторизация на МФУ по карте, 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://: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-файлы Ограничения Теневое копирование в сценариях копирования и сканирования документов доступно только на устройствах, где установлено встроенное приложение. Для обычных МФУ без приложения и принтеров сохраняются только печатные задания.