Pular para o conteúdo principal

Instalando o ONLYOFFICE Docs no CentOS ou RHEL para arm64

Introdução​

Este guia demonstrará como instalar a versão Linux do ONLYOFFICE Docs Community Edition 7.1 e posteriores no CentOS Stream 9 e 10, bem como no RHEL 8, 9 e 10 para arm64. Para ver a lista completa de recursos disponíveis, consulte a visão geral das edições do ONLYOFFICE Docs. Se você usa o ONLYOFFICE Workspace, a instalação do Docs também permitirá compartilhar arquivos, gerenciar direitos de acesso, incorporar documentos e editar arquivos de armazenamentos em nuvem conectados.

Requisitos de sistema​

  • CPU: processadores ARM de 64 bits
  • RAM: mínimo de 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 ou 10, RHEL 8, RHEL 9 ou RHEL 10 para arm64
  • Requisitos adicionais
    • NGINX: versão 1.30 ou posterior

Instalando dependências​

Instalando a versão mais recente do NGINX​

Para configurar o repositório yum para RHEL/CentOS, crie um 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
module_hotfixes=true

Instale o NGINX:

sudo yum install nginx

Remova o seguinte arquivo:

sudo rm /etc/nginx/conf.d/default.conf

Instrução oficial

Em seguida, edite o arquivo de configuração do NGINX /etc/nginx/nginx.conf para que 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;
}
Importante

Se você planeja executar o ONLYOFFICE Docs na porta 80, desative agora o site padrão do NGINX. Caso contrário, o ONLYOFFICE Docs pode não funcionar corretamente. Para isso, execute os seguintes comandos:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Dependendo de como o NGINX foi instalado, um dos dois primeiros comandos pode informar que o arquivo não existe. Você pode ignorar essa mensagem com segurança.

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 manualmente para a versão do seu sistema operacional (8 para as versões 8.x, 9 para as versões 9.x e assim por diante).

Instalando o ONLYOFFICE Docs​

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

Comandos para instalar o ONLYOFFICE Docs​

Execute o seguinte comando para a edição Community:

sudo yum install onlyoffice-documentserver

Inicie o serviço nginx e habilite a inicialização automática 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
Importante

No RHEL 8 e em seus derivados, executar yum update com o repositório do ONLYOFFICE ativado pode falhar com um erro de dependência.

Para evitar isso, exclua estes pacotes do repositório do 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 precisa ser executado apenas uma vez. Depois disso, o yum update funcionará como esperado.

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

Alterando a porta padrão do ONLYOFFICE Docs​

Por padrão, o ONLYOFFICE Docs escuta as conexões de entrada na porta 8083. A partir da versão 4.3, você pode alterar a porta do ONLYOFFICE Docs se planeja usar outra em vez da padrão.

observação

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

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

export DS_PORT=<PORT_NUMBER>

Substitua <PORT_NUMBER> no comando acima pelo número da porta.

observação

Se você definir a porta como 80, certifique-se de ter desativado o site padrão do NGINX, conforme descrito na seção Instalando a versão mais recente do NGINX.

Aviso

Se você quiser alterar o protocolo do ONLYOFFICE Docs para HTTPS, não altere a porta para 443; em vez disso, utilize este guia.

Depois disso, você pode continuar a configuração do ONLYOFFICE Docs.

Configurando o ONLYOFFICE Docs​

Executando o script de configuração​

Execute o script documentserver-configure:

bash documentserver-configure

Adicionando uma exceção no firewall​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

Desabilitando o SELinux​

observação

obsoleto 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 o servidor para que as alterações entrem em vigor.

Iniciando o ONLYOFFICE Docs no navegador​

Após concluir a configuração, você pode digitar http://localhost:8083 na barra de endereços do navegador para abrir a página de boas-vindas do ONLYOFFICE Docs, onde encontrará mais instruções sobre como ativar os exemplos de documentos ou integrar os editores online ao seu aplicativo web usando a API fornecida.