Skip to main content

Чек-лист перед обращением в техническую поддержку

Описание

Для получения качественной и быстрой помощи в обращении необходимо указать версии всех компонентов системы и собрать логи. Ниже описаны проверки работоспособности системы. Рекомендуется использовать после установки системы, крупных обновлений и при исправлении ошибок.


Чек-лист корректности настройки системы мониторинга

  • Найдены все устройства в сети.
  • У всех принтеров и МФУ корректно отображаются модели.
  • По всем принтерам и МФУ корректно отображаются серийные номера.
  • По всем цветным принтерам и МФУ отображаются показания цветного счётчика.
  • По всем принтерам подгружаются запчасти из базы (корректные русские названия, тип — «расходные материалы» или «ресурсные запчасти»).
  • По всем принтерам есть данные по оставшемуся ресурсу расходных материалов, полученных от устройства (в столбце «Оставшийся ресурс» для деталей с типом «Расходные материалы» отображается иконка «принтер»).
  • Нет запчастей с типом «Другое».
  • Не отображаются одновременно несколько картриджей одного цвета и разной ёмкости.

Как определить версии компонентов

Мониторинг и ПринтМенеджер

В терминале сервера введите команды:

cat /opt/printum/.version
cat /opt/printmanager/.version

Клиент ПМ (Windows)

  1. Перейдите в папку с Клиентом ПМ: C:\Program Files\printum\printmanager_client\
  2. Откройте свойства файла as_service.exe.
  3. Перейдите во вкладку «Подробно». В графе «Версия файла» указана версия программы.

Сбор логов

Мониторинг и ПМ

Если установлен Мониторинг и ПринтМенеджер или только Мониторинг:

bash /opt/printum/logs.sh

Если установлен только ПринтМенеджер:

bash /opt/printmanager/logs.sh

Если Мониторинг или ПринтМенеджер установлен с включённым шифрованием .env:

sudo -E ENV_VAULT_PASSWORD=<password> bash /opt/printum/logs.sh

или

sudo -E ENV_VAULT_PASSWORD=<password> bash /opt/printmanager/logs.sh

После завершения выводится сообщение вида:

Логи успешно собраны и сохранены в /путь_к_каталогу/ALL_LOGS/logs-2023-12-06-17-14-44.tar.gz

Собранные логи сохраняются в папке ALL_LOGS в виде архивов. При повторном запуске команды создаются новые архивы — ранее сформированные файлы не перезаписываются.

Включение режима DEBUG

  1. Перейдите в директорию нужного продукта:
    • Мониторинг: cd /opt/printum/
    • ПринтМенеджер: cd /opt/printmanager/
  2. Откройте файл .env: sudo nano .env
  3. Измените параметры:
DEBUG=True
LOG_LEVEL=DEBUG
  1. Перезапустите контейнеры: sudo docker-compose down && sudo docker-compose up -d

Что указать в обращении

  • Версии всех компонентов: Мониторинг, ПринтМенеджер, Клиент ПМ.
  • Архив с логами.
  • Описание симптомов и шагов для воспроизведения.
  • Модель и IP-адрес устройства (при проблемах с конкретным МФУ).
  • Ошибки идентификации из столбца «Ошибки идентификации» (при проблемах с обнаружением).