Installieren von ONLYOFFICE Workspace Community mit zusätzlichen Skriptparametern
Einleitung
ONLYOFFICE Workspace Community ist eine kostenlose Version eines kollaborativen Systems, das entwickelt wurde, um Dokumente, Projekte, Kundenbeziehungen und E-Mail-Korrespondenz an einem Ort zu verwalten.
ONLYOFFICE Workspace Community 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 Workspace Community erforderlichen Komponenten ein und ist einfach auszuführen, zu verwalten und zu aktualisieren.
Nachdem Sie das Installationsskript von ONLYOFFICE Workspace Community heruntergeladen haben, müssen Sie es möglicherweise mit einigen zusätzlichen Parametern 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 Skriptparameter anzuzeigen:
bash workspace-install.sh -h
Nachfolgend finden Sie eine kurze Beschreibung und einige Anwendungsbeispiele für diese Parameter.
Bildname
| Parameter | Beschreibung |
|---|---|
-ci, --communityimage | ONLYOFFICE Community Server Bildname |
-di, --documentimage | ONLYOFFICE Docs Bildname |
-mi, --mailimage | ONLYOFFICE E-Mail Bildname |
-cpi, --controlpanelimage | ONLYOFFICE Systemsteuerung Bildname |
Mit diesen Parametern können Sie den Namen des Images angeben, von dem ein Container gestartet werden soll. Das angegebene Image muss im offiziellen öffentlichen Repository auf Docker Hub verfügbar sein.
Beispiel
bash workspace-install.sh -ims false -di onlyoffice/documentserver -ics true -icp true
Dadurch wird ein Container aus dem angegebenen, im Repository gespeicherten ONLYOFFICE Docs-Image ausgeführt und auch die Container ONLYOFFICE Community Server und ONLYOFFICE Systemsteuerung werden ausgeführt.
Komponentenversion
| Parameter | Beschreibung |
|---|---|
-cv, --communityversion | ONLYOFFICE Community Server-Version |
-dv, --documentversion | ONLYOFFICE Docs-Version |
-mv, --mailversion | ONLYOFFICE E-Mail-Version |
-cpv, --controlpanelversion | ONLYOFFICE Systemsteuerung-Version |
Mit diesen Parametern können Sie eine bestimmte Komponentenversion installieren, wenn Sie nicht die neueste im Repository verfügbare Version verwenden möchten. Standardmäßig wird zum Ausführen jedes Komponentencontainers ein Image mit dem Tag latest verwendet.
Beispiel
Öffnen Sie das Docker Hub-Repository in Ihrem Browser, wählen Sie die gewünschte Komponente aus und wechseln Sie zur Registerkarte Tags, um alle verfügbaren Tags anzuzeigen. Geben Sie die Version an, die Sie für die erforderlichen Komponenten installieren möchten:
bash workspace-install.sh -ics true -cv 8.9.0.150 -ids false -icp true -cpv 1.6.0.52 -ims true -md "yourdomain.com"
Dadurch werden die Version 8.9.0.150 des ONLYOFFICE Community Servers, die Version 1.6.0.52 der ONLYOFFICE Systemsteuerung und die neueste Version von ONLYOFFICE E-Mail installiert, da deren Version nicht explizit angegeben wurde.
Server-IP
| Parameter | Beschreibung |
|---|---|
-dip, --documentserverip | ONLYOFFICE Docs IP-Adresse |
-mip, --mailserverip | ONLYOFFICE E-Mail IP-Adresse |
-mdbip, --mailserverdbip | IP-Adresse der ONLYOFFICE E-Mail-Datenbank |
Diese Parameter können zum Verbinden der Komponenten verwendet werden, wenn Sie sie auf separaten Maschinen installieren.
Beispiel
bash workspace-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false
Dadurch wird der ONLYOFFICE Community Server mit der ONLYOFFICE Systemsteuerung installiert und mit ONLYOFFICE Docs verbunden, das auf einem anderen Computer mit der IP-Adresse 192.168.3.202 installiert ist.
ONLYOFFICE E-Mail-Domänenname
| Parameter | Beschreibung |
|---|---|
-md, --maildomain | ONLYOFFICE E-Mail Domänenname |
Mit diesem Parameter können Sie Ihren eigenen Domänennamen angeben, der für ONLYOFFICE E-Mail verwendet wird.
Beispiel
bash workspace-install.sh -md "yourdomain.com"
Dadurch werden alle ONLYOFFICE Workspace Community-Komponenten einschließlich ONLYOFFICE E-Mail mit dem angegebenen Domänennamen yourdomain.com installiert.
Ihre Domäne, die für die Korrespondenz verwendet wird, muss gültig und für diesen Computer konfiguriert sein (d. h. sie sollte über den entsprechenden A-Eintrag in den DNS-Einstellungen verfügen, der Ihren Domänennamen auf die IP-Adresse des Computers verweist, auf dem ONLYOFFICE E-Mail installiert ist).
Im obigen Befehl muss der Parameter "yourdomain.com" als Servicedomäne für ONLYOFFICE E-Mail verstanden werden. Er wird normalerweise im MX-Eintrag der Domäne angegeben, die für die Korrespondenz verwendet wird. In der Regel sieht "yourdomain.com" wie mx1.onlyoffice.com aus.
Komponentenaktualisierung
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-u, --update | zum Aktualisieren vorhandener Komponenten verwenden | true|false | false |
Dieser Parameter ermöglicht die Installation der neuesten Versionen der erforderlichen Komponenten, wenn die entsprechenden auf Ihrem Computer installierten Komponenten veraltet sind.
Beispiel
bash workspace-install.sh -u true
Dadurch werden die zu aktualisierenden Container gestoppt, entfernt und anschließend die neuesten Versionen der entsprechenden ONLYOFFICE Workspace-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 Portaldaten werden automatisch beibehalten.
Anmeldeinformationen
| Parameter | Beschreibung |
|---|---|
-un, --username | dockerhub-Benutzername |
-p, --password | dockerhub-Kennwort |
Diese Parameter werden verwendet, wenn Anmeldeinformationen für den Zugriff auf ein Test-Repository bereitgestellt werden, damit Sie Container aus darin gespeicherten Images ausführen können.
Beispiel
bash workspace-install.sh -md "yourdomain.com" -un username -p password
Komponenteninstallation
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-ics, --installcommunityserver | ONLYOFFICE Community Server installieren | true|false|pull | true |
-ids, --installdocumentserver | ONLYOFFICE Docs installieren | true|false|pull | true |
-ims, --installmailserver | ONLYOFFICE E-Mail installieren | true|false|pull | true |
-icp, --installcontrolpanel | ONLYOFFICE Systemsteuerung installieren | true|false|pull | 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. - Verwenden Sie den Wert
pull, um eine Komponente herunterzuladen, ohne sie zu installieren.
Beispiel
bash workspace-install.sh -ims false
Dadurch werden alle ONLYOFFICE Workspace-Komponenten ohne ONLYOFFICE E-Mail installiert.
bash workspace-install.sh -ics false -ids true -icp false -ims false -es true
Dadurch wird die Installation von ONLYOFFICE E-Mail, ONLYOFFICE Community Server und ONLYOFFICE Systemsteuerung übersprungen und nur ONLYOFFICE Docs installiert.
Installationstyp
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-it, --installation_type | Installationstyp | WORKSPACE|WORKSPACE_ENTERPRISE | WORKSPACE_ENTERPRISE |
Dieser Parameter ermöglicht die Installation der angegebenen Lösung: ONLYOFFICE Workspace oder ONLYOFFICE Workspace Enterprise Edition.
Beispiel
bash workspace-install.sh -it GROUPS
Dadurch wird die ONLYOFFICE Workspace-Lösung installiert, die die Komponenten ONLYOFFICE Community Server und ONLYOFFICE Systemsteuerung enthält.
Verwenden einer Komponente als externer Server
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-es, --useasexternalserver | als externer Server verwenden | true|false | false |
Dieser Parameter wird verwendet, wenn Sie Komponenten auf separaten Servern installieren.
- Verwenden Sie den Wert
true, wenn Sie ONLYOFFICE Docs und ONLYOFFICE E-Mail auf separaten Computern installieren. - Verwenden Sie den Wert
false, wenn Sie ONLYOFFICE Community Server zusammen mit ONLYOFFICE Systemsteuerung auf einem separaten Computer installieren.
Beispiel
bash workspace-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true
Dadurch wird die Installation von ONLYOFFICE Docs, ONLYOFFICE Community Server und ONLYOFFICE Systemsteuerung übersprungen und nur ONLYOFFICE E-Mail installiert.
bash workspace-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false
Dadurch wird der ONLYOFFICE Community Server mit der ONLYOFFICE Systemsteuerung installiert und mit den auf einem anderen Computer installierten ONLYOFFICE Docs verbunden.
Auslagerungsdatei erstellen
| Parameter | Beschreibung | Werte | Standard |
|---|---|---|---|
-ms, --makeswap | Auslagerungsdatei erstellen | true|false | false |
Mit diesem Parameter können Sie eine 6 GB große Auslagerungsdatei erstellen. Standardmäßig ist der Wert true angegeben. Daher müssen Sie diesen Parameter beim Ausführen des Skripts nicht angeben. Die Auslagerungsdatei wird automatisch erstellt.
Beispiel
bash workspace-install.sh -ms false
Wenn bereits eine Auslagerungsdatei vorhanden ist, können Sie diesen Befehl verwenden, um zu verhindern, dass während der Installation eine neue Auslagerungsdatei erstellt wird.
Wenn Sie das Skript erneut ausführen, ohne den Parameter -ms anzugeben, prüft es, ob die onlyoffice_swapfile vorhanden ist. Wenn die Auslagerungsdatei bereits vorhanden ist, wird sie nicht erneut erstellt.
MySQL-Server
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqlh, --mysqlhost | MySQL-Serverhost | localhost |
-mysqlprt, --mysqlport | MySQL-Serverport | 3306 |
-mysqlru, --mysqlrootuser | MySQL-Server-Root-Benutzer | root |
-mysqlrp, --mysqlrootpassword | MySQL-Server-Root-Passwort | my-secret-pw |
Wenn Sie diese Parameter nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash workspace-install.sh -mysqlru root -mysqlrp new-secret-pw
Mit diesem Befehl können Sie während der Installation von ONLYOFFICE Workspace Ihr eigenes Passwort für das MySQL-Root-Konto festlegen.
ONLYOFFICE Community Server-Datenbank
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqld, --mysqldatabase | Datenbankname des ONLYOFFICE Community Servers | onlyoffice |
-mysqlu, --mysqluser | Datenbankbenutzer des ONLYOFFICE Community Servers | onlyoffice_user |
-mysqlp, --mysqlpassword | Datenbankkennwort des ONLYOFFICE Community Servers | onlyoffice_pass |
Mit diesen Parametern können Sie die ONLYOFFICE Community Server-Datenbank mit einem benutzerdefinierten Namen sowie einem Benutzernamen und einem Kennwort für ein Konto mit Superuser-Berechtigungen erstellen. Wenn Sie diese Parameter nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash workspace-install.sh -mysqld communitydatabase -mysqlu username -mysqlp password
ONLYOFFICE E-Mail-Datenbank
| Parameter | Beschreibung | Standard |
|---|---|---|
-mysqlmd, --mysqlmaildatabase | ONLYOFFICE E-Mail Datenbankname | onlyoffice_mailserver |
-mysqlmu, --mysqlmailuser | ONLYOFFICE E-Mail Datenbankbenutzer | mail_admin |
-mysqlmp, --mysqlmailpassword | ONLYOFFICE E-Mail Datenbankkennwort | Isadmin123 |
Mit diesen Parametern können Sie die ONLYOFFICE E-Mail-Datenbank mit einem benutzerdefinierten Datenbanknamen sowie einem Benutzernamen und einem Kennwort für das Konto mit Superuser-Berechtigungen für die erstellte Datenbank erstellen. Wenn Sie diese Parameter nicht explizit angeben, werden die Standardwerte verwendet.
Beispiel
bash workspace-install.sh -md "mx.yourdomain.com" -mysqlmd maildatabase -mysqlmu username -mysqlmp password
ONLYOFFICE Community Server-Port
| Parameter | Beschreibung | Standard |
|---|---|---|
-cp, --communityport | ONLYOFFICE Community Server-Port | 80 |
Mit diesem Parameter können Sie den Port ändern, auf dem ONLYOFFICE Community Server ausgeführt wird. Standardmäßig wird Port 80 verwendet.
Beispiel
bash workspace-install.sh -cp 8080
Einstellung für core.machinekey
| Parameter | Beschreibung |
|---|---|
-mk, --machinekey | Einstellung für core.machinekey |
Mit diesem Parameter können Sie bei der Installation von ONLYOFFICE Workspace Community Ihren eigenen Maschinenschlüssel angeben.
Dieser Parameter wird in die Konfigurationsdatei /app/onlyoffice/CommunityServer/data/.private/machinekey geschrieben.
Beispiel
bash workspace-install.sh -mk yourmachinekey
Einstellung für JWT-Geheimnis
| Parameter | Beschreibung |
|---|---|
-jwt, --jwtsecret | Einstellung für den geheimen JWT-Schlüssel |
Mit diesem Parameter können Sie bei der Installation von ONLYOFFICE Workspace Community Ihren eigenen geheimen JWT-Schlüssel angeben. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token zu signieren und das Token bei der Anfrage an ONLYOFFICE Docs zu validieren.
Dieser Parameter wird in die folgenden Konfigurationsdateien geschrieben (die Pfade werden innerhalb von Containern angegeben):
- Für Community Server -
/var/www/onlyoffice/WebStudio/web.appsettings.config - Für Document Server -
/etc/onlyoffice/documentserver/local.json
Beispiel
bash workspace-install.sh -jwt yoursecret