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

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

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

/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/.

Permission denied при подключении к Docker

Ошибка может возникнуть при тестировании подключения к экземпляру Docker в меню Настройки -> Система -> Компоненты, либо при попытке открыть вкладку Docker контейнеры в этом же меню и выглядит следующим образом:

В таком случае следует узнать идентификатор группы docker в хост-системе, где запущен экземпляр Docker Engine. Это делается командой:

getent group docker

Вывод должен быть примерно следующим:

docker:x:122:systemsupport

Откуда следует взять численное значение (122) и указать его в переменную окружения DOCKER_TOOL_DEFAULT_GID сервиса docker-tool:

.docker-tool.override.env

# id группы docker в хост-системе. fix permission denied в компонентах Памир.
DOCKER_TOOL_DEFAULT_GID=122

После чего следует применить параметры командой:

pamirctl start docker-tool