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, CanonFplus, иLexmark, другиеAvision

    Настройка не требующая установки пакета приложений:

      Brother, Epson

      Для получения инструкций по конкретному вендору и модели —необходимо направить запрос в ТП:Техническую поддержку: 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-serverf --tail=100
          Выполнить запрос из встроенного приложения, например: авторизоваться. В логах проверить наличие запросов в контейнере printmanager-web_1

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

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

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

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

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

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

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

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

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

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

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