Устранение неисправностей

Получение журналов об ошибках при установке

Ошибки, возникающие на различных этапах установки приложения записываются в лог-файл, находящийся по следующему пути:

/tmp/pamir-install-errors.log.

Вывод терминала в процессе установки (stdout) записывается в лог-файл, находящийся по следующему пути:

/tmp/pamir-install.log.

подсказка

Лог-файлы инсталлятора хранятся до перезагрузки узла (если каталог /tmp/ смонтирована как файловая система tmpfs), либо до следующей установки/обновления приложения. Если необходимо сохранить данные журналы для дальнейшей отладки, скопируйте их в надежный каталог.

Повторный запуск миграций БД

В некоторых случаях необходимо повторно применить миграции БД, например, если они не применились при установке или на этапе применения миграций возникла ошибка. В таком случае, после устранения причины ошибки, необходимо перейти в директорию приложения (по-умолчанию, $HOME/.pamir/, либо /opt/pamir/) и выполнить следующие команды:

export COMPOSE_ENV_FILES=.env,.deps.autogen,.auth.autogen,.docker-tool.autogen,.license.autogen,.monitoring.autogen,.notification.autogen,.srm.autogen,.task-tool.autogen
docker-compose --profile migrations up --abort-on-container-failure
docker-compose --profile migrations down
unset COMPOSE_ENV_FILES

примечание

Для выполнения вышеперечисленных команд требуется docker compose plugin версии не ниже 2.27.0. Он поставляется в комплекте с дистрибутивом и находится в директории <root iso>/deps/.

Также плагин устанавливается в систему, если он отсутствует, и при условии, что есть необходимые права на запись в директории /usr/local/lib/docker/cli-plugins/ и /usr/local/bin/. При наличии в системе более старой версии, плагин устанавливаться не будет, а будет использоваться из директории <root iso>/deps/.