Общие принципы диагностики проблем при развертывании BPMSoft

В статье описаны основные подходы к диагностике проблем при развертывании BPMSoft.

Перед началом диагностики необходимо:

1. Собрать информацию об инфраструктурной схеме развертываемого решения:
   • Версии операционных систем;
   • Версии всех компонентов BPMSoft.
2. Сравнить конфигурацию с системными требованиями. Если выявлено несоответствие — подобрать совместимые версии операционных систем и компонентов.
3. Выяснить конкретный компонент, в котором возникла проблема, и перейти к соответствующему разделу диагностики:
   • Проблемы с сервером приложений;
   • Проблемы с подключением к базе данных;
   • Проблемы с подключением к серверу кэширования;
   • Проблемы с установкой контейнерных компонентов.

Проблемы с сервером приложений

Если приложение не запускается:

• Убедитесь в корректной установке всех обязательных компонентов согласно инструкции для соответствующей версии приложения:
• Развертывание базы данных для BPMSoft;
• Развертывание сервера кэширования;
• Развертывание BPMSoft на Microsoft Windows;
• Развертывание BPMSoft на Linux.
• Проверьте права учетной записи, от имени которой запускается ApplicationPool (IIS), либо процесс (Kestrel) — она должна иметь права на чтение и изменение файлов в каталоге приложения.

Если приложение запускается, но не работает корректно, убедитесь, что протокол работы приложения (HTTP/HTTPS) настроен правильно.

Проблемы с подключением к базе данных

1. Проверьте содержимое файла ConnectionString.config:
   • Если настройки некорректны — исправьте параметры строк подключения. Подробнее: Настройка ConnectionStrings.config;
   • Если корректны — переходите к анализу настроек сервера базы данных.
     • Если используется PostgreSQL, то необходимо проверить настройки удаленного подключения к СУБД.
2. Выполните анализ проблем с доступностью сервера баз данных:
   • Проверьте сетевую связанность между:
     • Сервером приложения;
     • Сервером базы данных.

Проблемы с подключением к серверу кэширования

1. Проверьте содержимое файла ConnectionString.config:
   • Если настройки некорректны — исправьте параметры строк подключения. Подробнее: Настройка ConnectionStrings.config;
   • Если корректны — переходите к анализу настроек сервера кэширования.
2. Выполните анализ проблем с доступностью сервера кэширования:
   • Проверьте сетевую связанность между:
     • Сервером приложения;
     • Сервером кэширования;
     • Сервером базы данных.
3. Проверьте подключение к серверу кэширования из командной строки сервера:
   Redis
   redis-cli -n [номер_БД]
   • Если подключение не удается:
     • Убедитесь, что номер базы данных не превышает допустимое количество баз в настройках сервера кэширования;
     • Проверьте файлы конфигурации сервера кэширования.
   • Если подключение успешно:
     • Убедитесь в корректной настройке файрволла и наличии разрешения на нужные порты;
     • При необходимости можно очистить базу сервера кэширования:
       Redis
       redis-cli -n [номер_БД] flushdb

Проблемы с установкой контейнерных компонентов

1. Убедитесь, что используете поддерживаемую версию Docker/Kubernetes.
2. Проверьте:
   • Параметры, с которыми выполнялась установка;
   • Конфигурационные файлы и инструкции.
3. Проверьте состояние pods и компонентов микросервисов.
4. Выполните анализ логов проблемных микросервисов за день воспроизведения ошибки.

Информация для обращения в техническую поддержку

Если самостоятельная диагностика не позволила устранить проблему, пожалуйста, соберите следующую информацию и обратитесь в техническую поддержку BPMSoft:

1. Краткое и точное описание возникшей проблемы — подробная информация о проблеме ускоряет анализ и решение.
2. Версия и сборка BPMSoft или микросервисов — эта информация требуется для проверки гипотез на инфраструктуре, приближенной к вашей, а также анализа решенных проблем при выпуске новых версий BPMSoft и микросервисов.
3. Способ развертывания (с указанием используемой инструкции или скриптов установки) — эта информация требуется для проверки гипотез на инфраструктуре, приближенной к вашей.
4. Версия операционной системы, на которой выполняется развертывание — эта информация требуется для проверки гипотез, связанных со спецификой используемой операционной системы.
5. Версия используемой СУБД — эта информация требуется для проверки гипотез, связанных со спецификой работы СУБД.
6. Дата и время возникновения ошибки — эта информация необходима для максимально точного исследования причин возникновения проблемы.
7. Логи приложения за день возникновения ошибки — эта информация необходима для исследования проблемы и причин ее возникновения.
8. Скриншот страницы запуска приложения. При использовании IIS откройте страницу по адресу localhost на сервере — подробная информация об ошибке доступна только при локальном открытии.
9. Параметры серверов, на которых развернуто приложение: количество нод, объем CPU и RAM, наличие прокси-серверов или балансировщиков нагрузки — эта информация требуется для проверки гипотез на инфраструктуре, приближенной к вашей.
10. Значения системных настроек, указанных при установке микросервисов — эта информация требуется для проверки гипотез на инфраструктуре, приближенной к вашей, а также анализа решенных проблем при выпуске новых версий BPMSoft и микросервисов.
11. Конфигурационные файлы BPMSoft и всех задействованных микросервисов — эта информация требуется для анализа режимов работы BPMSoft и микросервисов.

Рекомендуем изучить

Системные требования BPMSoft
Калькулятор системных требований
Развертывание базы данных для BPMSoft
Развертывание сервера кэширования
Развертывание BPMSoft на Microsoft Windows
Развертывание BPMSoft на Linux