Nieudane usunięcie serwera dokumentów ONLYOFFICE może spowodować pozostawienie plików usług, konfiguracji, katalogów danych, woluminów Dockera lub pakietów zależności menedżera pakietów. Bezpiecznym sposobem na całkowite usunięcie serwera jest zidentyfikowanie sposobu jego instalacji, pozwolenie ONLYOFFICE na zamknięcie aktywnych sesji, usunięcie odpowiedniego pakietu lub kontenera, a następnie sprawdzenie trwałych danych i usług współdzielonych przed usunięciem czegokolwiek innego.
Zacznij od utworzenia kopii zapasowej, jeśli serwer nadal zawiera dokumenty, pliki pamięci podręcznej, których możesz potrzebować, certyfikaty lub niestandardową konfigurację. Odinstalowanie Serwera Dokumentów może zakłócić działanie NextCloud, ownCloud lub innej aplikacji, która się z nim łączy. Ponadto „usuń ONLYOFFICE” nie oznacza automatycznie „usuń PostgreSQL, Nginx, RabbitMQ, Redis lub współdzielone czcionki”: mogą one obsługiwać inne oprogramowanie.
Przed odinstalowaniem zidentyfikuj typ instalacji
Najpierw sprawdź bazę danych pakietów i Snap:
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice
Te polecenia są tylko do odczytu; pusty wynik z jednego menedżera pakietów nie dowodzi braku oprogramowania, jeśli zostało zainstalowane w inny sposób. W przypadku Dockera wyświetl listę kontenerów i obrazów:
docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice
Jeśli na hoście z systemem Linux działa Docker Compose, przed kontynuacją należy zlokalizować projekt Compose i deklaracje jego woluminów. Jeśli aplikacja ONLYOFFICE Docs została zainstalowana z Helm na Kubernetes, zamiast poleceń pakietu Linux należy użyć instrukcji deinstalacji z wykresu.
Jak usunąć instalację DEB lub RPM?
1. Zapisz pracę i odłącz użytkowników w sposób czysty
Aby zainstalować pakiet opisany w poradniku usuwania systemu Linux ONLYOFFICE, przed usunięciem pakietu uruchom skrypt przygotowujący do zamknięcia systemu:
sudo documentserver-prepare4shutdown.sh
Skrypt zamyka aktywne sesje i pomaga zapewnić zapisanie dokumentów. ONLYOFFICE informuje, że może to potrwać do pięciu minut. Zaplanuj ten krok podczas przerwy konserwacyjnej i najpierw powiadom podłączonych użytkowników. Jeśli polecenie nie zostanie znalezione, potwierdź zainstalowany pakiet i zapoznaj się z oficjalną stroną usuwania odpowiedniej edycji, zamiast zastępować ją innym skryptem.
2. Wyczyść pakiet w systemie Ubuntu lub Debian
W przypadku wersji Community Edition oficjalna nazwa pakietu to onlyoffice-documentserver:
sudo apt purge onlyoffice-documentserver
Nazwy pakietów różnią się w zależności od edycji. Oficjalny poradnik usuwania w wersji Developer Edition używa onlyoffice-documentserver-de. Sprawdź dokładną nazwę wyświetlaną przez dpkg -li skorzystaj z pasujących instrukcji dostawcy; nie usuwaj pakietu o podobnej nazwie na podstawie domysłów.
APT purge usuwa pliki binarne i konfigurację pakietu, ale ONLYOFFICE stwierdza, że zależności zainstalowane wraz z pakietem pozostają. Przed potwierdzeniem sprawdź, co proponuje APT. Unikaj apt autoremoveautomatycznego uruchamiania: najpierw przeczytaj listę pakietów i zachowaj wszystko, co jest używane przez inną usługę.
3. Usuń pakiet RPM w systemie CentOS lub kompatybilnych systemach
Strona usuwania wersji Community Edition podaje następującą komendę dla systemu CentOS:
sudo yum remove onlyoffice-documentserver
W systemach wykorzystujących DNF należy użyć nazwy pakietu zgłoszonej przez RPM i przejrzeć proponowaną transakcję przed jej potwierdzeniem:
sudo dnf remove onlyoffice-documentserver
Różnice w edycjach i repozytorium mogą zmienić nazwę pakietu. Oficjalne instrukcje ONLYOFFICE szczegółowo opisują yumpolecenie CentOS; przed usunięciem kompilacji Enterprise lub Developer sprawdź odpowiednią nazwę pakietu dla swojej dystrybucji.
Co zrobić z pozostałymi plikami i zależnościami?
Jeśli usuwanie pakietów zgłosi, że katalogi nie są puste, ONLYOFFICE wyświetla /etc/onlyofficei /var/www/onlyofficejako katalogi, które można usunąć ręcznie. Najpierw je sprawdź i skopiuj wszelkie konfiguracje, certyfikaty lub pliki, które chcesz zachować. Następnie, tylko jeśli serwer jest wycofywany z użytku i katalogi nie zawierają danych innych aplikacji, usuń te ścieżki:
sudo rm -rv /etc/onlyoffice /var/www/onlyoffice
Nie zastępuj tego polecenia docelowego symbolem wieloznacznym, takim jak rm -rf /var/*/onlyoffice*. Sprawdź pozostały stan usługi i pakietu:
systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
Menedżer pakietów może pozostawić zainstalowane pakiety Nginx, PostgreSQL, RabbitMQ, Redis i czcionek, ponieważ są one zależnościami lub wymaganiami wstępnymi. Usuń je dopiero po upewnieniu się, że nie są używane przez inną aplikację. W systemach Debian lub Ubuntu sprawdź zależności odwrotne przed rozważeniem usunięcia pakietu; w systemach opartych na pakietach RPM sprawdź usługi i pakiety, które od nich zależą. Jeśli repozytorium ONLYOFFICE zostało dodane wyłącznie dla tego serwera, możesz oddzielnie usunąć jego wpis w repozytorium i klucz podpisu po sprawdzeniu skonfigurowanych plików. Nie usuwaj współdzielonego repozytorium ani klucza używanego przez inny produkt ONLYOFFICE.
Sprawdź również konfigurację odwrotnego serwera proxy i zapory sieciowej. Przeszukaj pliki witryny Nginx pod kątem nazw hostów ONLYOFFICE lub docelowych serwerów proxy, a następnie edytuj tylko blok serwera dedykowany Serwerowi Dokumentów. Zachowaj niepowiązane hosty wirtualne. Certyfikaty TLS są zarządzane oddzielnie i mogą być nadal potrzebne innym witrynom.
Jak usunąć instalację Dockera?
Najpierw zidentyfikuj dokładny projekt lub kontener Compose. W przypadku instalacji Compose przejdź do katalogu zawierającego odpowiedni plik Compose i zatrzymaj projekt:
docker compose down
Spowoduje to usunięcie kontenerów i sieci projektu, ale nazwane woluminy zostaną zazwyczaj zachowane. Jest to przydatne, gdy konieczna będzie ponowna instalacja lub będą potrzebne zapisane dane. Jeśli zamierzasz trwale usunąć dane, sprawdź plik Compose i listę woluminów przed usunięciem czegokolwiek:
docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'
Oficjalny obraz Dockera ONLYOFFICE zawiera trwałe ścieżki /var/log/onlyoffice, w tym /var/www/onlyoffice/Data, i /var/lib/onlyoffice; dane PostgreSQL mogą być również przechowywane osobno. Konfiguracje Compose mogą mapować te ścieżki na nazwane woluminy lub katalogi hosta. Utwórz kopię zapasową wszystkich potrzebnych certyfikatów lub danych. Usuń tylko woluminy i katalogi montowane w systemie bind, które zostały zidentyfikowane jako należące wyłącznie do tego wdrożenia serwera dokumentów.
Po przeglądzie projekt Compose może usunąć zadeklarowane nazwane woluminy za pomocą:
docker compose down --volumes
Użyj tego tylko wtedy, gdy zamierzasz usunąć trwałe dane tego projektu. Nie uruchamiaj go docker volume prunejako skrótu; może on usunąć niepowiązane, nieużywane woluminy. W przypadku kontenera uruchomionego za pomocą docker run, zatrzymaj go i usuń, a następnie osobno sprawdź jego montowania i usuń tylko ścieżki danych lub woluminy, które chcesz usunąć:
docker stop <container_name>
docker rm <container_name>
Na koniec usuń obraz ONLYOFFICE tylko wtedy, gdy żaden z pozostałych kontenerów go nie potrzebuje. Użyj dokładnego obrazu i tagu podanego przez docker image ls:
docker image rm onlyoffice/documentserver:<tag>
Oficjalne repozytorium Dockera wyjaśnia ścieżki danych obrazu i wykorzystanie woluminu. Rzeczywiste montowania działającego kontenera mogą różnić się od domyślnych, dlatego należy ufać docker inspectplikowi Compose, a nie założeniom.
Jak odinstalować pakiet Snap?
Jeśli snap listwyświetla się plik ONLYOFFICE Docs, oficjalne repozytorium dokumentów Snap, usuwanie dokumentów odbywa się za pomocą:
sudo snap remove onlyoffice-ds
Następnie sprawdź snap listponownie. Usuwanie snapów i usuwanie zachowanych snapów lub danych użytkownika to odrębne operacje. Przejrzyj zapisane snapy snap savedi usuń tylko migawkę ONLYOFFICE, którą zamierzasz usunąć. Nie usuwaj współdzielonych danych snapów ani snapów bez powodu.
Ostatnie kontrole po odinstalowaniu
- Sprawdź, czy pakiet, Snap lub kontener, na który wskazałeś, nie jest już zainstalowany lub uruchomiony.
- Sprawdź, czy stary adres URL serwera dokumentów nie odpowiada już z zaufanej sieci lub z samego hosta.
- Sprawdź, czy każda podłączona aplikacja została skierowana do zastępczego serwera dokumentów lub czy jej łącznik został wyłączony.
- Sprawdź ustawienia Nginx, zapory sieciowej, DNS i TLS pod kątem wpisów specyficznych dla ONLYOFFICE, usuwając tylko te, które nie są już używane.
- Sprawdź wykorzystanie dysku i listę pozostałych zależności menedżera pakietów. Zachowaj współdzielone bazy danych, serwery proxy, brokery komunikatów i czcionki, jeśli inna usługa ich potrzebuje.
Jeśli usunięcie pakietu się nie powiedzie, przed próbą wymuszenia opcji należy przeczytać cały błąd i sprawdzić stan pakietu. Uszkodzony skrypt konserwatora lub przerwana aktualizacja mogą wymagać naprawy specyficznej dla danego systemu operacyjnego i wersji pakietu; wymuszenie usunięcia bez diagnostyki może spowodować niespójność stanu menedżera pakietów. Standardowa procedura usuwania jest zalecana, o ile działa.
Oficjalne referencje