Сбор диагностических данных
Перед обращением в техническую поддержку необходимо собрать диагностические данные. Это можно сделать с помощью специального скрипта — "dumper.sh". Скрипт можно скачать по ссылке.
Данный скрипт собирает следующие данные:
- postgresql.conf
- .env файл
- логи Offline ELM
- Папка log
- Логи контейнеров elmi-offline-db и elm-token
- файлы system.xml и logback.xml (папка config)
В собранных логах будут указаны серийные номера лицензируемых продуктов и IP-адреса, с которых они выполняли запросы на сервер Offline ELM.
Для сбора данных необходимо:
1. В .env файле включить лог уровня debug.
ELM_KERNEL_LOG_LEVEL=debug ELM_DEBUG_LOG_LEVEL=debug ELM_ENGINE_LOG_LEVEL=debug ELM_DB_LOG_LEVEL=debug ELM_NETWORKING_LOG_LEVEL=debug ELM_SECURITY_LOG_LEVEL=debug ELM_HOSTS_LOG_LEVEL=debug ELM_USERS_LOG_LEVEL=debug ELM_PCSCD_LOG_LEVEL=debug ELM_CLI_KERNEL_LOG_LEVEL=debug ELM_CLI_DEBUG_LOG_LEVEL=debug ELM_CLI_DB_LOG_LEVEL=debug ELM_CLI_NETWORKING_LOG_LEVEL=debug
2. Перезапустить контейнеры.
docker compose down docker compose up -d
3. Дождаться повторения проблемы или выполнить шаги, приводящие к проблеме.
4. Выдать права на выполнение скрипта.
sudo chmod +x ./dumper.sh
5. Запустить скрипт из под sudo в папке с конфигурационными файлами Offline ELM или, указав нужную директорию.
sudo ./dumper.sh elm-offline-data-1.5-1
6. Приложить созданный скриптом архив при обращении в техническую поддержку.
Решение проблем
Не получается зайти в web-интерфейс
Указан неверный адрес подключения или не запущен контейнер elmi-offline-web-ui
1. Проверьте, указанный адрес и порт подключения.
2. Проверьте командой "docker ps -a" статус контейнера elmi-offline-web-ui. Статус должен быть healthy.
Рисунок 25 — Пример сообщения в браузере при попытке подключиться по неверному адресу к web-интерфейсу
Ошибка на этапе авторизации
Не создано разрешающее правило на сервере Offline ELM. После нажатия на кнопку "Войти" в правом верхнем углу будет всплывающее сообщение "Доступ запрещен". При штатной эксплуатации сервер автоматически создаёт разрешающее правило. Если по какой-то причине оно не было создано, его можно добавить через CLI. Подробная информация представлена в документации Offline ELM. Описание пользовательского интерфейса, команда add iprule.
Рисунок 26 — Ошибка "Доступ запрещен"
Посмотреть IP-адрес контейнера elmi-offline-web-ui можно в логах. Пример лога:
elmi-offline-server | 2025-01-31 13:29:04,797 INFO o.e.e.c.RequestLogger.logRequest (line:34) - node017urnni85ri9jbw43y920csf16: Accepted /web/Hello request from 172.19.0.7
Либо с помощью команды "docker inspect". Пример использования команды:
$ docker inspect -f '{{ index .NetworkSettings.Networks "elmi-offline-network" "IPAddress" }}' elmi-offline-web-ui 172.19.0.7
Создать разрешающее IP-правило для контейнера elmi-offline-web-ui.
elmi-iprules> add iprule --group web --action allow --ip 172.19.0.7 OK elmi-iprules>
Сервер недоступен
Данная ошибка возможна, когда контейнер elmi-offline-server не запущен или находится в циклической перезагрузке, а также при первом запуске в течение нескольких минут после поднятия контейнеров.
Если спустя несколько минут подключиться так и не удалось, необходимо проверить состояние контейнеров Offline ELM — все контейнеры должны иметь статус healthy.
Рисунок 27 — Сервер недоступен
Запуск новой инсталляции Offline ELM
Предупреждение
Если с даты начала действия лицензии прошло более 120 дней, при чистом перезапуске Offline ELM (с удалением старой БД) система лицензирования в течение первого часа работы может приостановить процесс лицензирования, по истечении первого часа, процесс лицензирования восстановится. Это не является ошибкой или аварийной ситуацией.
Если с даты начала действия лицензии прошло менее 120 дней, то лицензирование начнет работать сразу после запуска.
1. Выполните сбор данных по инструкции Сбор диагностических данных.
2. Перейдите в папку, где был запущен Offline ELM и остановите контейнеры.
docker compose down -v
3. По инструкции Получение файлов для запуска Offline ELM скачайте конфигурационный файлы.
4. По инструкции Первый запуск Offline ELM в другой папке выполните запуск новой инсталляции Offline ELM.
5. После установки бандла система будем готова к работе сразу, если с момента начала действия лицензии прошло менее 120 дней. Если прошло более 120 дней, лицензирование начнется через 1 час после запуска Offline ELM.