Como atualizar o ONLYOFFICE Docs no Linux (Ubuntu e CentOS)

Introdução

Os pacotes oficiais de distribuição e o código-fonte do ONLYOFFICE Docs Community Edition para sistemas Linux estão hospedados publicamente e disponíveis no SourceForge.

Este manual fornece as diretrizes técnicas necessárias para atualizar a sua instância do ONLYOFFICE Docs Community Edition em servidores Linux para a versão estável mais recente.

Política de Suporte: A engenharia do ONLYOFFICE fornece suporte técnico estrito apenas para a versão estável mais recente do software. Novas versões contendo recursos inéditos, melhorias de performance e patches de segurança são lançadas regularmente. Caso sua infraestrutura execute uma versão obsoleta, recomendamos fortemente a atualização imediata.

Nota de compatibilidade: A partir da versão 4.1, o ONLYOFFICE Docs adotou o banco de dados PostgreSQL como mecanismo padrão de persistência de dados em substituição ao MySQL utilizado em builds legados. Este guia cobre a rotina de migração a partir da versão 4.1. Os procedimentos aqui descritos não se aplicam a instâncias obsoletas baseadas em MySQL.

IMPORTANTE: Se o seu servidor executa uma versão antiga do Integration Edition, o processo de upgrade requer a desinstalação completa do pacote depreciado (onlyoffice-documentserver-ie) seguida da instalação limpa do Enterprise Edition.

No Ubuntu / Debian, remova o pacote DEB via terminal: sudo apt-get remove onlyoffice-documentserver-ie
No CentOS / RHEL, remova o pacote RPM via terminal: sudo yum remove onlyoffice-documentserver-ie

Desligando o ONLYOFFICE Docs com segurança

Por questões de integridade estrutural e coautoria, o ONLYOFFICE Docs consolida e salva as alterações em um documento em lote apenas após o encerramento da sessão por todos os usuários ativos. Para mitigar o risco de perda de dados ou corrupção de arquivos antes do upgrade, você deve forçar a desconexão de todas as sessões ativas e interromper os microsserviços. Para executar este procedimento, rode o script utilitário abaixo no terminal:

documentserver-prepare4shutdown.sh

Nota de tempo: O processo de processamento em lote, fechamento de arquivos pendentes na memória RAM e desconexão forçada dos usuários pode levar até 5 minutos para ser inteiramente concluído pelo servidor de documentos.

Método 1. Atualizando automaticamente via Script

Este é o método recomendado para realizar o upgrade de forma rápida e padronizada.

Faça o download do script de instalação oficial diretamente do servidor de deploy:

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

Execute o instalador acionando a flag de atualização de pacotes no terminal:

bash docs-install.sh -u true

Quando o prompt do terminal interagir perguntando sobre o tipo de instalação, digite N e pressione Enter para instruir o instalador a realizar o upgrade nativo baseado em gerenciadores de pacotes (DEB/RPM).

Método 2. Atualizando manualmente

Instalando dependências de sistema

Certas dependências cruciais para o ecossistema do ONLYOFFICE Docs podem não vir pré-instaladas por padrão em distribuições Linux mais antigas, exigindo verificação manual durante o ciclo de upgrade.

Os seguintes pacotes de dependências e fontes tipográficas serão validados e instalados automaticamente caso você utilize distribuições atualizadas como o Ubuntu 14.04 LTS ou superior:

libcurl3 ou libcurl4 (dependendo da distribuição Linux)
libxml2 (mecanismo de processamento XML)
fonts-dejavu e fonts-liberation (fontes de compatibilidade)
ttf-mscorefonts-installer (pacote de fontes TrueType da Microsoft)
fonts-crosextra-carlito e fonts-takao-gothic (suporte a layouts internacionais)
fonts-opensymbol (renderização de fórmulas matemáticas e caracteres especiais)

Se você estiver realizando o upgrade especificamente a partir da versão 4.1, será necessário mapear e adicionar manualmente o repositório contendo a versão homologada do Node.js (etapa dispensável caso já esteja na v4.2 ou superior):

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

Executando a instalação da nova versão

Para distribuições baseadas em Debian / Ubuntu:

Atualize os índices de pacotes locais do gerenciador do sistema:

sudo apt-get update

Execute a atualização completa de sistema para puxar o binário mais recente do servidor de documentos:

sudo apt-get dist-upgrade

Para distribuições baseadas em RHEL / CentOS:

Invoque o gerenciador de pacotes para atualizar diretamente o pacote do ONLYOFFICE Server:

sudo yum update onlyoffice-documentserver

O banco de dados e os arquivos de configuração locais serão reaproveitados e migrados automaticamente da instalação anterior. Reinicie a pilha de serviços do ONLYOFFICE Docs e valide a integridade operacional dos editores acessando a página de boas-vindas.

Migração de Esquema de Banco de Dados (Upgrade para v6.3):
O esquema estrutural do banco de dados sofreu alterações críticas na versão 6.3. Caso o seu ambiente esteja migrando de um build anterior a esse marco, você deve rodar scripts de migração complementares para habilitar corretamente recursos do sistema, como a proteção de arquivos por senha.