# 1. Архитектура и концепции

Архитектура системы, компоненты, конфигурации, сценарии печати

# Что такое Принтум

# Обзор системы Принтум

<!--
keywords: архитектура системы, общая архитектура, структура системы, состав системы, из чего состоит система, основные компоненты системы, серверные компоненты, варианты внедрения, сценарии использования, модули системы
-->
## Кратко

Принтум — российская мультивендорная система мониторинга и управления печатью, копированием и сканированием.
Система состоит из двух основных серверных компонентов:
- Мониторинг — сбор данных об устройствах, пользователях и заданиях, отчёты, интеграции и администрирование.
- ПринтМенеджер — статистика по пользователям и подразделениям, авторизация пользователей и отложенная печать, правила, квоты и архив документов.

## Дополнительные компоненты

В зависимости от сценария внедрения могут использоваться:
Сетевой агент — обнаружение устройств и сбор данных по SNMP.
- Локальный агент — мониторинг локально подключённых устройств и заданий печати.
- Клиент ПринтМенеджера — формирование и отправка заданий печати.
- Встроенное приложение на МФУ — авторизация пользователей и работа с отложенной печатью.
- Внешнее средство авторизации — авторизация пользователей на МФУ без встроенного приложения.

Не все компоненты используются одновременно.

## Основные сценарии использования

### Мониторинг принтеров и МФУ
Система используется для сбора данных об устройствах, их техническом состоянии, объёмах печати и расходах.
В этом сценарии используется только Мониторинг.

### Управление печатью
Система дополнительно обеспечивает:
- статистику по пользователям и подразделениям;
- применение квот и правил печати;
- архив документов.

В этом сценарии используются Мониторинг и ПринтМенеджер.

### Авторизация пользователей на МФУ
Система позволяет идентифицировать пользователя перед выполнением операций печати, копирования и сканирования.

Поддерживаются два варианта реализации:

- Встроенное приложение на МФУ — устанавливается непосредственно на устройство, блокирует устройство для неавторизованного пользователя, обеспечивает авторизацию пользователя, отложенную печать и учёт операций.

- Внешнее средство авторизации — используется для устройств, не поддерживающих встроенные приложения. Авторизация выполняется с помощью считывателя карт, подключенного через TCP-конвертер.

В этом сценарии используются Мониторинг, ПринтМенеджер и одно из средств авторизации пользователей: встроенное приложение на МФУ или внешнее средство авторизации.
Что важно помнить
- Мониторинг является обязательным компонентом системы.
- ПринтМенеджер не может работать без Мониторинга.
- ПринтМенеджер является обязательным компонентом для работы встроенного приложения или внешней авторизации.


## Связанные страницы

- Мониторинг — справка по компоненту

- ПринтМенеджер — справка по компоненту

- Типовые конфигурации развёртывания

- Сценарии печати в Принтум

- Синхронизация Мониторинга и ПринтМенеджера

# Модель пользователей в Принтум

## Назначение

Принтум управляет пользователями, устройствами и заданиями печати.
Для управления доступом, квотами, правилами и статистикой используется собственная модель пользователей, которая не зависит напрямую от структуры домена.

## Ключевые концепции

### Пользователь Printum и доменная учётная запись

Пользователь в Printum (Printum ID) и доменная учётная запись — разные сущности.
Доменная учётная запись существует в Active Directory или другом LDAP-каталоге и используется для аутентификации пользователя.
Printum импортирует доменные учётные записи и создаёт на их основе пользователей системы.

### Один человек — один Printum ID

Printum рассматривает пользователя как реального человека, а не как набор логинов в разных доменах.
Поэтому один пользователь может иметь несколько доменных учётных записей, связанных с одним Printum ID.
Такой сценарий часто используется в организациях с несколькими контурами безопасности или несколькими доменами.

### Правила и квоты применяются к пользователю
Квоты, ограничения, роли и правила печати назначаются пользователю Printum, а не конкретной доменной учётной записи. Статистика также считается по пользователю.
Это позволяет применять единые политики независимо от того, под какой учётной записью работает сотрудник.


## Жизненный цикл пользователя в Принтум

1. Пользователь создаётся в службе каталогов организации.
2. Во время синхронизации Printum импортирует учётную запись и её атрибуты.
3. В системе создаётся или обновляется пользователь Printum.
4. Пользователю назначаются роли, правила и квоты.
5. Пользователь начинает работать с системой.
Пользователи могут создаваться как автоматически при синхронизации с доменом, так и вручную.

## Связанные страницы

- Синхронизация пользователей с доменом

- Объединение доменных учётных записей одного пользователя

- Назначение ролей через группы домена

- Доменная авторизация и SSO

# Авторизация пользователей по картам доступа

<!--
keywords: карта доступа, RFID, NFC, MIFARE, HID, считыватель карт, ридер карт, USB-ридер, картридер, авторизация по карте, авторизация на МФУ, пропуск сотрудника, карта сотрудника, регистрация карты, номер карты, UID карты, идентификатор карты, совместимость карт, совместимость считывателей
-->

# Назначение

Принтум поддерживает авторизацию пользователей на МФУ с помощью карт доступа.
После считывания карты пользователь получает доступ к функциям устройства и своим заданиям печати.

## Поддерживаются ли мои карты

Работа системы не зависит от конкретного типа карты.

Принтум использует идентификатор карты, который передаётся от встроенного приложения на МФУ или внешнего средства авторизации.

Если используемый считыватель способен считать карту и передать её идентификатор, такая карта может использоваться для авторизации в Printum.

## От чего зависит совместимость

Совместимость определяется двумя факторами:
- поддержкой карты используемым считывателем;
- совместимостью считывателя с конкретной моделью МФУ.

Printum не накладывает дополнительных ограничений на типы карт и считывателей.

## Какие карты могут использоваться

В зависимости от используемого оборудования могут поддерживаться:

- MIFARE;
- EM-Marine;
- HID;
- другие RFID-карты.

Фактическая поддержка определяется используемым оборудованием.

## Совместимость картридеров

Printum не взаимодействует с картридером напрямую.

При использовании встроенного приложения идентификатор карты сначала обрабатывается МФУ, после чего передаётся в Printum для поиска пользователя.

Поэтому совместимость определяется следующими факторами:

- совместимость картридера с конкретной моделью МФУ;
- поддержка используемого типа карт самим картридером.

Если картридер корректно работает с МФУ и передаёт идентификатор карты, дополнительной настройки со стороны Printum обычно не требуется.

Некоторые модели МФУ могут требовать включения специальных режимов работы или настройки. Рекомендуется использовать картридеры, рекомендованные производителем устройства или протестированные специалистами Printum.

## Как проверить совместимость оборудования

Перед внедрением рекомендуется проверить:

1. Поддерживает ли картридер используемый тип карт.
2. Поддерживается ли картридер производителем МФУ.
3. Успешно ли выполняется авторизация пользователя в Printum.

При использовании нового оборудования рекомендуется выполнить предварительное тестирование.

## Связанные статьи

- Встроенное приложение
- Внешнее средство авторизации
- Авторизация пользователей на МФУ
- Регистрация карт пользователей

# Типовые конфигурации

# Типовые конфигурации развёртывания

## Кратко

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

## Сравнение конфигураций

| Конфигурация | Когда применять | Отказоустойчивость | | ------------------------ | ------------------------------------- | ---------------------------- | | Сингл | Пилот, небольшая организация | Нет | | Сплит | Средняя нагрузка, разделение ролей | Нет | | Кластер Active-Active | Высокая нагрузка, критичность к сбоям | Да, на уровне ПринтМенеджера | | Филиальный ПринтМенеджер | Удалённые офисы, нестабильный канал | Локальная автономность |

## Кластер Active-Active

Формула: **T = 2F + 1**, где T — количество серверов ПринтМенеджера, F — допустимое число отказов.

| Серверов | Допустимых отказов | Нагрузка | | -------- | ------------------ | ------------------ | | 1 | 0 | до 100 заданий/мин | | 3 | 1 | до 250 заданий/мин | | 5 | 2 | 400+ заданий/мин |

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

- Active-Passive не поддерживается — использовать Active-Active
- Кластеризуется только ПринтМенеджер, Мониторинг не кластеризуется
- Отказоустойчивость PostgreSQL, HAProxy и NFS обеспечивается заказчиком

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

- [Обзор системы Принтум](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/obzor-sistemy-printum)
- [Синхронизация Мониторинга и ПринтМенеджера](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/sinxronizaciia-monitoringa-i-printmenedzera)

# Как Принтум работает при отказе Мониторинга

# Как Принтум работает при отказе Мониторинга

## Назначение

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

Это позволяет:
- не останавливать печать;
- сохранять работоспособность филиалов;
- минимизировать влияние отказа центрального сервера.

## Что происходит при отказе Мониторинга

Если Мониторинг недоступен:
- ПринтМенеджер продолжает работать;
- пользователи могут печатать;
- release-печать продолжает работать;
- авторизация пользователей продолжает работать.

## Что может быть недоступно

Во время отказа Мониторинга могут быть недоступны:
- обновление статистики;
- новые синхронизации пользователей;
- обновление конфигурации;
- часть отчетов.

## Что происходит после восстановления

После восстановления Мониторинга:
- синхронизация продолжается;
- статистика догружается;
- очереди обновляются;
- данные становятся доступны в отчетах.

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

- Мониторинг не участвует напрямую в процессе печати.
- ПринтМенеджер продолжает локальную работу.
- Система поддерживает degraded mode.

# Как работает филиальная архитектура Принтум

# Как работает филиальная архитектура Принтум

## Назначение

Принтум поддерживает распределенную архитектуру с филиалами.

Это позволяет:
- размещать ПринтМенеджер локально в филиале;
- продолжать печать при проблемах связи;
- снижать нагрузку на центральный сервер.

## Общая схема

```text
Центральный Мониторинг
          |
          |
    HTTP Sync
          |
          v
Локальный ПринтМенеджер филиала
          |
          v
Принтеры филиала
```

## Как работает печать

### Центральный Мониторинг

Используется для:
- пользователей;
- конфигурации;
- статистики;
- управления системой.

### Локальный ПринтМенеджер

Используется для:
- локальной обработки печати;
- release-печати;
- работы с очередями;
- взаимодействия с устройствами.

## Что происходит при потере связи

Если связь с центральным Мониторингом потеряна:
- локальный ПринтМенеджер продолжает работать;
- печать продолжается;
- задания сохраняются локально.

## Что происходит после восстановления связи

После восстановления:
- выполняется синхронизация;
- статистика передается в Мониторинг;
- обновляются конфигурации.

# Как работает отказоустойчивый ПринтМенеджер

### Как работает отказоустойчивый ПринтМенеджер

## Назначение

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

### Общая схема

HAProxy | +---------+---------+ | | v v ПринтМенеджер 1 ПринтМенеджер 2 Как работает балансировка HAProxy: распределяет запросы; проверяет доступность узлов; исключает недоступные узлы.

### Что происходит при отказе узла

Если один узел недоступен: HAProxy перенаправляет запросы; пользователи продолжают работать; печать продолжается.

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

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

- НЕ гарантирует

- HA Отказоустойчивая конфигурация

- ПринтМенеджера обеспечивает непрерывность работы при отказе отдельного узла, однако имеет ряд принципиальных ограничений: Не гарантирует отсутствие деградации при failover. Во время переключения между узлами возможны временные задержки и ошибки для активных сессий. Не гарантирует zero downtime. Переключение занимает время; кратковременный простой возможен. Не гарантирует real-time статистику при отказе

- Мониторинга. Если сервер

- Мониторинга недоступен, данные о печати не передаются в реальном времени. Не заменяет резервное копирование. HA защищает от отказа узла, но не от потери данных. Резервные копии необходимо создавать независимо. Не защищает от отказа

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

- В распределённых установках

- Мониторинг обычно расположен в центральном

- ЦОДе, а ПринтМенеджер — в филиалах. Схема построена так, чтобы при пропадании связи между филиалом и центром печать не останавливалась. Вот как это работает: Локальный

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

- МФУ, но может работать автономно. Если связь между

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

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

- ЦОДом надёжными линиями связи, достаточно централизованной конфигурации без локальных

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

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

- ПринтМенеджеров. Основные принципы: Минимум три ноды. Алгоритм отказоустойчивости требует 2F+1 узлов, чтобы пережить отказ

- F узлов. При двух нодах отказ одной приведёт к потере кворума. Балансировщик нагрузки (например, HAProxy) распределяет задания между серверами. Балансировщик можно настроить с резервированием, но сам

- Принтум поставляется с автоматизированными шаблонами настройки

- HAProxy. Обособленные сервисы : база данных

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

- Мониторинг и один из ПринтМенеджеров размещают на одном хосте, остальные

- ПринтМенеджер — на отдельных. Как работает кластер (пошагово) Пользователь отправляет задание на виртуальный

- МФУ Принтум. Балансировщик выбирает живой узел

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

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

- Мониторинг. Зона ответственности заказчика

- Принтум обеспечивает отказоустойчивость приложений, однако ответственность за инфраструктуру остаётся за заказчиком: репликация базы данных и файлового хранилища; отказоустойчивость сети и балансировщика; резервное копирование и аварийное восстановление (DR) серверов. Вывод

- Для надёжной работы

- Принтум в филиалах с ненадёжной связью выбирайте распределённую архитектуру с локальными

- ПринтМенеджерами. При необходимости непрерывной работы в централизованных установках используйте кластер из трёх и более

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

# Как работает балансировка нагрузки

# Как работает балансировка нагрузки

## Назначение

Балансировка нагрузки используется для:
- распределения запросов;
- повышения отказоустойчивости;
- масштабирования системы.

## Используемый компонент

Для балансировки используется HAProxy.

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

Балансируются:
- HTTP API;
- запросы Встроенного приложения;
- запросы авторизации;
- запросы release-печати.

## Как определяется доступность узла

Балансировщик:
- периодически проверяет health-check;
- исключает недоступные узлы;
- возвращает узлы после восстановления.

## Что происходит при отказе узла

Если узел недоступен:
- запросы перенаправляются;
- активные пользователи продолжают работу.

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

- Балансировка не заменяет резервное копирование.
- Все узлы должны иметь одинаковую конфигурацию.

# Режим деградации — что работает при частичном отказе

# Режим деградации — что работает при частичном отказе

## Назначение

Degraded mode — режим частичной деградации системы, при котором часть компонентов недоступна, но ключевые функции продолжают работать.

## Что может вызвать degraded mode

- отказ Мониторинга;
- отказ одного узла ПринтМенеджера;
- потеря связи между площадками;
- временная недоступность LDAP.

## Что обычно продолжает работать

| Функция | Работает |
|---|---|
| Прямая печать | Да |
| Release-печать | Да |
| Авторизация | Да |
| Очереди | Да |

## Что может работать ограниченно

| Функция | Ограничение |
|---|---|
| Статистика | Может обновляться позже |
| Синхронизация | Возможна задержка |
| Отчеты | Возможна неполная информация |

## Что происходит после восстановления

После восстановления:
- выполняется повторная синхронизация;
- восстанавливается статистика;
- обновляются состояния.

# Поддерживаемые сценарии отказоустойчивости

# Поддерживаемые сценарии отказоустойчивости

## Назначение

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

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

| Сценарий | Поддерживается |
|---|---|
| Отказ Мониторинга | Да |
| Отказ одного узла ПринтМенеджера | Да |
| Балансировка через HAProxy | Да |
| Работа филиала без центрального сервера | Да |
| Отложенная синхронизация статистики | Да |

## Что происходит при отказах

### Отказ Мониторинга

Продолжают работать:
- печать;
- release;
- очереди;
- авторизация.

### Отказ узла ПринтМенеджера

Запросы перенаправляются балансировщиком.

### Потеря связи филиала

Локальный ПринтМенеджер продолжает локальную работу.

## Ограничения

Не гарантируется:
- real-time статистика при отказе Мониторинга;
- мгновенная синхронизация после восстановления;
- отсутствие кратковременной деградации при failover.

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

- Отказоустойчивость снижает downtime, но не исключает деградацию.
- Требуется корректная настройка инфраструктуры.

# Отказоустойчивость и деградационные сценарии Printum

---
Page Type: Overview
Component: Printum
Domain: Architecture
Product Versions: All
OS: Not applicable
Status: Draft
Related Components:
  - ПринтМенеджер
  - Мониторинг
  - Сетевой агент
---

# Отказоустойчивость и деградационные сценарии Printum

Printum разрабатывался для предприятий с высокими требованиями к непрерывности печати и
постоянному сбору статистики. Система должна продолжать работать даже при отказах
серверов или проблемах со связью. Эта статья описывает две ключевые темы: **деградационный
режим** (branch‑mode при разрыве связи) и **высокую доступность** (кластер из нескольких
серверов управления печатью).

## Деградационный режим

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

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

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

## Высокая доступность ПринтМенеджер

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

* **Минимум три ноды**. Алгоритм отказоустойчивости требует 2F+1 узлов, чтобы пережить
  отказ F узлов. При двух нодах отказ одной приведёт к потере кворума.
* **Балансировщик нагрузки** (например, HAProxy) распределяет задания между
  серверами. Балансировщик можно настроить с резервированием, но сам Printum
  поставляется с автоматизированными шаблонами настройки HAProxy.
* **Обособленные сервисы**: база данных Printum и файловое хранилище (куда
  помещаются документы и теневые копии) размещаются на отдельном сервере
  или кластере. Отказ сервера с базой данных не должен останавливать всю
  систему, поэтому базу данных и файловое хранилище необходимо реплицировать на
  стороне заказчика.
* **Разделение ролей**: Мониторинг, ПринтМенеджер, база данных и файловое
  хранилище могут быть на разных серверах. На практике часто Мониторинг и
  один из ПринтМенеджер размещают на одном хосте, остальные PM — на отдельных.

### Как работает кластер

1. Пользователь отправляет задание на виртуальный МФУ Printum.
2. Балансировщик выбирает живой узел ПринтМенеджер и передаёт задание.
3. ПринтМенеджер обрабатывает задание, хранит метаданные в общей базе,
   сохраняет файл в общую папку и отправляет на физический МФУ после авторизации.
4. Если один из ПринтМенеджер выходит из строя, балансировщик исключает его из
   пула; остальные узлы продолжают работу без прерывания сервиса. Пока не восстановится
   кворум, система должна поддерживать минимум две активные ноды.
5. Администраторы восстанавливают упавший сервер или вводят новый. Система автоматически
   синхронизирует очереди и статистику через Мониторинг.

## Зона ответственности заказчика

Printum обеспечивает отказоустойчивость приложений, однако ответственность за
инфраструктуру остаётся за заказчиком:

* репликация базы данных и файлового хранилища;
* отказоустойчивость сети и балансировщика;
* резервное копирование и аварийное восстановление (DR) серверов.

## Вывод

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

# Сценарии печати

# Сценарии печати в Принтум

## Кратко

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

## Сравнение сценариев

| Сценарий | Авторизация на МФУ | ПО на рабочей станции | Когда применять | | -------------------- | ------------------ | --------------------------------- | ---------------------------------------------- | | Прямая печать | Не требуется | Клиент ПМ или виртуальный принтер | Личные кабинеты, закрытые зоны | | Отложенная печать | Карта или PIN | Клиент ПМ или виртуальный принтер | Опенспейсы, общие принт-румы | | Бесклиентская печать | По сценарию | Только универсальный PS-драйвер | Быстрое внедрение, ограничения на установку ПО | | Печать через почту | Карта или PIN | Не требуется | Мобильные пользователи, гости |

## Форматы заданий

| Формат | По умолчанию | Особенности | | ---------- | ----------------------- | ---------------------------------------------------------------- | | PDF | Да | Полная поддержка правил, квот, подсчёта страниц и цветности | | PostScript | Нет, включается вручную | Ускоряет обработку. Не работают правила по страницам и цветности |

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

- Пользователь может одновременно использовать прямую и отложенную печать
- Бесклиентская печать не поддерживает экономию тонера
- Для отложенной печати необходим ПринтМенеджер и МФУ со Встроенным приложением

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

- [Клиент ПМ — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/klient-pm-spravka-po-komponentu-aX6)
- [Встроенное приложение — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/vstroennoe-prilozenie-spravka-po-komponentu)
- [Установка бесклиентской печати на Windows](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-besklientskoi-pecati-na-windows)

# Путь задания при печати через Клиент ПМ

## Кратко

### При печати через Клиент ПМ на рабочей станции пользователя установлен компонент

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

### Участники процесса

Компонент Роль Приложение пользователя Создаёт задание печати Локальная очередь печати рабочей станции Принимает задание от приложения Клиент ПМ Забирает задание из локальной очереди, конвертирует и передаёт в ПринтМенеджер ПринтМенеджер Создаёт задание, применяет правила, хранит очередь CUPS ПринтМенеджера Передаёт задание на устройство Встроенное приложение Используется для выпуска отложенных заданий на МФУ Пошаговый путь задания Шаг 1. Пользователь отправляет документ на печать Пользователь в приложении (Word, Excel, браузер) нажимает «Печать» и выбирает МФУ. На этом этапе логика одинакова для прямой и отложенной печати. Шаг 2.

### Приложение создаёт задание в локальной очереди

Пользовательское приложение создаёт задание и отправляет его в локальную очередь печати на рабочей станции. Шаг 3. Клиент ПМ получает задание Клиент ПМ просматривает локальную очередь и забирает из неё новое задание. Шаг 4. Клиент ПМ конвертирует задание в PDF Клиент ПМ преобразует задание в PDF — основной формат для дальнейшей обработки в Принтум. Шаг 5. Клиент ПМ извлекает атрибуты задания Клиент ПМ анализирует задание из локальной очереди и извлекает параметры: Формат Дуплекс Количество страниц Цветность Ориентация Разбор по копиям Финишные опции Шаг 6. Клиент ПМ добавляет задание в очередь ПринтМенеджера После формирования PDF и извлечения атрибутов Клиент ПМ добавляет задание в очередь ПринтМенеджера. Шаг 7. ПринтМенеджер применяет правила печати ПринтМенеджер проверяет и применяет правила печати к заданию. Шаг 8. Клиент ПМ получает настройки оптимизации Клиент ПМ запрашивает из ПринтМенеджера настройки оптимизации (например, параметры экономии тонера). Шаг 9. Клиент ПМ применяет оптимизацию и отправляет образ документа После применения алгоритма экономии Клиент ПМ отправляет образ документа в ПринтМенеджер. Шаг 10.

### Дальнейший путь зависит от типа печати

Прямая печать Клиент ПМ отправляет задание в CUPS ПринтМенеджера. CUPS передаёт задание на конкретный МФУ — документ печатается.

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

Задание остаётся в очереди ПринтМенеджера. Когда пользователь авторизуется на МФУ через Встроенное приложение, приложение запрашивает у ПринтМенеджера список заданий. После нажатия «Печать» ПринтМенеджер отправляет задание в CUPS, CUPS — МФУ. Шаг 11.

### Завершение обработки

После успешной печати ПринтМенеджер: переводит задание в архив; обновляет статистику печати; передаёт статистику в Мониторинг после синхронизации.

### Где искать проблему

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

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

- Задание сначала попадает в локальную очередь рабочей станции, а затем забирается

- Клиентом ПМ. Клиент

- ПМ конвертирует задание в PDF. Клиент

- ПМ участвует в применении оптимизации печати. При прямой печати задание передаётся в CUPS сразу; при отложенной — остаётся в очереди до авторизации на

- МФУ. Статистика появляется в Мониторинге только после синхронизации.

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

- Путь задания при бесклиентской печати

- Как работает отложенная печать

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

- Как диагностировать проблемы печати по этапам

# Путь задания при бесклиентской печати

## Описание

Бесклиентская печать используется, когда на рабочую станцию пользователя нельзя установить клиент ПМ, например, по причине политики запрета ИБ об установке стороннего ПО.
Пользователь печатает на через драйвер виртуального принтера, настроенного на сервер ПринтМенеджера. Универсальный драйвер формирует PostScript-задание и отправляет его в CUPS ПринтМенеджера. Дальше задание обрабатывается ПринтМенеджером. 

#### Поддерживаемые универсальные драйверы

- Xerox Global Print Driver PostScript
- Konica Minolta Universal PS
- HP Universal Printing PS

## Участники процесса

| **Компонент**           | **Действия**                                                           |
| ----------------------- | ---------------------------------------------------------------------- |
| Приложение пользователя | Создаёт задание печати.                                                |
| Универсальный драйвер   | Формирует PostScript-задание.                                          |
| CUPS ПринтМенеджера     | Принимает задание с рабочей станции.                                   |
| ПринтМенеджер           | Создаёт внутреннее задание, парсит атрибуты, применяет правила печати. |
| Встроенное приложение   | Используется для печати заданий на МФУ.                                |
| МФУ                     | Печатает документ                                                      |

---
## Пошаговый путь задания

- **Шаг 1.** Пользователь отправляет документ на печать — пользователь нажимает «Печать» и выбирает виртуальный МФУ Принтум.
- **Шаг 2.** Универсальный драйвер формирует PostScript-задание — универсальный драйвер формирует задание в формате PostScript и отправляет его в CUPS ПринтМенеджера.
- **Шаг 3.** ПринтМенеджер обнаруживает новое задание в CUPS — ПринтМенеджер периодически опрашивает устройства в CUPS. При обнаружении нового задания он создаёт внутри системы собственное пустое задание.
- **Шаг 4.** ПринтМенеджер заполняет задание атрибутами — ПринтМенеджер парсит входящее PostScript-задание и заполняет внутреннее задание атрибутами. Исходное задание фактически не используется как основное — задание пересобирается с нуля. Извлекаются атрибуты: формат, дуплекс, количество страниц, цветность, ориентация, разбор по копиям, финишные опции.
- **Шаг 5.** Проверяется настройка USE_PS_PRINTING:
	- Если USE_PS_PRINTING выключена — задание конвертируется в PDF.
	- Если USE_PS_PRINTING включена — ПринтМенеджер проверяет, есть ли правила:
		- с условиями по количеству страниц;
		- с условиями по цветности страниц;
		- автоматического удаления документа после печати.
	- Если такие правила есть — задание всё равно конвертируется в PDF.
	- Если таких правил нет — конвертация не выполняется.
- **Шаг 6.** Применяются правила печати — ПринтМенеджер проверяет и применяет правила печати к заданию.
- **Шаг 7.** Исходное задание удаляется из CUPS — После того как внутреннее задание сформировано, исходное PostScript-задание, пришедшее с рабочей станции, удаляется из CUPS.
- **Шаг 8.** Дальнейший путь зависит от типа печати:
	- Прямая печать — сформированное задание отправляется в CUPS, CUPS передаёт его МФУ — документ печатается.
	- Отложенная печать — задание остаётся в очереди ПринтМенеджера. Когда пользователь авторизуется во встроенном приложении на МФУ, приложение запрашивает список заданий. После нажатия «Печать» МФУ запрашивает ПринтМенеджер, который отправляет задание в CUPS — CUPS передаёт его МФУ.
- **Шаг 9.** Завершение обработки — после успешной печати ПринтМенеджер переводит задание в архив, обновляет статистику и передаёт её в Мониторинг после синхронизации. 

## Особенности PostScript-режима

PostScript может ускорить обработку задания, но имеет ограничения. Если в системе используются правила по количеству страниц, цветности или автоматическому удалению после печати, ПринтМенеджер конвертирует задание в PDF даже при включённом USE_PS_PRINTING .

---
## Локализация причины проблемы

| **Симптом**                                                       | **Возможная область для диагностики**                                              |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Задание не попало в ПринтМенеджер                             | Драйвер виртуального принтера на АРМ пользователя, CUPS ПринтМенеджера.        |
| Задание появилось, но не печатается                           | ПринтМенеджер, CUPS, протокол подключения принтера в CUPS, драйвер устройства. |
| Правила печати с условиями по страницам/цветности не работают | Формат задания и настройка USE_PS_PRINTING.                                    |
| Пользователь не видит задание на МФУ                          | Очередь пользователя в ПринтМенеджере, встроенное приложение.                  |
## Связанные страницы
- [Путь задания при печати через Клиент ПМ
](https://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/put-zadaniia-pri-pecati-cerez-klient-pm)
- [Как работает отложенная печать](https://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rabotaet-otlozennaia-pecat)
- [Как Принтум использует CUPS](https://wiki.printum.io/books/2-komponenty-sistemy/page/kak-printum-ispolzuet-cups)
- [Как диагностировать проблемы печати по этапам](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/kak-diagnostirovat-problemy-pecati-po-etapam)

# Как работает отложенная печать

## Кратко

Отложенная печать — режим, при котором документ не печатается сразу после отправки. Задание сохраняется в очереди ПринтМенеджера и печатается только после того, как пользователь авторизуется на МФУ и подтвердит печать. Чем отличается от прямой печати Прямая печать Отложенная печать Документ сразу отправляется на устройство после обработки в ПринтМенеджере Документ остаётся в очереди ПринтМенеджера до выпуска пользователем на МФУ Как работает отложенная печать Шаг 1. Пользователь отправляет документ Пользователь выбирает МФУ отложенной печати и отправляет документ. Шаг 2. ПринтМенеджер обрабатывает задание ПринтМенеджер получает задание, анализирует атрибуты, применяет правила печати и сохраняет задание в очереди пользователя. Шаг 3. Задание ожидает в очереди После обработки задание остаётся в очереди ПринтМенеджера. Документ ещё не печатается. Шаг 4. Пользователь авторизуется на МФУ Пользователь проходит авторизацию через Встроенное приложение Принтум на МФУ: по карте; по PIN-коду; другим поддерживаемым способом. Шаг 5. Встроенное приложение получает очередь пользователя После успешной авторизации Встроенное приложение запрашивает у ПринтМенеджера список заданий пользователя. Пользователь видит свои задания на экране МФУ. Шаг 6. Пользователь выбирает задание и нажимает «Печать» Шаг 7. ПринтМенеджер отправляет задание в CUPS ПринтМенеджер отправляет задание в CUPS, CUPS передаёт его устройству — документ печатается. Шаг 8.

### Завершение обработки

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

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

- Документ не печатается сразу — задание хранится в очереди

- ПринтМенеджера. Пользователь видит только свои задания. Для выпуска задания требуется авторизация на МФУ через

- Встроенное приложение. Статистика появляется в Мониторинге только после синхронизации. Типовые проблемы

- Симптом Возможная причина

- Пользователь не видит задания на МФУ Проблема авторизации или очереди

- ПринтМенеджера Задание есть в системе, но не печатается

- Проблема CUPS или устройства

- Пользователь не может авторизоваться

- Проблема Встроенного приложения, PIN или карты

- После печати нет статистики

- Проблема синхронизации

- Мониторинга и ПринтМенеджера

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

- Как работает авторизация на МФУ Как устроена очередь заданий

- Путь задания при печати через Клиент

- ПМ Путь задания при бесклиентской печати

# Как работает авторизация на МФУ

## Кратко

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

## Поддерживаемые методы авторизации

- По карте (считыватель на МФУ).
- По PIN-коду (вводится на экране МФУ).

## Роль Встроенного приложения

Встроенное приложение Принтум на МФУ отвечает за:

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

Для работы Встроенного приложения требуется соответствующая лицензия (EMB).

## Как происходит авторизация

### По карте

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

### По PIN-коду

Пользователь вводит PIN-код на экране МФУ. После успешной проверки пользователь получает доступ к своим заданиям.

## Как пользователь получает очередь

После успешной авторизации:

1. Встроенное приложение отправляет запрос в ПринтМенеджер.
2. ПринтМенеджер возвращает список заданий пользователя.
3. Встроенное приложение отображает очередь на экране МФУ.

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

## Как выполняется печать

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

1. Встроенное приложение отправляет запрос в ПринтМенеджер.
2. ПринтМенеджер отправляет задание в CUPS.
3. CUPS передаёт задание устройству.
4. МФУ печатает документ.

## После завершения работы

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

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

<table id="bkmrk-%D0%A1%D0%B8%D0%BC%D0%BF%D1%82%D0%BE%D0%BC%D0%92%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%B0%D1%8F-%D0%BF%D1%80%D0%B8"><thead><tr><th>Симптом</th><th>Возможная причина</th></tr></thead><tbody><tr><td>Пользователь не может войти по карте</td><td>Проблема карты, считывателя или привязки в системе</td></tr><tr><td>Пользователь не может войти по PIN</td><td>Неверный PIN или проблема синхронизации</td></tr><tr><td>Пользователь вошёл, но не видит задания</td><td>Проблема очереди или принадлежности задания</td></tr><tr><td>Встроенное приложение не открывается</td><td>Проблема приложения или отсутствие лицензии EMB</td></tr></tbody></table>

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

- [Как работает отложенная печать](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rabotaet-otlozennaia-pecat)
- [Как устроена очередь заданий](http://wiki.printum.io/books/2-komponenty-sistemy/page/kak-ustroena-ocered-zadanii)
- [Путь задания при печати через Клиент ПМ](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/put-zadaniia-pri-pecati-cerez-klient-pm)

# Клиент ПМ и бесклиентская схема — сравнение

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

### Что такое

Клиент ПМ Клиент ПМ устанавливается на рабочие станции и состоит из: Виртуального МФУ (драйвер), который собирает задания, формирует PDF и отправляет его на сервер.

### Службы управления

МФУ на рабочей станции, которая автоматически создаёт и удаляет прямые очереди для устройств с разрешённой прямой печатью. Службы экономии тонера , которая регулирует насыщенность и гамму изображения для уменьшения расхода тонера. Преимущества Клиента ПМ Экономия тонера – уникальная возможность снижать расход расходных материалов за счёт снижения плотности заливки. Настройки выполняются на клиенте и применяются до отправки задания на сервер. Удержание задач и Follow Me – задания сохраняются на сервере до авторизации пользователя на устройстве. Это исключает забытые отпечатки и позволяет печатать на любом МФУ с картой или PIN. Автоматическое добавление прямых МФУ – для пользователей, которые должны печатать без авторизации (например, бухгалтерия), система автоматически создаёт локальные очереди. Администратор назначает пользователям доступ к конкретным устройствам, и служба разворачивает драйвер. Полная статистика – ПринтМенеджер получает атрибуты задания и пользователю не нужно устанавливать дополнительные драйверы. Недостатки Клиента ПМ Требуется развёртывание и обслуживание на рабочих станциях. Обычно установка выполняется через Group Policy, но в средах с неоднородными версиями Windows могут возникать сложности. Зависит от политики безопасности.

### На некоторых

АРМ запрещено устанавливать сторонние службы.

### Что такое бесклиентская схема

В этом варианте на рабочие станции не устанавливается Клиент ПМ. Пользователь печатает на виртуальный МФУ, настроенный системным администратором (обычно используется драйвер Generic PostScript или драйвер производителя). При этом: Задание отправляется на сервер напрямую. Сервер получает PostScript- или PDF-файл и обрабатывает его. Пользователь не может удержать задание на сервере – для режима удержания требуется авторизация непосредственно на устройстве (непосредственный режим Follow Me доступен только при наличии Клиента ПМ). Экономия тонера на текущий момент реализована только на клиенте, поэтому при бесклиентской схеме она недоступна. В будущих версиях планируется реализовать функцию экономии на сервере. Автоматическое управление локальными очередями отсутствует.

### Администратор должен вручную добавлять прямые

МФУ на рабочие станции или использовать сторонние инструменты развёртывания.

### Когда выбирать

Клиент ПМ Требуется экономия тонера и гибкие политики печати. Необходим Follow Me : задания должны удерживаться до авторизации на устройстве. Нужно автоматическое разворачивание прямых МФУ для отдельных пользователей/отделов. Компании готовы развернуть клиент через механизмы управления рабочими станциями (GPO, SCCM и т.п.). Когда выбирать бесклиентскую схему Среда жёстко ограничивает возможность установки ПО на рабочие станции. Важна скорость внедрения: достаточно установить драйвер на сервер и перенаправить задания. Для печати используются преимущественно стандартные драйверы (например, Xerox PostScript) и нет необходимости в удержании заданий. Экономия тонера и автоматическое управление очередями не являются ключевыми требованиями. Заключение Выбор между клиентской и бесклиентской схемой зависит от задач. Клиент ПМ даёт больше функциональности – экономию тонера, удержание заданий, управление МФУ – но требует развёртывания. Бесклиентская схема проще в администрировании и пригодна для сред с ограничениями на установку ПО, однако лишает некоторых возможностей. При проектировании системы можно комбинировать подходы: например, использовать Клиент ПМ для большинства пользователей, а в защищённых зонах печатать без клиента.

# Авторизация

# Авторизация пользователей в Принтум

## Кратко

Принтум поддерживает несколько методов авторизации. Основная сущность — Пользователь Принтум (Printum ID), к которому привязываются доменные учётные записи и идентификаторы.

## Методы авторизации

| Метод | Где используется | Протокол | | -------------------------- | ------------------------------------- | --------------------------------- | | Логин + пароль Принтум | Личный кабинет, панели администратора | — | | Доменная авторизация (SSO) | Личный кабинет | Kerberos или SAML 2.0 | | Карта | МФУ | RFID/NFC (MIFARE, HID, EM-Marine) | | PIN-код | МФУ | — |

## Способы добавления данных карты

| Способ | Описание | | ------------------------ | -------------------------------------------------------------------- | | Самостоятельная привязка | Пользователь прикладывает карту на МФУ и вводит PIN. Около 30 секунд | | Импорт из домена | Атрибут карты в настройках синхронизации с доменом | | Импорт из файла | Загрузка CSV или XLS через Личный кабинет | | Ручной ввод | Администратор вводит номер карты в карточке пользователя |

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

- Администратор не видит PIN-коды пользователей
- PIN отправляется пользователю на email после генерации
- Одновременно можно использовать только один протокол SSO: Kerberos или SAML
- При удалении доменного пользователя он восстановится после следующей синхронизации

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

- [Встроенное приложение — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/vstroennoe-prilozenie-spravka-po-komponentu)
- [Пользователь не может авторизоваться на МФУ по PIN](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/polzovatel-ne-mozet-avtorizovatsia-na-mfu-po-pin)
- [Пользователь не может авторизоваться на МФУ по карте](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/polzovatel-ne-mozet-avtorizovatsia-na-mfu-po-karte)

# Лицензирование

# Лицензирование в Принтум

### Общие сведения

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

### В рамках одной установленной системы

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

### Типы лицензий

Бессрочные лицензии Бессрочные лицензии имеют неограниченный срок службы и включают 1 год гарантийной технической поддержки . Начиная со 2-го года для сохранения поддержки и возможности установки обновлений необходимо приобрести продление технической поддержки. Если продление не приобретено, ПО продолжает работу, однако без обновлений и без поддержки со стороны производителя. При оформлении продления после перерыва стоимость пересчитывается в большую сторону — срок новой поддержки исчисляется с момента окончания предыдущего периода.

### Годовые лицензии

Годовые лицензии — это подписка, оплачиваемая ежегодно. Техническая поддержка включена в стоимость подписки.

### После истечения срока действия лицензии

ПО перестаёт функционировать , поэтому важно своевременно продлевать подписку.

### Сравнение типов лицензий

Параметр Бессрочные Годовые Срок действия Неограниченный 1 год (возобновляемая подписка) Техподдержка 1 год включена, далее — платное продление Включена в ежегодную подписку ПО при окончании поддержки Продолжает работать без обновлений Прекращает работу Когда выгоднее Использование 3 года и более Краткосрочные проекты (до 3 лет) Расширение парка Да Да При использовании ПО на протяжении 3 лет или дольше бессрочные лицензии выгоднее. Годовые лицензии оптимальны для краткосрочных проектов.

### Операции с лицензиями

В течение срока действия лицензии разрешается выполнять следующие операции: Обновление версии — установка новых версий программного обеспечения Принтум. Повторная установка — повторная активация лицензии на новом оборудовании. Расширение парка — приобретение дополнительных лицензий при увеличении числа устройств.

### Привязка к устройствам

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

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

- Модули Принтум и их лицензии

- Пробные и NFR лицензии

- Продление и обновление лицензий

# Модули Принтум и их лицензии

## Обзор модулей

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

## Описание модулей

Мониторинг МФУ и МФУ (базовый) Базовый модуль системы — необходим для работы любого другого модуля . Позволяет автоматически находить печатающие устройства в сети заказчика, собирать счётчики и данные по протоколу SNMP, отслеживать состояние устройств, расходных материалов и запчастей, строить отчёты, управлять складом и планировать закупки. Зависимости: нет (является базовым). Мониторинг печати Собирает статистику печати по сотрудникам и отделам без установки централизованного сервера печати и без изменений в текущей инфраструктуре. Позволяет понять, кто и сколько печатает. Не поддерживает установку квот и правил, а также ведение архива распечатанных документов. Зависимости: требует модуль «Мониторинг МФУ и МФУ». Управление печатью Ведёт архив распечатанных документов, позволяет устанавливать квоты и правила печати. Администратор настраивает широкий набор правил: принудительная двусторонняя печать, ограничение цветной печати, запрет монохромной печати на цветных устройствах, перенаправление больших заданий на производительные МФУ и др. Правила применяются для всей организации, отдельных пользователей или отделов. При покупке этого модуля «Мониторинг печати» не нужен. Зависимости: требует модуль «Мониторинг МФУ и МФУ». Встроенное приложение Наиболее удобный способ организовать безопасную печать с авторизацией по карте или пин-коду, а также управление копированием и сканированием.

### Пользователи управляют заданиями прямо на панели

МФУ или МФУ (повторная печать, удаление задания). Обеспечивает теневое копирование и отправку сканов на электронную почту или в сетевую папку. Зависимости: требует модули «Мониторинг МФУ и МФУ» и «Управление печатью». Внешнее устройство авторизации Организует безопасную печать с авторизацией по карточкам на любом сетевом устройстве, не поддерживающем установку встроенных приложений. Требует дополнительное оборудование: TCP-конвертер и картридер. Зависимости: требует модули «Мониторинг МФУ и МФУ» и «Управление печатью». Экономия тонера Снижает расход тонера при печати. Администратор настраивает процент экономии для всей организации или отдельных сотрудников и отделов — на одном устройстве разные пользователи могут печатать с разными настройками экономии. Зависимости: требует модули «Мониторинг МФУ и МФУ» и «Управление печатью». Таблица функционала модулей Функция Мониторинг МФУ и МФУ Мониторинг печати Управление печатью Внешнее устройство авторизации Встроенное приложение Экономия тонера Поиск сетевых МФУ и МФУ + Мониторинг состояния устройств, РМ и запчастей + Отчёты и уведомления + Журнал событий + Управление складом и планирование закупок + Конструктор отчётов + Мониторинг локальных устройств + + Статистика по сотрудникам и отделам + + Архив печати + Квоты и правила печати + Авторизация по карте + + Follow Me + + Авторизация по пин-коду + Теневое копирование + Сканирование в почту или папку + Режим экономии тонера +

# Пробные и NFR лицензии

## Лицензии NFR (не для продажи)

Принтум предлагает партнёрам лицензии NFR для следующих целей:

- внутреннее использование партнёром;
- долговременное тестирование (в качестве пробной версии);
- презентационные и маркетинговые задачи (демонстрации в выставочных залах).

### Характеристики NFR-лицензий

<table id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%A6%D0%B5%D0%BB"><thead><tr><th>Параметр</th><th>Значение</th></tr></thead><tbody><tr><td>Целевая аудитория</td><td>Только партнёры со статусом «Интегратор»</td></tr><tr><td>Назначение</td><td>Не предназначены для передачи клиентам</td></tr><tr><td>Срок действия</td><td>12 месяцев (с возможностью продления)</td></tr><tr><td>Максимальное количество устройств</td><td>До 20</td></tr></tbody></table>

## Пробные лицензии

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

### Лимиты по модулям

<table id="bkmrk-%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C%D0%9C%D0%B0%D0%BA%D1%81%D0%B8%D0%BC%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5-%D1%87"><thead><tr><th>Модуль</th><th>Максимальное число устройств</th></tr></thead><tbody><tr><td>Мониторинг</td><td>до 20</td></tr><tr><td>Управление печатью</td><td>до 20</td></tr><tr><td>Встроенные приложения</td><td>до 5</td></tr></tbody></table>

### Срок действия

Пробная лицензия действительна **60 дней** (по умолчанию). В обоснованных случаях срок может быть увеличен — для этого необходимо обратиться с запросом к представителю Принтум.

### Условия поддержки

На пробные лицензии не распространяются условия поддержки, указанные на странице [https://printum.io/support](https://printum.io/support). Если требуется стандартный уровень обслуживания в ходе пробной эксплуатации, проект должен быть согласован с Принтумом индивидуально. Принтум постарается обеспечить ускоренное время ответа и устранения проблем — с приоритетом сразу после инцидентов для уже оплаченных систем.

### Как запросить пробную лицензию

Заполните форму запроса: [https://printum.io/trial](https://printum.io/trial)

# Продление и обновление лицензий

## Продление технической поддержки для бессрочных лицензий

Бессрочные лицензии включают **1 год гарантийной технической поддержки**. Для сохранения права на получение обновлений ПО и технической поддержки после окончания этого периода необходимо приобрести продление технической поддержки.

Если на 2-й год продление не приобретено — ПО продолжает работу, но:

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

## Что происходит при перерыве в продлении

В случае перерыва в продлении срок действия новой технической поддержки исчисляется **с момента окончания предыдущего периода поддержки** — независимо от даты фактического оформления продления. Это означает, что пропущенный период входит в расчёт, что увеличивает итоговую стоимость.

Пример: если поддержка закончилась в январе, а продление оформляется в июле — новый период всё равно начнётся с января, и партнёр оплачивает в том числе пропущенные 6 месяцев.

## Коммерческие правила поставки

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

- **объединять лицензии** для нескольких проектов или заказчиков в рамках одной поставки;
- **согласовывать отсрочку начала технической поддержки** для части лицензий.

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

# Синхронизация Мониторинга и ПринтМенеджера

# Синхронизация Мониторинга и ПринтМенеджера

## Кратко

Мониторинг является master-сервером конфигурации.

### Все экземпляры

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

### Что синхронизируется

<table>
<thead>
<tr><th>Параметр</th><th>Тип по умолчанию</th></tr>
</thead>
<tbody>
<tr><td>Пользователи</td><td>По расписанию</td></tr>
<tr><td>Группы пользователей</td><td>По расписанию</td></tr>
<tr><td>МФУ</td><td>По расписанию</td></tr>
<tr><td>Группы МФУ</td><td>По расписанию</td></tr>
<tr><td>Правила печати</td><td>По расписанию</td></tr>
<tr><td>Лицензии</td><td>По расписанию</td></tr>
<tr><td>Системные настройки</td><td>По расписанию</td></tr>
<tr><td>Профили настроек на МФУ</td><td>По расписанию</td></tr>
</tbody>
</table>

### Как запустить вручную

Личный кабинет → Настройки → Интеграции → ПринтМенеджеры → кнопка Синхронизировать .

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

- По умолчанию синхронизация выполняется раз в час

- Правила печати применяются только после синхронизации

- Не изменяйте данные пользователей напрямую в ПринтМенеджере

- При диагностике расхождений всегда проверяйте время последней синхронизации

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

- Мониторинг — справка по компоненту

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

- Типовые конфигурации развёртывания

# Как работает синхронизация Мониторинга и ПринтМенеджера

# Как работает синхронизация Мониторинг и ПринтМенеджер

## Кратко

Мониторинг и ПринтМенеджер обмениваются информацией через механизм синхронизации.

Синхронизация требуется для передачи:

- пользователей;
- устройств;
- лицензий;
- статистики;
- изменений конфигурации.

## Что синхронизируется

| Данные |
|---|
| Пользователи |
| Устройства |
| Лицензии |
| Статистика печати |
| Изменения конфигурации |

## Как используется синхронизация

### Пользователи

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

### Устройства

ПринтМенеджер получает информацию об устройствах через синхронизацию.

### Лицензии

Изменения лицензий применяются после синхронизации.

### Статистика

После успешной печати статистика обновляется в ПринтМенеджер и передаётся в Мониторинг после синхронизации.

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

- Изменения применяются не мгновенно.
- Некоторые изменения становятся доступны только после синхронизации.
- При проблемах рекомендуется выполнить ручную синхронизацию.

## Когда проверять синхронизацию

Проверьте синхронизацию, если:

- пользователь не появляется в системе;
- устройство отсутствует;
- лицензия не применяется;
- статистика не обновляется;
- изменения конфигурации не вступают в силу.

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

| Симптом | Возможная причина |
|---|---|
| Нет статистики печати | Проблема синхронизации |
| Устройство отсутствует | Синхронизация устройств не выполнена |
| Лицензия не применяется | Изменения ещё не синхронизированы |
| Пользователь не появился | Проблема синхронизации пользователей |

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

- Компоненты системы Printum
- Как устроена очередь заданий
- Как Printum обрабатывает задание печати

# Процессы внутри системы

# Процессы в Мониторинге

## Обзор

### Мониторинг — компонент

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

### Общий путь данных

Настройка локации ↓ Список IP-адресов ↓ Сканирование сети (параллельно пачками, интервал настраивается) ↓ Список обнаруженных МФУ (идентификация по серийному номеру) ↓ Опрос по SNMP (параллельно пачками, интервал индивидуален для каждого устройства) ↓ Сырые данные (2 000–3 000 строк по умолчанию) → ClickHouse ↓ Интерпретация SNMP: вендор → линейка → модель ↓ Обработанные параметры и события → PostgreSQL ↓ Личный кабинет / Отчёты / Email Этап 1. Настройка локации и формирование списка IP Любая установка начинается с настройки локации. Локация задаётся: диапазонами IP-адресов; или конкретными IP-адресами. На выходе получается список IP, которые агент будет сканировать. По IP-адресу система определяет, к какой локации относится устройство. Этап 2.

### Сканирование сети

Агент опрашивает все IP-адреса из списка локации и формирует список устройств, ответивших по SNMP.

## Особенности

: Опрос идёт параллельно пачками , а не последовательно и не всех сразу. Интервал сканирования настраивается. По умолчанию — раз в час ; для большинства случаев достаточно нескольких раз в сутки. Результат сканирования — список устройств, идентифицированных как МФУ. Этап 3. Автоматическое обнаружение устройств МФУ не добавляются вручную. Единственное требование — устройство должно ответить по одному из IP-адресов в списке локации. После этого оно автоматически появляется в Личном кабинете.

### Идентификация по серийному номеру

Устройство идентифицируется по серийному номеру , а не по IP. Если МФУ переместили и его IP изменился, система автоматически обновит локацию, а вся накопленная статистика сохранится . Этап 4. Опрос устройств по SNMP Обнаруженные устройства регулярно опрашиваются по SNMP для сбора данных. Важные детали: Интервал опроса настраивается в том же конфигурационном файле, что и интервал сканирования. Интервал отсчитывается индивидуально для каждого устройства — после завершения предыдущего опроса этого устройства. Опрос идёт параллельно пачками . Медленно отвечающее устройство не блокирует опрос остальных. Частый опрос не рекомендуется: некоторые устройства могут зависать при большом количестве SNMP-запросов. Этап 5.

### Сырые данные — объём и оптимизация

По умолчанию собираются все данные , которые МФУ может отдать по SNMP. Для среднего устройства это 2 000–3 000 строк (OID и значения). Реально для работы системы нужно 20–50 строк . Когда имеет смысл оптимизировать объём: Парк 5 000–10 000+ устройств и есть ощутимая нагрузка на сервер. Нужно ускорить прохождение данных через все этапы обработки. Когда лучше оставить полный сбор: Парк до нескольких сотен устройств — оптимизация нецелесообразна.

### При полном сборе нужный

OID уже есть в базе — при частичном его просто не будет. Этап 6. Хранение сырых данных — ClickHouse Сырые SNMP-данные (OID + значение) складываются в ClickHouse . ClickHouse оптимизирован для хранения и обработки миллиардов строк и обеспечивает быструю запись потока данных от множества устройств.

### При необходимости вместо

ClickHouse может использоваться ADQM (ArenaData Quick Market) — сертифицированный российский аналог. Этап 7.

### Интерпретация данных

Сырые данные из ClickHouse интерпретируются: из тысяч строк вытягиваются конкретные параметры (счётчики страниц, уровень тонера, серийный номер, статус и т.д.). Интерпретация работает по иерархии от частного к общему: Уровень модели — наивысший приоритет (например, Xerox VersaLink B405). Уровень линейки — если нет настроек для модели (например, все VersaLink). Уровень вендора — если нет настроек для линейки (например, все Xerox). Настройки поставляются из коробки и могут дополняться. Что интерпретируется Значения параметров: счётчики страниц (ч/б, цвет), уровень расходных материалов, серийный номер, время работы. Статус устройства: норма, предупреждение, критичный. События и ошибки: мало бумаги, нет бумаги, мало тонера, замятие, открыта дверь, требуется обслуживание. Коды алертов с детализацией. Критичность событий настраивается — в том числе на уровне отдельных локаций. Этап 8. Обработанные данные — PostgreSQL Проинтерпретированные данные складываются в PostgreSQL . Именно из PostgreSQL данные отображаются в веб-интерфейсе Личного кабинета и попадают в отчёты. Задержка отображения — норма. Интервал опроса, время передачи данных по SNMP и интервал обработки суммируются. Кнопки «принудительного обновления» нет — данные обновляются по расписанию. Уменьшение количества собираемых OID сокращает задержку. Этап 9. Отчёты Отчёты формируются на основе данных из PostgreSQL. Стандартные отчёты : по устройствам, пользователям, событиям, заданиям. Конструктор отчётов : настройка столбцов, сохранение шаблонов. Форматы : веб-интерфейс или Excel. Подписка : регулярная отправка отчёта на email (вложение Excel). Какие данные собираются Модель устройства и серийный номер. IP-адрес и локация. Статус устройства. Счётчики отпечатков (общий, цветной, по автоподатчику). Информация о расходных материалах и ресурсных запчастях.

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

Симптом Возможная причина Устройство не отображается SNMP недоступен или IP не в списке локации Нет данных по ресурсу Устройство не передаёт значения по SNMP Устройство offline Нет сетевой связи с устройством Статус отображается неверно Некорректные SNMP-данные устройства Данные обновляются с большой задержкой Большой объём собираемых OID или высокая нагрузка на сервер

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

- Как Принтум определяет статус устройства

- Как рассчитывается ресурс деталей

- Как работают локальные устройства

# Как рассчитывается ресурс деталей

## Кратко

Принтум может:

- получать данные об оставшемся ресурсе напрямую от устройства по SNMP;
- рассчитывать оставшийся ресурс самостоятельно, если устройство эти данные не передаёт.

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

## Что такое ресурс детали

Ресурс детали — максимальное количество страниц, которое должна отработать деталь. Обычно указывается производителем при 5–6% заполнении листа.

## Когда используются данные устройства

Если устройство передаёт оставшийся ресурс по SNMP, Принтум отображает эти данные. В интерфейсе они помечаются как «получены от устройства».

## Когда ресурс рассчитывается системой

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

## Что такое момент замены

Момент замены — значение счётчика устройства в момент установки новой детали.

## Если момент замены неизвестен

### Сценарий 1: счётчик меньше ресурса

Если ресурс детали = 90 000, а счётчик устройства = 63 720 — система считает, что деталь ещё не заменялась. Момент замены принимается равным 0.

### Сценарий 2: счётчик больше ресурса

Если ресурс детали = 90 000, а счётчик устройства = 212 540 — система рассчитывает предполагаемый момент замены:

```

Количество циклов:      212540 / 90000 = 2
Момент замены:          90000 × 2 = 180 000
```

Такие расчётные значения помечаются символом `*`.

## Как рассчитывается текущий пробег детали

```

Текущий пробег = текущий счётчик − момент замены
Пример:          212 540 − 180 000 = 32 540
```

## Как рассчитывается оставшийся ресурс

```

Оставшийся ресурс = ресурс детали − текущий пробег
Пример:             90 000 − 32 540 = 57 460
```

## Как рассчитывается процент ресурса

```

% ресурса = (оставшийся ресурс / ресурс детали) × 100%
Пример:    (57 460 / 90 000) × 100 ≈ 64%
```

## Почему используются разные счётчики

Не все детали считаются по одному общему счётчику:

<table id="bkmrk-%D0%94%D0%B5%D1%82%D0%B0%D0%BB%D1%8C%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D1%83%D0%B5%D0%BC%D1%8B%D0%B9-%D1%81"><thead><tr><th>Деталь</th><th>Используемый счётчик</th></tr></thead><tbody><tr><td>Чёрный тонер</td><td>Общий счётчик</td></tr><tr><td>Цветной тонер</td><td>Цветной счётчик</td></tr><tr><td>Ролик автоподатчика</td><td>Счётчик автоподатчика</td></tr></tbody></table>

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

- Устройства не всегда передают корректные значения по SNMP.
- Предполагаемые расчёты помечаются символом `*`.
- Для разных деталей могут использоваться разные счётчики.

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

<table id="bkmrk-%D0%A1%D0%B8%D0%BC%D0%BF%D1%82%D0%BE%D0%BC%D0%92%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%B0%D1%8F-%D0%BF%D1%80%D0%B8"><thead><tr><th>Симптом</th><th>Возможная причина</th></tr></thead><tbody><tr><td>Отрицательный ресурс</td><td>Ошибка расчёта</td></tr><tr><td>Ресурс больше 100%</td><td>Некорректные данные устройства</td></tr><tr><td>Фактический ресурс более 200%</td><td>Используется неверный счётчик</td></tr><tr><td>Фактический ресурс менее 50%</td><td>Возможна ложная фиксация замены</td></tr></tbody></table>

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

- [Как работает история замены деталей](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rabotaet-istoriia-zameny-detalei)
- [Как Принтум определяет статус устройства](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-printum-opredeliaet-status-ustroistva)
- [Процессы в Мониторинге](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/processy-v-monitoringe)

# Как работает история замены деталей

## Кратко

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

## Когда фиксируется замена

Система считает, что деталь заменена, если значение оставшегося ресурса **увеличилось более чем на 5%**.

Пример последовательности значений, после которой фиксируется замена:

```
19% → 14% → 8% → 2% → 98%
```

Скачок с 2% до 98% — признак установки новой детали.

## Как определяется момент замены

Система использует комбинацию значений:

- процент оставшегося ресурса;
- текущий счётчик отпечатков устройства.

Пример расчёта при замене картриджа (ресурс = 10 000):

```

Старое значение ресурса:  2%
Новое значение ресурса:   98%
Счётчик устройства:       100 400

Момент замены = 100 400 − (10 000 × 0.02) = 100 200
```

## Уровень инсталляции и деинсталляции

**Уровень инсталляции** — первое значение ресурса после установки детали.

Если уровень инсталляции составляет, например, 67% — это означает, что установлен неполный (частично использованный) картридж.

**Уровень деинсталляции** — последнее зафиксированное значение ресурса перед следующей заменой.

## Как рассчитывается фактический ресурс

Фактический ресурс детали считается как разница счётчиков между двумя заменами:

```

Фактический ресурс = счётчик при деинсталляции − счётчик при инсталляции
Пример:              65 743 − 62 398 = 3 345 страниц
```

## Ложные замены

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

```
77% → 5% → 50%
```

В таком случае система может ошибочно зафиксировать замену детали.

### Как система фильтрует ложные замены

Принтум сравнивает:

- изменение процента ресурса;
- изменение счётчика отпечатков.

Если коэффициент (изменение ресурса / изменение счётчика) превышает 2.5, значение помечается как **ложное** и в историю не записывается.

## Какие значения ресурса игнорируются

Значения `253` и `254` не являются корректными процентами ресурса и игнорируются при обработке SNMP-данных.

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

- Устройства могут передавать ошибочные значения — не все замены определяются идеально.
- Неполные (стартовые) картриджи влияют на расчёт фактического ресурса.
- Для разных деталей используются разные счётчики (общий, цветной, автоподатчика).

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

<table id="bkmrk-%D0%A1%D0%B8%D0%BC%D0%BF%D1%82%D0%BE%D0%BC%D0%92%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%B0%D1%8F-%D0%BF%D1%80%D0%B8"><thead><tr><th>Симптом</th><th>Возможная причина</th></tr></thead><tbody><tr><td>Ложная замена в истории</td><td>Нестабильные данные устройства</td></tr><tr><td>Неверный фактический ресурс</td><td>Используется неверный счётчик</td></tr><tr><td>Ресурс более 100%</td><td>Ошибка в SNMP-данных устройства</td></tr><tr><td>Частые ложные события</td><td>Нестабильные значения от устройства</td></tr></tbody></table>

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

- [Как рассчитывается ресурс деталей](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rasscityvaetsia-resurs-detalei)
- [Процессы в Мониторинге](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/processy-v-monitoringe)

# Как Принтум определяет статус устройства

## Кратко

Принтум определяет состояние устройства на основе трёх источников: SNMP-статус устройства; ошибки и коды алертов; оставшийся ресурс деталей.

### Основные статусы

Цвет Значение Синий Устройство работает нормально Жёлтый Предупреждение или ресурс детали ниже порога Красный Критическая ошибка Серый Устройство недоступно Синий статус Синий статус отображается при одновременном выполнении условий: ресурс всех деталей выше порога; устройство находится в одном из состояний: Idle , Busy/Active , Standby , Moving on-line ; отсутствуют ошибки устройства.

### Жёлтый статус

Жёлтый статус отображается при выполнении одного из условий: ресурс хотя бы одной детали ниже порога (по умолчанию 15% ); устройство находится в состоянии Non Critical Alert Active . Пороговое значение может изменяться на уровне организации.

### Красный статус

Красный статус отображается при состоянии устройства Critical Alert Active . Серый статус Серый статус отображается при состояниях: Moving off-line ; Off-line ; Unavailable . Как отображается ресурс деталей Цвет индикатора Значение ресурса Синий 16–100% Жёлтый 1–15% Красный 0% Настройка критичности событий Критичность одного и того же события может различаться в зависимости от организации. Например, «мало бумаги» — некритично там, где пользователи сами докладывают бумагу, и критично там, где за это отвечает отдельный сотрудник. Настройки по умолчанию можно переопределить — в том числе на уровне отдельных локаций.

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

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

- SNMP. Типовые проблемы

- Симптом Возможная причина

- Неверный статус

- Некорректные SNMP-данные устройства

- Устройство постоянно offline

- Нет сетевой связи с устройством

- Жёлтый статус без видимых ошибок

- Низкий ресурс одной из деталей

- Красный статус

- Критическая ошибка по данным

- SNMP Почему разные вендоры показывают разные данные

- Производители по-разному реализуют

- Printer MIB: одни передают ресурс в процентах, другие — в страницах, третьи возвращают -1 или 0 . Расчётные значения (когда устройство не передаёт данные напрямую) помечаются символом * . Разные детали используют разные счётчики — Принтум рассчитывает ресурс по счётчику отпечатков, если устройство не передаёт данные о расходных материалах. Подробнее: страница «Как устроен

- SNMP и что

- Принтум получает от МФУ».

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

- Как рассчитывается ресурс деталей

- Процессы в Мониторинге

- Как устроен

- SNMP и что

- Принтум получает от МФУ

# Как работают локальные устройства

## Кратко

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

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

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

- Симптом Возможная причина

- Нет статистики по заданиям

- Локальный агент не запущен или не работает

- МФУ не определяется в системе

- Отсутствует идентификатор устройства

- Неверная локация

- Ошибка в IP-адресе компьютера с агентом

- Сброс счётчиков

- Неверно задано стартовое значение

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

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

- Процессы в Мониторинге

# Быстрый старт

# С чего начать — выбор конфигурации

## Выбор конфигурации

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

<table id="bkmrk-%D0%9F%D0%BE%D1%82%D1%80%D0%B5%D0%B1%D0%BD%D0%BE%D1%81%D1%82%D1%8C%D0%A0%D0%B5%D0%BA%D0%BE%D0%BC%D0%B5%D0%BD%D0%B4%D1%83"> <thead><tr><th>Потребность</th><th>Рекомендуемая конфигурация</th></tr></thead> <tbody> <tr><td>Только статистика и отчёты по устройствам</td><td>Только Мониторинг</td></tr> <tr><td>Учёт и контроль печати по пользователям</td><td>Мониторинг + ПринтМенеджер</td></tr> <tr><td>Отложенная печать с авторизацией на МФУ</td><td>+ Встроенное приложение или Внешнее средство авторизации</td></tr> <tr><td>Высокая нагрузка, требование отказоустойчивости</td><td>Кластер Active-Active</td></tr> <tr><td>Удалённые офисы с нестабильным каналом</td><td>+ Филиальный ПринтМенеджер</td></tr> </tbody></table>

# Маршрут внедрения — только Мониторинг

Сценарий Организация хочет мониторить МФУ и получать статистику.

### Шаги Установить Мониторинг Мастер первого запуска: Настройки организации и активация лицензии

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

# Маршрут внедрения — Мониторинг + ПринтМенеджер

## Сценарий

Полное внедрение с управлением печатью.

## Шаги

1. Установить Мониторинг
2. Мастер первого запуска: 
    - Настройки организации и активация лицензии
    - Настройка локаций и запуск сканирования устройств
    - Интеграция с почтовым сервером (опционально)
    - Интеграция с доменом
3. Установить ПринтМенеджер
4. Настроить синхронизацию Мониторинга и ПринтМенеджера
5. Выбрать способ печати: 
    - С Клиентом ПринтМенеджер — установить на рабочие станции
    - Бесклиентская печать — настроить виртуальный принтер
6. Для отложенной печати (опционально): 
    - Установить Встроенное приложение на МФУ
    - Или подключить Внешнее средство авторизации
7. Настроить правила и квоты (опционально)
8. Проверить печать тестовым заданием

# Маршрут внедрения — кластерная конфигурация

## Сценарий

Высокая нагрузка, требование отказоустойчивости.

## Шаги

1. Установить Мониторинг
2. Мастер первого запуска (настройки организации, локации, домен)
3. Подготовить инфраструктуру кластера: 
    - PostgreSQL (внешний)
    - NFS-хранилище
    - HAProxy
4. Установить первый ПринтМенеджер
5. Добавить узлы кластера
6. Проверить балансировку через панель HAProxy
7. Развернуть Клиент ПМ на рабочие станции (через GPO или вручную)
8. Для отложенной печати — установить Встроенное приложение на МФУ

# Жизненный цикл задания печати в Принтум

---
title: Жизненный цикл задания печати в Принтум
slug: zhiznennyy-cikl-zadaniya-pechati
tags: [задание печати, архитектура, путь задания, CUPS, Клиент ПМ, бесклиентская]
domain: Printing
type: Overview
audience: partner-engineer
product_versions: "4.x"
status: Draft
related_components: [ПринтМенеджер, Клиент ПМ, Встроенное приложение]
related_pages:
  - kak-printum-obrabatyvaet-zadanie-pecati
  - put-zadaniia-pri-pecati-cerez-klient-pm
  - put-zadaniia-pri-besklientskoi-pecati
  - kak-rabotaet-otlozennaia-pecat
---

# Жизненный цикл задания печати в Принтум

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

Для понимания полного пути задания — от нажатия «Печать» на АРМ до выхода документа
из МФУ. Помогает локализовать проблему на нужном этапе.

---

## Схемы печати

Принтум поддерживает две схемы отправки заданий:

| Схема | Описание |
|---|---|
| **Через Клиент ПМ** | На АРМ устанавливается Клиент ПМ. Он добавляет виртуальные МФУ, перехватывает задание из локальной очереди, конвертирует в PDF, применяет экономию тонера и передаёт в ПринтМенеджер |
| **Бесклиентская печать** | На АРМ не устанавливается ПО Принтум. Используется универсальный драйвер (Xerox Global Print Driver PS, Konica Minolta Universal PS, HP Universal Printing PS), в котором указан адрес сервера ПринтМенеджера. Драйвер формирует задание и отправляет напрямую в CUPS ПринтМенеджера |

Дальнейшая обработка в ПринтМенеджере одинакова для обеих схем.

---

## Путь задания при бесклиентской печати

### Этап 1 — Отправка с АРМ

Пользователь в приложении (Word, Excel, браузер) нажимает «Печать» и выбирает МФУ —
для прямой или отложенной печати.

Универсальный драйвер формирует задание в формате PostScript (PS) и отправляет его
напрямую в CUPS ПринтМенеджера.

**Компонент:** Универсальный драйвер на АРМ → CUPS ПринтМенеджера

---

### Этап 2 — Получение задания ПринтМенеджером

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

Парсируемые атрибуты:
- формат страницы
- дуплекс
- количество страниц
- цветность
- ориентация
- разбор по копиям
- финишные опции

**Компонент:** `printmanager-celery-print-queue`, `printmanager-app`

---

### Этап 3 — Конвертация

Проверяется настройка `USE_PS_PRINTING`:

- **Выключена** → задание конвертируется в PDF.
- **Включена** → конвертация в PDF выполняется только если есть правила по цветности/количеству страниц или правило автоудаления. В остальных случаях — остаётся в PS.

**Компонент:** `printmanager-app`

---

### Этап 4 — Применение правил печати

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

Исходное задание, пришедшее с АРМ, удаляется из CUPS — далее используется только
пересобранное задание ПринтМенеджера.

**Компонент:** `printmanager-app`

---

### Этап 5а — Прямая печать

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

**Компонент:** `printmanager-cups`

---

### Этап 5б — Отложенная печать

Задание остаётся в очереди ПринтМенеджера. При авторизации пользователя на МФУ
Встроенное приложение запрашивает у ПринтМенеджера список заданий пользователя.
При нажатии «Печать» в приложении МФУ отправляет запрос в ПринтМенеджер →
ПринтМенеджер передаёт задание в CUPS → CUPS передаёт на МФУ → МФУ печатает.

**Компонент:** `printmanager-app`, `printmanager-cups`, Встроенное приложение

---

### Этап 6 — Архивирование и статистика

После успешной печати ПринтМенеджер переводит задание в архив и обновляет статистику.
В Мониторинг обновлённая статистика попадает после синхронизации.

**Компонент:** `printmanager-app`, синхронизация с Мониторингом

---

## Путь задания при печати через Клиент ПМ

### Этап 1 — Отправка с АРМ

Пользователь нажимает «Печать» в приложении → задание попадает в локальную очередь
печати АРМ (системная очередь Windows/Linux).

**Компонент:** ОС АРМ

---

### Этап 2 — Перехват Клиентом ПМ

Клиент ПМ отслеживает локальную очередь печати, получает задание и конвертирует его
в PDF.

Клиент ПМ парсит атрибуты задания (те же что и при бесклиентской печати).

**Компонент:** Клиент ПМ

---

### Этап 3 — Передача в ПринтМенеджер и применение правил

Клиент ПМ добавляет задание в очередь ПринтМенеджера. ПринтМенеджер проверяет и
применяет правила печати.

**Компонент:** Клиент ПМ → `printmanager-app`

---

### Этап 4 — Экономия тонера

Клиент ПМ запрашивает из ПринтМенеджера настройки оптимизации (экономия тонера)
и применяет алгоритм к документу. После этого передаёт образ документа обратно
в ПринтМенеджер.

**Компонент:** Клиент ПМ

---

### Этап 5а — Прямая печать

Клиент ПМ отправляет задание в CUPS ПринтМенеджера → CUPS передаёт на МФУ →
МФУ печатает.

**Компонент:** Клиент ПМ → `printmanager-cups`

---

### Этап 5б — Отложенная печать

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

**Компонент:** `printmanager-app`, `printmanager-cups`, Встроенное приложение

---

### Этап 6 — Архивирование и статистика

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

**Компонент:** `printmanager-app`, синхронизация с Мониторингом

---

## Сводная таблица: этап → компонент → диагностика

| Этап | Схема | Компонент | Где искать если проблема |
|---|---|---|---|
| Отправка с АРМ | Клиентская | Клиент ПМ, локальная очередь ОС | Лог Клиента ПМ; `journalctl` или Event Viewer |
| Отправка с АРМ | Бесклиентская | Универсальный драйвер | Настройки драйвера; порт CUPS (631) |
| Получение CUPS | Обе | `printmanager-cups`, `printmanager-celery-print-queue` | `docker-compose logs printmanager-cups` |
| Парсинг и создание задания | Обе | `printmanager-app` | `docker-compose logs printmanager-app` |
| Конвертация PS→PDF | Обе | `printmanager-app` | `docker-compose logs printmanager-app` |
| Применение правил | Обе | `printmanager-app` | `docker-compose logs printmanager-app` |
| Экономия тонера | Клиентская | Клиент ПМ | Лог Клиента ПМ |
| Отложенная очередь | Обе | `printmanager-app` | `docker-compose logs printmanager-app`; панель ПринтМенеджера → Задания |
| Авторизация на МФУ | Отложенная | `printmanager-app`, `printmanager-converter-server` | `docker-compose logs printmanager-app` |
| Печать на МФУ | Обе | `printmanager-cups` | `docker-compose logs printmanager-cups` |
| Синхронизация статистики | Обе | `printmanager-celery`, `printum_worker-*` | `docker-compose logs printmanager-celery` |

---

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

- [Как Принтум обрабатывает задание печати](kak-printum-obrabatyvaet-zadanie-pecati)
- [Путь задания при печати через Клиент ПМ](put-zadaniia-pri-pecati-cerez-klient-pm)
- [Путь задания при бесклиентской печати](put-zadaniia-pri-besklientskoi-pecati)
- [Как работает отложенная печать](kak-rabotaet-otlozennaia-pecat)
- [Справочник контейнеров — где искать логи](spravochnik-konteinerov-gde-iskat-logi)