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

## Описание

Клиент ПМ — опциональный компонент, устанавливаемый на рабочие станции пользователей. Обеспечивает формирование и отправку печатных заданий на сервер ПринтМенеджера, управление локальным списком МФУ и применение алгоритмов экономии тонера. Поддерживается установка на Windows, Linux, macOS.
Задачи, выполняемые клиентом ПМ:
- Прямая и отложенная печать.
- Экономия тонера (алгоритмы осветления, сглаживания).
- Автоматическое добавление/удаление МФУ на рабочей станции.

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

##### Формирование задания.
В составе клиента есть XPS-драйвер (Windows) или PS-ориентированный драйвер (Linux). Задание формируется и отправляется на сервер ПринтМенеджер.
##### Управление МФУ
Клиент ПМ автоматически добавляет и удаляет МФУ для прямой печати на АРМ пользователя в соответствии с настройками со стороны сервера ПМ.
##### Экономия тонера.
Клиент применяет алгоритм экономии тонера при отложенной и прямой печати заданий пользователя. При низких значениях процента экономии (например, 10%) пользователь не заметит изменений в содержимом напечатанного документа, но фактическое уменьшение количества тонера, используемого принтером продлит срок работы его картриджей тонера.
## Связанные компоненты

- АРМ\терминальный сервер — среда отправки пользовательских заданий.
- Мониторинг — источник пользователей и настроек.
- ПринтМенеджер — сервер, на который клиент ПМ отправляет задания (порт 8080).
---
## Где настраивается

- Файл настроек клиента в Windows:
```
C:\Program Files\printum\printmanager_client\settings.yml
```
- Файл настроек клиента в Linux:
```
/opt/printum/printmanager_client/settings.yml
```
- Токен доступа PM_ACCESS_TOKEN: указан в панели администратора ПринтМенеджера, раздел Главная → Constance → Настройки → Общие настройки.
- Адрес сервера ПМ: задаётся в переменной PRINTMANAGER_BASE_URL при установке на Linux или прописывается вручную, в файле `settings.yml` после установки.

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

| Проблема                                                                     | Причина                                                            | Решение                                                                            |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| Сообщение об отсутствии доверия к драйверу Printum XPS при установке клиента | Не установлен сертификат GlobalSign на АРМ \терминальный сервер.   | Запустить certlm.msc, установить сертификат «ООО Принтум» в "Доверенные издатели". |
| Нет принтеров прямой печати                                                  | Пользователь не найден в ПМ или неверный SID.                      | Проверить наличие пользователя в разделе «Сотрудники».                             |
| Ошибка "Max retries exceeded" при подключении к серверу                      | Сервер ПринтМенеджер недоступен по указанному адресу и порту 8080. | Проверить сетевую доступность сервера ПМ с АРМ\терминального сервера пользователя. |
| Ошибка "Adding printer Printum means critical error"                         | Виртуальный принтер Printum с драйвером Printum XPS не найден.     | Выполнить переустановку клиента ПМ.                                            

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

- Логи Windows:
```
Оснастка Windows "Просмотр событий" → Журналы Windows → Приложения → источник «Print Manager Client»
```
- Логи Linux
```
/var/log/printum/printmanager_client.log
```
- Содержимое файла настроек settings.yml: проверить корректность указанных адреса сервера, токена ПМ, включение\выключение проверки SSL-сертификатов (`verify_SSL_cert` и `verify_cups_ssl`)
- Версия клиента на Windows:
```
C:\Program Files\printum\printmanager_client\as_service.exe → Свойства → Подробно → Версия файла
```
- Сетевая доступность сервера ПМ по порту 8080 с АРМ\терминального сервера пользователя.
---
## Связанные страницы
- [Экономия тонера в Принтум](https://wiki.printum.io/books/2-komponenty-sistemy/page/ekonomiia-tonera-v-printum)
- [Установка Клиента ПМ на Windows вручную](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-klienta-pm-na-windows-vrucnuiu)
- [Установка Клиента ПМ на Windows — групповые политики](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-klienta-pm-na-windows-gruppovye-politiki-s7B)
- [Обновление Клиента ПМ на Windows](https://wiki.printum.io/books/3-ustanovka/page/obnovlenie-klienta-pm-na-windows)
- [Удаление Клиента ПМ на Windows](https://wiki.printum.io/books/3-ustanovka/page/udalenie-klienta-pm-na-windows)
- [Клиент ПМ на Linux — установка и проверка](https://wiki.printum.io/books/3-ustanovka/page/klient-pm-na-linux-ustanovka-i-proverka)
- [Удаление Клиента ПМ на Linux](https://wiki.printum.io/books/3-ustanovka/page/udalenie-klienta-pm-na-linux)
- [Установка Клиента ПМ на macOS](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-klienta-pm-na-macos)