Bei einer fehlgeschlagenen Deinstallation des ONLYOFFICE Document Servers können Dienstdateien, Konfigurationen, Datenverzeichnisse, Docker-Volumes oder Abhängigkeiten des Paketmanagers zurückbleiben. Um den Server sicher und vollständig zu entfernen, sollten Sie zunächst die Installationsmethode ermitteln, ONLYOFFICE die aktiven Sitzungen schließen lassen, das entsprechende Paket oder den Container entfernen und anschließend die persistenten Daten und gemeinsam genutzten Dienste überprüfen, bevor Sie weitere Dateien löschen.
Erstellen Sie zunächst ein Backup, falls sich auf dem Server noch Dokumente, benötigte Cache-Dateien, Zertifikate oder benutzerdefinierte Konfigurationen befinden. Die Deinstallation des Dokumentenservers kann Nextcloud, ownCloud oder andere damit verbundene Anwendungen beeinträchtigen. Außerdem bedeutet „ONLYOFFICE entfernen“ nicht automatisch „PostgreSQL, Nginx, RabbitMQ, Redis oder gemeinsam genutzte Schriftarten entfernen“: Diese werden möglicherweise von anderer Software verwendet.
Vor der Deinstallation den Installationstyp ermitteln.
Überprüfen Sie zuerst die Paketdatenbank und Snap:
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice
Diese Befehle sind schreibgeschützt; ein leeres Ergebnis eines Paketmanagers beweist nicht, dass die Software fehlt, wenn sie auf anderem Wege installiert wurde. Für Docker: Container und Images auflisten:
docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice
Wenn auf dem Linux-Host Docker Compose ausgeführt wird, suchen Sie vor dem Fortfahren das Compose-Projekt und dessen Volume-Deklarationen. Falls ONLYOFFICE Docs mit Helm auf Kubernetes installiert wurde, verwenden Sie die Deinstallationsanweisungen des Charts anstelle der Befehle des Linux-Pakets.
Wie entfernt man eine DEB- oder RPM-Installation?
1. Arbeit speichern und Benutzer sauber trennen
Bei der Paketinstallation, die in der Linux-Deinstallationsanleitung von ONLYOFFICE beschrieben ist, muss vor der Deinstallation des Pakets das zugehörige Skript zur Vorbereitung des Herunterfahrens ausgeführt werden:
sudo documentserver-prepare4shutdown.sh
Das Skript schließt aktive Sitzungen und stellt sicher, dass Dokumente gespeichert werden. Laut ONLYOFFICE kann dies bis zu fünf Minuten dauern. Planen Sie diesen Schritt während eines Wartungsfensters und benachrichtigen Sie die verbundenen Benutzer vorher. Falls der Befehl nicht gefunden wird, überprüfen Sie das installierte Paket und konsultieren Sie die offizielle Deinstallationsseite der entsprechenden Edition, anstatt ein anderes Skript zu verwenden.
2. Entfernen Sie das Paket unter Ubuntu oder Debian.
Für die Community Edition lautet der offizielle Paketname onlyoffice-documentserver:
sudo apt purge onlyoffice-documentserver
Die Paketnamen variieren je nach Edition. Die offizielle Anleitung zur Deinstallation der Developer Edition verwendet den Namen des Pakets onlyoffice-documentserver-de. Überprüfen Sie den exakten Namen, der von der dpkg -lAnleitung angezeigt wird, und befolgen Sie die entsprechenden Anweisungen des Herstellers. Entfernen Sie kein Paket mit ähnlichem Namen auf gut Glück.
Der Befehl `apt purge` entfernt zwar die Paketdateien und die Paketkonfiguration, aber laut ONLYOFFICE bleiben die mit dem Paket installierten Abhängigkeiten erhalten. Überprüfen Sie daher die von APT vorgeschlagenen Schritte, bevor Sie die Ausführung bestätigen. Vermeiden Sie die apt autoremoveautomatische Ausführung: Lesen Sie vorher die Paketliste und behalten Sie alle Pakete bei, die von anderen Diensten verwendet werden.
3. Entfernen Sie das RPM-Paket auf CentOS oder kompatiblen Systemen.
Auf der Seite zur Deinstallation der Community Edition wird folgender Befehl für CentOS angegeben:
sudo yum remove onlyoffice-documentserver
Bei Systemen, die DNF verwenden, verwenden Sie den von RPM gemeldeten Paketnamen und überprüfen Sie die vorgeschlagene Transaktion, bevor Sie sie bestätigen:
sudo dnf remove onlyoffice-documentserver
Editions- und Repository-Unterschiede können den Paketnamen ändern. Die offizielle Anleitung von ONLYOFFICE beschreibt den CentOS yum-Befehl detailliert; überprüfen Sie den entsprechenden Paketnamen für Ihre Distribution, bevor Sie eine Enterprise- oder Developer-Version entfernen.
Was sollten Sie mit den verbleibenden Dateien und Abhängigkeiten tun?
Wenn die Paketdeinstallation meldet, dass Verzeichnisse nicht leer sind, listet ONLYOFFICE /etc/onlyofficediese /var/www/onlyofficeVerzeichnisse auf, die manuell entfernt werden können. Überprüfen Sie diese Verzeichnisse zunächst und kopieren Sie alle Konfigurationen, Zertifikate oder Dateien, die Sie behalten möchten. Entfernen Sie anschließend nur dann die entsprechenden Pfade, wenn der Server außer Betrieb genommen wird und die Verzeichnisse keine Daten anderer Anwendungen enthalten.
sudo rm -rv /etc/onlyoffice /var/www/onlyoffice
Ersetzen Sie diesen Befehl nicht durch einen Platzhalter wie z. B. rm -rf /var/*/onlyoffice*. Überprüfen Sie den verbleibenden Dienst- und Paketstatus:
systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
Der Paketmanager lässt möglicherweise Nginx, PostgreSQL, RabbitMQ, Redis und Schriftartenpakete installiert, da diese Abhängigkeiten oder Voraussetzungen darstellen. Entfernen Sie sie erst, nachdem Sie sichergestellt haben, dass sie nicht von einer anderen Anwendung verwendet werden. Unter Debian oder Ubuntu sollten Sie die umgekehrten Abhängigkeiten prüfen, bevor Sie ein Paket entfernen. Auf RPM-basierten Systemen prüfen Sie die Dienste und Pakete, die von diesen Paketen abhängen. Wenn das ONLYOFFICE-Repository ausschließlich für diesen Server hinzugefügt wurde, können Sie den zugehörigen Repository-Eintrag und den Signaturschlüssel separat entfernen, nachdem Sie die konfigurierten Dateien geprüft haben. Entfernen Sie kein gemeinsam genutztes Repository oder keinen gemeinsam genutzten Schlüssel, der von einem anderen ONLYOFFICE-Produkt verwendet wird.
Überprüfen Sie außerdem Ihre Reverse-Proxy- und Firewall-Konfiguration. Suchen Sie in den Nginx-Site-Dateien nach Hostnamen oder Proxy-Zielen, die ONLYOFFICE enthalten, und bearbeiten Sie anschließend nur den Serverblock, der dem Dokumentenserver zugeordnet ist. Nicht zugehörige virtuelle Hosts bleiben erhalten. TLS-Zertifikate werden separat verwaltet und werden möglicherweise weiterhin von anderen Websites benötigt.
Wie entfernt man eine Docker-Installation?
Zuerst identifizieren Sie das genaue Compose-Projekt oder den Container. Wechseln Sie bei einer Compose-Installation in das Verzeichnis, das die entsprechende Compose-Datei enthält, und stoppen Sie das Projekt:
docker compose down
Dadurch werden die Container und das Netzwerk des Projekts entfernt, benannte Volumes bleiben jedoch normalerweise erhalten. Dies ist nützlich, wenn Sie das Projekt neu installieren oder die gespeicherten Daten benötigen. Wenn Sie die Daten endgültig löschen möchten, überprüfen Sie die Compose-Datei und listen Sie die Volumes auf, bevor Sie etwas entfernen.
docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'
Das offizielle ONLYOFFICE Docker-Image dokumentiert persistente Pfade, einschließlich `<file>` /var/log/onlyoffice, /var/www/onlyoffice/Data`<file>` und /var/lib/onlyoffice`<file>`. PostgreSQL-Daten können auch separat gespeichert werden. Compose-Setups können diese Pfade benannten Volumes oder Hostverzeichnissen zuordnen. Sichern Sie alle benötigten Zertifikate und Daten. Entfernen Sie nur Volumes und eingebundene Verzeichnisse, die Sie eindeutig als ausschließlich zu dieser Document-Server-Bereitstellung gehörig identifiziert haben.
Nach der Überprüfung kann ein Compose-Projekt seine deklarierten benannten Volumes mit folgendem Befehl entfernen:
docker compose down --volumes
Verwenden Sie diese Option nur, wenn Sie die persistenten Daten des Projekts löschen möchten. Führen Sie sie nicht docker volume pruneals Verknüpfung aus, da dadurch auch nicht verwendete Volumes gelöscht werden können. Bei einem mit gestarteten Container docker runmüssen Sie den entsprechenden Container stoppen und entfernen. Überprüfen Sie anschließend separat dessen Mounts und entfernen Sie nur die Datenpfade oder Volumes, die Sie zum Löschen ausgewählt haben.
docker stop <container_name>
docker rm <container_name>
Entfernen Sie das ONLYOFFICE-Image nur dann, wenn kein verbleibender Container es mehr benötigt. Verwenden Sie das exakt von folgendem Befehl gemeldete Image und Tag docker image ls:
docker image rm onlyoffice/documentserver:<tag>
Das offizielle Docker-Repository erläutert die Datenpfade und die Volume-Nutzung des Images. Die tatsächlichen Mounts eines laufenden Containers können von den Standardeinstellungen abweichen. Vertrauen Sie daher docker inspecteher Ihrer Compose-Datei als Annahmen.
Wie deinstalliert man das Snap-Paket?
Wenn snap listder ONLYOFFICE Docs-Snap angezeigt wird, werden die offiziellen Snap-Repository-Dokumente zur Entfernung mit Folgendem angezeigt:
sudo snap remove onlyoffice-ds
Prüfen Sie anschließend snap listerneut. Das Entfernen von Snapshots und das Löschen gespeicherter Snapshots oder Benutzerdaten sind unterschiedliche Vorgänge. Überprüfen Sie gespeicherte Snapshots snap savedund entfernen Sie nur solche, die Sie löschen möchten. Löschen Sie freigegebene Snapshot-Daten oder Snapshots nicht wahllos.
Abschließende Überprüfungen nach der Deinstallation
- Vergewissern Sie sich, dass das von Ihnen angegebene Paket, der Snap oder der Container nicht mehr installiert ist oder ausgeführt wird.
- Prüfen Sie, ob die alte Dokumentenserver-URL weder von einem vertrauenswürdigen Netzwerk noch vom Host selbst aus erreichbar ist.
- Überprüfen Sie, ob alle verbundenen Anwendungen auf einen Ersatz-Dokumentenserver umgeleitet wurden oder ob deren Konnektor deaktiviert wurde.
- Überprüfen Sie die Nginx-, Firewall-, DNS- und TLS-Einstellungen auf ONLYOFFICE-spezifische Einträge und entfernen Sie nur diejenigen, die nicht mehr verwendet werden.
- Überprüfen Sie die Festplattennutzung und die verbleibende Abhängigkeitsliste des Paketmanagers. Behalten Sie gemeinsam genutzte Datenbanken, Proxys, Message Broker und Schriftarten bei, falls diese von anderen Diensten benötigt werden.
Schlägt die Paketentfernung fehl, lesen Sie die vollständige Fehlermeldung und überprüfen Sie den Paketstatus, bevor Sie erzwungene Deinstallationsoptionen anwenden. Ein fehlerhaftes Wartungsskript oder ein unterbrochenes Upgrade können eine Reparatur erfordern, die speziell auf das jeweilige Betriebssystem und die Paketversion zugeschnitten ist. Eine erzwungene Deinstallation ohne vorherige Diagnose kann zu inkonsistenten Paketmanager-Status führen. Die Standarddeinstallationsprozedur ist daher vorzuziehen, sofern sie funktioniert.
Offizielle Referenzen