2. Компоненты системы

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

Основные функции

Обнаружение принтеров и МФУ по SNMP
Сбор счётчиков, состояния расходных материалов и запчастей
Отслеживание статусов и ошибок устройств
Управление пользователями, ролями, лицензиями
Формирование отчётов и подписок
Интеграция с доменами и почтовым сервером
Единый интерфейс в виде Личного кабинета для конфигурации всех ПринтМенеджеров

Где настраивается

Личный кабинет — основной интерфейс
Панель администратора Мониторинга:

https://<адрес>:8001/config/

Учётные данные по умолчанию

Логин: printum / Пароль: printum

Путь установки и ключевые файлы

Файл	Назначение
/opt/printum/.env	Переменные окружения
/opt/printum/.version	Версия Мониторинга
/opt/printum/docker-compose.yml	Docker-стек
/opt/printum/logs.sh	Скрипт сбора логов
/opt/printum/backup.sh	Скрипт создания бэкапа

Контейнеры Docker

Контейнер	Роль
printum-backend	Работа API Мониторинга, все не фоновые задачи.
printum-clickhouse	Столбцовая система управления базами данных.
printum-dashboard	Личный кабинет.
printum-nginx	HTTP-сервер и обратный прокси-сервер, а также TCP/UDP прокси-сервер общего назначения. Он проксирует все http соединения от\до приложения, отдает статику и т.д.
printum-postgres	База данных PostgreSQL.
printum-redis	Брокер сообщений.
printum-scheduler	Выполнение задач Мониторинга, планировщик задач для celery.
printum-worker-default	Обработка всех фоновых задач Мониторинга: отправка писем, обработка данных от принтеров. Один из трёх контейнеров с celery.
printum-worker-high	Обработка всех фоновых задач Мониторинга: отправка писем, обработка данных от принтеров. Один из трёх контейнеров с celery.
printum_worker-low	Обработка всех фоновых задач Мониторинга: отправка писем, обработка данных от принтеров. Один из трёх контейнеров с celery.

Когда используется

Мониторинг является обязательным компонентом во всех поставках Printum. Он устанавливается первым и служит центральным узлом управления: управляет пользователями и устройствами, агрегирует статистику распределённых филиальных сетей, обеспечивает интеграцию с внешними системами.

Единственный сервер — конфигурация «Сингл».
Вместе с ПринтМенеджером на отдельных серверах — конфигурация «Сплит».
С кластером ПринтМенеджеров и балансировщиком — конфигурация «Кластер Active-Active».

Связанные компоненты

Сетевой агент — мониторинг сетевых устройств по SNMP; устанавливается автоматически вместе с Мониторингом.
Локальный агент — мониторинг локально подключённых устройств (USB).
ПринтМенеджер — подключается к Мониторингу, синхронизируется раз в час.
PostgreSQL — основная БД Мониторинга.
ClickHouse — хранилище сырых snmp-данных устройств.
Redis — кэш и очередь задач.
Docker — среда выполнения всех контейнеров.

Что диагностировать перед эскалацией

Уточнить версию Мониторинга:

cat /opt/printum/.version

Проверить статус контейнеров (активны, неактивны, перезапускаются):

cd /opt/printum && sudo docker-compose ps

Собрать логи:

sudo bash /opt/printum/logs.sh

Проверить свободное место на диске сервера и самые объёмные каталоги в разделе /:

sudo df -h
sudo du -h --max-depth=1 / | sort -hr

Типовые проблемы

Проблема	Причина	Решение
Timeout error при установке	Неверно указана переменная MON_HOSTNAME или нет разрешения доменного имени с DNS	1. Проверить корректность записи доменного имени в переменной MON_HOSTNAME. 2. Проверить разрешение имени сервера в DNS. 3. Запустить установку повторно.
Конфликт адресов Docker после установки	Диапазон 10.28.32.0/26 пересекается с локальной сетью	Указать другой пул адресов Docker в /etc/docker/daemon.json и перезапустить Docker
Обнаружены не все устройства	Неверный IP в локации, SNMP отключён, агент не опрашивает локацию	Проверить IP локации, статус SNMP командой snmpwalk, настройки агента в Настройки → Модули
Ошибка обновления: network has active endpoints	Контейнер занимает сеть во время обновления	Перезагрузить сервер и запустить обновление повторно

Расширенные возможности Мониторинга

Произвольные OID и гибкий SNMP-опрос

Система поддерживает произвольный набор OID — она может собирать любые параметры, которые устройства отдают по SNMP. Это счётчики, уровень расходных материалов, ошибки, температура, скорость печати и т.д. Стандартный набор OID покрывает большинство задач, но администратор может расширить его для специфических моделей или требований.

Точность данных при работе с Локальным агентом

Когда используется Локальный агент для мониторинга USB-принтеров, следует учитывать особенности точности данных:

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

Справочники запчастей и прогнозирование замены

Система поставляется с базой запчастей и материалов для распространённых моделей принтеров. Администратор может дополнять справочники вручную или попросить поддержку дополнить их при появлении новых устройств. Благодаря этому Мониторинг может прогнозировать замену деталей даже для устройств, которые сами не отслеживают расходники.

Интеграция с ПринтМенеджером

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

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

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

ПринтМенеджер — справка по компоненту

Назначение

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

Основные функции

Хранение заданий в персональной очереди пользователя
Авторизация на МФУ по карте, 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) для организации очереди и обработки заданий на Linux-серверах. Кратко 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 Проблема драйвера или сетевого подключения Задание зависло в CUPS Проблема устройства или CUPS Задание не передаётся на МФУ Проблема протокола или драйвера устройства Задание исчезло из CUPS ПринтМенеджер завершил обработку и удалил исходное задание Связанные страницы Путь задания при бесклиентской печати Путь задания при печати через Клиент ПМ Как диагностировать проблемы печати по этапам

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

Как работают правила печати

Назначение

Описание механизма правил печати в Принтум: условия применения, действия, приоритеты и взаимодействие с квотами.

Кратко

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

Когда применяются правила

После получения задания ПринтМенеджер:

анализирует параметры задания;
применяет правила печати;
формирует итоговое задание.

Какие параметры анализируются

Формат
Дуплекс
Количество страниц
Цветность
Ориентация
Разбор по копиям
Финишные опции

Виды правил

Правила по количеству страниц.
Правила по цветности страниц.
Правила автоматического удаления документа после печати.
Правила, связанные с квотами пользователя.
Правила оптимизации печати (экономия тонера и т.д.).

Что правила могут сделать с заданием

В зависимости от настроек ПринтМенеджер может:

изменить параметры обработки (например, принудить к дуплексу);
применить ограничения (запретить цветную печать);
выполнить конвертацию документа в PDF;
оставить задание в очереди или отправить на устройство;
удалить документ после печати.

Влияние правил на формат задания (PostScript vs PDF)

При бесклиентской печати действует настройка USE_PS_PRINTING. Если включены правила по количеству страниц, цветности или автоудалению — ПринтМенеджер принудительно конвертирует задание в PDF, даже если USE_PS_PRINTING включена. Если таких правил нет — задание может обрабатываться в PostScript без конвертации.

Как правила связаны с очередью

После применения правил ПринтМенеджер формирует итоговое задание и либо сохраняет его в очереди (отложенная печать), либо сразу отправляет в CUPS (прямая печать).

Типовые проблемы

Симптом	Возможная причина
Ограничения по страницам не работают	Проблема настройки правил или формата задания
Цветность определяется неверно	Проблема обработки задания или формата
Документ удаляется после печати	Сработало правило автоудаления
Задание обрабатывается медленно	Выполняется конвертация в PDF

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

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

Как устроена очередь заданий

Назначение

Описание жизненного цикла задания печати в системе Принтум: от отправки пользователем до выпуска на устройстве.

Кратко

Очередь заданий — хранилище документов в ПринтМенеджере, ожидающих печати. В очереди находятся задания прямой печати (до передачи в CUPS), отложенной печати (до авторизации пользователя на МФУ), а также задания в процессе обработки.

Когда создаётся задание

Задание создаётся после получения документа ПринтМенеджером. Затем:

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

Что хранится в очереди

Документ (PDF или PostScript).
Параметры печати.
Принадлежность пользователю.
Текущее состояние задания.

Как пользователь получает очередь на МФУ

При отложенной печати:

пользователь авторизуется на МФУ через Встроенное приложение;
Встроенное приложение запрашивает у ПринтМенеджера список заданий пользователя;
очередь отображается на экране МФУ.

Пользователь видит только свои задания.

Когда задание отправляется на печать

Прямая печать

Задание сразу передаётся в CUPS и далее на устройство.

Отложенная печать

Задание остаётся в очереди до подтверждения пользователем на МФУ.

Когда задание покидает очередь

После успешной печати ПринтМенеджер:

переводит задание в архив;
обновляет статистику;
удаляет активное задание из очереди.

Задание также может быть удалено правилами печати (например, правилом автоудаления).

Типовые проблемы

Симптом	Возможная причина
Пользователь не видит задания на МФУ	Проблема очереди или авторизации
Задание не удаляется из очереди	Проблема обработки или зависание задания
Задание исчезло после печати	Нормальное поведение — задание переведено в архив
Очередь пустая, хотя задание было отправлено	Задание не достигло ПринтМенеджера

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

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

Драйверы и печатный конвейер в Принтум

Эффективная печать зависит от правильного выбора драйвера и схемы передачи задания на сервер. Принтум использует гибкую модель, позволяя назначать различные драйверы для каждого устройства, а в бесклиентском режиме оптимизировать обработку за счёт 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 или могут быть выгружены администратором. Объём хранилища должен быть заранее спланирован. Хранение больших документов увеличивает требования к дисковому пространству. Когда использовать Нормативные требования. Некоторые организации обязаны сохранять копии распечаток и копирований (например, в сфере финансов или медицины). Защита информации. Теневые копии помогают расследовать утечки и контролировать соблюдение политики использования печатающих устройств. Аналитика. Анализ содержимого может выявлять типы документов, чаще всего печатаемые в компании, и оптимизировать процессы. Заключение Теневое копирование расширяет возможности Принтум, превращая систему управления печатью в инструмент контроля информации. Грамотная настройка позволяет соблюсти баланс между потребностями безопасности и затратами на хранилище. При проектировании учтите наличие Встроенных приложений на МФУ и требования к времени хранения.

Клиент ПМ

Клиент ПМ — справка по компоненту

Клиент ПМ — справка по компоненту Назначение Клиент ПМ — опциональный компонент, устанавливаемый на рабочие станции пользователей. Обеспечивает формирование и отправку печатных заданий на сервер ПринтМенеджера, управление локальным списком МФУ и применение алгоритмов экономии тонера. Когда используется Клиент ПМ необходим, когда рабочие станции пользователей должны отправлять задания через сервер ПринтМенеджера. Поддерживает Windows, Linux, macOS. Прямая и отложенная печать с управлением заданиями из ЛК. Экономия тонера (алгоритмы осветления, сглаживания). Автоматическое добавление/удаление МФУ на рабочей станции. Основные функции Формирование задания. В составе клиента — XPS-драйвер (Windows) или PS-ориентированный драйвер (Linux). Задание формируется и отправляется на сервер ПринтМенеджер. Управление МФУ. Автоматически добавляет и удаляет МФУ на АРМ в соответствии с настройками сервера. Экономия тонера. Применяет преднастроенные алгоритмы осветления и сглаживания по политике организации или профилю пользователя. Связанные компоненты ПринтМенеджер — сервер, на который Клиент ПМ отправляет задания (порт 8080). Мониторинг — источник пользователей и настроек. Где настраивается Файл настроек: C:\Program Files\printum\printmanager_client\settings.yml Токен доступа PM_ACCESS_TOKEN — в панели ПринтМенеджер: Администрирование → Системные настройки → Общие настройки. Адрес сервера задаётся при установке: PRINTMANAGER_BASE_URL (Linux) или параметр MSI (Windows). Типовые проблемы Проблема Причина Решение Сообщение о сертификате при установке Некорректная цепочка сертификатов GlobalSign Запустить certlm.msc, установить сертификат «ООО Принтум» в Доверенные издатели; GlobalSign GCC R45 EV CodeSigning CA 2020 — в промежуточные; GlobalSign Code Signing Root R45 — в корневые No user authorized, removing all printers Пользователь не найден в системе управления печатью или неверный SID Проверить наличие пользователя в разделе «Сотрудники»; проверить токен access_token Max retries exceeded при подключении к серверу Сервер ПринтМенеджер недоступен по указанному адресу и порту 8080 Проверить сетевую доступность сервера с рабочей станции AssertionError: Adding printer Printum means critical error МФУ Printum с драйвером Printum XPS не найден Удалить МФУ вручную и переустановить Клиент ПМ Что важно для диагностики Логи Windows: eventvwr → Журналы Windows → Приложения → источник «ПринтМенеджер Client» Файл настроек: settings.yml — проверить PRINTMANAGER_BASE_URL, PM_ACCESS_TOKEN, use_cups_ssl Версия: C:\Program Files\printum\printmanager_client\as_service.exe → Свойства → Подробно → Версия файла Что проверить перед эскалацией Версию Клиента ПринтМенеджер (see «Что важно для диагностики») Содержимое файла settings.yml Логи из eventvwr с ошибками Доступность сервера ПринтМенеджер: адрес и порт 8080

Клиент ПМ

Экономия тонера в Принтум

title: Экономия тонера в Принтум slug: ekonomiya-tonera-v-printum tags: [тонер, экономия, Клиент ПМ, настройка] domain: Printing type: Overview audience: partner-engineer product_versions: "All" status: ready related_components: [Клиент ПМ, ПринтМенеджер]

Экономия тонера в Принтум

Расход расходных материалов — важная статья затрат на печать. Принтум предоставляет возможность снижать расход тонера (или чернил) посредством программных настроек. Эта страница описывает принцип работы функции и её ограничения.

Как работает экономия

Экономия тонера реализована в Клиенте ПМ и основывается на регулировке плотности заливки изображений и текста:

При отправке задания Клиент ПМ анализирует документ и уменьшает плотность заливки шрифтов и штриховых объектов. Серые области становятся светлее, точки сетки — менее плотными.
Параметры экономии настраиваются администратором: можно выбрать стандартный уровень (например, 10 % экономии) или задать свои коэффициенты. Для важных документов экономию можно отключить.
После преобразования Клиент ПМ формирует PDF и отправляет его на сервер, где документ печатается как обычно.

Эффект зависит от типа документа: на текстовых документах экономия заметна (до 20–30 % уменьшения расхода), на графических — меньше. Визуальное качество сохраняется на приемлемом уровне для большинства офисных материалов.

Почему это уникальная опция

Функция экономии тонера встречается в немногих продуктах управления печатью. В Принтум она интегрирована в стандартный Клиент ПМ и не требует дополнительных лицензий. Это позволяет оптимизировать расходы без покупки специализированного ПО.

Ограничения и планы развития

Клиентская реализация. Сейчас экономия работает только в клиентской схеме. При бесклиентской печати функция недоступна. В планах — перенос на сервер, чтобы она работала независимо от схемы печати.
Влияние на цветность. При высокой экономии цвета могут выглядеть менее насыщенными. Для документов с графикой или маркетинговых материалов рекомендуется использовать меньший коэффициент или отключить функцию.
Совместимость. Экономия тонера не влияет на логику обработки PostScript/PDF, но при использовании некоторых драйверов производителей алгоритм может давать искажённые цвета. Тестируйте перед массовым включением.

Настройка

В консоли администрирования включите опцию экономии тонера для нужных пользователей, групп или устройств.
Выберите уровень экономии. Начните с небольшого (10 %), чтобы проверить восприятие. Постепенно увеличивайте, если качество устраивает.
Предупредите пользователей о включении функции и собирайте обратную связь. Для презентаций или договоров экономию рекомендуется отключать.

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

Локальный агент — справка по компоненту

Назначение

Локальный агент — служба на рабочей станции. Отслеживает локальную очередь печати и передаёт данные о заданиях и USB-устройствах в Мониторинг.

Когда используется

Мониторинг принтеров, подключённых по USB
Статистика печати по пользователям без ПринтМенеджера

Ключевые параметры конфигурации (Windows)

Файл: Printum.JobTracking.WindowsService.exe.config

Параметр	Описание
PrintumURL	Адрес Мониторинга, например `http://10.0.0.1:8000/localprinter/`
PrintumClientKey	Ключ из Панели администратора `Мониторинга → Локальные принтеры → Клиентские ключи`
OnlyUSB	`true` — только USB-принтеры, `false` — все очереди

Что важно для диагностики

Windows:

Просмотр событий → Источник ServicePrintum

Linux:

systemctl status printum-jtm

Основные функции

Отслеживание локальной очереди печати в режиме реального времени.
Сбор статистики по USB-устройствам и сетевым устройствам, на которые отправляются задания с данного ПК.
Агент Windows отправляет данные немедленно, агент Linux — в течение 5 минут (настраивается).
Фильтрация по USB или по всем устройствам — в зависимости от задачи.

Связанные компоненты

Мониторинг — сервер, на который агент отправляет данные (порт 8000 HTTP / 8001 HTTPS).
PrintumClientKey — ключ для аутентификации агента, берётся из настроек Мониторинга.

Где настраивается

Конфигурационный файл (Windows): Printum.JobTracking.WindowsService.exe.config — параметры PrintumURL и PrintumClientKey.
Для HTTPS: CA-сертификат из /home/printum/certs/current/ca.crt добавляется в доверенные на ПК.

Типовые проблемы

Проблема	Причина	Решение
Локальные принтеры меняют название после печати	Неактуальные задания в спулере рабочей станции	Остановить спулер: `net stop spooler`; удалить файлы .shd и .spl из C:\Windows\System32\spool\PRINTERS; запустить: `net start spooler`
Статистика не отображается в ЛК	Неверный PrintumURL или PrintumClientKey	Проверить конфигурационный файл агента

Что проверить перед эскалацией

Статус службы агента (Windows: services.msc → Printum JobTracking)
Содержимое конфигурационного файла (PrintumURL, PrintumClientKey)
Сетевую доступность сервера Мониторинга (порт 8000 или 8001)
Наличие задания в ЛК после тестовой печати

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

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

Как Локальный агент отслеживает задания печати

Назначение

Описание механизма отслеживания заданий печати Локальным агентом мониторинга на рабочих станциях с локально подключёнными устройствами.

Кратко

Локальный агент (внутреннее техническое название службы — Job Tracking Monitor, PrintumJTMS) — Windows-служба, устанавливаемая на компьютер пользователя или сервер печати. Её задача — отслеживать локальную очередь печати и отправлять информацию о заданиях на бэкенд Принтум.

Основная задача

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

отслеживает задания печати в очереди Windows;
определяет момент завершения печати;
отправляет события с данными задания на бэкенд.

Как работает мониторинг очереди

Служба работает в фоне и постоянно опрашивает очередь печати Windows с интервалом 60 мс. Отслеживаемые статусы заданий:

Printed — задание напечатано;
Retained — задание удержано в очереди;
Completed — задание завершено.

Как отправляются данные

Данные отправляются на бэкенд по TCP. Доставка сообщений не гарантирована: при проблемах со связью часть событий может быть потеряна без возможности восстановления.

Потенциальные проблемы

Потеря событий при нестабильном соединении

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

Быстрое удаление задания из очереди

Если задание исчезает из очереди быстрее, чем Локальный агент успевает его опросить (между итерациями по 60 мс), нужный статус может не зафиксироваться.

Логи

Логи Локального агента записываются в стандартный журнал событий Windows:

Просмотр событий → Журналы Windows → Приложение

Код события: 101

Открыть быстро:

eventvwr

Установка

Варианты установки:

MSI-установщик + XML-файл конфигурации;
скрипты install.bat / uninstall.bat.

Основные команды установки

msiexec /i printum_installer.msi /qn

Printum.JobTracking.WindowsService.exe --install

net start PrintumJTMS

Основные команды удаления

net stop PrintumJTMS

Printum.JobTracking.WindowsService.exe --uninstall

msiexec /x printum_installer.msi /qn

Что важно помнить

Локальный агент работает как Windows-служба (PrintumJTMS).
Доставка TCP-сообщений не гарантируется.
Слишком быстрое удаление заданий из очереди может приводить к пропуску событий.
Логи пишутся в стандартный журнал Windows (событие 101).

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

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

Мониторинг USB-принтеров с помощью Локального агента

В стандартной конфигурации Принтум собирает статистику через Сетевой агент, который опрашивает устройства по SNMP. Однако в инфраструктурах с USB-МФУ или нестандартными устройствами сетевой опрос недоступен. Для таких случаев используется Локальный агент – небольшая программа, установленная на рабочих станциях. Когда нужен Локальный агент USB-МФУ. Если МФУ подключён напрямую к компьютеру, Мониторинг не может собирать данные по SNMP. Локальный агент отслеживает очередь печати на этой станции и передаёт в систему сведения о заданиях и пользователях. Отсутствие ПринтМенеджера. В компаниях, где не требуется централизованное управление заданиями (нет ПринтМенеджера), Локальный агент позволяет всё-таки вести учёт печати в разрезе пользователей и отделов. Это полезно для ориентировочного распределения затрат. Мониторинг локальных очередей. Даже при наличии ПринтМенеджера Локальный агент может быть полезен, если компания хочет анализировать задания, отправленные мимо сервера (например, на личные или временные МФУ). Как работает Локальный агент Агент подписывается на события локальной очереди печати. Когда пользователь отправляет задание, агент фиксирует: пользователя (по учётной записи операционной системы); имя МФУ и тип подключения; количество страниц, цветность, формат; атрибуты задания (двусторонняя печать, размеры и др.). Эти данные отправляются на сервер Мониторинга. В базе появляется запись о задании, которая может использоваться для отчётов. При необходимости использовать правила (квоты, политики) или делать удержание заданий для авторизации нужно подключать ПринтМенеджер. Ограничения и точность данных Ограниченный набор параметров. В отличие от SNMP-опроса через Сетевой агент, Локальный агент не может получить счётчики устройства или состояние расходников. Он видит только атрибуты конкретного задания. Ошибки драйвера. Оценка цветности и других атрибутов зависит от драйвера МФУ. Иногда драйвер считает документ цветным, даже если он черно-белый, потому что пользователь отправил его без изменения настроек. Принтум корректирует очевидные несоответствия (например, исключает цвет для монохромных МФУ), но полностью исключить погрешности невозможно. Нет контроля очередей. Локальный агент — это только мониторинг. Он не способен удерживать задания или применять правила. Для полного контроля требуется ПринтМенеджер. Рекомендации по развёртыванию Устанавливайте Локальный агент только там, где действительно нужны данные о печати: на рабочих станциях с USB-МФУ или на отдельных АРМ с высокими требованиями к учёту. Настраивайте агент в режиме «мониторинг USB-устройств» (фильтрация по типу подключения), если вас интересует только статистика по USB-МФУ. Периодически сверяйте собранную статистику со счётчиками устройств, чтобы корректировать возможные ошибки в определении цветности или страниц. Заключение Локальный агент – полезное расширение Принтум для мониторинга печати на USB-МФУ и там, где нет ПринтМенеджера. Он не заменяет сетевой мониторинг и ПринтМенеджер, но позволяет собрать нужную статистику, повысить прозрачность затрат и подготовить базу для внедрения полноценного управления печатью.

Сетевой агент

Сетевой агент — справка по компоненту

Назначение

Сетевой агент — служба, которая сканирует IP-диапазоны и опрашивает принтеры и МФУ по SNMP. Передаёт данные в Мониторинг.

Когда используется

Всегда — устанавливается автоматически с Мониторингом
Дополнительные агенты — для сегментов сети, недоступных с основного сервера

Ключевые параметры конфигурации

Файл: /opt/printum-agent/config.env

Параметр	По умолчанию	Описание
DEFAULT_SCAN_INTERVAL	3600 сек	Интервал сканирования сети
DEFAULT_POLL_INTERVAL	300 сек	Интервал опроса устройств
LOG_LEVEL	WARNING	Уровень логирования. DEBUG — для диагностики

Что важно для диагностики

Текущий лог:
```
/opt/printum-agent/agent.log
```
Перезапуск:
```
systemctl restart printum-agent.service
```

Что проверить перед эскалацией

IP-адрес устройства в настройках локации
Доступность SNMP: snmpwalk -v 2c -c public <ip>
Логи агента в режиме DEBUG

Основные функции

Обнаружение сетевых принтеров и МФУ по IP-диапазонам, заданным в локациях.
Опрос устройств по протоколу SNMP: состояние, счётчики, расходные материалы.
Передача данных на сервер Мониторинга.
Один агент может обслуживать несколько локаций.

Связанные компоненты

Мониторинг — сервер, к которому подключается агент (IP + TOKEN).
МФУ и Принтер — устройства, которые агент опрашивает по SNMP.

Где настраивается

Токен агента создаётся в ЛК Мониторинга: Настройки → Интеграции → Сетевые агенты.
Привязка агента к локациям: Настройки → Общие настройки → Модули → Сетевой агент.
Linux: параметры IP_ADDRESS и TOKEN передаются при установке через install.sh.
Windows: файл config.env (BACKEND, TOKEN) в директории агента.

Типовые проблемы

Проблема	Причина	Решение
Не все устройства обнаружены	Неверный IP в локации, SNMP отключён, агент не опрашивает локацию	Проверить IP в настройках локации; убедиться, что локация отмечена для агента; проверить SNMP: `snmpwalk -v 2c -c public <printer-ip>`
Версия агента не обновляется в панели	Агент не перезапустился после обновления	Проверить статус сервиса агента

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

Встроенное приложение

Встроенное приложение — справка по компоненту

Назначение

Встроенное приложение — компонент, устанавливаемый на МФУ. Блокирует устройство до авторизации, идентифицирует пользователя по карте или PIN-коду, учитывает операции.

Основные функции

Блокировка МФУ до авторизации
Авторизация по карте или PIN
Применение прав доступа пользователя
Учёт печати, копирования, сканирования

Поддерживаемые производители для автоустановки из Личного кабинета

Xerox
Konica Minolta
HP
Sharp
Ricoh

Для остальных — загрузка файла вручную. Инструкции по запросу: support@printum.io

Где настраивается

Личный кабинет → Управление → Устройства → кнопка Установить приложение.

Что проверить перед эскалацией

Версию прошивки МФУ
Наличие лицензии на Встроенное приложение
Логи контейнера printmanager-app
Отсутствие конфликтующих приложений на МФУ

Когда используется

Встроенное приложение устанавливается на поддерживаемые принтеры и МФУ для организации безопасного доступа: авторизации по карте или PIN-коду, ограничения функций копирования/сканирования/печати, учёта операций.

Используется в сценариях отложенной печати — пользователь авторизуется на МФУ и выпускает задание из персональной очереди.

Связанные компоненты

ПринтМенеджер — управляющий сервер; встроенное приложение подключается к нему.
Мониторинг — источник пользователей, ролей и профилей настроек на МФУ.
МФУ — устройство, на котором установлено приложение.

Типовые проблемы

Проблема	Причина	Решение
Постоянный запрос токена на МФУ Ricoh	Стороннее приложение (например, Device Software Manager) конфликтует с системой	В интерфейсе управления принтером найти и удалить сторонние приложения; перезагрузить принтер
Приложение не устанавливается автоматически	Производитель МФУ не поддерживает автоустановку	Загрузить файл приложения вручную через интерфейс МФУ; обратиться к инструкции вендора или в техподдержку Printum

Что важно для диагностики

Статус приложения на МФУ — в ЛК Мониторинга, карточка устройства.
Логи встроенного приложения — доступны в интерфейсе администратора МФУ.
Версия прошивки МФУ — должна быть совместима с версией встроенного приложения.
Статус токена — в ЛК: Управление → Устройства → кнопка «Сгенерировать токен» / «Удалить токен».

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

Внешнее средство авторизации

Внешнее средство авторизации — справка по компоненту

Назначение

Внешнее средство авторизации — программно-аппаратный комплекс (TCP-конвертер + картридер) для авторизации на МФУ, которые не поддерживают Встроенное приложение.

Сценарии выпуска заданий

Сценарий	Поведение
Все задания	При поднесении карты печатаются все задания из очереди
По одному с последнего	При каждом поднесении — одно задание, начиная с самого нового
По одному с первого	При каждом поднесении — одно задание, начиная с самого старого

Где настраивается

TCPConv (AdminPack) — настройка конвертера
Панель администратора Мониторинга — привязка IP конвертера к принтеру
Панель администратора ПринтМенеджера → DELAYED_PRINT_QUEUE_SETTINGS — сценарий выпуска

Что проверить перед эскалацией

IP конвертера в настройках принтера в Мониторинге
Порт: 7776 (параллельное) или 7777 (последовательное подключение)
Лицензию на Внешнюю авторизацию

Когда используется

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

Основные функции

Авторизация пользователя по RFID-карте через аппаратный картридер.
Выпуск заданий из очереди после прикладывания карты (все сразу, по одному с первого или с последнего).
Привязка: «IP-адрес TCP-конвертера ↔ конкретный принтер/МФУ».
Не требует установки ПО на МФУ.

Связанные компоненты

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

Типовые проблемы

Проблема	Причина	Решение
Задание не выпускается при прикладывании карты	Неверная привязка IP конвертера к принтеру, или карта не зарегистрирована	Проверить привязку в настройках ПМ; убедиться, что карта добавлена для пользователя в Управление → Пользователи → вкладка «Авторизация»
Картридер не считывает карту	Несовместимость типа карты или проблема с оборудованием	Проверить поддерживаемые форматы карт устройством; проверить логи конвертера

Что важно для диагностики

Логи конвертера — доступны через интерфейс устройства.
Привязка конвертера к принтеру — в настройках ПМ.
Наличие карты пользователя в системе — Управление → Пользователи → вкладка «Авторизация».
Наличие заданий в очереди пользователя на момент прикладывания карты.

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

Внешнее средство авторизации

Как работает RFID-авторизация в Принтум

Назначение Принтум поддерживает авторизацию пользователей через RFID-карты и USB-считыватели. RFID-авторизация используется для: быстрого входа на МФУ; release-печати; безопасной идентификации пользователей; исключения ручного ввода логина и пароля; ускорения работы сотрудников. Поддерживаются: HID-считыватели; USB RFID readers; считыватели Elatec; keyboard-emulation устройства. Общая схема работы RFID Card | v USB Reader | v HID Keyboard Emulation | v Встроенное приложение | v Авторизация Принтум | v User Session Как работает авторизация Шаг 1. Пользователь прикладывает карту Пользователь прикладывает RFID-карту к считывателю. Считыватель: считывает UID карты; преобразует UID в последовательность символов; отправляет данные как HID-клавиатура. Шаг 2. Считыватель передает UID Большинство считывателей работают как USB HID Keyboard Device. Для операционной системы считыватель выглядит как обычная клавиатура. Пример: 458712991<ENTER> Где: 458712991 — UID карты; <ENTER> — suffix/carriage return. Шаг 3. Встроенное приложение получает UID Встроенное приложение на МФУ получает UID, отправляет запрос в Принтум и ищет пользователя. Шаг 4. Принтум выполняет поиск пользователя Принтум ищет: пользователя; связанную карту; разрешения; роли; ограничения. Шаг 5. Создание пользовательской сессии Если карта найдена: создается сессия; открывается пользовательский интерфейс; становятся доступны задания печати. Что такое HID Keyboard Emulation Большинство RFID-считывателей работают как клавиатура. Это означает: драйверы обычно не требуются; считыватель печатает UID в активное поле ввода; Принтум получает UID как текст. Это один из самых совместимых способов интеграции. Что такое Prefix и Suffix Считыватель может автоматически добавлять prefix и suffix. Пример: <STX>458712991<ENTER> Чаще всего используется suffix CR (carriage return). Он автоматически подтверждает ввод карты. Почему нельзя включать все типы карт Считыватель может поддерживать: Mifare, ISO14443A, HID, Legic, NFC и другие стандарты. Но включение всех типов карт увеличивает время отклика, замедляет авторизацию и может вызывать ложные срабатывания. Рекомендуется: включать только используемые типы карт; поднимать наиболее используемый тип выше в списке приоритета. Почему скорость считывания зависит от типов карт Считыватель последовательно проверяет каждый включённый тип карт — пока не найдёт совпадение или не пройдёт весь список. Чем больше типов включено — тем дольше цикл опроса на каждое прикладывание карты. При всех включённых типах время считывания может вырасти до 2–3 секунд вместо нормальных 0.3–0.5 секунд . Включать только реально используемые типы карт. Наиболее используемый тип поднимать выше в AppBlaster — он будет проверяться первым. Это самая частая причина жалоб пользователей на медленную авторизацию на МФУ. Что такое VID и PID USB-устройства имеют Vendor ID (VID) и Product ID (PID). Параметры используются для идентификации устройства, настройки Встроенного приложения и фильтрации HID-устройств. После настройки считывателя рекомендуется сохранить VID/PID. Типовые проблемы Симптом Возможная причина Карта не читается Неверный тип карты Медленная авторизация Включено слишком много типов карт UID вводится не полностью Неверный suffix Считыватель не определяется Проблемы драйвера Пользователь не авторизуется Карта не привязана Что проверить при диагностике Проверить USB: устройство должно определяться как HID Device / Keyboard Device. Проверить ввод UID: открыть текстовый редактор и приложить карту — UID должен появиться как обычный текст. Проверить suffix: после UID должен выполняться перевод строки и автоматическое подтверждение. Проверить привязку карты: карта привязана пользователю, пользователь активен и синхронизирован. Что важно помнить RFID-считыватель обычно работает как клавиатура. UID карты используется как идентификатор пользователя. Принтум не хранит данные RFID-карты как credential. Скорость работы зависит от конфигурации считывателя. Правильный выбор типа карт критически важен для стабильной работы. Совместимость картридеров и МФУ Принтум поддерживает широкий спектр карт и картридеров. При выборе оборудования важно понимать ключевые принципы совместимости. Картридер должен быть совместим с МФУ Главное требование – совместимость картридера с конкретной моделью МФУ. На МФУ со Встроенным приложением считыватель подключается к МФУ. При прикладывании карты картридер считывает идентификатор и передаёт его в «мозги» МФУ. Большинство популярных производителей выпускают считыватели, которые работают с нужными устройствами, однако совместимость следует проверять до массового внедрения. Тип карты определяется картридером, не Принтум Поддержка карт (MIFARE, HID iClass, NFC и т.д.) определяется моделью картридера, а не Принтум. Принтум не декодирует карту самостоятельно: он получает номер, который МФУ считает корректным, и использует его для поиска пользователя. Если картридер умеет читать вашу карту и передавать её идентификатор в МФУ, Принтум примет этот номер. Принтум ведёт список проверенных комбинаций Некоторые сочетания «ридер–МФУ» работают нестабильно. Принтум ведёт внутреннюю таблицу сочетаний «картридер–МФУ», которые были протестированы. Она включает сведения о необходимости дополнительной настройки на МФУ (например, для некоторых моделей HP требуется включение специального режима). Рекомендуется ориентироваться на этот список при выборе оборудования. Если вашего картридера в таблице нет, обратитесь к технической поддержке для уточнения сроков сертификации. Несертифицированные картридеры не блокируются, но требуют тестирования Принтум не блокирует использование несертифицированных картридеров. Система готова принять любой считыватель, который правильно передаёт номер карты в МФУ. Однако если оборудование отсутствует в таблице проверенных комбинаций, потребуется индивидуальная проверка совместимости. Иногда проблемы решаются обновлением прошивки картридера или МФУ.

Внешнее средство авторизации

Настройка считывателя Elatec TWN4 Multitech

Назначение

Инструкция описывает настройку RFID-считывателя Elatec TWN4 Multitech для работы с Принтум. Настройка требуется для RFID-авторизации, release-печати, корректного считывания UID карт и работы Встроенных приложений на МФУ.

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

Считыватель Elatec TWN4;
Windows ПК;
USB-подключение;
DevPack от Elatec;
AppBlaster.exe.

Шаг 1. Получение DevPack

Скачайте DevPack с сайта производителя: https://www.elatec-rfid.com/int/twn4-dev-pack

Нажать кнопку Request DevPack.
Заполнить форму.
Следовать инструкциям из пришедших писем.
Распаковать скачанный архив, перейти в папку с содержимым.

В архиве помимо самого приложения для конфигурирования находятся драйвера и шаблоны настроек. Для настройки ридера потребуется приложение AppBlaster.exe.

Шаг 2. Установка драйверов

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

Управление компьютером → Диспетчер устройств → Свойства → Драйвер → Обновить драйвер

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

ВАЖНО: считыватель не имеет настроек для редактирования. Поэтому при каждом изменении (например, добавление нового типа смарт-карт) необходимо устанавливать заранее подготовленную конфигурацию.

Шаг 3. Создание конфигурации в AppBlaster

Запустить AppBlaster.exe.
Выбрать Configurable Project.
В окне создания конфигурации выбрать шаблон Multi Keyboard V4 — этот режим используется для HID keyboard emulation.

Шаг 4. Раздел Transponder Types — настройка типов карт

В разделе Transponder Types добавляются типы карт, с которыми будет взаимодействовать считыватель. Необходимо заранее узнать тип карт, которыми предполагается авторизация, поскольку добавление всех типов нежелательно — это может привести к медленной работе считывателя.

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

Также есть возможность установки приоритета считывания: например, при большинстве добавляемых карт типа Mifare нужно поставить их тип первыми в списке — отклик будет значительно быстрее.

Шаг 5. Раздел Prefix / Field Delimiter / Suffix

Программа даёт возможность указания различных префиксов и суффиксов при считывании карт ридером.

Распространённый суффикс — /r (перевод каретки), который после считывания номера карты указывает, что нужно подтвердить ввод и перейти на следующую строку. Suffix указан в настройках по умолчанию — требуется проверить наличие его записи.

Пример: UID + CR

Шаг 6. Раздел Behavior / Signaling

Настройка позволяет настроить цветовую индикацию на считывателе и реакцию на карту, таймаут.

Шаг 7. Раздел Options

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

Шаг 8. Раздел Security

Используется для расширенных настроек безопасности.

Шаг 9. Раздел Version information

В этом разделе можно сохранить шаблон конфигурации, задать имя и версию.

Шаг 10. Создание и загрузка проекта

Сохранить проект: указать имя, версию, описание.
Нажать Upload для загрузки конфигурации на считыватель.
В процессе загрузки устройство перезагрузится — вы услышите звук переопределения устройства в системе.
При успешно установленной конфигурации в строке вывода появится запись Done.

Шаг 11. Проверка работы

Подготовленный считыватель при подключении к компьютеру определяется как HID-устройство. Перед тем как отключить его от ПК и подключить к МФУ, необходимо сохранить параметры VID и PID.

Проверка в HID-режиме:

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

Шаг 12. Сохранение VID/PID

Перед подключением к МФУ необходимо сохранить параметры VID и PID — они понадобятся для настройки атрибутов в Принтум (Встроенное приложение).

Типовые проблемы

Симптом	Возможная причина
Reader не определяется	Нет драйвера
Медленная работа	Включены лишние типы карт
UID вводится неверно	Ошибка suffix
Нет реакции на карту	Неверный стандарт карты
Встроенное приложение не видит reader	Неверный VID/PID

Что важно помнить

Elatec TWN4 не редактируется на лету.
При изменении конфигурации требуется загрузка нового проекта.
Скорость считывания зависит от выбранных типов карт.
HID keyboard mode — основной рекомендуемый режим работы с Принтум.

Личный кабинет

Личный кабинет — справка по компоненту

Назначение

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

Основные разделы

Раздел	Назначение
Аналитика → Отчёты	Отчёты по устройствам, пользователям, заданиям, событиям
Управление → Устройства	Просмотр и управление принтерами и МФУ, лицензиями, драйверами
Управление → Пользователи	Сотрудники, PIN-коды, карты, правила, квоты
Управление → Задания	Очередь печати, делегирование, удаление
Управление → Склад	Учёт расходных материалов, расчёт потребности
Настройки → Интеграции	Агенты, домены, почта, ПринтМенеджеры
Настройки → Общие	Организация, лицензии, правила печати, события

Что важно помнить

Доступные разделы зависят от роли пользователя
Панель администратора Мониторинга (порт 8001) — отдельный интерфейс для расширенных настроек
Панель администратора ПринтМенеджера (порт 8080) — отдельный интерфейс для настроек ПМ

Когда используется

Личный кабинет — основной веб-интерфейс системы Printum для работы пользователей и администраторов. Открывается в браузере по адресу сервера Мониторинга.

Для администраторов: управление пользователями, устройствами, правилами, квотами, отчётами.
Для пользователей: просмотр и управление очередью заданий, делегирование.
Для операторов/инженеров: мониторинг состояния устройств, склад, отчёты.

Основные функции

Аналитика: отчёты по устройствам, пользователям, заданиям и событиям.
Управление: устройства, пользователи, задания, склад.
Настройки: интеграции с доменом, правила и квоты, уведомления, профили МФУ.
Ролевой доступ: доступные разделы и действия зависят от роли пользователя.

Связанные компоненты

Мониторинг — серверная часть ЛК; ЛК доступен по адресу https://<mon-ip>.
ПринтМенеджер — управление заданиями и устройствами через ЛК.

Где настраивается

Панель администратора Мониторинга: https://<mon-ip>/config
Панель администратора ПринтМенеджера: https://<pm-ip>:8080/config
Роли и права: Настройки → Пользователи → вкладка «Роли»

Типовые проблемы

Проблема	Причина	Решение
Пользователь не может войти в ЛК	Неверный пароль, заблокированная УЗ, или неверная настройка SSO	Проверить статус УЗ; администратор может сбросить пароль или разблокировать пользователя
Раздел недоступен пользователю	Роль пользователя не имеет доступа к данному разделу	Проверить роль пользователя и настройки ролевой модели

Что важно для диагностики

Версия Мониторинга:
```
cat /opt/printum/.version
```
Статус контейнеров:
```
cd /opt/printum && docker-compose ps
```
Логи:
```
docker-compose logs --tail=100
```
Доступность по HTTPS: открыть URL в браузере с рабочей станции

Что проверить перед эскалацией

Версию Мониторинга
Статус всех контейнеров Docker
Логи на предмет ERROR
Роль и права пользователя, если проблема связана с доступом