Come installare OnlyOffice Docs e Oracle DB su Ubuntu

Introduzione

LYONOFFICE Docs è una suite per ufficio open source che comprende editor collaborativi per documenti di testo, fogli di calcolo, presentazioni, moduli e PDF. Il pacchetto è distribuito con la licenza AGPL v3.0. OOXML (DOCX, XLSX e PPTX) viene utilizzato come formato principale. Gli editor possono essere integrati con vari servizi cloud come framework CMS, piattaforme di collaborazione e contenuti, tracker di problemi, soluzioni di e-learning, ecc. Tra le integrazioni pronte all'uso ci sono Redmine, Odoo, ownCloud, Moodle, WordPress, Confluence , Jira e altri. C'è anche la possibilità di incorporare la suite nella tua app o servizio web.

Questo articolo spiega come installare OnlyOFFICE Docs su Ubuntu 22.04 utilizzando Docker e connettere Oracle Database.

Requisiti hardware

Per installare OnlyOffice Docs, avrai bisogno almeno di:

CPU: dual-core da 2 GHz o superiore
RAM: 4 GB o più
HDD: almeno 40 GB di spazio libero
SWAP: almeno 4 GB (ma dipende dal sistema operativo host)
L'ultima versione di Docker

Installazione di OnlyOffice

Il modo più semplice per installare la suite è utilizzare Docker. Gli sviluppatori consigliano ufficialmente questo metodo. Se Docker non è installato, puoi fare riferimento alle istruzioni di installazione di Docker.

Una volta che hai l'ultima versione di Docker, puoi installare OnlyOFFICE Docs con tutte le dipendenze utilizzando un unico comando:

sudo docker run -i -t -d -p 80:80 --restart=always \
  -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

In OnlyOffice Docs, un segreto JWT viene generato in modo casuale. Se il segreto JWT non viene specificato con la variabile d'ambiente, porta alla sua rigenerazione durante ogni riavvio delle VM o del server fisico, quindi potrebbero esserci problemi nelle integrazioni. Si consiglia di specificare il proprio valore in -e JWT_SECRET=my_jwt_secret. Se non utilizzerai JWT nella tua installazione, usa -e JWT_ENABLED=false.

Se vuoi cambiare la porta, usa l'opzione -p:

sudo docker run -i -t -d -p <PORT_NUMBER>:80 --restart=always \
  -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Una volta pronto, accedi http://localhostalla barra degli indirizzi del browser per avviare la pagina di benvenuto. Lì viene fornito di default un esempio di integrazione insieme agli editor. È un semplice DMS utilizzato per testare gli editor e vedere come può essere implementata l'integrazione.

Per integrare OnlyOffice Docs con la piattaforma cloud richiesta, controlla le istruzioni corrispondenti.

Archiviazione dei dati all'esterno dei contenitori

Si consiglia vivamente di archiviare i dati all'esterno dei contenitori Docker sul computer host in quanto consente di aggiornare facilmente OnlyOffice Docs una volta rilasciata la nuova versione senza perdere dati.

Per ottenere l'accesso ai dati situati all'esterno del contenitore, montare i volumi. Può essere fatto specificando l'opzione -v nel comando Docker run:

sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \
    -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
    -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
    -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Se elimini il contenitore o qualcosa va storto durante l'aggiornamento, non perderai i tuoi dati. Potrai anche aggiornare i tuoi certificati senza interferire con il contenitore.

Passaggio a HTTPS

Il modo più semplice per passare OnlyOFFICE Docs a HTTPS è ottenere i certificati SSL Let's Encrypt utilizzando certbot automaticamente.

Esegui il contenitore Docker di OnlyOffice Docs. Specifica le porte 80 e 443 e imposta il nome del dominio e l'e-mail:

sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \
    -e LETS_ENCRYPT_DOMAIN=yourdomain.com -e [email protected] \
    -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Una volta terminato, OnlyOffice Docs sarà disponibile in formato https://yourdomain.com.

Connessione al database Oracle

Fare riferimento alle runopzioni del comando docker per il flag --env-file, in cui è possibile specificare tutte le variabili di ambiente richieste in un singolo file. Ciò ti eviterà di scrivere un comando di esecuzione docker potenzialmente lungo.

Per connettere il database Oracle, modificare il parametro DB_TYPE su oracle.

Per utilizzare le impostazioni di connessione avanzate per Oracle, utilizzare il parametro oracleExtraOptions.

Conclusione

Ti abbiamo mostrato come installare OnlyOFFICE Docs su Ubuntu 22.04 e connetterti al DB Oracle. Ora puoi modificare e co-modificare vari documenti Office all'interno della piattaforma cloud che già utilizzi.

Se hai domande, lascia i commenti qui sotto.