В состав каждого из компонентов JMS (сервера JMS, серверного web-приложения консоли управления) входит утилита сбора диагностической информации Aladdin.EAP.DiagInfo.Terminal, которая позволяет произвести диагностику установленного компонента (или всех установленных на данном хосте). Утилита устанавливается автоматически вместе с устанавливаемым компонентом из дистрибутива. Сбор диагностической информации упаковывается в архивный zip-файл с указанным местом расположения. Опционально предусмотрена генерация отчета о сборе диагностической информации.
Утилита служит для помощи в случаях сложного отказа системы с привлечением специалистов службы поддержки компании-производителя. По окончании процедуры сбора диагностической информации полученные файлы следует направить в службу поддержки компании «Аладдин».
Чтобы выполнить сбор диагностической информации, выполните следующие действия.
- Проверьте корректность конфигурационного файла /opt/eap-diaginfo/Configuration/ProductConfiguration.json, установленного по умолчанию:
[ { "ProductName": "Aladdin R.D. JMS Server", "Path": "/opt/eap-engine", "LogConfigurationFile": "Aladdin.EAP.Engine.log4net", "OutputFormat": "Json", "ConfigFiles": [ "*.config", "*.xml", "*.json", "/etc/aladdin/eap-engine/AppSettings.json" ] }, { "ProductName": "Aladdin R.D. JMS Agent-Terminal", "Path": "/opt/eap-engine/eap-agent", "LogConfigurationFile": "Aladdin.EAP.Agent.Terminal.log4net", "OutputFormat": "Json", "ConfigFiles": [ "*.config", "*.xml", "*.json" ] }, { "ProductName": "Aladdin R.D. JMS Web Admin", "Path": "/opt/eap-web-admin", "LogConfigurationFile": "log4net.config", "OutputFormat": "Json", "ConfigFiles": [ "*.config", "*.xml", "*.json" ] }]При необходимости внесите коррективы в конфигурационный файл. Описание параметров конфигурационного файла приведено в Табл. 9.
Табл. 9 – Параметры конфигурационного файла утилиты сбора диагностической информации
Параметр | Описание |
|---|---|
ProductName | Наименование компонента продукта |
Path | Путь к компоненту продукта |
LogConfigurationFile | Путь к конфигурационному файлу подсистемы логгирования относительно пути к компоненту |
OutputFormat | Тип конечных сериализуемых данных Json/Xml (к примеру, информация об окружении) |
ConfigFiles | Маска для определения конфигурационных файлов в папке с компонентом продукта, полный путь к конфигурационному файлу |
2. Запустите на выполнение утилиту диагностики (EAP.DiagInfo.Terminal) командой следующего вида.
sudo /opt/eap-diaginfo/Aladdin.EAP.DiagInfo.Terminal --zip /mnt/documents/JMS_4LX-Distrib/_diags/2021_09_01_JMS4LX_diags.zip --report /mnt/documents/JMS_4LX-Distrib/_diags/2021_09_01_JMS4LX_diags_report.txtКлючи команды приведены в Табл. 10 (ниже).
В случае успешного выполнения производится выдача следующего вида.
Рис. 36 – Выдача утилиты сбора диагностической информации
Табл. 10 – Ключи команды Aladdin.EAP.DiagInfo.Terminal с примерами использования
Ключ команды | Описание | Обязателен | Значение ключа по умолчания | Пример |
|---|---|---|---|---|
--zip | Путь к конечному Zip-архиву | Нет | ‘<личная папка пользователя>/JMS Diagnostic Data/<yyyy.mm.dd_hh-mm>_DiagnosticData.zip’ | --zip /home/admin/diagnosticData.zip |
--report | Путь к конечному файлу отчёта | Нет | Нет | --report /home/admin/diagnosticReport.txt |