Обновление ONLYOFFICE Document Server до версии 5.5

ONLYOFFICE Document Server — это веб‑редакторы и просмотровщики документов, таблиц и презентаций для интеграции с облачными хранилищами и собственными решениями. Продукт распространяется под лицензией GNU AGPL v3.0 и полностью совместим с форматами OOXML: docx, xlsx, pptx.

Опишем упрощённый, но безопасный поток обновления Document Server отдельно от других компонентов ONLYOFFICE Community Edition.

Что нового в версии 5.5

• Дополнительные параметры для маркированных и нумерованных списков
• Зеркальные и полевые (gutter) поля и подписи в редакторе документов
• Пользовательская сортировка и «прилипание» ячеек в таблицах
• Опция Scale to Fit для подгонки листа под печатную страницу
• Заливка ячеек цветом, паттернами и градиентами
• Массовые действия над листами в таблицах
• Пересчёт формул вручную/автоматически
• Произвольные разделители тысяч и десятичных
• Добавление объектов в макет слайдов презентации
• Reset Slide — возможность сброса макета слайда

Внизу — пошаговое руководство, чек-листы, критерии приёмки и план отката.

Определения

• AGPL v3.0 — копилефт‑лицензия, требующая публикации исходного кода при предоставлении сервиса по сети.

План обновления — кратко

1. Подготовка и коммуникация с пользователями.
2. Резервное копирование конфигураций и данных.
3. Остановка Document Server.
4. Проверка зависимостей и свободного места.
5. Обновление репозитория и пакетов.
6. Перезапуск сервиса и тесты приёмки.
7. Мониторинг и откат при проблемах.

Шаг 1: Отключите пользователей Document Server

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

documentserver-prepare4shutdown.sh

Важно: этот скрипт уведомляет подключённые редакторы и завершает активные сессии. Не пропускайте этот шаг на рабочей инсталляции.

Шаг 2: Установите зависимости

Проверьте, установлены ли на сервере следующие пакеты:

• libcurl3
• libxml2
• supervisor
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

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

Step 2: Install the dependencies

Примечание: список шрифтов важен для корректного отображения документов. На сервере без графической подсистемы пакеты шрифтов всё равно нужны для корректной печати и рендеринга.

Шаг 3: Установите новую версию Document Server

Обновите индексы пакетов и выполните дист‑апгрейд:

sudo apt-get update

sudo apt-get dist-upgrade

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

Проверки после обновления

• Убедитесь, что веб‑интерфейс доступен.
• Откройте документ, таблицу и презентацию и сохраните изменения.
• Проверьте пересчёт формул в таблицах и отображение новых опций списков.
• Просмотрите логи /var/log/onlyoffice/ и системные журналы на предмет ошибок.

Чек‑лист администратора (быстрое руководство)

• Уведомили пользователей о временной недоступности
• Создали резервные копии конфигураций и данных
• Остановили Document Server (см. скрипт выше)
• Проверили зависимости и диск
• Выполнили apt-get update && dist-upgrade
• Перезапустили сервисы и проверили работоспособность
• Сохранили журналы обновления и результаты тестов

Чек‑лист для разработчика/интегратора

• Проверили совместимость API редакторов с интеграцией
• Протестировали интеграцию с Nextcloud/ownCloud/Seafile/Plone
• Проверили шаблоны печати и пользовательские макеты
• Обновили настройки CORS и прокси при необходимости

Критерии приёмки

• Веб‑редактор загружается без ошибок в консоли браузера.
• Открытие и сохранение DOCX/XLSX/PPTX проходит успешно.
• Формулы пересчитываются корректно в избранных таблицах.
• Новые функции (например, Scale to Fit) доступны в UI.

План отката (runbook)

1. Немедленно при остановке/ошибке — вернуть пользователей в режим «только просмотр».
2. Восстановить конфигурационные файлы из резервной копии.
3. Переустановить предыдущую версию пакета (если доступна) или восстановить образ системы/VM.
4. Перезапустить Document Server и проверить базовую функциональность.
5. Документировать причину отката и сохранить журналы для анализа.

Советы по аварийному откату: заранее храните DEB‑пакеты предыдущих версий в локальном репозитории или на объектном хранилище, чтобы быстро переустановить точную версию.

Тесты приёмки (acceptance)

• Открыть тестовый DOCX, внести правку, сохранить — результат должен содержать изменения.
• Открыть XLSX с формулами, изменить входные значения, проверить пересчёт.
• Открыть PPTX, добавить/сбросить слайд, проверить визуализацию объектов.
• Прогнать 5‑10 скриптов автоматизированного тестирования UI (Selenium/Puppeteer) для критичных сценариев.

Альтернативные подходы к обновлению

• Обновление в Docker: если вы используете контейнеры, обновите образ и разверните новый контейнер за пределами прод‑трафика, затем переключите трафик.
• Кластерный подход: обновляйте узлы по одному (rolling update), чтобы сохранить доступность.

Ментальные модели и рекомендации

• «Backup first» — всегда создавайте резервные копии перед изменениями.
• «One change, one window» — выполняйте одну значимую операцию в одном окне обслуживания.
• Тестируйте в тестовом окружении, похожем на прод, прежде чем обновлять прод.

Совместимость и подводные камни

• Интеграции с Nextcloud/ownCloud и другими хранилищами обычно стабильны, но местные плагины или кастомные прокси могут требовать правок.
• Проверьте конфигурацию nginx/Apache и правила проксирования WebSocket, если используете их.

Мини‑методология развертывания

1. Подготовка: уведомления, резервные копии, тестовая площадка.
2. Остановка: закрыть активные сессии.
3. Обновление: репозитории и пакеты.
4. Верификация: ручные + автоматизированные тесты.
5. Мониторинг: 24–72 часа повышенного наблюдения.

Быстрые команды для диагностики

• Проверить логи:

sudo tail -n 200 /var/log/onlyoffice/documentserver/DocumentServer.log

• Проверить статус supervisor:

sudo supervisorctl status

• Проверить порты и прослушивание:

sudo ss -tulnp | grep 80\|443\|9980

Риски и рекомендации по минимизации

• Риск: потеря конфигураций — всегда делайте бэкап.
• Риск: несовместимость кастомных интеграций — тестируйте на стенде.
• Риск: длительное время простоя — используйте rolling update или контейнеры.

Короткая памятка для уведомления пользователей (пример)

Обновление ONLYOFFICE Document Server до версии 5.5 запланировано на [дата/время]. Ожидаемое время простоя: 10–30 минут. Новые функции: улучшенные списки, масштаб под печать, расширенные возможности таблиц и презентаций.

Короткое резюме

Обновление Document Server до 5.5 — стандартная операция, если подготовиться: сделать бэкап, проверить зависимости, корректно остановить сервис, обновить пакеты и выполнить тесты приёмки. Для критичных прод-инсталляций рассмотрите поэтапное обновление или контейнерный подход.

Список ключевых действий: резервная копия, скрипт prepare4shutdown, проверка шрифтов, apt-get update && dist-upgrade, перезапуск, тестирование.

Сводка тестов, чек‑листы и план отката помогут снизить риск при обновлении.