Обновление OnlyOffice Document Server с Debian 12 до Debian 13 может привести к сбоям запуска из-за конфликтов конфигурации и RabbitMQ. Разбираем причины и способы исправления.
Обновление операционной системы на сервере с работающим OnlyOffice Document Server (DS) — задача не из простых. Переход с Debian 12 (Bookworm) на Debian 13 (Trixie) добавляет свои сложности: меняются версии системных библиотек, обновляется RabbitMQ, а пакет DS может содержать новые параметры конфигурации, которых нет в вашем старом файле настроек. В этой заметке я собрал проблемы, с которыми столкнулся лично, и то, как их можно обойти.
Проблема 1: Скрипт остановки зависает на «Preparing for shutdown»
При обновлении пакета onlyoffice-documentserver вы можете увидеть, что процесс dpkg завис на строке Preparing for shutdown, it can take a lot of time, please wait... и не двигается с места более 10–20 минут.
Это связано с работой скрипта documentserver-prepare4shutdown.sh, который принудительно отключает пользователей перед остановкой службы. Согласно документации ONLYOFFICE, выполнение этого скрипта может занимать до 5 минут, так как он ждёт, пока все пользователи закроют документы [citation:2][citation:14]. Однако на практике скрипт может зависнуть навсегда, если какая-то из внутренних служб (например, RabbitMQ или PostgreSQL) не отвечает корректно.
Что делать: Если процесс висит более 10 минут, его нужно принудительно завершить. Найдите PID процесса dpkg или apt и завершите его:
sudo kill -9 <PID>
Затем восстановите состояние базы данных пакетов:
sudo dpkg --configure -a
Если и эта команда снова зависает на том же скрипте, можно временно закомментировать вызов documentserver-prepare4shutdown.sh в файле /var/lib/dpkg/info/onlyoffice-documentserver.prerm (или .postrm), чтобы обойти зависание, а после завершения обновления разобраться с причиной.
Проблема 2: RabbitMQ не запускается после обновления Debian
После обновления системы до Debian 13 вы можете обнаружить, что apt -f install или dpkg --configure -a завершаются ошибкой на пакете rabbitmq-server. Служба RabbitMQ не стартует, а dpkg не может завершить настройку.
Причина в том, что при обновлении с Debian 12 на Debian 13 версия RabbitMQ меняется, и новая версия может быть несовместима со старыми данными в каталоге mnesia. Если RabbitMQ ранее использовался (в нём есть очереди или сообщения), новая версия не запустится из-за отсутствия необходимых feature flags в базе данных.
Решение (если данные RabbitMQ не нужны)
Остановите RabbitMQ, переименуйте или удалите каталог с данными и создайте пустой:
sudo systemctl stop rabbitmq-server 2>/dev/null sudo mv /var/lib/rabbitmq/mnesia /var/lib/rabbitmq/mnesia.old sudo mkdir -p /var/lib/rabbitmq/mnesia sudo chown -R rabbitmq:rabbitmq /var/lib/rabbitmq/ sudo dpkg --configure -a
После этого RabbitMQ должен запуститься как чистый экземпляр, и dpkg сможет завершить настройку.
Проблема 3: ds-docservice падает с ошибкой «Configuration property … is not defined»
После успешного завершения обновления пакетов и перезагрузки вы можете обнаружить, что служба ds-docservice находится в состоянии activating (auto-restart) и постоянно перезапускается. В логах (/var/log/onlyoffice/documentserver/docservice/out.log) будет ошибка вида:
Error: Configuration property "tenants.licenseRevalidateInterval" is not defined
Это классический конфликт файлов конфигурации при обновлении. При установке новой версии onlyoffice-documentserver пакет dpkg обнаруживает, что файл /etc/onlyoffice/documentserver/default.json был изменён локально, и по умолчанию сохраняет вашу старую версию, а новый файл сохраняет как default.json.dpkg-dist. Новая версия программы ожидает найти в конфигурации новые параметры, которых в старом файле нет, поэтому падает при запуске.
Согласно официальной документации, редактировать следует только local.json, а default.json должен оставаться таким, каким его поставляет пакет [citation:17][citation:27]. Однако, если программа уже не запускается, самый быстрый способ — временно использовать новый файл из пакета.
Решение: Проверьте наличие файла default.json.dpkg-dist:
ls -la /etc/onlyoffice/documentserver/default.json*
Если он существует, сделайте резервную копию текущего файла и замените его новым:
sudo cp /etc/onlyoffice/documentserver/default.json /etc/onlyoffice/documentserver/default.json.bak sudo cp /etc/onlyoffice/documentserver/default.json.dpkg-dist /etc/onlyoffice/documentserver/default.json sudo systemctl restart ds-docservice
После этого проверьте статус службы. Если она запустилась, можно при необходимости перенести ваши пользовательские настройки (например, параметры JWT) в local.json.
Если замена default.json не помогла, попробуйте временно переименовать local.json, чтобы исключить влияние старых настроек:
sudo mv /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.bak sudo systemctl restart ds-docservice
Итог
Обновление OnlyOffice DS вместе с переходом на новую версию Debian требует внимания к трём ключевым моментам: зависание скрипта остановки, несовместимость RabbitMQ и конфликт файлов конфигурации. Если вы столкнулись с ошибкой «Configuration property … is not defined», почти наверняка проблема решается заменой default.json на версию из пакета. А если RabbitMQ не запускается — очистка старого каталога mnesia (при отсутствии необходимости в данных) возвращает систему в рабочее состояние.
Вы можете поддержать сайт UNLIX и его развитие удобной суммой.

