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. Seleziona quale desideri installare: ONLYOFFICE Docs, ONLYOFFICE Workspace o ONLYOFFICE Mail e segui 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 'utente fittizio'. C'è anche un servizio OnlyofficeHealthCheck nell'elenco dei servizi. Perché accade questo e devo fare qualcosa al riguardo?

R:L'utente e il servizio fanno parte della futura funzionalità di Controllo dello stato, che sarà disponibile nei prossimi rilasci per i portali. Al momento, non è funzionale, quindi puoi lasciarlo così com'è o disabilitare il servizio OnlyofficeHealthCheck e rimuoverlo dall'elenco 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 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 proprio. Cosa potrebbe essere sbagliato?

R:Docker specifica i server DNS di Google per impostazione predefinita, e il server cerca di contattarli ogni volta che effettua alcune richieste di rete. Se il tuo ONLYOFFICE Workspace, ONLYOFFICE Docs o ONLYOFFICE Mail non avrà accesso a Internet, ti consigliamo di cambiare l'indirizzo DNS predefinito di Docker con l'indirizzo del tuo server DNS locale. Per farlo, vai al file /etc/default/docker e cambia l'indirizzo IP nella seguente riga con l'indirizzo IP di un server DNS nella tua 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. Puoi permetterlo modificando le iptables per avere i reindirizzamenti come questo:

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 dimenticare 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:Segui i passaggi per resettare la cache:
Trova i file /etc/nginx/includes/ds-docservice.conf e /etc/nginx/includes/ds-spellchecker.conf. Devono esserci il valore della data e dell'ora di build. Cambia questi valori con altri (qualsiasi valore va bene, ma l'importante è che sia lo stesso in tutti i posti), e riavvia 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 ricevo un 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 incontri un problema con l'ottenimento dei metadati SSO, WebDAV e altri servizi node.js quando usi certificati SSL autofirmati, puoi provare una delle seguenti opzioni per risolvere questo problema:

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

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

   nano /lib/systemd/system/onlyofficeSsoAuth.service

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

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. Riavvia i servizi:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Opzione 2 - Usa il bundle di certificati di sistema.

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

   nano /lib/systemd/system/onlyofficeSsoAuth.service

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

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

   Sostituiscila con la seguente:

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

3. Per CentOS, aggiungi inoltre la seguente stringa specificando il percorso al bundle 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 questo problema?

A:Modifica il file /var/www/onlyoffice/WebStudio/web.appsettings.config, rimuovendo l'ultima riga:

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

e riavvia monoserve con il seguente comando:

sudo service monoserve restart

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

A:Gli utenti Fedora e RHEL/CentOS dovrebbero provare a disabilitare SELinux con il comando setenforce 0. Se risolve il problema, puoi scegliere di mantenere SELinux disabilitato, cosa non raccomandata da RedHat, o passare a utilizzare 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 interrompere 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