Installieren von ONLYOFFICE Docs Enterprise Edition für CentOS und Derivate

Einleitung

Mit der Enterprise Edition können Sie ONLYOFFICE Docs auf Ihrem lokalen Server installieren und die Online-Editoren in die ONLYOFFICE-Kollaborationsplattform oder andere beliebte Systeme integrieren (siehe die detaillierte Liste der Funktionen). Diese Anleitung zeigt Ihnen, wie Sie die Linux-Version von ONLYOFFICE Docs Enterprise Edition auf Ihrem Computer installieren.

Systemanforderungen
  • CPU: Dual-Core 2 GHz oder besser
  • RAM: mindestens 2 GB, hängt aber vom Host-Betriebssystem ab. Mehr ist besser
  • HDD: mindestens 40 GB freier Speicherplatz
  • SWAP: mindestens 4 GB, hängt aber vom Host-Betriebssystem ab. Mehr ist besser
  • OS: CentOS Stream 9, RHEL 8 oder RHEL 9
  • Zusätzliche Anforderungen:
    • PostgreSQL: Version 12.9 oder höher
    • NGINX: Version 1.3.13 oder höher
    • Redis: Version 5 oder höher
    • RabbitMQ

Installieren von Abhängigkeiten

Installieren der aktuellen NGINX-Paketversion

Um das yum-Repository für RHEL/CentOS einzurichten, erstellen Sie die Datei /etc/yum.repos.d/nginx.repo mit folgendem Inhalt:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Offizielle Anleitung

NGINX installieren:

sudo yum install nginx

Bearbeiten Sie anschließend die NGINX-Konfigurationsdatei /etc/nginx/nginx.conf, sodass sie folgendermaßen aussieht:

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
worker_connections  1024;
}
http {
include             /etc/nginx/mime.types;
default_type        application/octet-stream;
log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log          /var/log/nginx/access.log  main;
sendfile            on;
#tcp_nopush         on;
keepalive_timeout   65;
#gzip               on;
include             /etc/nginx/conf.d/*.conf;
}
Wichtig Wenn Sie ONLYOFFICE Docs auf Port 80 ausführen möchten, deaktivieren Sie jetzt die Standard-Website von NGINX. Andernfalls funktioniert ONLYOFFICE Docs möglicherweise nicht richtig. Führen Sie dazu die folgenden Befehle aus:
sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Je nachdem, wie NGINX installiert wurde, meldet einer der ersten beiden Befehle möglicherweise, dass die Datei nicht existiert. Diese Meldung können Sie ignorieren.

EPEL-Repository installieren
sudo yum install epel-release

Um EPEL auf CentOS 9 zu installieren, verwenden Sie die folgenden Befehle:

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

Um EPEL auf RHEL zu installieren, verwenden Sie die folgenden Befehle:

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

Ersetzen Sie $REV manuell durch die Version Ihres Betriebssystems (7 für Version 7.x, 8 für Version 8.x, 9 für Version 9.x usw.).

Installieren und Konfigurieren von PostgreSQL

Installieren Sie die PostgreSQL-Version, die in Ihrer CentOS-Version enthalten ist:

sudo yum install postgresql postgresql-server
Wenn Sie eine andere PostgreSQL-Version aus dem PostgreSQL-Repository installieren möchten, finden Sie weitere Einzelheiten in der offiziellen PostgreSQL-Dokumentation.

Initialisieren Sie die PostgreSQL-Datenbank

sudo service postgresql initdb 
sudo chkconfig postgresql on

Unter CentOS 9 ist chkconfig nicht standardmäßig installiert. Installieren Sie es mit dem folgenden Befehl:

sudo yum install chkconfig

Aktivieren Sie die Authentifizierungsmethode „scram-sha-256“ für IPv4- und IPv6-Localhost

Öffnen Sie die Datei /var/lib/pgsql/data/pg_hba.conf in einem Texteditor.

Suchen Sie die Zeichenfolge host all all 127.0.0.1/32 ident und ersetzen Sie sie durch die folgende:

host    all             all             127.0.0.1/32            scram-sha-256

Suchen Sie dann die Zeichenfolge host all all ::1/128 ident und ersetzen Sie sie durch die folgende:

host    all             all             ::1/128                 scram-sha-256

Speichern Sie die Änderungen.

Öffnen Sie die Datei /var/lib/pgsql/data/postgresql.conf in einem Texteditor.

Suchen Sie nach 'password_encryption', entfernen Sie das Kommentarzeichen und ersetzen Sie den Wert durch 'scram-sha-256':

password_encryption = 'scram-sha-256'

Speichern Sie die Änderungen.

Starten Sie den PostgreSQL-Dienst neu:

sudo service postgresql restart

Erstellen Sie die PostgreSQL-Datenbank und den Benutzer:

Sie können einen beliebigen Benutzernamen und ein beliebiges Passwort angeben.

Führen Sie zuerst den folgenden Befehl aus:

cd /tmp

So vermeiden Sie die Warnung could not change directory to "/root", wenn Sie die Befehle als root ausführen. Erstellen Sie anschließend die Datenbank und den Benutzer:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"
Redis installieren

Führen Sie den folgenden Befehl aus:

sudo yum -y install redis

Starten Sie den Redis-Dienst und aktivieren Sie den automatischen Start beim Hochfahren:

sudo systemctl enable --now redis
RabbitMQ installieren
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.rpm.sh | os=centos dist=$REV sudo bash
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/erlang/script.rpm.sh | os=centos dist=$REV sudo bash

Ersetzen Sie $REV manuell durch die Version Ihres Betriebssystems (7 für Version 7.x, 8 für Version 8.x, 9 für Version 9.x usw.).

sudo yum install rabbitmq-server

Alternativ können Sie RabbitMQ auf CentOS 8 oder CentOS 9 über die offizielle Website installieren.

Starten Sie den RabbitMQ-Dienst und aktivieren Sie den automatischen Start beim Hochfahren:

sudo systemctl enable --now rabbitmq-server
Hinzufügen des ONLYOFFICE Docs-Repositorys

Fügen Sie das yum-Repository von ONLYOFFICE Docs mit dem folgenden Befehl hinzu:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm
mscorefonts installieren

Installieren Sie die Pakete cabextract und xorg-x11-font-utils:

sudo yum install cabextract xorg-x11-font-utils

Für CentOS 7.8(2003) ist zusätzlich fontconfig erforderlich:

sudo yum install fontconfig

Installieren Sie das msttcore-Schriftenpaket:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

ONLYOFFICE Docs installieren

Führen Sie den folgenden Befehl aus:

sudo yum install onlyoffice-documentserver-ee

Starten Sie den NGINX-Dienst und aktivieren Sie den automatischen Start beim Hochfahren:

sudo service nginx start
sudo systemctl enable nginx

Anschließend wird ONLYOFFICE Docs als Prozess ausgeführt. Das Paket wird wie jedes andere RPM-Paket aktualisiert.

ONLYOFFICE Docs aktualisieren

Um ONLYOFFICE Docs zu aktualisieren, führen Sie den folgenden Befehl aus:

sudo yum update onlyoffice-documentserver-ee
Wichtig Auf RHEL 8 und davon abgeleiteten Distributionen kann yum update bei aktiviertem ONLYOFFICE-Repository mit einem Abhängigkeitsfehler fehlschlagen.

Um dies zu verhindern, schließen Sie diese Pakete aus dem ONLYOFFICE-Repository aus, sodass sie stattdessen aus dem AppStream-Repository des Systems bezogen werden:

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Dieser Befehl muss nur einmal ausgeführt werden. Danach funktioniert yum update wie erwartet.

Wenn Sie ONLYOFFICE Docs über OneClick Install installiert haben, wird dieser Ausschluss bereits automatisch angewendet.

Ändern des standardmäßigen ONLYOFFICE Docs-Ports

Standardmäßig nimmt ONLYOFFICE Docs eingehende Verbindungen über Port 8083 entgegen. Ab Version 4.3 können Sie einen anderen Port für ONLYOFFICE Docs festlegen, wenn Sie ihn anstelle des Standardports verwenden möchten.

Wenn Sie den Standardport ändern, stellen Sie sicher, dass er für eingehende/ausgehende Verbindungen geöffnet ist. Sehen Sie sich die vollständige Liste der von ONLYOFFICE Docs verwendeten Ports an.

Dazu müssen Sie die Umgebungsvariable DS_PORT mit folgendem Befehl bearbeiten:

export DS_PORT=<PORT_NUMBER>

Ersetzen Sie im obigen Befehl <PORT_NUMBER> durch die gewünschte Portnummer.

Wenn Sie den Port auf 80 setzen, stellen Sie sicher, dass Sie die Standard-Website von NGINX deaktiviert haben, wie im Abschnitt Installieren der aktuellen NGINX-Paketversion beschrieben.
Warnung Wenn Sie das Protokoll von ONLYOFFICE Docs auf HTTPS umstellen möchten, ändern Sie den Port nicht auf 443, sondern verwenden Sie stattdessen diese Anleitung.

Danach können Sie mit der Konfiguration von ONLYOFFICE Docs fortfahren.

ONLYOFFICE Docs konfigurieren

Konfigurationsskript ausführen
Hinweis Standardmäßig wird PostgreSQL als Datenbank verwendet. Wenn Sie MySQL anstelle von PostgreSQL verwenden möchten, fügen Sie vor dem Ausführen des Skripts documentserver-configure zwei Umgebungsvariablen hinzu, um Datenbanktyp und Port festzulegen:
export DB_TYPE=mysql
export DB_PORT=3306

Nachdem Sie diese beiden Variablen hinzugefügt haben, können Sie die Datenbank mithilfe des Skripts wechseln.

Führen Sie das Skript documentserver-configure aus:

bash documentserver-configure

Sie werden aufgefordert, die Verbindungsparameter für PostgreSQL, Redis und RabbitMQ anzugeben. Verwenden Sie die folgenden Daten:

Für PostgreSQL:

  • Host: localhost
  • Datenbank: onlyoffice
  • Benutzer: onlyoffice
  • Passwort: onlyoffice

Für Redis:

  • Host: localhost

Für RabbitMQ:

  • Host: localhost
  • Benutzer: guest
  • Passwort: guest
Firewall-Ausnahme hinzufügen
sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload
SELinux deaktivieren veraltet seit v.5.0

Öffnen Sie die Datei /etc/selinux/config mit einem beliebigen Texteditor, ersetzen Sie die Zeichenfolge SELINUX=enforcing oder SELINUX=permissive durch SELINUX=disabled und speichern Sie die Änderungen.

Starten Sie Ihren Server neu, damit die Änderungen wirksam werden.

Hinweis Aus Sicherheitsgründen werden ab Version 8.1 beim Ausführen des Skripts documentserver-configure neue WOPI-Schlüssel in local.json generiert. Wenn Sie eine WOPI-Verbindung verwenden, müssen Sie das Skript nach der Aktualisierung von ONLYOFFICE Docs ausführen:
documentserver-configure --wopienabled true

Starten von ONLYOFFICE Docs in einem Browser

Sobald die Konfiguration abgeschlossen ist, können Sie http://localhost:8083 in die Adressleiste Ihres Browsers eingeben, um die Willkommensseite von ONLYOFFICE Docs zu öffnen. Dort finden Sie weitere Anweisungen, wie Sie Dokumentbeispiele aktivieren oder die Online-Editoren mithilfe der bereitgestellten API in Ihre Webanwendung integrieren.

Registrieren Ihrer Enterprise Edition-Version

Wenn Sie die Enterprise Edition gekauft und die Datei license.lic erhalten haben, können Sie sie zu Ihrer Installation hinzufügen, um die Vollversion der Software zu erhalten.

Wenn Sie eine Red Hat-basierte Linux-Distribution verwenden, legen Sie die Datei license.lic im folgenden Ordner ab:

/var/www/onlyoffice/Data/license.lic

Danach ist Ihre Version der Enterprise Edition registriert und verfügt über den vollen Funktionsumfang.

Artikel zum Thema:
Alle Schlagwörter