Проблемы Клиента ПМ

Принтеры не появляются на рабочей станции

Симптом

После установки клиента ПринтМенеджер принтер Printum не появился в списке принтеров на АРМ пользователя.

Диагностика

Шаг 1. Проверить статус службы

Windows: Win+R → eventvwr → Журналы Windows → Приложение → источник ПринтМенеджер Client.

Linux:

sudo systemctl status printum-printmanager-client.service

Шаг 2. Проверить типовые ошибки в логах

Ошибка Решение
No user {'login'} is authorized, removing all printers Пользователь не существует в Printum или неверный SID. Проверьте учётную запись.
Max retries exceeded АРМ не достигает сервер ПМ. Проверьте сетевую доступность и порты.
AssertionError: Adding printer Printum means critical error Принтер Printum не найден или неверный драйвер. Удалите принтер вручную и переустановите клиент.

Шаг 3. Проверить драйвер принтера Printum

В списке принтеров Windows: принтер должен называться Printum и использовать драйвер Printum XPS.

Шаг 4. Windows 7: ошибка «ОС Windows не удается подключиться к принтеру»

Включите компонент «Клиент интернет-печати»: Панель управления → Программы → Включение компонентов Windows → Службы печати документов → Клиент интернет-печати. Перезагрузите компьютер.

Логи и диагностические данные

Где смотреть логи

Что искать в логах

Что приложить к обращению в поддержку

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

Задание отправлено но не появилось на сервере

Симптом

Пользователь отправил документ на принтер Printum, но задание не появилось в системе (нет в разделе «Задания» и на МФУ).

Диагностика

Шаг 1. Проверить логи клиента ПМ

Windows: Win+R → eventvwr → источник ПринтМенеджер Client.

Linux:

cat /var/log/printum/printmanager_client.log

Шаг 2. Проверить подключение к серверу ПМ

Ошибка HTTPSConnectionPool: Max retries exceeded — клиент не достигает сервер. Проверьте подключение с АРМ до test250-158.prtm.tst, например, с помощью ping. Если подключение существует, то проверьте доступность порта 8080, как до АРМ, так и от него.

Шаг 3. Проверить настройку IGNORE_USERNAME_CASE

При бесклиентской печати: убедитесь, что в панели ПринтМенеджер → Системные настройки → Настройки импорта из доменов включена настройка IGNORE_USERNAME_CASE (если регистр логина на АРМ отличается от домена).

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

Ошибка сертификата при установке Клиента ПМ

Симптом

Клиент ПМ не подключается к серверу ПринтМенеджер по HTTPS — ошибка проверки SSL-сертификата.

Логи и диагностические данные

Где смотреть логи

Что искать в логах

Что приложить к обращению в поддержку

Решение для Windows

  1. Откройте корневой сертификат сервера ПринтМенеджер (printum_ca.crt или ca.crt). Скопируйте весь текст (включая -----BEGIN----- и -----END-----).
  2. Откройте файл с правами администратора:
    C:\Program Files\printum\printmanager_client\lib\certifi\cacert.pem
  3. Вставьте скопированный текст в конец файла. Сохраните.
  4. Перезапустите службу или перезагрузите компьютер.

Решение для Linux

systemctl stop printum-printmanager-client.service
# Добавьте CA-сертификат в конец файла:
cat /path/to/ca.crt >> /opt/printum/printmanager_client/venv/lib/python3.10/site-packages/certifi/cacert.pem
systemctl start printum-printmanager-client.service

Для более ранних версий замените python3.10 на python3.8.

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

Error 401 — пользователь не найден в ПМ (клиент ПМ Linux)

Симптомы

Задание отправлено на печать, но в очереди ПринтМенеджер не появляется. В логах клиента ПМ:

Job 00233 for Printum failed: 401 Client Error: Unauthorized for url: https://<pm_host>:8080/create_job

или:

ipplib.IppTransportException: Error: 401

Причина

Пользователь, авторизованный в ОС Linux, не существует в ПринтМенеджер, или не прошла синхронизация Мониторинг–ПринтМенеджер после добавления пользователя.

Диагностика

Шаг 1. Проверить, существует ли пользователь в ПринтМенеджер:

В панели администратора ПринтМенеджер → Сотрудники: найти пользователя по имени учётной записи Linux → в его карточке проверить наличие Учётной записи с указанным логином и uid.

Шаг 2. Проверить синхронизацию:

Если пользователь есть в Мониторинге, но нет в ПринтМенеджер — не прошла синхронизация Мониторинг–ПринтМенеджер.

Шаг 3. Проверить Ключ доступа ПринтМенеджера:

cat /opt/printum/printmanager_client/settings.yml | grep access_token

Токен должен совпадать с ключом доступа ПринтМенеджера, к которому подключён клиент.

Решение

Если пользователя нет в ПринтМенеджер:

  1. Убедиться, что пользователь существует в Мониторинге.
  2. Запустить синхронизацию домена в Личный кабинет → Настройки → Интеграции → Домены. <svg data-v-35ec99d5="" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
  3. Запустить синхронизацию Мониторинг–ПринтМенеджер: панель администратора М → ПринтМенеджеры → «Синхронизировать». <svg data-v-35ec99d5="" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
  4. Проверить, появился ли пользователь в панели ПринтМенеджер.

Если access_token неверный:

Обновить токен в settings.yml:

sudo nano /opt/printum/printmanager_client/settings.yml
# Указать актуальный access_token из Личного кабинета → Настройки → Интеграции → ПМ

sudo systemctl restart printum-printmanager-client.service

Как проверить результат

Отправить тестовое задание от пользователя. Задание появляется в очереди ПринтМенеджер. В логах нет 401.

Когда эскалировать

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

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