Passa al contenuto principale

Installazione di ONLYOFFICE Docs su CentOS o RHEL per arm64

Introduzione​

Questa guida ti mostrerà come installare la versione Linux di ONLYOFFICE Docs Community Edition 7.1 e successive su CentOS Stream 9 e 10, nonché su RHEL 8, 9 e 10 per arm64. Per l'elenco completo delle funzionalità disponibili, consulta la panoramica delle edizioni di ONLYOFFICE Docs. Se utilizzi ONLYOFFICE Workspace, l'installazione di Docs consentirà anche la condivisione dei file, la gestione dei diritti di accesso, l'incorporamento dei documenti e la modifica dei file dagli archivi cloud collegati.

Requisiti di sistema​

  • CPU: processori ARM a 64 bit
  • RAM: almeno 2 GB, ma dipende dal sistema operativo host. Più è meglio
  • HDD: almeno 40 GB di spazio libero
  • SWAP: almeno 4 GB, ma dipende dal sistema operativo host. Più è meglio
  • OS: CentOS Stream 9 o 10, RHEL 8, RHEL 9 o RHEL 10 per arm64
  • Requisiti aggiuntivi
    • NGINX: versione 1.30 o successiva

Installazione delle dipendenze​

Installazione della versione aggiornata del pacchetto NGINX​

Per configurare il repository yum per RHEL/CentOS, crea il file denominato /etc/yum.repos.d/nginx.repo con il seguente contenuto:

[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

Installa NGINX:

sudo yum install nginx

Rimuovi il seguente file:

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

Istruzione ufficiale

Dopodiché, modifica il file di configurazione /etc/nginx/nginx.conf di NGINX, in modo che appaia come segue:

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 intendi eseguire ONLYOFFICE Docs sulla porta 80, disattiva ora il sito web predefinito di NGINX. Altrimenti ONLYOFFICE Docs potrebbe non funzionare correttamente. Per farlo, esegui i seguenti comandi:

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

A seconda di come è stato installato NGINX, uno dei primi due comandi potrebbe segnalare che il file non esiste. Puoi ignorare tranquillamente questo messaggio.

Installazione del repository EPEL​

sudo yum install epel-release

Per installare EPEL su CentOS 9, utilizza i seguenti comandi:

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

Per installare EPEL su RHEL, utilizza i seguenti comandi:

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

Cambia $REV con la versione del tuo sistema operativo manualmente (8 per le versioni 8.x, 9 per le versioni 9.x e così via).

Installazione di ONLYOFFICE Docs​

Aggiunta del repository ONLYOFFICE Docs​

Aggiungi il repository yum di ONLYOFFICE Docs con il seguente comando:

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

Comandi per l'installazione di ONLYOFFICE Docs​

Esegui il seguente comando per l'edizione Community:

sudo yum install onlyoffice-documentserver

Avvia il servizio nginx e abilita l'avvio automatico:

sudo service nginx start
sudo systemctl enable nginx

Dopo di ciò, ONLYOFFICE Docs verrà eseguito come un processo. Il pacchetto verrà aggiornato come qualsiasi altro pacchetto rpm.

Aggiornamento di ONLYOFFICE Docs​

Per aggiornare ONLYOFFICE Docs, esegui il seguente comando:

sudo yum update onlyoffice-documentserver
Importante

Su RHEL 8 e i suoi derivati, eseguire yum update con il repository ONLYOFFICE abilitato potrebbe fallire con un errore di dipendenza.

Per evitare ciò, escludi questi pacchetti dal repository ONLYOFFICE in modo che siano ottenuti dal repository AppStream del sistema:

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

Questo comando deve essere eseguito solo una volta. Dopo di ciò, yum update funzionerà come previsto.

Se hai installato ONLYOFFICE Docs tramite OneClick Install, questa esclusione è già applicata automaticamente.

Cambiare la porta predefinita di ONLYOFFICE Docs​

Per impostazione predefinita, ONLYOFFICE Docs ascolta le connessioni in arrivo utilizzando la porta 8083. A partire dalla versione 4.3 puoi cambiare la porta per ONLYOFFICE Docs se prevedi di utilizzarla al posto di quella predefinita.

note

Se intendi cambiare la porta predefinita, assicurati che sia aperta per le connessioni in entrata/uscita. Consulta l'elenco completo delle porte utilizzate da ONLYOFFICE Docs.

Per farlo, dovrai modificare la variabile d'ambiente DS_PORT eseguendo il comando:

export DS_PORT=<PORT_NUMBER>

Inserisci il numero di porta al posto di <PORT_NUMBER> nel comando sopra.

note

Se imposti la porta su 80, assicurati di aver disattivato il sito web predefinito di NGINX come descritto nella sezione Installazione della versione aggiornata del pacchetto NGINX.

Attenzione

Se vuoi cambiare il protocollo di ONLYOFFICE Docs in HTTPS, non cambiare la porta a 443, ma utilizza questa istruzione invece.

Dopo di ciò, puoi continuare a configurare ONLYOFFICE Docs.

Configurazione di ONLYOFFICE Docs​

Esegui uno script di configurazione​

Esegui lo script documentserver-configure:

bash documentserver-configure

Aggiungi un'eccezione al firewall​

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

Disabilita SELinux​

note

deprecato dalla v.5.0

Apri il file /etc/selinux/config utilizzando un qualsiasi editor di testo, sostituisci la stringa SELINUX=enforcing o SELINUX=permissive con SELINUX=disabled e salva le modifiche.

Riavvia il server affinché le modifiche abbiano effetto.

Avviare ONLYOFFICE Docs in un browser​

Una volta completata la configurazione, puoi inserire http://localhost:8083 nella barra degli indirizzi del tuo browser per aprire la pagina di benvenuto di ONLYOFFICE Docs, dove troverai ulteriori istruzioni su come abilitare esempi di documenti o integrare editor online nella tua applicazione web utilizzando l'API fornita.