Instalando o ONLYOFFICE Docs Enterprise Edition para CentOS e derivados

Introdução

O Enterprise Edition permite que você instale o ONLYOFFICE Docs em seu servidor local e integre editores online com a plataforma de colaboração ONLYOFFICE ou outros sistemas populares.

O ONLYOFFICE Docs é um pacote office online que compreende visualizadores e editores para textos, planilhas e apresentações, totalmente compatível com os formatos Office Open XML: .docx, .xlsx, .pptx e permitindo a edição colaborativa em tempo real.

Funcionalidade

  • Document Editor
  • Spreadsheet Editor
  • Presentation Editor
  • Visualizadores web móveis
  • Editores web móveis
  • Edição colaborativa
  • Suporte a hieróglifos
  • Suporte para todos os formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Veja a lista detalhada de recursos disponíveis para o ONLYOFFICE Docs Enterprise Edition.

Ao utilizá-lo no ONLYOFFICE Workspace, você poderá:

  • compartilhar arquivos;
  • gerenciar direitos de acesso a documentos;
  • incorporar documentos em um site;
  • visualizar e editar arquivos armazenados no Drive, Box, Dropbox, OneDrive, OwnCloud conectados ao ONLYOFFICE.

Este guia mostrará como instalar a versão Linux do ONLYOFFICE Docs Enterprise Edition em sua máquina.

Requisitos de sistema
  • CPU: dual core de 2 GHz ou superior
  • RAM: pelo menos 2 GB, mas depende do SO host. Quanto mais, melhor
  • HDD: pelo menos 40 GB de espaço livre
  • SWAP: pelo menos 4 GB, mas depende do SO host. Quanto mais, melhor
  • SO: CentOS Stream 9, RHEL 8 ou RHEL 9
  • Requisitos adicionais:
    • PostgreSQL: versão 12.9 ou posterior
    • NGINX: versão 1.3.13 ou posterior
    • Redis: versão 5 ou posterior
    • RabbitMQ

Instalando dependências

Instalando a versão atualizada do pacote NGINX

Para configurar o repositório yum para RHEL/CentOS, crie o arquivo chamado /etc/yum.repos.d/nginx.repo com o seguinte conteúdo:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Instrução oficial

Instale o NGINX:

sudo yum install nginx

Depois disso, edite o arquivo de configuração do NGINX em /etc/nginx/nginx.conf para que ele fique da seguinte forma:

user                    nginx;
worker_processes      1;
error_log               /var/log/nginx/error.log warn;
pid                    /var/run/nginx.pid;
events {
worker_connections  1024;
}
http {
include             /etc/nginx/mime.types;
default_type        application/octet-stream;
log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log          /var/log/nginx/access.log  main;
sendfile            on;
#tcp_nopush         on;
keepalive_timeout   65;
#gzip               on;
include             /etc/nginx/conf.d/*.conf;
}
Instalando o repositório EPEL
sudo yum install epel-release

Para instalar o EPEL no CentOS 9, use os seguintes comandos:

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

Para instalar o EPEL no RHEL, use os seguintes comandos:

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

Altere $REV para a versão do seu SO manualmente (7 para versões 7.x, 8 para versões 8.x, 9 para versões 9.x e assim por diante).

Instalando e configurando o PostgreSQL

Instale a versão do PostgreSQL incluída na sua versão do CentOS:

sudo yum install postgresql postgresql-server
Se você deseja instalar alguma outra versão do PostgreSQL do Repositório PostgreSQL, consulte a documentação oficial do PostgreSQL para mais detalhes.

Inicialize o banco de dados PostgreSQL

sudo service postgresql initdb 
sudo chkconfig postgresql on

No CentOS 9, o chkconfig não é instalado por padrão. Instale-o usando o comando:

sudo yum install chkconfig

Ative o método de autenticação 'scram-sha-256' para localhost IPv4 e IPv6

Abra o arquivo /var/lib/pgsql/data/pg_hba.conf em um editor de texto.

Encontre a string host all all 127.0.0.1/32 ident e substitua pela seguinte:

host    all             all             127.0.0.1/32            scram-sha-256

Em seguida, encontre a string host all all ::1/128 ident e substitua pela seguinte:

host    all             all             ::1/128                 scram-sha-256

Salve as alterações.

Abra o arquivo /var/lib/pgsql/data/postgresql.conf em um editor de texto.

Encontre 'password_encryption', remova o comentário e altere o valor para 'scram-sha-256':

password_encryption = 'scram-sha-256'

Salve as alterações.

Reinicie o serviço PostgreSQL:

sudo service postgresql restart

Crie o banco de dados e o usuário do PostgreSQL:

Você pode especificar qualquer nome de usuário e senha.

Primeiro execute o comando

cd /tmp

para evitar o aviso could not change directory to "/root" se estiver executando como root. Então, o banco de dados e o usuário devem ser criados:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"
Instalando o Redis

Execute o seguinte comando:

sudo yum -y install redis

Inicie o serviço redis e habilite a inicialização no boot:

sudo systemctl enable --now redis
Instalando o RabbitMQ
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.rpm.sh | os=centos dist=$REV sudo bash
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/erlang/script.rpm.sh | os=centos dist=$REV sudo bash

Altere $REV para a versão do seu SO manualmente (7 para 7.x, 8 para 8.x, 9 para 9.x, etc.).

sudo yum install rabbitmq-server

Alternativamente, você pode instalar o RabbitMQ no CentOS 8 ou CentOS 9 a partir do site oficial.

Inicie o serviço rabbitmq e habilite a inicialização no boot:

sudo systemctl enable --now rabbitmq-server
Adicionando o repositório do ONLYOFFICE Docs

Adicione o repositório yum do ONLYOFFICE Docs com o seguinte comando:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm
Instalando mscorefonts

Instale os pacotes cabextract e xorg-x11-font-utils:

sudo yum install cabextract xorg-x11-font-utils

Para CentOS 7.8(2003), o fontconfig também é necessário:

sudo yum install fontconfig

Instale o pacote de fontes msttcore:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

Instalando o ONLYOFFICE Docs

Execute o seguinte comando:

sudo yum install onlyoffice-documentserver-ee

Inicie o serviço nginx e habilite a inicialização no boot:

sudo service nginx start
sudo systemctl enable nginx

Depois disso, o ONLYOFFICE Docs será executado como um processo. O pacote será atualizado como qualquer outro pacote rpm.

Atualizando o ONLYOFFICE Docs

Para atualizar o ONLYOFFICE Docs, execute o seguinte comando:

sudo yum update onlyoffice-documentserver-ee
Importante No RHEL 8 e seus derivados, executar yum update com o repositório ONLYOFFICE ativado pode falhar com um erro de dependência.

Para evitar isso, exclua estes pacotes do repositório ONLYOFFICE para que sejam obtidos do repositório AppStream do sistema:

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Este comando só precisa ser executado uma vez. Depois disso, o yum update funcionará conforme o esperado.

Se você instalou o ONLYOFFICE Docs via OneClick Install, esta exclusão já foi aplicada automaticamente.

Alterando a porta padrão do ONLYOFFICE Docs

Por padrão, o ONLYOFFICE Docs escuta as conexões de entrada na porta 80. A partir da versão 4.3, você pode alterar a porta se planeja usá-la em vez da porta padrão.

Se for alterar a porta padrão, certifique-se de que ela esteja aberta para conexões de entrada/saída. Veja a lista completa das portas usadas pelo ONLYOFFICE Docs.

Para fazer isso, você precisará editar a variável de ambiente DS_PORT executando o comando:

export DS_PORT=<NÚMERO_DA_PORTA>

Escreva o número da porta no lugar de <NÚMERO_DA_PORTA> no comando acima.

Aviso Se você deseja alterar o protocolo do ONLYOFFICE Docs para HTTPS, não altere a porta para 443, mas use esta instrução em seu lugar.

Depois disso, você pode continuar configurando o ONLYOFFICE Docs.

Configurando o ONLYOFFICE Docs

Execute o script de configuração
Nota Por padrão, o PostgreSQL é usado como banco de dados. Se desejar usar o MySQL, adicione duas variáveis de ambiente para definir o tipo e a porta do banco de dados antes de executar o script documentserver-configure.sh:
export DB_TYPE=mysql
export DB_PORT=3306

Após adicionar essas duas variáveis, você poderá trocar o banco de dados usando o script.

Execute o script documentserver-configure.sh:

bash documentserver-configure.sh

Será solicitado que você especifique os parâmetros de conexão do PostgreSQL, Redis e RabbitMQ. Use os seguintes dados:

Para o PostgreSQL:

  • Host: localhost
  • Database: onlyoffice
  • User: onlyoffice
  • Password: onlyoffice

Para o Redis:

  • Host: localhost

Para o RabbitMQ:

  • Host: localhost
  • User: guest
  • Password: guest
Adicione uma exceção ao firewall
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
Desative o SELinux descontinuado desde a v.5.0

Abra o arquivo /etc/selinux/config em qualquer editor de texto, substitua a string SELINUX=enforcing ou SELINUX=permissive por SELINUX=disabled e salve as alterações.

Reinicie seu servidor para que as alterações entrem em vigor.

Nota Por motivos de segurança, a partir da v8.1, novas chaves WOPI são geradas em local.json ao executar o script documentserver-configure.sh. Se você estiver usando uma conexão WOPI, precisará executar o script após atualizar o ONLYOFFICE Docs:
documentserver-configure.sh --wopienabled true

Iniciando o ONLYOFFICE Docs no navegador

Assim que a configuração terminar, você pode inserir http://localhost na barra de endereços do seu navegador para abrir a página de boas-vindas do ONLYOFFICE Docs, onde encontrará instruções sobre como habilitar exemplos de documentos ou integrar editores online em sua aplicação web usando a API fornecida.

Registrando sua versão Enterprise Edition

Se você comprou o Enterprise Edition e recebeu o arquivo license.lic, você pode colocá-lo em sua instalação para obter a versão completa do software.

Sendo um usuário de uma distribuição Linux baseada em Red Hat, o arquivo license.lic deve ser colocado na seguinte pasta:

/var/www/onlyoffice/Data/license.lic

Depois disso, sua versão do Enterprise Edition se tornará registrada e completa.

Artigo com o tag:
Veja todas as etiquetas