Passa al contenuto principale

Installazione di ONLYOFFICE Docs su CentOS o RHEL per arm64

Introduzione​

Developer Edition ti permette di installare ONLYOFFICE Docs sul tuo server locale e integrare gli editor online con la tua applicazione web (consulta la lista dettagliata delle funzionalità). Questa guida ti mostrerà come installare la versione Linux di ONLYOFFICE Docs Developer Edition versione 7.1 e successive su CentOS Stream 9, RHEL 8 e RHEL 9 per l'architettura ARM a 64 bit.

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, RHEL 8, o RHEL 9 per arm64
  • Requisiti aggiuntivi:
    • PostgreSQL: versione 12.9 o successiva
    • NGINX: versione 1.3.13 o successiva
    • Redis: versione 5 o successiva
    • RabbitMQ

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

Istruzioni ufficiali

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

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 prevedi di eseguire ONLYOFFICE Docs sulla porta 80, disabilita ora il sito web predefinito di NGINX. In caso contrario, 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 questo messaggio senza problemi.

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

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

Installazione e configurazione di PostgreSQL​

Installa la versione di PostgreSQL inclusa nella tua versione di CentOS:

sudo yum install postgresql postgresql-server
note

Se desideri installare un'altra versione di PostgreSQL dal Repository PostgreSQL, consulta la documentazione ufficiale di PostgreSQL per maggiori dettagli.

Inizializza il database PostgreSQL

sudo service postgresql initdb
sudo chkconfig postgresql on

Attiva il metodo di autenticazione 'scram-sha-256' per localhost IPv4 e IPv6

Apri il file /var/lib/pgsql/data/pg_hba.conf in un editor di testo.

Trova la stringa host all all 127.0.0.1/32 ident e sostituiscila con la seguente:

host    all             all             127.0.0.1/32            scram-sha-256

Quindi trova la stringa host all all ::1/128 ident e sostituiscila con la seguente:

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

Salva le modifiche.

Apri il file /var/lib/pgsql/data/postgresql.conf in un editor di testo.

Trova 'password_encryption', decommentalo e sostituisci il valore con 'scram-sha-256':

password_encryption = 'scram-sha-256'

Salva le modifiche.

Riavvia il servizio PostgreSQL:

sudo service postgresql restart

Crea il database e l'utente PostgreSQL:

note

Puoi specificare qualsiasi nome utente e password.

Esegui prima il comando

cd /tmp

per evitare l'avviso could not change directory to "/root" se eseguito da root. Quindi il database e l'utente devono essere creati:

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

Installazione di Redis​

Esegui il seguente comando:

sudo yum -y install redis

Avvia il servizio redis e abilita l'avvio all'accensione:

sudo systemctl enable --now redis

Installazione di 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

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

sudo yum install rabbitmq-server

In alternativa, puoi installare RabbitMQ su CentOS 8 o CentOS 9 dal sito ufficiale.

Avvia il servizio rabbitmq e abilita l'avvio all'accensione:

sudo systemctl enable --now rabbitmq-server

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

Installazione di ONLYOFFICE Docs​

Esegui il seguente comando:

sudo yum install onlyoffice-documentserver-de

Avvia il servizio nginx e abilita l'avvio automatico al boot:

sudo service nginx start
sudo systemctl enable nginx

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

Aggiornare ONLYOFFICE Docs​

Per aggiornare ONLYOFFICE Docs, esegui il seguente comando:

sudo yum update onlyoffice-documentserver-de
Importante

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

Per evitare ciò, escludi questi pacchetti dal repository di ONLYOFFICE in modo che vengano presi dal repository AppStream di 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 entrata utilizzando la porta 8083. A partire dalla versione 4.3 puoi cambiare la porta per ONLYOFFICE Docs se intendi utilizzarne una diversa da 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 disabilitato il sito web predefinito di NGINX come descritto nella sezione Installazione della versione aggiornata del pacchetto NGINX.

Avviso

Se desideri 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.

Configurare ONLYOFFICE Docs​

Esegui uno script di configurazione​

Nota

Per impostazione predefinita, viene utilizzato PostgreSQL come database. Se desideri utilizzare MySQL invece di PostgreSQL, aggiungi due variabili d'ambiente per definire il tipo di database e la porta prima di eseguire lo script documentserver-configure.sh:

export DB_TYPE=mysql
export DB_PORT=3306

Dopo aver aggiunto queste due variabili, sarai in grado di cambiare il database utilizzando lo script.

Esegui lo script documentserver-configure.sh:

bash documentserver-configure.sh

Ti verrà chiesto di specificare i parametri di connessione per PostgreSQL, Redis e RabbitMQ. Utilizza i seguenti dati:

Per PostgreSQL:

  • Host: localhost
  • Database: onlyoffice
  • Utente: onlyoffice
  • Password: onlyoffice

Per Redis:

  • Host: localhost

Per RabbitMQ:

  • Host: localhost
  • Utente: guest
  • Password: guest

Aggiungi un'eccezione al firewall​

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

Disabilita SELinux​

note

deprecato dalla versione 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.

Nota

Per motivi di sicurezza, a partire dalla versione 8.1, nuove chiavi WOPI vengono generate in local.json quando si esegue lo script documentserver-configure.sh. Se stai utilizzando una connessione WOPI, devi eseguire lo script dopo aver aggiornato ONLYOFFICE Docs:

documentserver-configure.sh --wopienabled true

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.

Registrare la tua versione Developer Edition​

Se hai acquistato Developer Edition e hai ricevuto il file license.lic, puoi posizionarlo nella tua installazione per ottenere la versione completa del software.

Se sei un utente di una distribuzione Linux basata su Red Hat, il file license.lic viene posizionato nella seguente cartella:

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

Dopo di ciò, la tua versione di Developer Edition sarà registrata e completa di tutte le funzionalità.