# Проблемы Клиента ПМ # Принтеры не появляются на рабочей станции ## Симптом После установки клиента ПринтМенеджер принтер 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 → Службы печати документов → Клиент интернет-печати. Перезагрузите компьютер. ## Логи и диагностические данные ### Где смотреть логи - **Клиент ПМ Windows** — Отправка заданий на печать на ОС Windows Откройте `eventvwr` → Журналы Windows → Приложение → источник _Print Manager Client_ - **Клиент ПМ Linux** — Отправка заданий на печать на ОС Linux sudo journalctl -u printum-printmanager-client.service - **printmanager-app** — Основной контейнер ПМ — формирование списка принтеров для клиентов sudo docker logs printmanager-app ### Что искать в логах - Выявить ошибки запуска сервиса клиента ПМ. - Выявить ошибки передачи данных (список принтеров). - Определить причины возврата кодов 4xx/5xx при запросе списка принтеров. ### Что приложить к обращению в поддержку - Логи клиента ПМ: Windows — Просмотр событий (`eventvwr`) → Журналы Windows → Приложение → источник _Print Manager Client_; Linux — `sudo journalctl -u printum-printmanager-client.service` - Версию ПринтМенеджера: `cat /opt/printmanager/.version` - Описание сценария и шагов воспроизведения - ОС рабочей станции и сервера ## Связанные страницы - [Задание не появляется в очереди печати](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/zadanie-ne-poiavliaetsia-v-oceredi-pecati) # Задание отправлено но не появилось на сервере ## Симптом Пользователь отправил документ на принтер 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` (если регистр логина на АРМ отличается от домена). ## Связанные страницы - [Принтеры не появляются на рабочей станции](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/printery-ne-poiavliaiutsia-na-rabocei-stancii) - [Задание не распечатывается на принтере](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/zadanie-ne-raspecatyvaetsia-na-printere) # Ошибка сертификата при установке Клиента ПМ ## Симптом Клиент ПМ не подключается к серверу ПринтМенеджер по HTTPS — ошибка проверки SSL-сертификата. ## Логи и диагностические данные ### Где смотреть логи - **Клиент ПМ Windows** — Установка на ОС Windows Логи установки: `C:\Program Files\printum\service_install_*.log`, `driver_install_*.log` Логи службы: `eventvwr` → Журналы Windows → Приложение → источник *Print Manager Client* ### Что искать в логах - Выявить ошибки установки, связанные с сертификатами. - Выявить ошибки запуска службы после установки. ### Что приложить к обращению в поддержку - Логи клиента ПМ: Windows — Просмотр событий (`eventvwr`) → Журналы Windows → Приложение → источник *Print Manager Client*; Linux — `sudo journalctl -u printum-printmanager-client.service` - Версию ПринтМенеджера: `cat /opt/printmanager/.version` - Описание сценария и шагов воспроизведения - ОС рабочей станции и сервера ## Решение для 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`. ## Связанные страницы - [Обновление сертификатов Мониторинга и ПринтМенеджера](http://wiki.printum.io/books/6-obnovlenie-i-obsluzivanie/page/obnovlenie-sertifikatov-monitoringa-i-printmenedzera) # Error 401 — пользователь не найден в ПМ (клиент ПМ Linux) ### Симптомы Задание отправлено на печать, но в очереди ПринтМенеджер не появляется. В логах клиента ПМ: ``` Job 00233 for Printum failed: 401 Client Error: Unauthorized for url: https://:8080/create_job ``` или: ``` ipplib.IppTransportException: Error: 401 ``` --- ### Причина Пользователь, авторизованный в ОС Linux, не существует в ПринтМенеджер, или не прошла синхронизация Мониторинг–ПринтМенеджер после добавления пользователя. --- ### Диагностика **Шаг 1. Проверить, существует ли пользователь в ПринтМенеджер:** В панели администратора ПринтМенеджер → Сотрудники: найти пользователя по имени учётной записи Linux → в его карточке проверить наличие Учётной записи с указанным логином и uid. **Шаг 2. Проверить синхронизацию:** Если пользователь есть в Мониторинге, но нет в ПринтМенеджер — не прошла синхронизация Мониторинг–ПринтМенеджер. **Шаг 3. Проверить Ключ доступа ПринтМенеджера:** ```bash cat /opt/printum/printmanager_client/settings.yml | grep access_token ``` Токен должен совпадать с ключом доступа ПринтМенеджера, к которому подключён клиент. --- ### Решение **Если пользователя нет в ПринтМенеджер:** 1. Убедиться, что пользователь существует в Мониторинге. 2. Запустить синхронизацию домена в Личный кабинет → Настройки → Интеграции → Домены. 3. Запустить синхронизацию Мониторинг–ПринтМенеджер: панель администратора М → ПринтМенеджеры → «Синхронизировать». 4. Проверить, появился ли пользователь в панели ПринтМенеджер. **Если `access_token` неверный:** Обновить токен в `settings.yml`: ```bash sudo nano /opt/printum/printmanager_client/settings.yml # Указать актуальный access_token из Личного кабинета → Настройки → Интеграции → ПМ sudo systemctl restart printum-printmanager-client.service ``` --- ### Как проверить результат Отправить тестовое задание от пользователя. Задание появляется в очереди ПринтМенеджер. В логах нет `401`. --- ### Когда эскалировать - Пользователь есть в ПринтМенеджер, токен верный, но ошибка 401 сохраняется. - Синхронизация завершается с ошибкой. Приложить к заявке: логи клиента ПМ, версию ПринтМенеджер, имя пользователя (без персональных данных), конфигурационный файл CUPS на АРМ. --- ### Связанные страницы - [Клиент ПМ на Linux — установка и проверка](https://wiki.printum.io/books/3-ustanovka/page/klient-pm-na-linux-ustanovka-i-proverka) - [Как работает синхронизация пользователей с доменом](https://wiki.printum.io/books/4-integracii/page/kak-rabotaet-sinxronizaciia-polzovatelei-s-domenom) - [Как работает синхронизация Мониторинга и ПринтМенеджера](https://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/kak-rabotaet-sinxronizaciia-monitoringa-i-printmenedzera)