Installieren von ONLYOFFICE Apps Enterprise mit zusätzlichen Skriptparametern
Einleitung
ONLYOFFICE Apps Enterprise ist eine kostenpflichtige Version eines Dokumenten-Hubs, in dem Sie Benutzer und Dokumente an einem Ort verbinden können, um die Zusammenarbeit zu fördern.
ONLYOFFICE Apps Enterprise wird als automatisches Installationsskript für Linux-Betriebssysteme mit installiertem Docker ausgeliefert. Das Skript richtet Docker-Container mit allen für die korrekte Funktion von ONLYOFFICE Apps Enterprise erforderlichen Komponenten ein und ist einfach auszuführen, zu verwalten und zu aktualisieren.
Nachdem Sie das Installationsskript ONLYOFFICE Apps Enterprise heruntergeladen haben, müssen Sie es möglicherweise unter Angabe einiger zusätzlicher Parameter ausführen, beispielsweise, wenn Sie jede Komponente auf einem separaten Computer installieren möchten.
Verwenden Sie den folgenden Befehl, um die Liste aller verfügbaren Docker-Skriptparameter anzuzeigen:
bash apps-enterprise-install.sh docker -h
Verwenden Sie den folgenden Befehl, um die Liste aller verfügbaren DEB/RPM-Skriptparameter anzuzeigen:
bash apps-enterprise-install.sh package -h
Nachfolgend finden Sie eine kurze Beschreibung und einige Anwendungsbeispiele für diese Parameter.
Wenn Sie das Skript mit Parametern ausführen, werden Sie aufgefordert, die Installationsmethode für ONLYOFFICE Apps auszuwählen. Geben Sie Y ein und drücken Sie die Eingabetaste, um ONLYOFFICE Apps mit Docker zu installieren. Geben Sie N ein und drücken Sie die Eingabetaste, um ONLYOFFICE Apps aus DEB/RPM-Paketen zu installieren.
Anmeldeinformationen
| Parameter | Beschreibung |
|---|---|
-reg, --registry | Docker-Registrierungs-URL (z. B. https://myregistry.com:5000) |
-un, --username | Docker-Registrierungsanmeldung |
-p, --password | Docker-Registrierungskennwort |
Diese Parameter werden verwendet, falls wir Ihnen Anmeldeinformationen für den Zugriff auf ein Test-Repository zur Verfügung stellen, damit Sie Container aus den darin gespeicherten Images ausführen können.
Beispiel
bash apps-enterprise-install.sh -reg URL -un username -p password
Installationstyp
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-it, --installationtype | Installationstyp | community|developer|enterprise | enterprise |
Mit diesem Parameter können Sie die angegebene Lösung installieren: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer oder ONLYOFFICE Apps Enterprise.
Beispiel
bash apps-enterprise-install.sh -it community
Dadurch wird die Lösung ONLYOFFICE Apps Community installiert.
Hardware-Check
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-skiphc, --skiphardwarecheck | verwenden, um die Hardwareprüfung zu überspringen | true|false | false |
Mit diesem Parameter können Sie die Prüfung überspringen, ob das System die minimalen Hardwareanforderungen erfüllt.
Beispiel
bash apps-enterprise-install.sh -skiphc true
Dadurch wird die Hardwareprüfung übersprungen.
Komponentenaktualisierung
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-u, --update | verwenden, um vorhandene Komponenten zu aktualisieren | true|false | false |
Mit diesem Parameter können Sie die neuesten Versionen der erforderlichen Komponenten installieren, wenn die entsprechenden auf Ihrem Computer installierten Komponenten veraltet sind.
Beispiel
bash apps-enterprise-install.sh -u true
Dadurch werden nacheinander die Container gestoppt, die aktualisiert werden müssen, entfernt und dann die neuesten Versionen der entsprechenden ONLYOFFICE Apps Enterprise-Komponenten ausgeführt. Wenn die aktuelle Komponentenversion mit der neuesten verfügbaren übereinstimmt, ist ein solcher Container nicht betroffen. Wenn Sie bei der vorherigen Installation einige Komponenten übersprungen haben, werden diese ebenfalls übersprungen. Die ONLYOFFICE Apps-Daten sollten automatisch übernommen werden.
Docs nur auf Version 7.2.1.34 aktualisieren und die Aktualisierung aller anderen Komponenten überspringen:
bash apps-enterprise-install.sh -u true -docsi onlyoffice/documentserver-ee -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
ONLYOFFICE Apps nur auf Version 1.2.0 aktualisieren und die Aktualisierung aller anderen Komponenten überspringen:
bash apps-enterprise-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
Komponenteninstallation
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-ia, --installapps | ONLYOFFICE Apps installieren | true|false | true |
-idocs, --installdocs | ONLYOFFICE Docs installieren | true|false | true |
-irbt, --installrabbitmq | RabbitMQ installieren | true|false | true |
-irds, --installredis | Redis installieren | true|false | true |
-imysql, --installmysql | MySQL installieren | true|false | true |
Mit diesen Parametern können Sie festlegen, ob eine bestimmte Komponente installiert werden soll oder nicht. Sie können verwendet werden, wenn Sie jede Komponente auf einem separaten Computer installieren möchten.
- Verwenden Sie den Wert
true, um eine Komponente zu installieren. - Verwenden Sie den Wert
false, um die Installation einer Komponente zu überspringen.
Beispiel
bash apps-enterprise-install.sh -idocs false
Dadurch werden alle ONLYOFFICE Apps Enterprise-Komponenten ohne ONLYOFFICE Docs installiert.
bash apps-enterprise-install.sh -ia false -idocs true -imysql false -irbt false -irds false
Dadurch wird die Installation von ONLYOFFICE Apps, MySQL, RabbitMQ und Redis übersprungen und nur ONLYOFFICE Docs installiert.
Komponentenversion
| Parameter | Beschreibung |
|---|---|
-asv, --appsversion | ONLYOFFICE Apps-Version |
-docsv, --docsversion | ONLYOFFICE Docs-Version |
Diese Parameter können verwendet werden, um eine bestimmte ONLYOFFICE Apps- oder ONLYOFFICE Docs-Version zu installieren, wenn Sie aus irgendeinem Grund nicht die neueste im Repository verfügbare Version installieren möchten. Standardmäßig wird ein mit latest getaggtes Image zum Ausführen des Komponentencontainers verwendet.
Beispiel
Öffnen Sie das Docker Hub-Repository in Ihrem Browser, wählen Sie ONLYOFFICE Docs aus und gehen Sie zur Registerkarte Tags, um alle im Repository verfügbaren Tags anzuzeigen. Geben Sie die Version an, die Sie installieren möchten:
bash apps-enterprise-install.sh -docsv 7.2.1.34
Dadurch wird ONLYOFFICE Apps mit der Version 7.2.1.34 von ONLYOFFICE Docs installiert.
ONLYOFFICE Docs-Bildname
| Parameter | Beschreibung |
|---|---|
-docsi, --docsimage | Name des ONLYOFFICE Docs-Images |
Mit diesem Parameter können Sie den Namen des ONLYOFFICE Docs-Images angeben, aus dem ein Container gestartet werden soll. Das angegebene Image sollte in unserem offiziellen öffentlichen Repository auf Docker Hub gespeichert sein.
Beispiel
bash apps-enterprise-install.sh -docsi onlyoffice/documentserver-ee
Dadurch wird ein Container aus dem angegebenen, im Repository gespeicherten ONLYOFFICE Docs-Image ausgeführt.
Einstellungen für Hosts
| Parameter | Beschreibung |
|---|---|
-ash, --appshost | ONLYOFFICE Apps-Host |
-esh, --elastichost | OpenSearch-Hosts |
Diese Parameter können verwendet werden, um die Komponenten zu verbinden, wenn Sie sie auf separaten Computern installieren.
Beispiel
bash apps-enterprise-install.sh -esh 192.168.3.202
Dadurch wird ONLYOFFICE Apps installiert und mit OpenSearch verbunden, das auf einem anderen Computer mit der IP-Adresse 192.168.3.202 installiert ist.
Einstellung für core.machinekey
| Parameter | Beschreibung |
|---|---|
-mk, --machinekey | Einstellung für den Schlüssel core.machinekey |
Mit diesem Parameter können Sie bei der Installation von ONLYOFFICE Apps Enterprise Ihren eigenen machinekey angeben.
Dieser Parameter wird in die Konfigurationsdatei /app/onlyoffice/config/appsettings.json geschrieben (der Pfad ist innerhalb des Containers onlyoffice-studio angegeben).
Beispiel
bash apps-enterprise-install.sh -mk yourmachinekey
Externer Port von ONLYOFFICE Apps
| Parameter | Beschreibung | Standard |
|---|---|---|
-ep, --externalport | Externer Port von ONLYOFFICE Apps | 80 |
Mit diesem Parameter können Sie den Port ändern, auf dem ONLYOFFICE Apps ausgeführt wird. Standardmäßig wird Port 80 verwendet.
Beispiel
bash apps-enterprise-install.sh -ep 8080
Einstellungen für JWT-Header und -Geheimnis
| Parameter | Beschreibung |
|---|---|
-jh, --jwtheader | Einstellung für den JWT-Header |
-js, --jwtsecret | Einstellung für den geheimen JWT-Schlüssel |
Mit diesen Parametern können Sie bei der Installation von ONLYOFFICE Apps Enterprise den JWT-Header und Ihren eigenen geheimen JWT-Schlüssel angeben. Der JWT-Header definiert den HTTP-Header, der zum Senden des JWT verwendet wird. Der geheime Schlüssel wird zum Signieren des JSON Web Tokens und zum Validieren des Tokens bei der Anfrage an ONLYOFFICE Docs verwendet.
Diese Parameter werden in die folgenden Konfigurationsdateien geschrieben (die Pfade sind innerhalb der Container onlyoffice-studio und onlyoffice-document-server angegeben):
- Für ONLYOFFICE Apps -
/app/onlyoffice/config/appsettings.json - Für Document Server -
/etc/onlyoffice/documentserver/local.json
Beispiel
bash apps-enterprise-install.sh -js yoursecret
MySQL-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqlrp, --mysqlrootpassword | Root-Passwort des MySQL-Servers | automatisch generiert |
-mysqlh, --mysqlhost | Host des MySQL-Servers | localhost |
-mysqlport, --mysqlport | Portnummer des MySQL-Servers | 3306 |
Wenn Sie Host und Port nicht explizit angeben, werden die Standardwerte verwendet. Das Root-Passwort wird automatisch generiert, wenn Sie es nicht festlegen.
Beispiel
bash apps-enterprise-install.sh -mysqlrp new-secret-pw
Mit diesem Befehl können Sie bei der Installation von ONLYOFFICE Apps Enterprise Ihr eigenes Passwort für das MySQL-Root-Konto festlegen.
ONLYOFFICE Apps-Datenbank
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqld, --mysqldatabase | Datenbankname von ONLYOFFICE Apps | onlyoffice_apps |
-mysqlu, --mysqluser | Datenbankbenutzer von ONLYOFFICE Apps | - |
-mysqlp, --mysqlpassword | Datenbankpasswort von ONLYOFFICE Apps | automatisch generiert |
Mit diesen Parametern können Sie die ONLYOFFICE Apps-Datenbank mit einem benutzerdefinierten Datenbanknamen sowie einem Benutzernamen und Passwort für das Konto mit Superuser-Berechtigungen für die erstellte Datenbank erstellen. Wenn Sie den Datenbanknamen nicht explizit angeben, wird der Standardwert verwendet. Wenn Sie kein Passwort festlegen, wird es automatisch generiert.
Beispiel
bash apps-enterprise-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
RabbitMQ-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
--rabbitmqprotocol | RabbitMQ-Verbindungsprotokoll | amqp |
--rabbitmqhost | Host des RabbitMQ-Servers | localhost |
--rabbitmqport | Portnummer des RabbitMQ-Servers | 5672 |
--rabbitmqusername | RabbitMQ-Benutzername | - |
--rabbitmqpassword | RabbitMQ-Benutzerpasswort | - |
--rabbitmqvirtualhost | Virtueller RabbitMQ-Host | / |
Mit diesen Parametern verbinden Sie ONLYOFFICE Apps mit einem RabbitMQ-Server, der bereits auf einem anderen Computer läuft. Überspringen Sie die Installation von RabbitMQ mit dem Parameter -irbt false und geben Sie dann die Verbindungsparameter Ihres eigenen Servers an. Wenn Sie das Protokoll, den Host, den Port oder den virtuellen Host nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash apps-enterprise-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
Dadurch wird ONLYOFFICE Apps ohne RabbitMQ installiert und mit dem RabbitMQ-Server verbunden, der auf dem Host mq.example.com läuft.
Redis-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
--redishost | Host des Redis-Servers | localhost |
--redisport | Portnummer des Redis-Servers | 6379 |
--redisusername | Redis-Benutzername, falls der Server eine Autorisierung erfordert | - |
--redispassword | Redis-Benutzerpasswort, falls der Server eine Autorisierung erfordert | - |
Mit diesen Parametern verbinden Sie ONLYOFFICE Apps mit einem Redis-Server, der bereits auf einem anderen Computer läuft. Überspringen Sie die Installation von Redis mit dem Parameter -irds false und geben Sie dann die Verbindungsparameter Ihres eigenen Servers an. Benutzername und Passwort werden nur benötigt, wenn Ihr Redis-Server eine Autorisierung erfordert.
Beispiel
bash apps-enterprise-install.sh -irds false --redishost redis.example.com --redispassword password
Dadurch wird ONLYOFFICE Apps ohne Redis installiert und mit dem Redis-Server verbunden, der auf dem Host redis.example.com läuft.
OpenSearch-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
--elasticprotocol | OpenSearch-Verbindungsprotokoll | http |
--elasticport | Portnummer des OpenSearch-Servers | 9200 |
Verwenden Sie diese Parameter zusammen mit dem Parameter -esh, --elastichost, der oben im Abschnitt Einstellungen für Hosts beschrieben ist, um ONLYOFFICE Apps mit einem OpenSearch-Server zu verbinden, der auf einem anderen Computer läuft. Wenn Sie das Protokoll und den Port nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash apps-enterprise-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
Dadurch wird ONLYOFFICE Apps über HTTPS mit dem OpenSearch-Server verbunden, der auf dem Host search.example.com läuft.
Umstellung auf HTTPS
| Parameter | Beschreibung |
|---|---|
-led, --letsencryptdomain | definiert die Domain für das Let's Encrypt-Zertifikat |
-lem, --letsencryptmail | definiert die E-Mail-Adresse des Domain-Administrators für das Let's Encrypt-Zertifikat |
-cf, --certfile | Pfad zur Zertifikatsdatei für die Domain |
-ckf, --certkeyfile | Pfad zur privaten Schlüsseldatei für das Zertifikat |
Mit diesen Parametern können Sie den Arbeitsbereich auf HTTPS umstellen. Sie können nur für die Docker-Version verwendet werden.
Beispiel
bash apps-enterprise-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Dadurch wird automatisch das von letsencrypt.org CA-signierte Zertifikat erstellt und auf Ihrem Server installiert und der NGINX-Dienst neu gestartet, damit die Änderungen wirksam werden.
bash apps-enterprise-install.sh docker --certfile path --certkeyfile path
Dadurch wird Ihr eigenes SSL-Zertifikat angewendet.