Ripristina le impostazioni di Collabora CODE senza perdere le modifiche di distribuzione.

Un container Collabora CODE potrebbe riavviarsi con le impostazioni predefinite dopo una ricostruzione, oppure un errore del server potrebbe impedire di avere una copia funzionante della sua configurazione. Eseguire il backup dei coolwsd.xmlfile attivi e di distribuzione che forniscono le impostazioni. Ripristinarli nella stessa origine persistente, quindi convalidare il file e il servizio prima che gli utenti riprendano a modificarli.

Il file principale è generalmente /etc/coolwsd/coolwsd.xml. La fonte di verità varia a seconda che si tratti di installazioni di pacchetti, Docker o Helm, quindi identifica la distribuzione prima di copiare qualsiasi cosa.

1. Individuare la sorgente di configurazione attiva

Con l'installazione di un pacchetto, ispeziona il file host. In Docker, ispeziona il file all'interno del container in esecuzione e verifica se un file host o una directory è montato su di esso. Conserva anche i valori di Compose, i file di ambiente a cui si fa riferimento o i valori di Helm: le opzioni di avvio fornite in questi file non sono necessariamente memorizzate in XML.

sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml

Sostituisci collabora-codecon il nome effettivo del tuo container. La configurazione di Collabora e la documentazione Docker descrivono questi percorsi di distribuzione, e il relativo chart Helm espone le impostazioni a livello di chart. Consulta la documentazione relativa alla tua versione; le impostazioni predefinite e il comportamento di distribuzione possono variare tra le diverse versioni.

2. Eseguire il backup dei file XML e di distribuzione

Conservare una copia datata in una directory con accesso limitato. La configurazione può rivelare gli host WOPI consentiti, il comportamento del proxy, i percorsi dei certificati o le impostazioni amministrative. Trattare il backup come dati operativi sensibili.

Per l'installazione di un pacchetto, conserva i metadati del file:

sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml

Per Docker, copia il file live dal container all'host:

mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
  ~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml

Se il file viene fornito tramite un bind mount, esegui il backup anche del suo codice sorgente lato host; questo è il file che può sovrascrivere una modifica all'interno del container al riavvio. Mantieni il file Compose e qualsiasi .envfile a cui fa riferimento nello stesso set di backup protetto. Per Helm, salva il file dei valori esatti e l'identità della release, oltre ai Secret o ConfigMap gestiti separatamente utilizzando il tuo processo di gestione dei segreti esistente.

3. Rendere il backup riproducibile

Registra il tag dell'immagine CODE o la versione del pacchetto, il nome del contenitore, la sorgente di montaggio e la data del backup. Le installazioni dei pacchetti possono essere utilizzate cp -aper preservare i metadati. La proprietà dei file del contenitore può differire da quella dell'host, quindi non dare per scontato che un determinato proprietario o permesso dell'host sia adatto a ogni versione dell'immagine.

Per Compose, determina se è montato un file o un'intera directory /etc/coolwsd. Il montaggio di una directory può nascondere i file inclusi nell'immagine; una directory incompleta può rendere non disponibili i file previsti. Esegui il backup di ogni file nella directory montata da cui dipende CODE. Mantieni le impostazioni dell'ambiente separate e proteggi i dati sensibili.

Per Helm, non affidatevi alla modifica di un pod generato: gli aggiornamenti possono ricrearlo. Conservate i valori del chart e qualsiasi Secret o ConfigMap esterno. Il chart upstream di Collabora supporta i contenuti di configurazione tramite valori, quindi la sua sorgente dichiarata può essere più autorevole di una copia da un pod in esecuzione.

4. Ripristinare l'origine persistente

Interrompere CODE o utilizzare una finestra di manutenzione. Salvare il file corrente prima di sostituirlo. Per l'installazione di un pacchetto, ripristinare il backup scelto mantenendo la proprietà e i permessi previsti da tale pacchetto:

sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd

Il proprietario e il gruppo di esempio potrebbero non corrispondere al tuo pacchetto. Controlla il file esistente state mantieni la proprietà e i permessi previsti, invece di applicare i valori di esempio alla cieca. Per un container montato tramite bind, ripristina il file host e segui il flusso di lavoro di riavvio o ricreazione di Compose. Se un'immagine personalizzata o un valore Helm fornisce la configurazione, aggiorna tale origine e ridistribuisci; la modifica di un container usa e getta non sarà permanente.

Prima di eseguire il ripristino in caso di un cambio di versione principale, è necessario rivedere la configurazione. Le opzioni possono variare tra le diverse versioni, quindi è consigliabile confrontare il file salvato con il modello e le note di migrazione della versione di destinazione. Il ripristino del file XML non include certificati, chiavi private, font personalizzati o configurazione del proxy inverso, a meno che non siano stati salvati separatamente.

5. Verificare prima di riaprire la modifica

Verifica che il file esista, sia leggibile dal servizio e sia un file XML ben formato. Se installato, xmllintcontrolla la sintassi:

xmllint --noout /etc/coolwsd/coolwsd.xml

Questo conferma solo la sintassi XML; non dimostra che tutte le opzioni siano supportate dalla tua versione di CODE. Controlla i log per eventuali errori di analisi e verifica che il servizio rimanga in esecuzione. Per i container, controlla docker compose psi log recenti. Per i pacchetti, controlla systemctl status coolwsdil journal di sistema.

Infine, apri un documento tramite il solito host WOPI e verifica che venga caricato e salvato correttamente. Se CODE si avvia ma i documenti non vengono caricati, confronta l'elenco di elementi consentiti ripristinato, il nome host esterno, la terminazione TLS e le impostazioni del proxy con quelle della distribuzione. Se l'avvio non riesce, ripristina la copia precedente al ripristino e confronta i file prima di riprovare.

• Verificare che la versione del backup e la distribuzione corrispondano.
• Verificare che i valori di mount o Helm puntino alla sorgente ripristinata.
• Confermare che l'analisi XML e l'avvio del servizio siano andati a buon fine.
• Prova ad aprire e salvare i dati tramite la piattaforma di archiviazione connessa.

Riferimenti ufficiali

• Documentazione di configurazione di Collabora Online
• Documentazione dell'immagine Docker di Collabora CODE
• Collaborare a monte ai valori del grafico Helm
• Documentazione sui bind mount di Docker