Risoluzione dei problemi

D:Voglio installare il server basato su Docker sul mio server locale. Come posso farlo?

R:L'ultima versione del server online basato su Docker è disponibile su Docker hub. Si prega di selezionare quale desiderate installare: ONLYOFFICE Docs, ONLYOFFICE Workspace o ONLYOFFICE Mail e seguire le istruzioni sulla pagina appropriata.

D:Dopo aver creato ed effettuato l'accesso al portale, vedo un utente sconosciuto nel modulo Persone con il nome 'fake user'. C'è anche un servizio OnlyofficeHealthCheck nella lista dei servizi. Perché succede questo e devo fare qualcosa al riguardo?

R:L'utente e il servizio fanno parte della futura funzionalità di Health Check che sarà disponibile nei prossimi rilasci per i portali. Al momento non è funzionale, quindi potete lasciarlo com'è o disabilitare il servizio OnlyofficeHealthCheck e rimuoverlo dalla lista di avvio automatico dei servizi.

D:Quale sistema devo avere per installare la soluzione server e utilizzarla con successo?

R:I requisiti di sistema sono:

• CPU
  dual core 2 GHz o superiore
• RAM
  4 GB o più
• HDD
  almeno 20 GB di spazio libero
• SWAP
  almeno 4 GB, ma dipende dal sistema operativo host. Più è meglio
• OS
  Distribuzione Linux amd64 con versione del kernel 3.10 o successiva
• Requisiti aggiuntivi
  • Docker: qualsiasi versione supportata dal team Docker

D:Ho installato una delle versioni del server utilizzando il servizio Docker, ma ho alcuni problemi relativi al server DNS o alla risoluzione del nome. Cosa può essere sbagliato?

R:Docker specifica i server DNS di Google per impostazione predefinita e il server tenta di contattarli ogni volta che effettua richieste di rete. Se il vostro ONLYOFFICE Workspace, ONLYOFFICE Docs o ONLYOFFICE Mail non avrà accesso a Internet, vi consigliamo di cambiare l'indirizzo DNS predefinito di Docker con l'indirizzo del vostro server DNS locale. Per fare ciò, andate al file /etc/default/docker e cambiate l'indirizzo IP nella seguente riga con l'indirizzo IP di un server DNS nella vostra rete locale:

docker_OPTS="--dns 8.8.8.8"

Per i sistemi operativi basati su RPM come CentOS, il file di configurazione può essere trovato qui: /etc/docker/daemon.json

D:Gli editor di documenti si aprono e l'interfaccia appare, ma il documento stesso non si carica, mostrando continuamente il progresso del caricamento. Cosa si può fare?

R:Il motivo potrebbe essere che il computer deve essere in grado di indirizzarsi utilizzando l'accesso di loopback Internet, cioè deve essere accessibile dall'esterno per se stesso. Potete permetterlo modificando le iptables per avere i reindirizzamenti come segue:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <piblic_ip>

Non dimenticate di sostituire gli indirizzi public_ip e local_ip con gli indirizzi IP reali.

D:Ho aggiunto un tema di interfaccia personalizzato o aggiornato i file di lingua del mio editor (corretto alcune traduzioni) ma il server mostra ancora i valori precedenti invece di quelli corretti. Come posso resettare la cache per tutti gli utenti contemporaneamente?

R:Si prega di seguire i passaggi per resettare la cache:
Trovate i file /etc/nginx/includes/ds-docservice.conf e /etc/nginx/includes/ds-spellchecker.conf. Ci deve essere il valore della data e dell'ora di build. Cambiate questi valori con altri (qualsiasi valore va bene, ma la cosa principale è che deve essere lo stesso in tutti i luoghi), e riavviate NGINX:

sudo service nginx reload

La cache dovrebbe essere resettata per tutti gli utenti del server.

D:Ho aggiunto un certificato SSL autofirmato e ora ho l'errore quando apro la pagina dei metadati SSO, quando lavoro con WebDAV e altri servizi node.js. Cosa si può fare per risolvere questo problema?

R:Se riscontrate un problema con l'ottenimento dei metadati SSO, WebDAV e altri servizi node.js quando utilizzate certificati SSL autofirmati, potete provare una delle seguenti opzioni per risolvere questo problema:

Opzione 1 - Aggiungere parametri per l'avvio del servizio.

1. Aprire il file onlyofficeSsoAuth.service (all'interno del container CommunityServer):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Aggiungere la seguente stringa specificando il percorso al certificato root alla fine del blocco [Service]:

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. Riavviare i servizi:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Opzione 2 - Usare il pacchetto di certificati di sistema.

1. Aprire il file onlyofficeSsoAuth.service (all'interno del container CommunityServer):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Trovare la seguente stringa nel blocco [Service]:

   ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

   Sostituirla con la seguente:

   ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

3. Per CentOS, aggiungere inoltre la seguente stringa specificando il percorso al pacchetto di certificati alla fine del blocco [Service]:

   Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

4. Riavviare i servizi:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Q:Ho riavviato il server senza fermare il container Docker con il comando docker stop id e ora ricevo l'errore ERR_TOO_MANY_REDIRECTS per il mio server. Cosa si può fare per risolvere il problema?

A:Si prega di modificare il file /var/www/onlyoffice/WebStudio/web.appsettings.config rimuovendo l'ultima riga:

<add key="web.warmup.type" value="basic" />

e riavviare monoserve con il seguente comando:

sudo service monoserve restart

Q:Sto usando Fedora Linux e i processi non si avviano all'interno del container Docker. Esiste una soluzione al problema?

A:Gli utenti di Fedora e RHEL/CentOS dovrebbero provare a disabilitare SELinux con il comando setenforce 0. Se risolve il problema, potete scegliere di mantenere SELinux disabilitato, cosa non raccomandata da RedHat, oppure passare all'uso di Ubuntu.

Q:Si è verificata una perdita di dati durante l'arresto di ONLYOFFICE Docs. Come prevenire la perdita di dati?

A:A causa delle caratteristiche operative, ONLYOFFICE Docs salva un documento solo dopo che è stato chiuso da tutti gli utenti che lo hanno modificato. Per evitare la perdita di dati, è necessario disconnettere forzatamente gli utenti di ONLYOFFICE Docs quando è necessario fermare ONLYOFFICE Docs in caso di aggiornamento dell'applicazione, riavvio del server, ecc. Per farlo, eseguire il seguente script sul server dove è installato ONLYOFFICE Docs:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh