# ПринтМенеджер # ПринтМенеджер — справка по компоненту ## Назначение ПринтМенеджер — опциональный модуль управления печатью. Подключается к Мониторингу и обеспечивает управление заданиями, авторизацию на МФУ, правила, квоты, архив документов. ## Основные функции - Хранение заданий в персональной очереди пользователя - Авторизация на МФУ по карте, 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 (в кластерной конфигурации) ## Связанные страницы - [Синхронизация Мониторинга и ПринтМенеджера](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/sinxronizaciia-monitoringa-i-printmenedzera) - [Клиент ПМ — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/klient-pm-spravka-po-komponentu-aX6) # Как Принтум использует CUPS Назначение Описание того, как ПринтМенеджер использует систему печати CUPS (Common UNIX Printing System) для организации очереди и обработки заданий на Linux-серверах. Кратко CUPS (Common Unix Printing System) используется ПринтМенеджером для приёма и передачи заданий печати на устройства. CUPS является частью пути задания при прямой и отложенной печати в обоих сценариях — через Клиент ПМ и при бесклиентской печати. Где используется CUPS При бесклиентской печати — принимает PostScript-задание с рабочей станции. При прямой печати — передаёт задание на устройство. При выпуске отложенного задания — передаёт задание на устройство после авторизации пользователя. Как задания попадают в CUPS При бесклиентской печати Универсальный драйвер на рабочей станции отправляет PostScript-задание напрямую в CUPS ПринтМенеджера. При печати через Клиент ПМ После обработки задания ПринтМенеджер или Клиент ПМ отправляет итоговое задание в CUPS. Как ПринтМенеджер работает с CUPS ПринтМенеджер периодически опрашивает CUPS на наличие новых заданий. При обнаружении нового задания — анализирует и применяет правила. После обработки передаёт итоговое задание обратно в CUPS. CUPS отправляет задание на физическое устройство. Диагностика через веб-интерфейс CUPS Веб-интерфейс CUPS доступен по адресу: https://:1631 Что проверять: наличие задания в очереди; статус задания; ошибки передачи; доступность устройства. Что важно помнить CUPS является обязательной частью пути задания. При бесклиентской печати задание сначала попадает в CUPS, затем ПринтМенеджер его забирает. При прямой и отложенной печати CUPS отправляет итоговое задание на устройство. Типовые проблемы Симптом Возможная причина Задание не появляется в CUPS Проблема драйвера или сетевого подключения Задание зависло в CUPS Проблема устройства или CUPS Задание не передаётся на МФУ Проблема протокола или драйвера устройства Задание исчезло из CUPS ПринтМенеджер завершил обработку и удалил исходное задание Связанные страницы Путь задания при бесклиентской печати Путь задания при печати через Клиент ПМ Как диагностировать проблемы печати по этапам # Как работают правила печати ## Назначение Описание механизма правил печати в Принтум: условия применения, действия, приоритеты и взаимодействие с квотами. --- ## Кратко Правила печати — механизм автоматической обработки заданий в ПринтМенеджере. Правила применяются до отправки задания на устройство и могут изменять параметры задания, ограничивать или разрешать печать, управлять очередью. ## Когда применяются правила После получения задания ПринтМенеджер: 1. анализирует параметры задания; 2. применяет правила печати; 3. формирует итоговое задание. ## Какие параметры анализируются - Формат - Дуплекс - Количество страниц - Цветность - Ориентация - Разбор по копиям - Финишные опции ## Виды правил - Правила по количеству страниц. - Правила по цветности страниц. - Правила автоматического удаления документа после печати. - Правила, связанные с квотами пользователя. - Правила оптимизации печати (экономия тонера и т.д.). ## Что правила могут сделать с заданием В зависимости от настроек ПринтМенеджер может: - изменить параметры обработки (например, принудить к дуплексу); - применить ограничения (запретить цветную печать); - выполнить конвертацию документа в PDF; - оставить задание в очереди или отправить на устройство; - удалить документ после печати. ## Влияние правил на формат задания (PostScript vs PDF) При бесклиентской печати действует настройка `USE_PS_PRINTING`. Если включены правила по количеству страниц, цветности или автоудалению — ПринтМенеджер **принудительно конвертирует задание в PDF**, даже если `USE_PS_PRINTING` включена. Если таких правил нет — задание может обрабатываться в PostScript без конвертации. ## Как правила связаны с очередью После применения правил ПринтМенеджер формирует итоговое задание и либо сохраняет его в очереди (отложенная печать), либо сразу отправляет в CUPS (прямая печать). ## Типовые проблемы
СимптомВозможная причина
Ограничения по страницам не работаютПроблема настройки правил или формата задания
Цветность определяется неверноПроблема обработки задания или формата
Документ удаляется после печатиСработало правило автоудаления
Задание обрабатывается медленноВыполняется конвертация в PDF
## Связанные страницы - [Путь задания при бесклиентской печати](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/put-zadaniia-pri-besklientskoi-pecati) - [Путь задания при печати через Клиент ПМ](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/put-zadaniia-pri-pecati-cerez-klient-pm) - [Как устроена очередь заданий](http://wiki.printum.io/books/2-komponenty-sistemy/page/kak-ustroena-ocered-zadanii) # Как устроена очередь заданий ## Назначение Описание жизненного цикла задания печати в системе Принтум: от отправки пользователем до выпуска на устройстве. --- ## Кратко Очередь заданий — хранилище документов в ПринтМенеджере, ожидающих печати. В очереди находятся задания прямой печати (до передачи в CUPS), отложенной печати (до авторизации пользователя на МФУ), а также задания в процессе обработки. ## Когда создаётся задание Задание создаётся после получения документа ПринтМенеджером. Затем: 1. выполняется анализ задания; 2. извлекаются атрибуты; 3. применяются правила печати; 4. формируется внутреннее задание системы. ## Что хранится в очереди - Документ (PDF или PostScript). - Параметры печати. - Принадлежность пользователю. - Текущее состояние задания. ## Как пользователь получает очередь на МФУ При отложенной печати: 1. пользователь авторизуется на МФУ через Встроенное приложение; 2. Встроенное приложение запрашивает у ПринтМенеджера список заданий пользователя; 3. очередь отображается на экране МФУ. Пользователь видит только **свои** задания. ## Когда задание отправляется на печать ### Прямая печать Задание сразу передаётся в CUPS и далее на устройство. ### Отложенная печать Задание остаётся в очереди до подтверждения пользователем на МФУ. ## Когда задание покидает очередь После успешной печати ПринтМенеджер: 1. переводит задание в архив; 2. обновляет статистику; 3. удаляет активное задание из очереди. Задание также может быть удалено правилами печати (например, правилом автоудаления). ## Типовые проблемы
СимптомВозможная причина
Пользователь не видит задания на МФУПроблема очереди или авторизации
Задание не удаляется из очередиПроблема обработки или зависание задания
Задание исчезло после печатиНормальное поведение — задание переведено в архив
Очередь пустая, хотя задание было отправленоЗадание не достигло ПринтМенеджера
## Связанные страницы - [Как работает отложенная печать](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rabotaet-otlozennaia-pecat) - [Как работает авторизация на МФУ](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rabotaet-avtorizaciia-na-mfu) - [Как работают правила печати](http://wiki.printum.io/books/2-komponenty-sistemy/page/kak-rabotaiut-pravila-pecati) # Драйверы и печатный конвейер в Принтум Эффективная печать зависит от правильного выбора драйвера и схемы передачи задания на сервер. Принтум использует гибкую модель, позволяя назначать различные драйверы для каждого устройства, а в бесклиентском режиме оптимизировать обработку за счёт PostScript-файлов. Generic PostScript как драйвер по умолчанию При импорте МФУ из Мониторинга в ПринтМенеджер всем устройствам назначается драйвер Generic PostScript . Этот драйвер является универсальным и обеспечивает совместимость с большинством моделей. Его преимущества: Отсутствие зависимости от конкретного производителя. Корректная передача основных атрибутов задания (формат бумаги, двусторонность, цветность). Минимальные проблемы при установке и обслуживании. Однако в некоторых ситуациях Generic PS может привести к плохо распечатанным документам (глифы, некорректные цвета) или неоптимальной скорости. В таких случаях администратор может переключить устройство на другой драйвер. Альтернативные драйверы Generic PCL – другой универсальный драйвер, основанный на протоколе PCL. Может быть полезен, если МФУ поддерживают PCL и возникли проблемы с PostScript. Generic PDF – позволяет передавать в печатный конвейер PDF-файлы. Используется в бесклиентской схеме для оптимизации скорости (см. ниже). Драйверы производителей – для конкретных моделей или брендов (например, Canon, Xerox, Kyocera). Иногда даёт лучшее качество печати, полный контроль над функциями (скрепки, финишеры), но увеличивает число устанавливаемых драйверов и сложность поддержки. Изменение драйвера выполняется в интерфейсе администрирования Принтум. Менять драйвер имеет смысл, если возникают проблемы: иероглифы вместо текста, неправильная цветность, слишком медленная печать. Бесклиентская печать и PostScript-конвейер В схеме без Клиента ПМ (см. отдельную статью) сервер получает PostScript-файлы напрямую. Это позволяет пропустить шаг преобразования, который выполняет клиент, и существенно ускоряет обработку больших заданий. В недавних версиях Принтум обработка 500-страничных документов в бесклиентской схеме происходит в разы быстрее , чем при передаче через Клиент ПМ. Причины: сервер сразу получает PostScript-код, который можно отправить на МФУ без повторного преобразования; разделение конвейера: сканирование, распаковка, конвертация и отправка выполняются параллельно. PDF против PostScript Иногда МФУ лучше печатают PDF, особенно если документы содержат сложные шрифты или графику. В бесклиентской схеме можно выбрать «Generic PDF». Но следует помнить: PDF-поток может быть медленнее для некоторых МФУ; PostScript остаётся более надёжным универсальным форматом для промышленной печати; переход на PDF может повлиять на работу правил (например, анализ цветности). Рекомендации Используйте Generic PostScript как стандарт. Он обеспечивает максимальную совместимость. Переключайтесь на Generic PCL или драйвер производителя , если наблюдаются проблемы: некорректная печать, необычно длинные задержки. Для больших документов (сотни страниц) используйте бесклиентскую схему и PostScript-конвейер. Это ускоряет обработку. Тестируйте новые модели МФУ с разными драйверами и фиксируйте результаты. Это поможет при масштабировании системы. Итог Выбор драйвера влияет на качество и скорость печати. Принтум по умолчанию выбирает Generic PostScript, но позволяет переходить на PCL, PDF или продуктовые драйверы в зависимости от задач. Бесклиентская схема и PostScript-конвейер дают значительный прирост производительности при печати больших документов. # Теневое копирование и архив печатных заданий Принтум позволяет не только управлять заданиями в очередях, но и хранить копии документов, которые пользователи печатали или копировали. Эта возможность называется теневым копированием . Она полезна для выполнения нормативных требований, контроля содержимого и анализа инцидентов. Что такое теневое копирование Теневое копирование – это сохранение образа документа, который был распечатан или откопирован. В случае печати сервер сохраняет PDF-представление задания. При копировании устройство вместо обычной функции «копировать» выполняет «сканирование + печать»: Пользователь кладёт документ в АПД или на стекло, нажимает «Копия». Встроенное приложение сканирует документ, отправляет его на сервер и одновременно запускает печать на устройстве. Сканированный файл сохраняется на сервере как теневой образ. Таким образом, копирование превращается в сканирование плюс печать. Это позволяет сохранить содержимое копий так же, как сохраняются печатные задания. Какие документы сохраняются Печатные задания , отправленные через ПринтМенеджер. Они сохраняются в виде PDF (либо в исходном формате, если настроено). Копии , выполненные на МФУ со Встроенным приложением. Сканирования , отправленные через функцию «Сканировать в e-mail» или «Сканировать в папку» – файлы сохраняются в формате PDF и могут быть архивированы. По умолчанию хранение теневых копий отключено, чтобы не расходовать место. Администратор может включить его для всех или отдельных устройств и установить срок хранения (например, 3 дня, 1 неделя, 1 месяц). Управление и доступ Конфиденциальность. Теневые копии содержат реальные документы, поэтому доступ к ним ограничивается правами. Обычно только администраторы безопасности или ответственные менеджеры могут просматривать архив. Аудит. Каждое сохранённое задание привязывается к пользователю, времени, устройству и параметрам печати. Это упрощает расследование инцидентов. Большие документы. Для сканов большого объёма (например, >100 МБ) предусмотрено автоматическое разбиение на несколько файлов. Пользователь получает архив в виде нескольких частей по электронной почте или через веб-интерфейс. Ограничения Теневое копирование доступно только на устройствах, где установлено Встроенное приложение. Для обычных МФУ без приложения сохраняются только печатные задания. Архив сканов в текущей версии не отображается как отдельный раздел, однако файлы доступны через API или могут быть выгружены администратором. Объём хранилища должен быть заранее спланирован. Хранение больших документов увеличивает требования к дисковому пространству. Когда использовать Нормативные требования. Некоторые организации обязаны сохранять копии распечаток и копирований (например, в сфере финансов или медицины). Защита информации. Теневые копии помогают расследовать утечки и контролировать соблюдение политики использования печатающих устройств. Аналитика. Анализ содержимого может выявлять типы документов, чаще всего печатаемые в компании, и оптимизировать процессы. Заключение Теневое копирование расширяет возможности Принтум, превращая систему управления печатью в инструмент контроля информации. Грамотная настройка позволяет соблюсти баланс между потребностями безопасности и затратами на хранилище. При проектировании учтите наличие Встроенных приложений на МФУ и требования к времени хранения.