Installazione di ONLYOFFICE Apps Community con parametri aggiuntivi dello script
Introduzione
ONLYOFFICE Apps Community è una versione gratuita di un hub di documenti in cui puoi collegare utenti e documenti in un unico posto per potenziare la collaborazione.
ONLYOFFICE Apps Community viene distribuito come script di installazione automatica per sistemi operativi Linux con Docker installato. Lo script configurerà i container Docker con tutti i componenti necessari per il corretto funzionamento di ONLYOFFICE Apps Community ed è facile da eseguire, gestire e aggiornare.
Dopo aver scaricato lo script di installazione di ONLYOFFICE Apps Community, potrebbe essere necessario eseguirlo specificando alcuni parametri aggiuntivi, ad esempio se vuoi installare ogni componente su una macchina separata.
Usa il seguente comando per visualizzare l'elenco di tutti i parametri Docker disponibili dello script:
bash apps-install.sh docker -h
Usa il seguente comando per visualizzare l'elenco di tutti i parametri DEB/RPM disponibili dello script:
bash apps-install.sh package -h
Di seguito puoi trovare una breve descrizione e alcuni esempi di utilizzo di questi parametri.
Quando esegui lo script con i parametri, ti verrà chiesto di selezionare il modo in cui vuoi installare ONLYOFFICE Apps. Digita Y e premi Invio per installare ONLYOFFICE Apps utilizzando Docker. Digita N e premi Invio per installare ONLYOFFICE Apps dai pacchetti DEB/RPM.
Credenziali
| Parametro | Descrizione |
|---|---|
-reg, --registry | URL del registro Docker (ad es., https://myregistry.com:5000) |
-un, --username | login del registro Docker |
-p, --password | password del registro Docker |
Questi parametri vengono utilizzati nel caso in cui ti forniamo le credenziali per accedere a un repository di test, in modo da poter eseguire container dalle immagini in esso archiviate.
Esempio
bash apps-install.sh -reg URL -un username -p password
Tipo di installazione
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-it, --installationtype | tipo di installazione | community|developer|enterprise | community |
Questo parametro ti consente di installare la soluzione specificata: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer o ONLYOFFICE Apps Enterprise.
Esempio
bash apps-install.sh -it enterprise
Questo installerà la soluzione ONLYOFFICE Apps Enterprise.
Verifica hardware
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-skiphc, --skiphardwarecheck | da usare per saltare la verifica hardware | true|false | false |
Questo parametro ti consente di saltare la verifica che il sistema soddisfi i requisiti hardware minimi.
Esempio
bash apps-install.sh -skiphc true
Questo salterà la verifica hardware.
Aggiornamento componenti
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-u, --update | da usare per aggiornare i componenti esistenti | true|false | false |
Questo parametro ti consente di installare le versioni più recenti dei componenti necessari se i componenti corrispondenti installati sulla tua macchina sono obsoleti.
Esempio
bash apps-install.sh -u true
Questo arresterà di conseguenza i container che devono essere aggiornati, li rimuoverà e quindi eseguirà le versioni più recenti dei componenti corrispondenti di ONLYOFFICE Apps Community. Se la versione corrente del componente coincide con quella più recente disponibile, tale container non verrà modificato. Se hai saltato alcuni componenti durante l'installazione precedente, verranno saltati anche questi. I dati di ONLYOFFICE Apps dovrebbero essere rilevati automaticamente.
Aggiorna solo Docs alla versione 7.2.1.34 e salta l'aggiornamento di tutti gli altri componenti:
bash apps-install.sh -u true -docsi onlyoffice/documentserver -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Aggiorna solo ONLYOFFICE Apps alla versione 1.2.0 e salta l'aggiornamento di tutti gli altri componenti:
bash apps-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
Installazione componenti
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-ia, --installapps | installa ONLYOFFICE Apps | true|false | true |
-idocs, --installdocs | installa ONLYOFFICE Docs | true|false | true |
-irbt, --installrabbitmq | installa RabbitMQ | true|false | true |
-irds, --installredis | installa Redis | true|false | true |
-imysql, --installmysql | installa MySQL | true|false | true |
Questi parametri ti consentono di specificare se devi installare o meno un determinato componente. Possono essere utilizzati se vuoi installare ogni componente su una macchina separata.
- Usa il valore
trueper installare un componente. - Usa il valore
falseper saltare l'installazione di un componente.
Esempio
bash apps-install.sh -idocs false
Questo installerà tutti i componenti di ONLYOFFICE Apps Community senza ONLYOFFICE Docs.
bash apps-install.sh -ia false -idocs true -imysql false -irbt false -irds false
Questo salterà l'installazione di ONLYOFFICE Apps, MySQL, RabbitMQ e Redis e installerà solo ONLYOFFICE Docs.
Versione del componente
| Parametro | Descrizione |
|---|---|
-asv, --appsversion | versione di ONLYOFFICE Apps |
-docsv, --docsversion | versione di ONLYOFFICE Docs |
Questi parametri possono essere utilizzati per installare una determinata versione di ONLYOFFICE Apps o di ONLYOFFICE Docs se per qualche motivo non vuoi installare l'ultima versione disponibile nel repository. Per impostazione predefinita, per eseguire il container del componente viene utilizzata un'immagine con tag latest.
Esempio
Apri il repository Docker Hub nel tuo browser, seleziona ONLYOFFICE Docs e vai alla scheda Tags per visualizzare tutti i tag disponibili nel repository. Specifica la versione che vuoi installare:
bash apps-install.sh -docsv 7.2.1.34
Questo installerà ONLYOFFICE Apps con la versione 7.2.1.34 di ONLYOFFICE Docs.
Nome immagine ONLYOFFICE Docs
| Parametro | Descrizione |
|---|---|
-docsi, --docsimage | nome dell'immagine di ONLYOFFICE Docs |
Questo parametro può essere utilizzato per specificare il nome dell'immagine di ONLYOFFICE Docs da cui avviare un container. L'immagine specificata deve essere archiviata nel nostro repository pubblico ufficiale su Docker Hub.
Esempio
bash apps-install.sh -docsi onlyoffice/documentserver
Questo eseguirà un container dall'immagine di ONLYOFFICE Docs specificata e archiviata nel repository.
Impostazione per host
| Parametro | Descrizione |
|---|---|
-ash, --appshost | host di ONLYOFFICE Apps |
-esh, --elastichost | host di OpenSearch |
Questi parametri possono essere utilizzati per collegare i componenti se li installi su macchine separate.
Esempio
bash apps-install.sh -esh 192.168.3.202
Questo installerà ONLYOFFICE Apps e lo collegherà a OpenSearch installato su un'altra macchina con indirizzo IP 192.168.3.202.
Impostazione per core.machinekey
| Parametro | Descrizione |
|---|---|
-mk, --machinekey | Impostazione per la chiave core.machinekey |
Questo parametro ti consente di specificare la tua machinekey durante l'installazione di ONLYOFFICE Apps Community.
Questo parametro viene scritto nel file di configurazione /app/onlyoffice/config/appsettings.json (il percorso è specificato all'interno del container onlyoffice-studio).
Esempio
bash apps-install.sh -mk yourmachinekey
Porta esterna ONLYOFFICE Apps
| Parametro | Descrizione | Predefinito |
|---|---|---|
-ep, --externalport | porta esterna di ONLYOFFICE Apps | 80 |
Questo parametro ti consente di modificare la porta su cui verrà eseguito ONLYOFFICE Apps. Per impostazione predefinita, viene utilizzata la porta 80.
Esempio
bash apps-install.sh -ep 8080
Impostazioni per intestazione e segreto JWT
| Parametro | Descrizione |
|---|---|
-jh, --jwtheader | Impostazione per l'intestazione JWT |
-js, --jwtsecret | Impostazione per la chiave segreta JWT |
Questi parametri ti consentono di specificare l'intestazione JWT e la tua chiave segreta JWT durante l'installazione di ONLYOFFICE Apps Community. L'intestazione JWT definisce l'intestazione http che verrà utilizzata per inviare il JWT. La chiave segreta viene utilizzata per firmare il token web JSON e convalidare il token alla richiesta a ONLYOFFICE Docs.
Questi parametri vengono scritti nei seguenti file di configurazione (i percorsi sono specificati all'interno dei container onlyoffice-studio e onlyoffice-document-server):
- Per ONLYOFFICE Apps -
/app/onlyoffice/config/appsettings.json - Per Document Server -
/etc/onlyoffice/documentserver/local.json
Esempio
bash apps-install.sh -js yoursecret
Server MySQL
| Parametro | Descrizione | Predefinito |
|---|---|---|
-mysqlrp, --mysqlrootpassword | password root del server MySQL | generata automaticamente |
-mysqlh, --mysqlhost | host del server MySQL | localhost |
-mysqlport, --mysqlport | numero di porta del server MySQL | 3306 |
Se non specifichi esplicitamente l'host e la porta, vengono utilizzati i valori predefiniti. La password di root viene generata automaticamente se non la imposti.
Esempio
bash apps-install.sh -mysqlrp new-secret-pw
Questo comando ti consente di impostare la tua password per l'account root di MySQL durante l'installazione di ONLYOFFICE Apps Community.
Database ONLYOFFICE Apps
| Parametro | Descrizione | Predefinito |
|---|---|---|
-mysqld, --mysqldatabase | nome del database di ONLYOFFICE Apps | onlyoffice_apps |
-mysqlu, --mysqluser | utente del database di ONLYOFFICE Apps | - |
-mysqlp, --mysqlpassword | password del database di ONLYOFFICE Apps | generata automaticamente |
Questi parametri ti consentono di creare il database di ONLYOFFICE Apps specificando un nome di database personalizzato, nonché un nome utente e una password per l'account con permessi di superutente sul database creato. Se non specifichi esplicitamente il nome del database, viene utilizzato il valore predefinito. Se non imposti una password, questa viene generata automaticamente.
Esempio
bash apps-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
Server RabbitMQ
| Parametro | Descrizione | Predefinito |
|---|---|---|
--rabbitmqprotocol | protocollo di connessione di RabbitMQ | amqp |
--rabbitmqhost | host del server RabbitMQ | localhost |
--rabbitmqport | numero di porta del server RabbitMQ | 5672 |
--rabbitmqusername | nome utente di RabbitMQ | - |
--rabbitmqpassword | password dell'utente di RabbitMQ | - |
--rabbitmqvirtualhost | host virtuale di RabbitMQ | / |
Utilizza questi parametri per collegare ONLYOFFICE Apps a un server RabbitMQ già in esecuzione su un'altra macchina. Salta l'installazione di RabbitMQ con il parametro -irbt false, quindi specifica i parametri di connessione del tuo server. Se non specifichi esplicitamente il protocollo, l'host, la porta o l'host virtuale, vengono utilizzati i valori predefiniti.
Esempio
bash apps-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
Questo installerà ONLYOFFICE Apps senza RabbitMQ e lo collegherà al server RabbitMQ in esecuzione sull'host mq.example.com.
Server Redis
| Parametro | Descrizione | Predefinito |
|---|---|---|
--redishost | host del server Redis | localhost |
--redisport | numero di porta del server Redis | 6379 |
--redisusername | nome utente di Redis, se il server richiede l'autorizzazione | - |
--redispassword | password dell'utente di Redis, se il server richiede l'autorizzazione | - |
Utilizza questi parametri per collegare ONLYOFFICE Apps a un server Redis già in esecuzione su un'altra macchina. Salta l'installazione di Redis con il parametro -irds false, quindi specifica i parametri di connessione del tuo server. Il nome utente e la password sono necessari solo se il tuo server Redis richiede l'autorizzazione.
Esempio
bash apps-install.sh -irds false --redishost redis.example.com --redispassword password
Questo installerà ONLYOFFICE Apps senza Redis e lo collegherà al server Redis in esecuzione sull'host redis.example.com.
Server OpenSearch
| Parametro | Descrizione | Predefinito |
|---|---|---|
--elasticprotocol | protocollo di connessione di OpenSearch | http |
--elasticport | numero di porta del server OpenSearch | 9200 |
Utilizza questi parametri insieme al parametro -esh, --elastichost descritto nella sezione Impostazione per host sopra per collegare ONLYOFFICE Apps a un server OpenSearch in esecuzione su un'altra macchina. Se non specifichi esplicitamente il protocollo e la porta, vengono utilizzati i valori predefiniti.
Esempio
bash apps-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
Questo collegherà ONLYOFFICE Apps al server OpenSearch in esecuzione sull'host search.example.com tramite HTTPS.
Passaggio a HTTPS
| Parametro | Descrizione |
|---|---|
-led, --letsencryptdomain | definisce il dominio per il certificato Let's Encrypt |
-lem, --letsencryptmail | definisce l'indirizzo e-mail dell'amministratore del dominio per il certificato Let's Encrypt |
-cf, --certfile | percorso del file del certificato per il dominio |
-ckf, --certkeyfile | percorso del file della chiave privata per il certificato |
Questi parametri ti consentono di passare lo spazio di lavoro a HTTPS. Possono essere utilizzati solo per la versione Docker.
Esempio
bash apps-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Questo creerà e installerà automaticamente sul tuo server il certificato firmato dalla CA letsencrypt.org e riavvierà il servizio NGINX affinché le modifiche abbiano effetto.
bash apps-install.sh docker --certfile path --certkeyfile path
Questo applicherà il tuo certificato SSL.