Come disinstallare completamente ONLYOFFICE Document Server da Linux

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

Lascia un commento

Risolvi il problema di copia e incolla tra app locali in Collabora Online.

Risolvi il problema di copia e incolla tra app locali in Collabora Online.

Risolvere i problemi di copia e incolla di Collabora Online con le app locali testando le scorciatoie da tastiera, le autorizzazioni degli appunti del browser, HTTPS, le policy iframe e i formati dei contenuti.

Come eliminare i caratteri sfocati in ONLYOFFICE Desktop su Linux: una guida pratica

Come eliminare i caratteri sfocati in ONLYOFFICE Desktop su Linux: una guida pratica

Risolvi il problema del testo sfocato negli editor desktop di ONLYOFFICE su Linux verificando, in un ordine sicuro, la scalatura dello schermo, la scalatura dell'interfaccia dell'applicazione, la disponibilità dei caratteri e l'ambito di rendering.

Come limitare la stampa e il download in ONLYOFFICE

Come limitare la stampa e il download in ONLYOFFICE

Scopri come bloccare la stampa e il download nelle integrazioni di ONLYOFFICE Workspace, DocSpace o Docs e verifica quali controlli si applicano a ciascun metodo di condivisione.

Come risolvere l'errore 502 Bad Gateway del server documenti ONLYOFFICE dietro Nginx

Come risolvere l'errore 502 Bad Gateway del server documenti ONLYOFFICE dietro Nginx

Risolvere gli errori 502 del server documenti ONLYOFFICE dietro Nginx. Verificare lo stato del servizio, i log, le porte upstream, le intestazioni inoltrate, i WebSocket e la rete Docker.

Risolvere i problemi di timeout di connessione dell'app mobile ONLYOFFICE a un server self-hosted

Risolvere i problemi di timeout di connessione dell'app mobile ONLYOFFICE a un server self-hosted

Risolvere i problemi di timeout dei documenti ONLYOFFICE su un server self-hosted verificando l'URL del portale o WebDAV corretto, l'accesso alla rete, HTTPS, le credenziali e il routing del server.

Come modificare il modello di documento predefinito in LibreOffice Writer

Come modificare il modello di documento predefinito in LibreOffice Writer

Imposta un modello personalizzato di LibreOffice Writer come predefinito, aggiornalo o reimpostalo e verifica che i nuovi documenti utilizzino gli stili e il layout di pagina che preferisci.

Risolvere l'errore "Download non riuscito" durante l'esportazione di un PDF da ONLYOFFICE

Risolvere l'errore "Download non riuscito" durante l'esportazione di un PDF da ONLYOFFICE

Risolvi i problemi di esportazione PDF di ONLYOFFICE separando i problemi di conversione, di download dal browser e del server, quindi verifica che il PDF salvato si apra e mantenga il suo layout.

Come disinstallare completamente ONLYOFFICE Document Server da Linux

Come disinstallare completamente ONLYOFFICE Document Server da Linux

Rimuovere ONLYOFFICE Document Server da Linux in modo sicuro. Seguire le istruzioni relative a pacchetti, Docker, Snap e Kubernetes, preservare i dati e verificare i servizi rimanenti.

How to Configure LDAP / Active Directory Sync in ONLYOFFICE

How to Configure LDAP / Active Directory Sync in ONLYOFFICE

Configure LDAP or Active Directory sync in ONLYOFFICE Workspace with secure connection settings, user and group filters, attribute mapping, admin rights, scheduled sync, and practical verification checks.

Come eseguire il server di documenti ONLYOFFICE dietro un bilanciatore di carico HAProxy

Come eseguire il server di documenti ONLYOFFICE dietro un bilanciatore di carico HAProxy

Posiziona ONLYOFFICE Document Server dietro HAProxy con terminazione TLS, intestazioni inoltrate, controlli di integrità, timeout sicuri per WebSocket e routing consapevole dei documenti per implementazioni multi-nodo.