Перейти к основному содержимому

Обновление ONLYOFFICE Docs Enterprise Edition для Docker

Введение​

В данном руководстве рассматривается процесс обновления ONLYOFFICE Docs Enterprise Edition для Docker до последней версии.

примечание

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

Важно

Если вы используете старую версию Integration Edition, обновить ее можно только одним способом: удалить Integration Edition (onlyoffice/documentserver-ie) и установить вместо нее Enterprise Edition.

Перед обновлением убедитесь, что ваша версия Docker соответствует системным требованиям (любая версия, поддерживаемая командой Docker).

Закрытие ONLYOFFICE Docs​

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

sudo docker exec {{DOCUMENT_SERVER_ID}} documentserver-prepare4shutdown.sh

где {{DOCUMENT_SERVER_ID}} — это имя или ID контейнера ONLYOFFICE Docs.

Узнать текущее имя или ID контейнера ONLYOFFICE Docs можно с помощью команды Docker, которая выводит список всех существующих контейнеров:

sudo docker ps -a
примечание

Для выполнения скрипта может потребоваться время (до 5 минут).

Для отключения пользователей может потребоваться время (до 5 минут).

Обновление ONLYOFFICE Docs для Docker​

Обновление с помощью скрипта​

Если ONLYOFFICE Docs был установлен с помощью этого скрипта, выполните следующую команду:

bash docs-enterprise-install.sh -u true

Введите Y и нажмите Enter, чтобы обновить ONLYOFFICE Docs для Docker.

примечание

ONLYOFFICE Docs Enterprise Edition для Docker обновится с помощью скрипта, только если установка ранее выполнялась этим же скриптом.

Обновление вручную​

Шаг 1: Проверьте, смонтированы ли все внешние папки для хранения данных

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

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

Шаг 2: Остановите текущий Docker-контейнер ONLYOFFICE Docs.

sudo docker stop {{DOCUMENT_SERVER_ID}}

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

Скачайте образ последней версии ONLYOFFICE Docs, указав тег latest:

docker pull onlyoffice/documentserver-ee:latest

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

sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /host_folder:/volume \
    -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

Убедитесь, что запускаете новый образ, указав пути к папкам, привязанным точно так же, как они были смонтированы в предыдущей версии, в противном случае данные, сохраненные в этих папках, не будут получены автоматически. Для этого укажите аргументы опции -v, заменив значения /host_folder:/volume на актуальные пути, как в Шаге 1.

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

По завершении процесса установки запустите ONLYOFFICE Docs и проверьте корректность работы.

Шаг 5 (необязательно): Удалите старый контейнер и образ ONLYOFFICE Docs

Убедившись, что все в порядке и обновленная версия ONLYOFFICE Docs работает корректно, вы можете удалить старый контейнер ONLYOFFICE Docs:

sudo docker rm {{OLD_DOCUMENT_SERVER_CONTAINER_ID}}

где {{OLD_DOCUMENT_SERVER_CONTAINER_ID}} — это имя или ID старого контейнера ONLYOFFICE Docs.

Чтобы освободить место, можно также удалить старый образ. Выведите список всех образов Docker:

sudo docker images -a

Найдите в списке ID ненужного образа и удалите его:

sudo docker rmi {{OLD_DOCUMENT_SERVER_IMAGE_ID}}
примечание

В версии 6.3 изменилась схема базы данных. При обновлении до версии 6.3 (в случае использования Docker-версии ONLYOFFICE Docs с внешней базой данных) вам также может понадобиться обновить схему базы данных, чтобы обеспечить возможность использования функции защиты с помощью пароля.

  1. Найдите скрипт для обновления схемы базы данных в контейнере ONLYOFFICE Docs.

    • Для PostgreSQL: /var/www/onlyoffice/documentserver/server/schema/postgresql/upgrade/upgradev630.sql
    • Для MySQL: /var/www/onlyoffice/documentserver/server/schema/mysql/upgrade/upgradev630.sql

  2. Выполните скрипт, используя командную строку.

    • Для PostgreSQL: psql -U onlyoffice -W onlyoffice < {path-to-upgradev630.sql}
    • Для MySQL: mysql -u root -p onlyoffice < {path-to-upgradev630.sql}

    Укажите пароль, использованный при создании базы данных (onlyoffice).