Installazione di ONLYOFFICE Apps Enterprise con parametri aggiuntivi dello script
Introduzione
ONLYOFFICE Apps Enterprise è una versione a pagamento di un hub di documenti in cui puoi connettere utenti e documenti in un unico posto per favorire la collaborazione.
ONLYOFFICE Apps Enterprise viene fornito 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 Enterprise ed è facile da eseguire, gestire e aggiornare.
Dopo aver scaricato lo script di installazione di ONLYOFFICE Apps Enterprise, potrebbe essere necessario eseguirlo specificando alcuni parametri aggiuntivi, ad esempio, se desideri installare ciascun componente su una macchina separata.
Usa il seguente comando per visualizzare l'elenco di tutti i parametri disponibili per lo script Docker:
bash apps-enterprise-install.sh docker -h
Usa il seguente comando per visualizzare l'elenco di tutti i parametri disponibili per lo script DEB/RPM:
bash apps-enterprise-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 desideri 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 (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-enterprise-install.sh -reg URL -un username -p password
Tipo di installazione
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-it, --installationtype | tipo di installazione | community|developer|enterprise | enterprise |
Questo parametro ti consente di installare la soluzione specificata: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer o ONLYOFFICE Apps Enterprise.
Esempio
bash apps-enterprise-install.sh -it community
Questo installerà la soluzione ONLYOFFICE Apps Community.
Verifica hardware
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-skiphc, --skiphardwarecheck | usa per saltare la verifica hardware | true|false | false |
Questo parametro ti consente di saltare il controllo che verifica se il sistema soddisfa i requisiti hardware minimi.
Esempio
bash apps-enterprise-install.sh -skiphc true
Questo salterà la verifica hardware.
Aggiornamento componenti
| Parametro | Descrizione | Valori | Predefinito |
|---|---|---|---|
-u, --update | usa 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-enterprise-install.sh -u true
Questo arresterà in sequenza i container che devono essere aggiornati, li rimuoverà e quindi eseguirà le versioni più recenti dei componenti ONLYOFFICE Apps Enterprise corrispondenti. Se la versione attuale del componente coincide con l'ultima disponibile, tale container non verrà interessato. Se durante l'installazione precedente hai saltato alcuni componenti, verranno saltati anche questi. I dati di ONLYOFFICE Apps dovrebbero essere recuperati automaticamente.
Aggiornare solo Docs alla versione 7.2.1.34 e saltare l'aggiornamento di tutti gli altri componenti:
bash apps-enterprise-install.sh -u true -docsi onlyoffice/documentserver-ee -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Aggiornare solo ONLYOFFICE Apps alla versione 1.2.0 e saltare l'aggiornamento di tutti gli altri componenti:
bash apps-enterprise-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 è necessario installare un determinato componente o meno. Possono essere utilizzati se desideri installare ciascun 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-enterprise-install.sh -idocs false
Questo installerà tutti i componenti di ONLYOFFICE Apps Enterprise senza ONLYOFFICE Docs.
bash apps-enterprise-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 componenti
| 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 ONLYOFFICE Docs se per qualche motivo non desideri installare l'ultima versione disponibile nel repository. Per impostazione predefinita, per eseguire il container del componente viene utilizzata un'immagine con il 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 desideri installare:
bash apps-enterprise-install.sh -docsv 7.2.1.34
Questo installerà ONLYOFFICE Apps con la versione 7.2.1.34 di ONLYOFFICE Docs.
Nome dell'immagine di 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 deve essere avviato un container. L'immagine specificata deve essere archiviata nel nostro repository pubblico ufficiale su Docker Hub.
Esempio
bash apps-enterprise-install.sh -docsi onlyoffice/documentserver-ee
Questo eseguirà un container dall'immagine di ONLYOFFICE Docs specificata archiviata nel repository.
Impostazione per gli host
| Parametro | Descrizione |
|---|---|
-ash, --appshost | host di ONLYOFFICE Apps |
-esh, --elastichost | host di OpenSearch |
Questi parametri possono essere utilizzati per connettere i componenti se li installi su macchine separate.
Esempio
bash apps-enterprise-install.sh -esh 192.168.3.202
Questo installerà ONLYOFFICE Apps e lo collegherà a OpenSearch installato su una macchina diversa 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 Enterprise.
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-enterprise-install.sh -mk yourmachinekey
Porta esterna di 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-enterprise-install.sh -ep 8080
Impostazioni per l'intestazione e il 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 Enterprise. 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-enterprise-install.sh -js yoursecret
Server MySQL
| Parametro | Descrizione | Predefinito |
|---|---|---|
-mysqlrp, --mysqlrootpassword | password root del server MySQL | generato 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 root viene generata automaticamente se non la imposti.
Esempio
bash apps-enterprise-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 Enterprise.
Database di 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 | generato 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, viene generata automaticamente.
Esempio
bash apps-enterprise-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
Server RabbitMQ
| Parametro | Descrizione | Predefinito |
|---|---|---|
--rabbitmqprotocol | protocollo di connessione RabbitMQ | amqp |
--rabbitmqhost | host del server RabbitMQ | localhost |
--rabbitmqport | numero di porta del server RabbitMQ | 5672 |
--rabbitmqusername | nome utente RabbitMQ | - |
--rabbitmqpassword | password dell'utente RabbitMQ | - |
--rabbitmqvirtualhost | host virtuale RabbitMQ | / |
Usa 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-enterprise-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 Redis, se il server richiede l'autorizzazione | - |
--redispassword | password dell'utente Redis, se il server richiede l'autorizzazione | - |
Usa 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-enterprise-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 OpenSearch | http |
--elasticport | numero di porta del server OpenSearch | 9200 |
Usa questi parametri insieme al parametro -esh, --elastichost descritto nella sezione Impostazione per gli host qui 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-enterprise-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 email 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-enterprise-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Questo creerà e installerà automaticamente il certificato firmato dalla CA letsencrypt.org sul tuo server e riavvierà il servizio NGINX affinché le modifiche abbiano effetto.
bash apps-enterprise-install.sh docker --certfile path --certkeyfile path
Questo applicherà il tuo certificato SSL.