Installieren von ONLYOFFICE Apps Developer mit zusätzlichen Skriptparametern
Einleitung
ONLYOFFICE Apps Developer 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 Developer 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 Developer erforderlichen Komponenten ein und ist einfach auszuführen, zu verwalten und zu aktualisieren.
Nachdem Sie das Installationsskript ONLYOFFICE Apps Developer 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-developer-install.sh docker -h
Verwenden Sie den folgenden Befehl, um die Liste aller verfügbaren DEB/RPM-Skriptparameter anzuzeigen:
bash apps-developer-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, wenn wir Ihnen Anmeldeinformationen für den Zugriff auf ein Test-Repository bereitstellen, damit Sie Container aus darin gespeicherten Bildern ausführen können.
Beispiel
bash apps-developer-install.sh -reg URL -un username -p password
Installationstyp
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-it, --installationtype | Installationstyp | community|developer|enterprise | developer |
Mit diesem Parameter können Sie die angegebene Lösung installieren: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer oder ONLYOFFICE Apps Enterprise.
Beispiel
bash apps-developer-install.sh -it community
Dadurch wird die ONLYOFFICE Apps Community-Lösung installiert.
Hardware-Check
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-skiphc, --skiphardwarecheck | Der Parameter wird verwendet, um das Hardware-Check zu überspringen | true|false | false |
Mit diesem Parameter können Sie die Überprüfung überspringen, ob das System die minimalen Hardwareanforderungen erfüllt.
Beispiel
bash apps-developer-install.sh -skiphc true
Dadurch wird das Hardware-Check übersprungen.
Komponentenaktualisierung
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-u, --update | Der Parameter dient zum Aktualisieren vorhandener Komponenten | 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-developer-install.sh -u true
Dadurch werden die zu aktualisierenden Container gestoppt, entfernt und anschließend die neuesten Versionen der entsprechenden ONLYOFFICE Apps Developer-Komponenten ausgeführt. Wenn die aktuelle Komponentenversion mit der neuesten verfügbaren Version ü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 abgerufen werden.
Aktualisieren Sie nur Docs auf Version 7.2.1.34 und überspringen Sie das Update für alle anderen Komponenten:
bash apps-developer-install.sh -u true -docsi onlyoffice/documentserver-de -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Aktualisieren Sie ONLYOFFICE Apps nur auf Version 1.2.0 und überspringen Sie das Update für alle anderen Komponenten:
bash apps-developer-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 angeben, ob Sie eine bestimmte Komponente installieren müssen 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-developer-install.sh -idocs false
Dadurch werden alle ONLYOFFICE Apps Developer-Komponenten ohne ONLYOFFICE Docs installiert.
bash apps-developer-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 Version von ONLYOFFICE Apps oder ONLYOFFICE Docs zu installieren, wenn Sie aus bestimmten Gründen nicht die neueste im Repository verfügbare Version installieren möchten. Standardmäßig wird ein als latest gekennzeichnetes 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-developer-install.sh -docsv 7.2.1.34
Dadurch wird ONLYOFFICE Apps mit der Version ONLYOFFICE Docs 7.2.1.34 installiert.
ONLYOFFICE Docs-Bildname
| Parameter | Beschreibung |
|---|---|
-docsi, --docsimage | ONLYOFFICE Docs-Bildname |
Mit diesem Parameter können Sie den Namen des ONLYOFFICE Docs-Bildes angeben, von dem aus ein Container gestartet werden soll. Das angegebene Image sollte in unserem offiziellen öffentlichen Repository auf Docker Hub gespeichert sein.
Beispiel
bash apps-developer-install.sh -docsi onlyoffice/documentserver-de
Dadurch wird ein Container aus dem angegebenen ONLYOFFICE Docs-Bild ausgeführt, das im Repository gespeichert ist.
Einstellungen für Hosts
| Parameter | Beschreibung |
|---|---|
-ash, --appshost | ONLYOFFICE Apps-Host |
-esh, --elastichost | OpenSearch-Hosts |
Diese Parameter können zum Verbinden der Komponenten verwendet werden, wenn Sie sie auf separaten Maschinen installieren.
Beispiel
bash apps-developer-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 Developer Ihren eigenen machinekey angeben.
Dieser Parameter wird in die Konfigurationsdatei /app/onlyoffice/config/appsettings.json geschrieben (der Pfad wird im onlyoffice-studio-container angegeben).
Beispiel
bash apps-developer-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-developer-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 Developer den JWT-Header und Ihren eigenen JWT-Geheimschlüssel angeben. Der JWT-Header definiert den HTTP-Header, der zum Senden des JWT verwendet wird. Der Geheimschlüssel wird verwendet, um das JSON-Web-Token zu signieren und das Token bei der Anfrage an ONLYOFFICE Docs zu validieren.
Diese Parameter werden in die folgenden Konfigurationsdateien geschrieben (die Pfade werden 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-developer-install.sh -js yoursecret
MySQL-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqlrp, --mysqlrootpassword | MySQL-Server-Root-Passwort | automatisch generiert |
-mysqlh, --mysqlhost | MySQL-Serverhost | localhost |
-mysqlport, --mysqlport | MySQL-Server-Portnummer | 3306 |
Wenn Sie Host und Port nicht explizit angeben, werden die Standardwerte verwendet. Das Root-Passwort wird automatisch generiert, wenn Sie keines festlegen.
Beispiel
bash apps-developer-install.sh -mysqlrp new-secret-pw
Mit diesem Befehl können Sie während der Installation von ONLYOFFICE Apps Developer Ihr eigenes Passwort für das MySQL-Root-Konto festlegen.
ONLYOFFICE Apps-Datenbank
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqld, --mysqldatabase | ONLYOFFICE Apps-Datenbankname | onlyoffice_apps |
-mysqlu, --mysqluser | ONLYOFFICE Apps-Datenbankbenutzer | - |
-mysqlp, --mysqlpassword | ONLYOFFICE Apps-Datenbankkennwort | automatisch generiert |
Mit diesen Parametern können Sie die ONLYOFFICE Apps-Datenbank erstellen. Geben Sie dazu einen benutzerdefinierten Datenbanknamen sowie einen Benutzernamen und ein Kennwort für das Konto mit Superuser-Berechtigungen für die erstellte Datenbank an. Wenn Sie den Datenbanknamen nicht explizit angeben, wird der Standardwert verwendet. Wenn Sie kein Kennwort festlegen, wird es automatisch generiert.
Beispiel
bash apps-developer-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
RabbitMQ-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
--rabbitmqprotocol | RabbitMQ-Verbindungsprotokoll | amqp |
--rabbitmqhost | RabbitMQ-Serverhost | localhost |
--rabbitmqport | RabbitMQ-Server-Portnummer | 5672 |
--rabbitmqusername | RabbitMQ-Benutzername | - |
--rabbitmqpassword | RabbitMQ-Benutzerkennwort | - |
--rabbitmqvirtualhost | Virtueller RabbitMQ-Host | / |
Mit diesen Parametern verbinden Sie ONLYOFFICE Apps mit einem RabbitMQ-Server, der bereits auf einem anderen Computer ausgeführt wird. Überspringen Sie die Installation von RabbitMQ mit dem Parameter -irbt false und geben Sie dann die Verbindungsparameter Ihres eigenen Servers an. Wenn Sie Protokoll, Host, Port oder virtuellen Host nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash apps-developer-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 ausgeführt wird.
Redis-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
--redishost | Redis-Serverhost | localhost |
--redisport | Redis-Server-Portnummer | 6379 |
--redisusername | Redis-Benutzername, wenn der Server eine Autorisierung erfordert | - |
--redispassword | Redis-Benutzerkennwort, wenn der Server eine Autorisierung erfordert | - |
Mit diesen Parametern verbinden Sie ONLYOFFICE Apps mit einem Redis-Server, der bereits auf einem anderen Computer ausgeführt wird. Überspringen Sie die Installation von Redis mit dem Parameter -irds false und geben Sie dann die Verbindungsparameter Ihres eigenen Servers an. Benutzername und Kennwort werden nur benötigt, wenn Ihr Redis-Server eine Autorisierung erfordert.
Beispiel
bash apps-developer-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 ausgeführt wird.
OpenSearch-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
--elasticprotocol | OpenSearch-Verbindungsprotokoll | http |
--elasticport | OpenSearch-Server-Portnummer | 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 ausgeführt wird. Wenn Sie Protokoll und Port nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash apps-developer-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 ausgeführt wird.
Umstellung auf HTTPS
| Parameter | Beschreibung |
|---|---|
-led, --letsencryptdomain | definiert die Domäne für das Let’s Encrypt-Zertifikat |
-lem, --letsencryptmail | definiert die E-Mail-Adresse des Domänenadministrators für das Let's Encrypt-Zertifikat |
-cf, --certfile | Pfad zur Zertifikatsdatei für die Domäne |
-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-developer-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Dadurch wird das von der Zertifizierungsstelle letsencrypt.org signierte Zertifikat automatisch erstellt und auf Ihrem Server installiert und der NGINX-Dienst neu gestartet, damit die Änderungen wirksam werden.
bash apps-developer-install.sh docker --certfile path --certkeyfile path
Dadurch wird Ihr eigenes SSL-Zertifikat angewendet.