Найдите первый неуспешный этап. Проверка более позднего компонента не исправляет ошибку подготовки платформы.
ОС, зависимости и запуск
| Симптом | Что проверить | Как понять, что исправлено |
|---|---|---|
| Нет dotnet или нужного runtime | SDK 8, оба runtime, путь службы | Команды версий и запуск под служебной учётной записью успешны |
| Linux-служба перезапускается | journalctl -u bpmsoft -n 100, WorkingDirectory, конфигурация |
Служба остаётся активной, первая ошибка больше не повторяется |
| IIS возвращает 500.19/500.31 | Hosting Bundle, web.config, runtime | Сайт запускается с тем же пулом без ошибки |
| Отказ записи | Путь из ошибки, учётная запись службы, свободное место | Приложение записывает временные файлы и завершает компиляцию |
| БД не восстановлена | Соответствие архива СУБД и выпуску, первый отказ pg_restore | Восстановление в пустую базу завершается без ошибок |
| Слишком много подключений | Лимиты PostgreSQL и сумма пулов приложений | Есть запас подключений во время компиляции/установки |
Не лечите запуск массовым удалением SysSchema, кэша, пакетов или исходников. Не меняйте ключи шифрования уже работающей системы.
Сеть и HTTPS
Проверьте имя, маршрут, порт, сертификат и прикладную авторизацию из среды инициатора. Для callback инициатором является внешний сервис, а не браузер администратора.
| Симптом | Действие |
|---|---|
| Ошибка имени/сертификата | Сверьте DNS, SAN, срок и цепочку доверия |
| 401/403 | Проверьте предусмотренную авторизацию и права; не открывайте сервис анонимно целиком |
| 404 | Проверьте путь, метод, регистрацию сервиса и префикс публикации |
| 413 | Согласуйте лимит запроса на proxy и в приложении |
| 502/504 | Проверьте запуск upstream и причину длительной операции |
Подключения и точные пути собраны во внутренней сетевой статье. Настройка публикации — в HTTPS.
Установка пакета
Если установка завершилась ошибкой, сохраните полный журнал, имя и контрольную сумму архива, версии платформы и продукта, время и этап. Проверьте зависимости, серверную компиляцию, права службы и свободное место. Не повторяйте установку многократно без устранения первой причины.
Результат установки проверяется в «Установка и удаление приложений», конфигурации и при первичной приёмке. Наличие одного пакета в списке не доказывает успешную установку всего приложения.
Документ, файл или задача недоступны
Сравните лицензии и права обычного сотрудника с действием: раздел, операции объекта, запись, вложение и назначенная задача. Не выдавайте роль администратора ради положительного результата. Для диагностики используйте контрольный документ и второго сотрудника, а не рабочие данные клиента.
Дополнительные функции
- Почта: разделите отправку, получение Listener и изменение маршрута; проверьте каждое отдельно.
- Редактор: отделите получение исходника, завершение сеанса, callback, скачивание результата и появление новой версии.
- LDAP: проверьте синхронизацию, вход и права Документооборота как разные этапы.
- Закрытый контур: проверяйте новый браузерный сеанс и отсутствие необходимых внешних зависимостей, скрытых кэшем.
В передаваемых журналах удаляйте пароли, токены, строки подключения, персональные данные и содержимое документов. Для воспроизведения достаточно версий, времени, этапа, обезличенного идентификатора контрольного объекта и текста ошибки.