ProjectDB: как продолжить прерванную установку на Linux

6 мин чтения

Практическая диагностика незавершённой установки ProjectDB на Debian и Ubuntu: журнал попытки, состояние APT/dpkg, повторный запуск и признаки полного успеха.

Продолжение выполняет сам установщик: оператор изучает причину сбоя и не редактирует служебные отметки этапов вручную.
  1. ОстановкаСеанс SSH, APT или отдельный этап завершился до общей проверки.
  2. ЖурналОпределяется последняя попытка и первая содержательная ошибка.
  3. ПакетыПроверяются незавершённые операции dpkg и целостность APT.
  4. ПовторТот же официальный установщик читает сохранённый план и пропускает готовые этапы.
  5. КонтрольФинальная проверка создаёт отметку завершения и подтверждает доступность команды projectdb.

Установка ProjectDB на новый сервер меняет несколько подсистем: пакеты ОС, firewall, Node.js, PHP, а при выбранных опциях — Nginx и PostgreSQL. Обрыв SSH, перезапуск сервера или незавершённая операция APT не означают, что нужно удалять созданные файлы и начинать вручную с нуля.

Актуальный установщик ProjectDB для Debian и Ubuntu сохраняет план и отметки выполненных этапов. При повторном запуске он проверяет состояние пакетного менеджера, восстанавливает незавершённые операции и пропускает уже готовые шаги. Задача администратора — сначала понять причину остановки, затем запустить тот же официальный сценарий и проверить финальный результат.

Сначала определите тип остановки

Если терминал ещё открыт, дождитесь возврата приглашения командной строки. После Ctrl+C установщик завершает управляемые дочерние процессы; немедленно запускать вторую копию не следует. Сообщение Another ProjectDB installation is already running означает, что постоянный файл блокировки занят действующим процессом, а не что его нужно удалить.

Проверьте процессы без изменения системы:

pgrep -af 'pdb-install|apt-get|dpkg'

Если виден активный apt-get, dpkg или установщик ProjectDB, дождитесь его завершения либо разберитесь, почему процесс завис. Не удаляйте lock-файлы и не завершайте пакетный менеджер принудительно только ради нового запуска: это может оставить базу пакетов в более сложном состоянии.

Найдите журнал последней попытки

Каждая попытка создаёт отдельный файл вида ~/.projectdb/log/projectdb-install.*.log. Установщик выводит точный путь в начале работы. При запуске от root домашний каталог обычно соответствует /root, но в командах лучше использовать $HOME, а не зашивать путь.

find "$HOME/.projectdb/log" -maxdepth 1 -type f \
  -name 'projectdb-install.*.log' -printf '%T@ %p\n' \
  | sort -nr | head -n 5

Первое число — время изменения, далее расположен путь. Откройте последний файл локально на сервере:

less "$HOME/.projectdb/log/projectdb-install.REPLACE.log"

REPLACE нужно заменить частью имени из предыдущей команды. Ищите не последнюю строку любой ценой, а первый этап с ошибкой и несколько строк перед ним. Сообщение This step could not be completed является итогом; конкретная причина обычно находится выше: недоступный репозиторий, проблема DNS, нехватка места, ошибка подписи пакета или незавершённый dpkg.

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

Проверьте ОС, место и пакетный менеджер

Поддерживаемая система

Основной скрипт выбирает установщик по /etc/os-release. В текущем репозитории указаны Debian 12/13 и Ubuntu 22.04/24.04. Посмотреть фактические значения можно так:

. /etc/os-release
printf 'ID=%s VERSION_ID=%s CODENAME=%s\n' \
  "$ID" "$VERSION_ID" "$VERSION_CODENAME"

На другой версии сценарий останавливается до загрузки платформенного установщика. Подменять значения os-release ради обхода проверки не следует.

Свободное место и память

df -h /
df -h "$HOME"
free -h

Особенно важно проверить файловую систему, где находятся системные пакеты, и домашний каталог root с журналами и временными файлами. Если место закончилось, сначала освободите его понятным и контролируемым способом; не очищайте служебный каталог установки ProjectDB.

Состояние dpkg и APT

Следующие команды выполняют диагностику и не устанавливают новые пакеты:

dpkg --audit
apt-get check

Пустой вывод dpkg --audit и успешное завершение apt-get check означают, что явных незавершённых конфигураций и нарушенных зависимостей не найдено. Если есть ошибка, сохраните её вместе с контекстом журнала. Сам установщик при продолжении выполняет предусмотренную последовательность восстановления, включая проверку dpkg, конфигурирование незавершённых пакетов и исправление зависимостей APT.

Как правильно продолжить установку

Используйте тот же официальный входной скрипт. Не запускайте платформенный файл напрямую и не удаляйте каталог ~/.projectdb/install/server: в нём находятся сохранённый план, отметки завершённых этапов и блокировка параллельного запуска.

curl -fLO \
  https://raw.githubusercontent.com/pavel-elblaus/projectdb/master/dist/pdb-install.sh

less pdb-install.sh
bash pdb-install.sh

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

При найденном незавершённом плане появится сообщение о продолжении предыдущей установки. Готовые этапы отмечаются как Skipped; это нормальное поведение, а не признак пропущенной проверки. Для одного и того же этапа установщик записывает отметку атомарно через временный файл и переименование, поэтому частично записанное состояние не должно считаться завершённым шагом.

Чего не делать при повторном запуске

  • не удаляйте ~/.projectdb/install/server и каталог done;
  • не создавайте и не исправляйте вручную файлы отметок stage-* и complete;
  • не запускайте две установки параллельно в разных SSH-сеансах;
  • не применяйте apt --fix-broken install вслепую до чтения конкретной ошибки;
  • не считайте наличие команды projectdb доказательством завершения всех выбранных этапов.

Последний пункт важен: пакет ProjectDB может быть уже установлен, а настройка firewall, Nginx или PostgreSQL ещё не пройти финальную проверку.

Как подтвердить полный успех

Установка считается завершённой после сообщения 100% ProjectDB installation completed и итоговой строки с длительностью. Только после финальных проверок создаётся общая отметка complete. Её можно проверить без изменения данных:

test -f "$HOME/.projectdb/install/server/complete" \
  && echo 'installation state: complete' \
  || echo 'installation state: incomplete'

Затем подтвердите доступность CLI:

command -v projectdb
projectdb --version
projectdb --help

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

Готовая установка runtime ещё не означает, что прикладной экземпляр запущен. Дальнейшие шаги — соединение с базой и первый запуск — описаны в статье «ProjectDB: от установки runtime к первому приложению». Для постоянной работы выберите один режим из материала о службе Linux и PM2, а перед последующими обновлениями подготовьте паспорт экземпляра ProjectDB.

Критерии завершённой диагностики

  • определён последний журнал и найден первый завершившийся ошибкой этап;
  • нет второй активной установки;
  • dpkg --audit и apt-get check проверены до повторного запуска;
  • служебные отметки ProjectDB не изменялись вручную;
  • повторно использован официальный входной скрипт из реального репозитория;
  • получено финальное подтверждение, создана отметка complete, CLI отвечает.

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

Источники и дальнейшее чтение