Fehlerbehebung unter Windows. ONLYOFFICE Docs
Bevor Sie den Support kontaktieren: Sammeln von Diagnoseinformationen
Wenn Sie ein Problem haben, das unten nicht behandelt wird, sammeln Sie bitte die folgenden Informationen, bevor Sie den ONLYOFFICE-Support kontaktieren:
Windows:
- Protokollverzeichnis:
%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\ - Installierte Version: Prüfen Sie sie unter „Programme und Features“ in der Systemsteuerung
Probleme bei der Nutzung
F: Beim Stoppen von ONLYOFFICE Docs ist ein Datenverlust aufgetreten. Wie kann ich Datenverlust verhindern?
A: Aufgrund der Betriebsweise speichert ONLYOFFICE Docs ein Dokument erst, nachdem es von allen Benutzern, die es bearbeitet haben, geschlossen wurde. Um Datenverlust zu vermeiden, müssen Sie die ONLYOFFICE Docs-Benutzer zwangsweise trennen, wenn Sie ONLYOFFICE Docs stoppen müssen, z. B. bei einem Anwendungsupdate, Serverneustart usw. Führen Sie dazu folgendes Skript auf dem Server aus, auf dem ONLYOFFICE Docs installiert ist:
%ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-prepare4shutdown.bat
Die Ausführung des Skripts kann lange dauern (bis zu 5 Minuten).
F: Die ONLYOFFICE Docs-Dienste starten nicht. Was soll ich tun?
A: Öffnen Sie die Dienste-Konsole (services.msc) und überprüfen Sie den Status von ds-docservice und ds-converter. Wenn einer der Dienste gestoppt ist, versuchen Sie, ihn manuell zu starten. Häufige Ursachen sind:
-
Unzureichender Arbeitsspeicher (mindestens 4 GB RAM werden empfohlen).
-
Port 80 wird bereits von einer anderen Anwendung verwendet. Stoppen Sie entweder die andere Anwendung oder installieren Sie ONLYOFFICE Docs mit einem anderen Port neu:
onlyoffice-documentserver.exe /DS_PORT=<PORT_NUMBER> -
Prüfen Sie die Protokolle unter
%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\auf spezifischere Fehlermeldungen.
F: JWT-Authentifizierung schlägt nach der Integration von ONLYOFFICE Docs in meine Plattform fehl. Wie behebe ich das?
A: Stellen Sie sicher, dass das in ONLYOFFICE Docs konfigurierte JWT-Geheimnis exakt mit dem in den Connector-Einstellungen Ihrer Plattform konfigurierten Geheimnis übereinstimmt. Prüfen Sie auch, ob der JWT-Header-Name übereinstimmt (Standard ist "Authorization"). Um Ihr aktuelles Geheimnis zu prüfen, öffnen Sie die folgende Datei in einem Texteditor:
%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
Suchen Sie nach dem Wert unter services.CoAuthoring.secret.session.string. Häufige Fehler:
- Führende oder nachgestellte Leerzeichen im Geheimniswert.
- Verwendung des standardmäßigen zufälligen Geheimnisses anstelle eines benutzerdefinierten.
F: Die Dokumentenkonvertierung schlägt fehl (z. B. wird beim Öffnen von DOC-, XLS- oder PPT-Dateien ein Fehler angezeigt). Was kann ich tun?
A: Prüfen Sie das Konverter-Protokoll auf Fehler:
%ProgramFiles%\ONLYOFFICE\DocumentServer\Log\
Häufige Ursachen sind unzureichender Speicherplatz und fehlende Schriftarten.
F: ONLYOFFICE Docs verbraucht viel Arbeitsspeicher. Ist das normal?
A: Der Arbeitsspeicherverbrauch skaliert mit der Anzahl der geöffneten Dokumente und gleichzeitigen Benutzer. Für einen Server mit einigen Dutzend aktiven Benutzern sind 2–4 GB RAM normal. Wenn der Speicherverbrauch unerwartet hoch ist, prüfen Sie, ob sich festhängende oder vergessene Dokumente in folgendem Verzeichnis befinden:
%ProgramData%\ONLYOFFICE\DocumentServer\App_Data\cache\files\forgotten\
Probleme mit der Enterprise und Developer Edition
F: Ich sehe eine Warnung "Lizenz abgelaufen". Was soll ich tun?
A: Ihre license.lic-Datei ist abgelaufen. Kontaktieren Sie sales@onlyoffice.com, um Ihre Lizenz zu erneuern. Nachdem Sie die neue Datei erhalten haben, ersetzen Sie die alte license.lic-Datei im Datenverzeichnis und starten Sie ONLYOFFICE Docs neu.
F: Ich kann nicht auf das Admin-Panel zugreifen. Was soll ich tun?
A: Wenn Sie das Admin-Panel noch nicht eingerichtet haben, folgen Sie der Anleitung zur Einrichtung des Admin-Panels. Wenn Sie Ihr Admin-Passwort vergessen haben, löschen Sie den Eintrag passwordHash aus der Datei runtime.json und starten Sie neu – ein neuer Bootstrap-Code wird generiert.