Skip to main content

Встроенное приложение — диагностика проблем

title: Встроенное приложение — диагностика проблем slug: kak-diagnostirovat-problemy-vstroennogo-prilozheniya tags: [встроенное приложение, Встроенное приложение, диагностика, МФУ, Kyocera, Xerox, Ricoh, Lexmark, Pantum] domain: Troubleshooting type: Runbook audience: partner-engineer product_versions: "4.x" status: ready related_components: [Встроенное приложение, ПринтМенеджер, Мониторинг] related_pages:

  • ts-vstroennoe-prilozhenie-ne-ustanavlivaetsya
  • ts-vstroennoe-prilozhenie-belyy-ekran
  • ts-zadaniya-ne-otobrazhaetsya-v-prilozhenii
  • ts-avtorizaciya-po-karte-ne-rabotaet-v-prilozhenii
  • ts-ricoh-postoyannyy-zapros-tokena
  • kak-rabotaet-avtorizaciya-na-mfu

Встроенное приложение — диагностика проблем

Как устанавливается приложение

Автоматическая установка из ЛК (кнопка «Установить приложение»):

  • Xerox, Konica Minolta, HP, Sharp, Ricoh

Ручная установка через интерфейс МФУ с токеном:

  • Kyocera, Lexmark, Pantum, Canon и другие

Для получения инструкций по конкретному вендору и модели — запрос в ТП: support@printum.io

Предусловия для работы приложения

Перед диагностикой убедиться, что выполнены все условия:

  • Устройство добавлено в Мониторинг и опрашивается (статус не серый).
  • У устройства есть лицензия M (мониторинг) + PM (управление печатью) + EMB (встроенное приложение).
  • Синхронизация Мониторинг–ПринтМенеджер выполнена (ЛК → Настройки → Интеграции → ПринтМенеджер).
  • МФУ доступен по сети с сервера ПринтМенеджер (проверить ping <ip_мфу> с сервера).
  • Версия прошивки МФУ соответствует требованиям (запросить у ТП список совместимых прошивок).

Алгоритм диагностики

Шаг 1. Проверить лицензии

ЛК → Управление → Устройства → развернуть карточку → вкладка «Лицензии».

Должны быть активны: M, PM, EMB. Если EMB отсутствует — нажать «Установить приложение» или «Сгенерировать токен».

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

Если приложение установлено, но настройки (пользователи, правила, PIN-коды) не применяются — запустить синхронизацию Мониторинг–ПринтМенеджер вручную.

Шаг 3. Проверить логи ПринтМенеджер

cd /opt/printmanager
sudo docker-compose logs printmanager-app --tail=100 | grep -i "error\|embed\|auth"
sudo docker-compose logs printmanager-converter-server --tail=100

Шаг 4. Проверить доступность ПринтМенеджер с устройства

МФУ должен иметь сетевой доступ к серверу ПринтМенеджер. Проверить с сервера ПринтМенеджер:

ping <ip_мфу>
curl -k https://<ip_мфу>/

Если МФУ недоступен с сервера ПринтМенеджер — сетевая проблема, решается на стороне заказчика.

Шаг 5. Переустановить приложение

Если предыдущие шаги не дали результата:

  1. В ЛК → Управление → Устройства → «Удалить приложение» (или «Удалить токен»).
  2. Перезагрузить МФУ.
  3. Установить заново.

Навигация по конкретным проблемам

Симптом Статья
Приложение не устанавливается, ошибка при установке Встроенное приложение не устанавливается
Белый экран или приложение не открывается Белый экран во встроенном приложении
Пользователь авторизовался, но заданий нет Задания не отображаются в приложении
Авторизация по карте не работает Авторизация по карте не работает во встроенном приложении
Ricoh: приложение постоянно запрашивает токен Ricoh — постоянный запрос токена
Xerox: сканирование/копирование не работает без ошибок Xerox — сканирование не работает, ошибок нет

Что приложить при эскалации в ТП

  • Вендор и модель МФУ, версия прошивки.
  • Версия приложения (есть в ЛК или в интерфейсе МФУ).
  • Версии М и ПринтМенеджер.
  • Логи printmanager-app и printmanager-converter-server.
  • Описание симптома: что именно происходит на экране МФУ.
Back to top