Skip to main content

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

title: Встроенное приложение — диагностика проблем slug: kak-diagnostirovat-problemy-vstroennogo-prilozheniya tags: [встроенное приложение, embedded app, диагностика, МФУ, 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