Как пошагово обновить OnlyOffice во всех его компонентах

Если вы ежедневно работаете с ONLYOFFICE, рано или поздно вам потребуется обновить платформу , чтобы воспользоваться новейшими функциями, поддерживать безопасность в актуальном состоянии и исправлять ошибки. Проблема в том, что обновление происходит не всегда одинаково: DocSpace, размещенный на собственном сервере, отличается от ONLYOFFICE Docs на Linux, Workspace на Windows или почтового сервера на основе Docker.

Ниже вы найдете исчерпывающее руководство, которое собирает, систематизирует и четко объясняет всю разрозненную информацию о том, как обновить ONLYOFFICE в различных компонентах и ​​распространенных сценариях: DocSpace, Docs Community Edition, Mail Server, Workspace и многое другое. Цель состоит в том, чтобы независимо от вашей текущей конфигурации вы знали, какую команду запустить, какие папки резервировать и какие изменения вносит каждая версия, без необходимости просматривать десятки руководств.

Что входит в обновление до ONLYOFFICE и почему это выгодно?

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

В панели обновлений ONLYOFFICE обычно отображается раздел с изменениями, в котором перечислены новые функции по модулям : от самой панели обновлений и внутренней функции поиска до таких модулей, как LoginHistory, AuditTrail, Restore и SSO. Эти списки — не просто информационный материал; они напрямую влияют на повседневное администрирование.

• Обновление ПОНапример, при установке компонентов Docker добавлено диалоговое окно с лицензионным соглашением, а также исправлена ​​проблема с неактивными кнопками для удаленных компонентов, теперь позволяющая загрузить и установить доступную версию.
• Поиск: включено визуализация хода индексированияЭто помогает определить местоположение поисковой системы при обработке больших объемов документов.
• История входов и журнал аудитаДобавлены новые пустые экраны для более наглядного отображения информации, даже если изначально данные отсутствуют.
• Восстановить: включены дополнительные элементы управления при восстановлении данных из локальных хранилищ или от сторонних сервисов, что снижает риск некачественного или неполного восстановления.
• SSOФункциональность SSOAuth больше не находится в панели управления и теперь является частью параметров портала в Community Server, что очень важно, если вы управляете единым входом.
• Исправлены ошибки и внесены изменения в лицензии.Устранены многочисленные внутренние проблемы (ошибки 47721, 49101, 49187, 49273, 49272, 49324, 46386, 49585), а также обновлены лицензии и авторские права третьих лиц, что крайне важно для соответствия требованиям.

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

Что нового при обновлении ONLYOFFICE DocSpace до версии 2.5?

DocSpace — это платформа ONLYOFFICE, ориентированная на совместную работу с документами и создание рабочих пространств. В обновленной версии 2.5 , доступной как в облачной, так и в самостоятельно размещаемой версиях, добавлено множество новых функций, которые значительно меняют способы обмена и организации файлов.

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

• Возможность обмена файлами и папками через Общедоступные ссылки для внешних пользователейЭто упрощает взаимодействие с клиентами, поставщиками или партнерами без необходимости создания для них внутренних учетных записей.
• Возможность подключения сторонние хранилища Такие сервисы, как Google Drive, OneDrive, Box, Dropbox, kDrive, Nextcloud, ownCloud и др., позволяют централизовать доступ ко всему вашему контенту в ваших публичных комнатах.
• Поддержка Просмотр, создание и редактирование файлов Markdown.Очень полезно для технической документации, заметок и несложного контента.
• Инструменты для создания и управления группы пользователейЭто упрощает распределение прав доступа в комнатах и ​​документах.
• Предустановки для встроить DocSpace или его части в любом веб-интерфейсе, интегрируя его во внутренние сети, корпоративные порталы или собственные приложения.
• Помощник по импортировать данные Переход с ONLYOFFICE Workspace, Google Workspace и Nextcloud позволяет избежать болезненных миграций.
• конфигурация квоты хранения для каждой комнаты или для каждого пользователя, чтобы контролировать потребление дискового пространства.
• способность создавать несколько пространств документов в рамках одной и той же инфраструктуры и обеспечить к ним доступ для различных групп пользователей.

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

Как обновить самостоятельно размещенный DocSpace (Enterprise Edition)

Если у вас на сервере установлена ​​локальная версия ONLYOFFICE DocSpace Enterprise Edition, вы можете без особых проблем обновить её до версии 2.5 (или более поздней) с помощью официального скрипта установки, который также служит для обновления.

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

Для одновременного обновления всего пакета DocSpace Enterprise можно использовать следующую общую команду:

bash docspace-enterprise-install.sh -u true

Эта команда останавливает необходимые контейнеры, удаляет их и запускает последние версии всех компонентов ONLYOFFICE DocSpace Enterprise. Это удобный способ обеспечить синхронизацию всех служб до одной и той же версии.

Если же вы хотите обновить только компонент DocSpace, а остальное оставить как есть, вы можете выполнить более специфичный запрос, например:

bash docspace-enterprise-install.sh -u true -dsv v2.5.0 -idocs false -irbt false -irds false

В этом случае параметр -dsv явно указывает на версию DocSpace, которую вы хотите установить (например, v2.5.0), в то время как флаги -idocs, -irbt и -irds, установленные в значение false, указывают на то, что другие компоненты, такие как Docs, RabbitMQ или службы, связанные с хранилищем, обновляться не должны.

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

Установите ONLYOFFICE DocSpace, если он еще не установлен на вашем сервере.

Если вы еще не перешли на DocSpace и хотите настроить его впервые, процесс отличается от процесса обновления, но об этом стоит упомянуть, поскольку первоначальная установка часто путается с обновлением версии.

Для развертывания DocSpace на собственном сервере (Windows или Linux) необходимо загрузить соответствующий пакет с официального сайта ONLYOFFICE, где предлагаются установщики для каждой операционной системы , а во многих случаях и автоматизированные скрипты.

После загрузки соответствующего установщика для вашей среды просто следуйте инструкциям мастера или скрипта, в зависимости от того, используете ли вы Windows или Linux/Docker. После завершения установки вы сможете обновлять свой локальный DocSpace в будущем, используя тот же метод, описанный выше, установив параметр `-u` в значение `true`.

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

Обновление почтового сервера ONLYOFFICE на основе Docker

Компонент электронной почты ONLYOFFICE обычно развертывается в виде контейнера Docker . Для корректного обновления без потери данных крайне важно убедиться, что все тома данных правильно смонтированы и что при повторном создании контейнера с новым образом используются те же самые пути.

Стандартная процедура обновления почтового сервера ONLYOFFICE четко разделена на несколько этапов: проверка томов, удаление старого контейнера, удаление старого образа, запуск нового образа и повторное подключение Docs и Community Server.

Шаг 1: Проверка внешних томов хранения

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

sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{MAIL_SERVER_ID}}

В этой команде {{MAIL_SERVER_ID}} представляет собой имя или идентификатор контейнера ONLYOFFICE Mail. Просмотрев вывод, вы увидите пути к томам, используемым для хранения журналов, баз данных и почтовых данных.

В качестве дополнительной меры безопасности рекомендуется создавать резервные копии смонтированных папок, расположенных на хост-машине, например:

• /app/onlyoffice/MailServer/logs
• /app/onlyoffice/MailServer/mysql
• /app/onlyoffice/MailServer/data
• /app/onlyoffice/MailServer/data/certs

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

Шаг 2: Удалите текущий контейнер

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

sudo docker rm -f {{MAIL_SERVER_ID}}

Помните, что {{MAIL_SERVER_ID}} по-прежнему является именем или идентификатором контейнера ONLYOFFICE Mail. Этот шаг освобождает имя контейнера и позволяет избежать потенциальных конфликтов с новой версией.

Шаг 3: Удалите старый образ почтового клиента ONLYOFFICE.

Если вы не удалите старый образ, Docker может использовать его повторно, и почтовое программное обеспечение фактически не обновится . Чтобы принудительно загрузить последний образ, следует сделать что-то подобное:

sudo docker rmi -f $(sudo docker images | grep onlyoffice/mailserver | awk '{ print $3 }')

Эта команда гарантирует, что любой образ с меткой onlyoffice/mailserver исчезнет из вашей системы, и при следующем запуске Docker загрузит последнюю доступную версию из реестра.

Шаг 4: Запустите новый образ, используя те же пути к карте.

Перед запуском нового контейнера проверьте, существует ли у вас уже сеть Docker с именем onlyoffice. Если её нет, вы можете создать её с помощью следующей команды:

docker network create --driver bridge onlyoffice

Затем запустите новый контейнер почтового сервера ONLYOFFICE, используя те же пути к томам , что и раньше, примерно так:

sudo docker run --net onlyoffice --privileged -i -t -d --restart=always --name onlyoffice-mail-server \
-p 25:25 -p 143:143 -p 587:587 \
-v /app/onlyoffice/MailServer/data:/var/vmail \
-v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver \
-v /app/onlyoffice/MailServer/logs:/var/log \
-v /app/onlyoffice/MailServer/mysql:/var/lib/mysql \
-h yourdomain.com \
onlyoffice/mailserver

Здесь yourdomain.com — это имя хоста почтового сервера ONLYOFFICE. Этот домен должен быть действительным и указывать на IP-адрес компьютера, на котором установлен почтовый сервер, используя запись A в вашей DNS.

Кроме того, этот домен обычно отображается в MX-записи домена, который вы используете для электронной почты, в формате, например, mx1.onlyoffice.com. Важно, чтобы при повторном создании контейнера вы снова указали те же самые пути к томам, чтобы новый образ включал все существующие данные почтовых ящиков, сертификатов и баз данных.

Шаг 5: Повторно запустите Docs и Community Server, указав те же пути.

После обновления почтового сервера настало время проверить другие компоненты вашей экосистемы ONLYOFFICE, такие как ONLYOFFICE Docs и ONLYOFFICE Community Server, которые также обычно работают в контейнерах Docker.

Необходимо запустить новый контейнер ONLYOFFICE Docs , а затем контейнер ONLYOFFICE Community Server , подключив их в соответствии с рекомендациями официальных руководств и смонтировав папки с данными точно так же, как и в предыдущей версии.

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

Обновите ONLYOFFICE Workspace через панель управления.

Если вы используете ONLYOFFICE Workspace с веб-панелью, самый простой способ оставаться в курсе последних обновлений — это использовать встроенную в портал панель управления . Она централизует доступные версии каждого модуля в режиме онлайн, а также предоставляет возможности для загрузки и установки обновлений.

Для доступа к панели управления войдите в свой портал с учетной записью, имеющей права администратора, и щелкните соответствующую ссылку на главной странице . Вы также можете перейти в раздел «Настройки» портала и найти доступ к панели управления в боковом меню.

В разделе обновлений вы увидите список компонентов, их текущую версию и версию, доступную на сервере ONLYOFFICE. При обнаружении обновления обычно появляется кнопка «СКАЧАТЬ» для загрузки необходимых файлов.

После завершения загрузки кнопка загрузки изменится на кнопку ОБНОВИТЬ . Например, в средах Windows установщик обычно сохраняется в папке «Загрузки», и вам придется запускать его вручную для каждого компонента, который вы хотите обновить.

При нажатии кнопки «ОБНОВИТЬ» появится предупреждающее окно, сообщающее о том, что портал и панель управления будут перезапущены и временно недоступны. Если вы еще не создали резервную копию, вы можете отменить операцию, но нажатие кнопки «ОК» запустит процесс установки новой версии , который может занять около пяти минут.

После завершения обновления в столбцах «Текущая» и «Доступная» на странице обновления будет отображаться одна и та же версия обновленного компонента. Оттуда вы можете вернуться на главный портал (ПЕРЕЙТИ НА ПОРТАЛ) и начать тестирование новых функций модуля.

ONLYOFFICE Docs 9.3: Почему вам следует обновиться

В случае с ONLYOFFICE Docs, последние версии, такие как 9.3, привносят ряд улучшений, в значительной степени ориентированных на расширенное редактирование PDF-файлов, возможности добавления подписей и удобство работы с длинными документами или презентациями.

Среди улучшений, анонсированных для ONLYOFFICE Docs 9.3, — такие функции, как улучшенное редактирование PDF-файлов , расширенные возможности цифровой подписи документов, многостраничный просмотр текстовых документов, модуль Solver для электронных таблиц, воспроизведение GIF-анимации во время презентаций и различные улучшения на основе искусственного интеллекта.

Все это делает ONLYOFFICE Docs гораздо более мощным пакетом программ как для классических офисных условий, так и для учебных, юридических или технических сценариев, где ведется интенсивная работа со сложными документами.

Обновите ONLYOFFICE Docs Community Edition на Linux.

Если вы используете ONLYOFFICE Docs Community Edition в Linux, способ обновления до последней версии зависит от того, используете ли вы скрипт установки/обновления или предпочитаете ручную процедуру с пакетами DEB/RPM и управлением зависимостями.

Версия Community для дистрибутивов Linux и исходный код находятся в открытом доступе, и политика поддержки ONLYOFFICE четко определяет: поддержка предоставляется только для последней стабильной версии , которая обычно включает исправления ошибок и новые функции. Поэтому они рекомендуют обновить программу как можно скорее.

Есть одна важная деталь: начиная с версии 4.1, ONLYOFFICE Docs перешла на использование PostgreSQL вместо MySQL в качестве внутренней базы данных. Это означает, что стандартные процедуры обновления применяются начиная с версии 4.1, но они не применимы к более ранним версиям, которые по-прежнему использовали MySQL.

Подготовьте документы ONLYOFFICE к закрытию.

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

Для этого сам пакет предоставляет специальный скрипт, который необходимо запустить перед остановкой службы:

documentserver-prepare4shutdown.sh

Выполнение этого скрипта может занять до пяти минут, поскольку он отключает сессии, объединяет изменения и оставляет документы в безопасном состоянии для завершения работы . Лучше не пропускать этот шаг, чтобы избежать неожиданностей.

Обновите документы ONLYOFFICE в Linux с помощью скрипта.

Самый простой способ обновить ONLYOFFICE Docs в среде Linux — использовать официальный скрипт установки, который также поддерживает режим обновления с помощью параметра, аналогичного тому, который мы видели в DocSpace.

Для начала загрузите скрипт из официального репозитория, используя команду следующего вида:

curl -O http://download.onlyoffice.com/docs/docs-install.sh

После загрузки вы можете запустить скрипт с включенным параметром обновления:

bash docs-install.sh -u true

В процессе установки программа спросит, хотите ли вы обновить систему с помощью пакетов DEB/RPM. Если вы используете эту систему пакетов, вы можете выбрать соответствующий вариант, например, нажав клавишу N , а затем Enter, когда появится соответствующий запрос, чтобы продолжить обновление с помощью необходимых пакетов.

Обновление вручную: зависимости и репозитории

Если вы предпочитаете контролировать каждую деталь или ваша система устарела, вы можете выполнить обновление ONLYOFFICE Docs вручную, самостоятельно позаботившись о необходимых зависимостях и репозиториях.

В дистрибутивах, таких как Ubuntu 14.04 LTS и более поздних версиях, многие зависимости, необходимые для ONLYOFFICE Docs, обычно устанавливаются автоматически при обновлении с официальных пакетов. Вот некоторые из наиболее важных:

• libcurl3
• libxml2
• шрифты-дежавю
• шрифты-освобождение
• TTF-mscorefonts-инсталлятор
• шрифты-crosextra-carlito
• шрифты-takao-gothic
• шрифты-opensymbol

В очень старых дистрибутивах, например, до Ubuntu 14.04, может потребоваться ручная установка некоторых из этих библиотек для обеспечения корректной работы пакета, особенно в отношении отображения шрифтов и совместимости с документами.

Если вы обновляете ONLYOFFICE Docs с версии 4.1, имейте в виду, что вам может потребоваться добавить правильный репозиторий для конкретной версии Node.js, необходимой для вашей системы. В документации предлагается примерно следующее:

curl -sL https://deb.nodesource.com/setup_8.x | sudo bash -

После добавления репозитория вы можете установить необходимую версию Node.js и начать обновление ONLYOFFICE Docs до последней версии. Для дистрибутивов старше 14.04 могут потребоваться дополнительные зависимости, поэтому перед обновлением рекомендуется ознакомиться с примечаниями к выпуску и официальными требованиями.

Интеграция ONLYOFFICE с Nextcloud/ownCloud и совместное редактирование.

Одно из главных преимуществ ONLYOFFICE — это возможность интеграции с такими платформами, как Nextcloud или ownCloud , что позволяет совместно редактировать документы в режиме реального времени прямо в браузере, подобно Google Docs, но под вашим собственным контролем.

ONLYOFFICE позволяет редактировать текстовые документы, электронные таблицы и презентации в различных форматах: по умолчанию используется формат .docx, но вы также можете включить форматы .odt, .doc, .ods, .xls, .xlsx, .odp, .ppt или .pptx для работы с документами, созданными вне приложения.

В таком варианте развертывания Nextcloud или ownCloud выступают в качестве интерфейса доступа к файлам , а ONLYOFFICE отвечает за редактирование. Вместо загрузки документа при щелчке по нему, онлайн-редактор открывается в браузере.

Базовая установка ONLYOFFICE для интеграции с Nextcloud/ownCloud.

Перед установкой ONLYOFFICE в качестве автономного сервиса для подключения к Nextcloud важно определиться с доменом или поддоменом, под которым он будет размещен. Типичным примером может служить onlyoffice.mydomain.com, для которого необходимо создать запись A DNS, указывающую на IP-адрес сервера.

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

На многих хостинговых платформах в разделе «Установка приложений» при выборе ONLYOFFICE отобразится поле, куда необходимо ввести выбранный домен или поддомен, например onlyoffice.mydomain.com, а также секретный пароль , который потребуется позже для связи ONLYOFFICE с Nextcloud. Рекомендуется хранить этот пароль в надежном месте.

Подключите ONLYOFFICE к Nextcloud/ownCloud

После завершения установки ONLYOFFICE следующим шагом является установка и настройка соответствующего расширения из панели администрирования Nextcloud или ownCloud. Для этого войдите в систему с учетной записью администратора, перейдите в раздел «Приложения », обычно в категорию «Office и текст», и найдите коннектор ONLYOFFICE.

Нажатие на кнопку «Скачать и активировать» добавит модуль, после чего вам потребуется перейти в раздел «Настройки» > «ТОЛЬКО ОФИС» в Nextcloud, чтобы заполнить данные.

Необходимо заполнить два ключевых поля:

• URL-адрес установки сервера ONLYOFFICE, включая https://, например, https://onlyoffice.mydomain.com.
• Секретный ключ, разрешающий соединение между Nextcloud и ONLYOFFICE, — это тот же ключ, который вы задали во время установки. Если вы его не помните, вы обычно можете найти или изменить его в панели управления провайдера, в разделе управления ONLYOFFICE.

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

Во многих системах установлена ​​версия ONLYOFFICE Community, которая имеет определенные ограничения, такие как максимум 10 одновременно открытых документов и около 20 активных подключений. Для более требовательных сред рекомендуется рассмотреть коммерческие версии с расширенными ограничениями и выделенной поддержкой.

В целом, поддержание ONLYOFFICE в актуальном состоянии — будь то DocSpace, Docs Community Edition, Workspace, почтовый сервер или интеграция с Nextcloud/ownCloud — обеспечивает не только новые интересные функции, такие как улучшенное управление PDF-файлами, коннекторы к внешним облачным сервисам или многостраничные представления, но и повышенную безопасность, меньшее количество ошибок и гораздо более удобную совместную работу для всех пользователей, которые ежедневно используют эту платформу.