Pular para o conteúdo principal

Como instalar o ONLYOFFICE Docs Developer Edition no CentOS (arm64)

Introdução​

A Developer Edition permite que você instale o ONLYOFFICE Docs em seu servidor local e integre os editores online com sua aplicação web (veja a lista detalhada de funcionalidades). Este guia mostrará como instalar a versão Linux do ONLYOFFICE Docs Developer Edition 7.1 e posteriores no CentOS Stream 9, RHEL 8 e RHEL 9 para a arquitetura ARM de 64 bits.

Requisitos do sistema​

  • CPU: processadores ARM de 64 bits
  • RAM: pelo menos 2 GB, mas depende do sistema operacional host. Mais é melhor
  • HDD: pelo menos 40 GB de espaço livre
  • SWAP: pelo menos 4 GB, mas depende do sistema operacional host. Mais é melhor
  • OS: CentOS Stream 9, RHEL 8 ou RHEL 9 para arm64
  • 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
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

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

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

Instalando e configurando o PostgreSQL​

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

sudo yum install postgresql postgresql-server
observação

Se você deseja instalar alguma outra versão do PostgreSQL do Repositório PostgreSQL, por favor, consulte a documentação oficial do PostgreSQL para mais detalhes sobre isso.

Inicialize o banco de dados PostgreSQL

sudo service postgresql initdb
sudo chkconfig postgresql on

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-a 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-a 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', descomente-o e substitua o valor por '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:

observação

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. Em seguida, 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 automática:

sudo systemctl enable --now redis

Instalando o RabbitMQ​

sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.rpm.sh | sudo bash
ERLANG_LATEST_VERSION=$(curl -s https://api.github.com/repos/rabbitmq/erlang-rpm/releases | sed -n 's/.*"tag_name":\s*"v\([^"]*\)".*/\1/p' | head -1)
sudo rpm -ivh https://github.com/rabbitmq/erlang-rpm/releases/latest/download/erlang-${ERLANG_LATEST_VERSION}-1.el${REV}.aarch64.rpm

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

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 automática:

sudo systemctl enable --now rabbitmq-server

Instalando o ONLYOFFICE Docs​

Adicionando o repositório 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 o ONLYOFFICE Docs​

Execute o seguinte comando:

sudo yum install onlyoffice-documentserver-de

Inicie o serviço nginx e habilite a inicialização automática:

sudo service nginx start
sudo systemctl enable nginx

Após isso, o ONLYOFFICE Docs será executado como um processo. O pacote será atualizado como qualquer outro pacote rpm.

Atualizando ONLYOFFICE Docs​

Para atualizar o ONLYOFFICE Docs, execute o seguinte comando:

sudo yum update onlyoffice-documentserver-de
Importante

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

Para evitar isso, exclua esses pacotes do repositório ONLYOFFICE para que eles 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, 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 usando a porta 8083. A partir da versão 4.3, você pode alterar a porta para o ONLYOFFICE Docs se planeja usá-la em vez da padrão.

observação

Se você for alterar a porta padrão, certifique-se de que ela está 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=<PORT_NUMBER>

Por favor, escreva o número da porta em vez de <PORT_NUMBER> no comando acima.

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 atualizada do pacote NGINX.

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 vez disso.

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

Configurando ONLYOFFICE Docs​

Executar um script de configuração​

Nota

Por padrão, o PostgreSQL é usado como banco de dados. Se você quiser usar MySQL em vez de PostgreSQL, por favor, adicione duas variáveis de ambiente para definir o tipo de banco de dados e a porta 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á alternar o banco de dados usando o script.

Execute o script documentserver-configure.sh:

bash documentserver-configure.sh

Você será solicitado a especificar os parâmetros de conexão do PostgreSQL, Redis e RabbitMQ. Use os seguintes dados:

Para PostgreSQL:

  • Host: localhost
  • Banco de dados: onlyoffice
  • Usuário: onlyoffice
  • Senha: onlyoffice

Para Redis:

  • Host: localhost

Para RabbitMQ:

  • Host: localhost
  • Usuário: guest
  • Senha: guest

Adicionar uma exceção de firewall​

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

Desativar SELinux​

observação

Obsoleto desde a v.5.0

Abra o arquivo /etc/selinux/config usando 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 tenham efeito.

Nota

Por razões 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 ONLYOFFICE Docs em um navegador​

Uma vez que a configuração esteja concluída, você pode digitar http://localhost:8083 na barra de endereços do seu navegador para abrir a página de boas-vindas do ONLYOFFICE Docs, onde encontrará mais 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 Developer Edition​

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

Quando você é um usuário de uma distribuição Linux baseada em Red Hat, o arquivo license.lic é colocado na seguinte pasta:

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

Depois disso, sua versão da Developer Edition será registrada e completa.