Un tentativo di rimozione non riuscito di ONLYOFFICE Document Server può lasciare sul sistema i file di servizio, la configurazione, le directory dei dati, i volumi Docker o i pacchetti di dipendenza del gestore di pacchetti. Il modo più sicuro per rimuoverlo completamente è identificare come è stato installato, lasciare che ONLYOFFICE chiuda le sessioni attive, rimuovere il pacchetto o il container corrispondente e quindi esaminare i dati persistenti e i servizi condivisi prima di eliminare qualsiasi altra cosa.
Se il server contiene ancora documenti, file di cache necessari, certificati o configurazioni personalizzate, è consigliabile eseguire prima un backup. La disinstallazione di Document Server può compromettere il funzionamento di Nextcloud, ownCloud o di altre applicazioni connesse ad esso. Inoltre, "rimuovere ONLYOFFICE" non significa automaticamente "rimuovere PostgreSQL, Nginx, RabbitMQ, Redis o font condivisi": questi potrebbero essere utilizzati da altri software.
Prima di disinstallare, identificare il tipo di installazione
Controlla prima il database dei pacchetti e Snap:
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice
Questi comandi sono di sola lettura; un risultato vuoto da un gestore di pacchetti non dimostra l'assenza del software se è stato installato in un altro modo. Per Docker, elenca i container e le immagini:
docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice
Se l'host Linux esegue Docker Compose, individuare il progetto Compose e le relative dichiarazioni di volume prima di procedere. Se ONLYOFFICE Docs è stato installato con Helm su Kubernetes, utilizzare le istruzioni di disinstallazione del chart anziché i comandi del pacchetto Linux.
Come si rimuove un'installazione DEB o RPM?
1. Salva il lavoro e disconnetti gli utenti in modo pulito
Per l'installazione del pacchetto descritta nella guida di rimozione per Linux di ONLYOFFICE, eseguire lo script di preparazione allo spegnimento prima di rimuovere il pacchetto:
sudo documentserver-prepare4shutdown.sh
Lo script chiude le sessioni attive e contribuisce a garantire il salvataggio dei documenti. ONLYOFFICE afferma che l'operazione potrebbe richiedere fino a cinque minuti. Pianifica questa operazione durante una finestra di manutenzione e avvisa prima gli utenti connessi. Se il comando non viene trovato, verifica il pacchetto installato e consulta la pagina di rimozione ufficiale dell'edizione corrispondente, anziché sostituirlo con uno script non correlato.
2. Disinstallare completamente il pacchetto su Ubuntu o Debian
Per la Community Edition, il nome ufficiale del pacchetto è onlyoffice-documentserver:
sudo apt purge onlyoffice-documentserver
I nomi dei pacchetti variano a seconda dell'edizione. La guida ufficiale per la rimozione della Developer Edition utilizza onlyoffice-documentserver-de. Verifica il nome esatto mostrato da dpkg -le segui le istruzioni del fornitore corrispondenti; non rimuovere un pacchetto con un nome simile basandoti su supposizioni.
Il comando `apt purge` rimuove i file binari e la configurazione del pacchetto, ma ONLYOFFICE specifica che le dipendenze installate con il pacchetto rimangono. Prima di confermare, esamina attentamente le proposte di APT. Evita di eseguire l'operazione apt autoremoveautomaticamente: leggi prima l'elenco dei pacchetti e mantieni tutto ciò che è utilizzato da altri servizi.
3. Rimuovere il pacchetto RPM su CentOS o sistemi compatibili
La pagina di rimozione della Community Edition fornisce questo comando per CentOS:
sudo yum remove onlyoffice-documentserver
Sui sistemi che utilizzano DNF, utilizzare il nome del pacchetto riportato da RPM e rivedere la transazione proposta prima di confermarla:
sudo dnf remove onlyoffice-documentserver
Le differenze di edizione e di repository possono modificare il nome del pacchetto. Le istruzioni ufficiali di ONLYOFFICE documentano specificamente il yumcomando per CentOS; verificare il nome del pacchetto equivalente per la propria distribuzione prima di rimuovere una build Enterprise o Developer.
Cosa fare con i file e le dipendenze rimanenti?
Se la rimozione del pacchetto segnala che le directory non sono vuote, ONLYOFFICE le elenca /etc/onlyofficecome /var/www/onlyofficedirectory che possono essere rimosse manualmente. Prima di tutto, esaminale e copia eventuali configurazioni, certificati o file che desideri conservare. Quindi, solo se il server viene dismesso e le directory non contengono dati di altre applicazioni, rimuovi esattamente quei percorsi:
sudo rm -rv /etc/onlyoffice /var/www/onlyoffice
Non sostituire questo comando mirato con un carattere jolly come rm -rf /var/*/onlyoffice*. Verifica lo stato rimanente del servizio e del pacchetto:
systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
Il gestore di pacchetti potrebbe lasciare installati i pacchetti Nginx, PostgreSQL, RabbitMQ, Redis e i font perché sono dipendenze o prerequisiti. Rimuovili solo dopo aver verificato che non siano utilizzati da altre applicazioni. Su Debian o Ubuntu, controlla le dipendenze inverse prima di considerare la rimozione di un pacchetto; sui sistemi basati su RPM, controlla i servizi e i pacchetti che dipendono da essi. Se il repository ONLYOFFICE è stato aggiunto esclusivamente per questo server, puoi rimuovere separatamente la relativa voce del repository e la chiave di firma dopo aver controllato i file di configurazione. Non rimuovere un repository o una chiave condivisa utilizzata da un altro prodotto ONLYOFFICE.
Verifica anche la configurazione del reverse proxy e del firewall. Cerca nei file di configurazione del sito Nginx i nomi host o le destinazioni proxy ONLYOFFICE, quindi modifica solo il blocco server dedicato al Document Server. Mantieni gli host virtuali non correlati. I certificati TLS sono gestiti separatamente e potrebbero essere ancora necessari ad altri siti.
Come si rimuove un'installazione Docker?
Innanzitutto, identifica il progetto o il container Compose esatto. Nel caso di un'installazione di Compose, spostati nella directory contenente il file Compose pertinente e arresta il progetto:
docker compose down
Questa operazione rimuove i container e la rete del progetto, ma i volumi denominati vengono normalmente mantenuti. Ciò è utile nel caso in cui si desideri reinstallare il progetto o recuperare i dati memorizzati. Se si intende eliminare definitivamente il progetto, è necessario esaminare il file Compose ed elencare i volumi prima di rimuovere qualsiasi elemento.
docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'
L'immagine Docker ufficiale di ONLYOFFICE documenta i percorsi persistenti, inclusi /var/log/onlyoffice, /var/www/onlyoffice/Datae /var/lib/onlyoffice; i dati PostgreSQL possono anche essere archiviati separatamente. Le configurazioni di Compose possono mappare questi percorsi a volumi denominati o directory host. Eseguire il backup di tutti i certificati o dati necessari. Rimuovere solo i volumi e le directory montate tramite bind che sono stati identificati con certezza come appartenenti esclusivamente a questa distribuzione di Document Server.
Dopo la revisione, un progetto Compose può rimuovere i volumi denominati dichiarati con:
docker compose down --volumes
Utilizzare questa opzione solo quando si intende eliminare i dati persistenti di quel progetto. Non eseguirla docker volume prunecome collegamento; potrebbe eliminare volumi inutilizzati non correlati. Per un container avviato con docker run, arrestare e rimuovere il container specifico, quindi ispezionare separatamente i relativi mount e rimuovere solo i percorsi dati o i volumi che si è scelto di eliminare:
docker stop <container_name>
docker rm <container_name>
Infine, rimuovere l'immagine ONLYOFFICE solo se nessun altro contenitore ne ha bisogno. Utilizzare l'immagine e il tag esatti segnalati da docker image ls:
docker image rm onlyoffice/documentserver:<tag>
Il repository ufficiale di Docker spiega i percorsi dei dati e l'utilizzo dei volumi dell'immagine. I punti di montaggio effettivi di un container in esecuzione potrebbero differire da quelli predefiniti, quindi è consigliabile fare affidamento docker inspectsul file Compose piuttosto che su supposizioni.
Come si disinstalla il pacchetto Snap?
Se snap listviene visualizzato lo snap ONLYOFFICE Docs, il repository ufficiale dello snap documenta la rimozione con:
sudo snap remove onlyoffice-ds
Quindi controlla snap listdi nuovo. La rimozione degli snapshot e la cancellazione degli snapshot conservati o dei dati utente sono operazioni distinte; esamina gli snapshot salvati snap savede rimuovi solo gli snapshot ONLYOFFICE che intendi eliminare. Non eliminare indiscriminatamente i dati o gli snapshot condivisi.
Verifiche finali dopo la disinstallazione
- Verifica che il pacchetto, lo Snap o il contenitore di destinazione non siano più installati o in esecuzione.
- Verifica che il vecchio URL del server documenti non risponda più da una rete attendibile o dall'host stesso.
- Verificare che qualsiasi applicazione connessa sia stata configurata per utilizzare un Document Server sostitutivo o che il relativo connettore sia stato disabilitato.
- Esamina le impostazioni di Nginx, firewall, DNS e TLS per individuare le voci specifiche di ONLYOFFICE, rimuovendo solo quelle non più utilizzate.
- Verifica l'utilizzo del disco e l'elenco delle dipendenze rimanenti del gestore pacchetti. Mantieni attivi i database condivisi, i proxy, i broker di messaggi e i font se sono necessari ad altri servizi.
Se la rimozione del pacchetto non riesce, leggere attentamente il messaggio di errore completo e verificare lo stato del pacchetto prima di tentare di forzare le opzioni. Uno script di manutenzione danneggiato o un aggiornamento interrotto potrebbero richiedere una riparazione specifica per quel sistema operativo e quella versione del pacchetto; forzare la rimozione senza una diagnosi potrebbe rendere incoerente lo stato del gestore dei pacchetti. La procedura di rimozione standard è preferibile ogni volta che funziona.
Riferimenti ufficiali