#323: Установка Пассворка завершилась с ошибкой

Отредактирована: 6 дней назад

Сохраните текст ошибки и сообщения перед остановкой установки. Причина может быть связана с загрузкой компонентов, правами пользователя, проверкой архива или запуском служб. Последняя строка вывода часто сообщает только о завершении установки, поэтому следует найти первое сообщение об ошибке.

Проверьте условия установки

Используется инструкция для выбранного способа установки: Docker, Windows Server с PowerShell-модулем или ручная установка
Версия операционной системы и компонентов соответствует требованиям устанавливаемой версии Пассворка
На диске достаточно свободного места для компонентов, распаковки архивов и базы данных
У пользователя есть права на установку компонентов и запись в рабочие каталоги
Выбран подходящий режим установки: онлайн при доступе к репозиториям или офлайн для закрытого контура

Требования к окружению приведены в технической документации.

Если не загружаются компоненты или архив Пассворка

Проверьте адрес, указанный в сообщении об ошибке. Доступность сайта с рабочего компьютера не подтверждает доступность с сервера установки.

При ошибке разрешения имени проверьте DNS на сервере
При тайм-ауте или отказе в соединении проверьте сетевой доступ, межсетевой экран и настройки прокси
При ошибке TLS проверьте дату и время сервера, доверие к сертификатам и наличие подмены сертификатов корпоративным прокси
При ошибке авторизации проверьте API-ключ клиентского портала, если установщик запрашивает ключ

В закрытом контуре следует использовать офлайн-инструкцию. Одного архива Пассворка недостаточно — необходимо заранее подготовить компоненты для выбранного способа установки.

Если установка в Docker остановилась

Проверьте доступность Docker и плагина Docker Compose:

docker version
docker compose version

Если Docker сообщает об отказе в доступе, проверьте права пользователя на работу с Docker. Если клиент не может подключиться к Docker daemon, проверьте состояние службы Docker.

Скрипт passwork_compose_install.sh при ошибках создаёт журнал с именем вида install_log_date.log. Сохраните журнал вместе с выводом терминала.

Если установка дошла до создания контейнеров, выполните из каталога с файлом Docker Compose:

docker compose ps -a
docker compose logs --tail=100

Проверьте контейнеры в состоянии Exited или Restarting и сообщения соответствующих служб. При ошибке занятого порта определите, какой процесс использует порт, и устраните конфликт в настройках размещения.

Если установка через PowerShell остановилась

Убедитесь, что PowerShell запущен от имени администратора.

Если команда Install-Passwork не распознаётся, проверьте выполнение шага установки PowerShell-модуля
Если не устанавливается компонент, сохраните название компонента и полный текст ошибки
Если ошибка возникает при загрузке файлов, проверьте доступ к указанному адресу с сервера
Если установка останавливается при настройке IIS или MongoDB, проверьте состояние соответствующей службы и журнал ошибок

Сообщения об ошибках установки отображаются в PowerShell. Скопируйте текст ошибки вместе с командой запуска и предшествующими сообщениями.

Если ошибка возникла при ручной установке

Продолжайте проверку с этапа, на котором появилась первая ошибка:

При установке пакетов проверьте подключённые репозитории и совместимость версий
При настройке PHP проверьте наличие обязательных расширений и используемый файл конфигурации
При запуске веб-сервера проверьте конфигурацию, пути к файлам и права доступа
При запуске MongoDB проверьте журнал службы, каталог данных и права пользователя службы

Сверяйте настройки с инструкцией для конкретного дистрибутива. Названия пакетов, служб и расположение конфигурационных файлов могут различаться.

Если не проходит проверка цифровой подписи

Повторно получите архив, соответствующий файл подписи и открытый ключ из официального источника. Для офлайн-установки проверьте комплектность файлов и расположение согласно инструкции.

Ошибка проверки может указывать на повреждение архива или несоответствие файлов. Пропуск проверки подписи не устраняет причину ошибки.

Перед повторной попыткой

Устраните выявленную причину и проверьте, какие этапы уже выполнены. Если установщик успел создать контейнеры, службы или базу данных, повторный запуск следует выполнять с учётом текущего состояния установки.

Не удаляйте каталог данных MongoDB, Docker-тома и конфигурационные файлы для повторной установки без проверки содержимого. Удаление может привести к потере уже созданных данных.

Для обращения в техническую поддержку подготовьте:

Версию Пассворка и название архива Пассворка
Способ установки: Docker, PowerShell-модуль или ручная установка
Соберите отладочную информацию
Ссылку на использованную инструкцию
Этап остановки, полный текст ошибки и сообщения перед ошибкой
Информацию о доступе в интернет, использовании прокси и установке в закрытом контуре
Результаты выполненных проверок и сведения о предыдущих попытках установки

Более подробно: