• Home
  • Atualizando o ONLYOFFICE Docs Developer Edition para Linux para a versão mais recente

Atualizando o ONLYOFFICE Docs Developer Edition para Linux para a versão mais recente

Introdução

Este guia prático descreve o procedimento técnico para atualizar o seu ONLYOFFICE Docs Developer Edition para Linux para a versão estável mais recente.

Nota sobre o suporte: A política oficial da empresa restringe o suporte técnico apenas à versão estável mais recente do ecossistema. Atualizações frequentes trazem correções críticas de segurança e novos recursos.

A partir da versão 4.1, o ONLYOFFICE Docs realiza a persistência de dados utilizando o banco de dados PostgreSQL (substituindo o antigo motor MySQL). Portanto, este procedimento destina-se estritamente à migração de ambientes a partir da versão 4.1. Versões legadas baseadas em MySQL não são compatíveis com este fluxo direto.


1. Preparação: Desligamento Seguro do ONLYOFFICE Docs

Por questões de integridade de dados e arquitetura operacional, o ONLYOFFICE Docs realiza o salvamento definitivo de um documento em disco apenas após o encerramento das sessões de todos os usuários cocriadores. Para evitar a perda de alterações pendentes durante a atualização, force a desconexão e o encerramento do serviço executando o script de segurança:

documentserver-prepare4shutdown.sh
Aviso: O processo de desconexão e encerramento completo das instâncias ativas pode levar até 5 minutos para ser concluído pelo servidor.

2. Processo de Atualização do Aplicativo

Método A: Atualização automatizada via script corporativo

Faça o download do utilitário oficial de instalação em seu terminal:

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

Inicie o assistente de atualização em modo de update:

bash docs-developer-install.sh -u true

Quando questionado pelo terminal, digite N e pressione Enter para instruir o instalador a atualizar o software diretamente a partir dos pacotes nativos DEB/RPM da sua distribuição.


Método B: Atualização manual e gestão de dependências

Resolução de dependências básicas:

Os pacotes complementares listados abaixo são necessários para o pleno funcionamento dos editores. Em sistemas como o Ubuntu 14.04 LTS ou superiores, eles são instalados nativamente durante o upgrade (caso tenham sido removidos do ambiente anteriormente):

  • libcurl3 / libxml2
  • fonts-dejavu / fonts-liberation
  • ttf-mscorefonts-installer (termos de fontes Microsoft)
  • fonts-crosextra-carlito / fonts-takao-gothic / fonts-opensymbol

Ambientes baseados na versão 4.1 (Legada):

Se você está atualizando especificamente a partir da versão 4.1, certifique-se de injetar o repositório correto contendo o Node.js correspondente antes de rodar os gerenciadores de pacotes (etapa dispensável se o seu ponto de partida for a v4.2):

curl -sL https://deb.nodesource.com/setup_8.x | sudo bash -
Execução do Upgrade de Pacotes

Para sistemas Debian, Ubuntu e derivados (APT):

Sincronize as listas de repositórios do sistema operacional:

sudo apt-get update

Execute a atualização completa dos binários do servidor:

sudo apt-get dist-upgrade

Para sistemas RHEL, CentOS e derivados (YUM/DNF):

Execute a atualização direta apontando para o repositório da edição Developer:

sudo yum update onlyoffice-documentserver-de

A estrutura de tabelas do banco de dados e os arquivos locais configurados serão herdados de forma transparente pela nova versão. Reinicie os serviços e valide o acesso aos editores.

Ajuste de esquema para proteção de arquivos (v6.3 ou superior):
O modelo de tabelas passou por alterações estruturais na versão 6.3. Se o seu ambiente antigo for anterior a esta versão, execute os scripts abaixo para garantir a conformidade do recurso de proteção por senha.
  1. Faça o download do arquivo SQL de migração conforme o banco em uso:
  2. Importe o script diretamente no terminal do banco de dados:
    • PostgreSQL: psql -U onlyoffice -W onlyoffice < upgradev630.sql
    • MySQL: mysql -u root -p onlyoffice < upgradev630.sql

    Injete as credenciais de acesso padrão configuradas durante o deploy (padrão de fábrica: onlyoffice).

Artigo com o tag:
Veja todas as etiquetas