Restaurez les paramètres de Collabora CODE sans perdre les modifications de déploiement

Après une reconstruction, un conteneur Collabora CODE peut redémarrer avec ses paramètres par défaut. Une panne de serveur peut également vous priver de toute copie fonctionnelle de sa configuration. Sauvegardez les coolwsd.xmlfichiers actifs et de déploiement qui fournissent les paramètres. Restaurez-les sur la même source persistante, puis validez le fichier et le service avant que les utilisateurs ne reprennent l'édition.

Le fichier principal est généralement /etc/coolwsd/coolwsd.xml. La source de référence diffère selon qu'il s'agisse d'un package, d'une installation Docker ou Helm ; il est donc important d'identifier le déploiement avant toute copie.

1. Trouvez la source de configuration active

Lors de l'installation d'un paquet, examinez le fichier host. Dans Docker, examinez le fichier à l'intérieur du conteneur en cours d'exécution et vérifiez si un fichier ou un répertoire host y est monté. Conservez également les valeurs Compose, les fichiers d'environnement référencés et les valeurs Helm : les options de démarrage qui y sont fournies ne sont pas nécessairement stockées dans le 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

Remplacez ` collabora-code<nom_du_conteneur>` par le nom réel de votre conteneur. La documentation de configuration et Docker de Collabora décrit ces chemins de déploiement, et son graphique Helm amont expose les paramètres au niveau du graphique. Consultez la documentation de votre version ; les valeurs par défaut et le comportement de déploiement peuvent varier d'une version à l'autre.

2. Sauvegardez les fichiers XML et de déploiement

Conservez une copie datée dans un répertoire restreint. La configuration peut révéler les hôtes WOPI autorisés, le comportement du proxy, les chemins d'accès aux certificats ou les paramètres d'administration. Traitez cette sauvegarde comme des données opérationnelles sensibles.

Pour l'installation d'un paquet, conservez les métadonnées des fichiers :

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

Pour Docker, copiez le fichier actif du conteneur vers l'hôte :

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

Si le fichier est fourni par un montage de liaison, sauvegardez également sa source côté hôte ; c’est ce fichier qui peut écraser une modification effectuée dans le conteneur au redémarrage. Conservez le fichier Compose et tous .envles fichiers référencés dans le même ensemble de sauvegarde protégé. Pour Helm, sauvegardez le fichier de valeurs exact et l’identité de la version, ainsi que les Secrets ou ConfigMaps gérés séparément à l’aide de votre processus de gestion des secrets existant.

3. Rendre la sauvegarde reproductible

Enregistrez l'étiquette de l'image CODE ou la version du paquet, le nom du conteneur, le point de montage et la date de sauvegarde. Les installations de paquets peuvent servir cp -aà préserver les métadonnées. Le propriétaire des fichiers du conteneur peut différer de celui de l'hôte ; par conséquent, ne présumez pas qu'un propriétaire ou un mode hôte convienne à toutes les versions d'image.

Pour Compose, déterminez si un fichier ou un répertoire entier est monté /etc/coolwsd. Un montage de répertoire peut masquer des fichiers inclus dans l'image ; un répertoire incomplet peut rendre certains fichiers inaccessibles. Sauvegardez tous les fichiers du répertoire monté dont CODE dépend. Conservez les paramètres d'environnement séparément et protégez les données sensibles.

Pour Helm, ne vous fiez pas à la modification d'un pod généré : les mises à jour peuvent le recréer. Conservez les valeurs du chart ainsi que tout Secret ou ConfigMap externe. Le chart amont de Collabora prend en charge le contenu de la configuration via des valeurs ; sa source déclarée peut donc être plus fiable qu'une copie depuis un pod en cours d'exécution.

4. Restaurer à la source persistante

Arrêtez CODE ou utilisez une fenêtre de maintenance. Sauvegardez le fichier actuel avant de le remplacer. Pour l'installation d'un paquet, restaurez la sauvegarde choisie et conservez le propriétaire et le mode attendus par ce paquet :

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

Le propriétaire et le groupe de l'exemple peuvent ne pas correspondre à votre package. Vérifiez le fichier existant statet conservez son propriétaire et son mode attendus au lieu d'appliquer des valeurs d'exemple sans discernement. Pour un conteneur monté, restaurez le fichier hôte et suivez votre procédure de redémarrage ou de recréation Compose. Si une image personnalisée ou une valeur Helm fournit la configuration, mettez à jour cette source et redéployez ; la modification d'un conteneur jetable ne sera pas conservée.

Vérifiez la configuration avant de la restaurer suite à un changement de version majeur. Les options peuvent varier d'une version à l'autre ; comparez donc le fichier enregistré avec le modèle et les notes de migration de la version cible. La restauration du fichier XML ne restaure pas les certificats, les clés privées, les polices personnalisées ni la configuration du proxy inverse, sauf si ces éléments ont été sauvegardés séparément.

5. Vérifiez avant de rouvrir la modification

Vérifie que le fichier existe, qu'il est lisible par le service et qu'il s'agit d'un fichier XML bien formé. Si installé, xmllintvérifie la syntaxe :

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

Cela confirme uniquement la syntaxe XML ; cela ne garantit pas que toutes les options sont prises en charge par votre version de CODE. Consultez les journaux pour détecter les erreurs d'analyse et vérifiez que le service est toujours en cours d'exécution. Pour les conteneurs, consultez docker compose psles journaux récents. Pour les paquets, consultez systemctl status coolwsdle journal système.

Enfin, ouvrez un document via l'hôte WOPI habituel et vérifiez qu'il se charge et s'enregistre correctement. Si CODE démarre mais que les documents ne se chargent pas, comparez la liste blanche, le nom d'hôte externe, la terminaison TLS et les paramètres de proxy restaurés avec ceux du déploiement. En cas d'échec du démarrage, restaurez la copie antérieure à la restauration et comparez les fichiers avant de réessayer.

• Vérifiez que la version de sauvegarde et le déploiement correspondent.
• Vérifiez que les valeurs de montage ou Helm pointent bien vers la source restaurée.
• Confirmez que l'analyse XML et le démarrage du service ont réussi.
• Testez l'ouverture et l'enregistrement via la plateforme de stockage connectée.

Références officielles

• Documentation de configuration de Collabora Online
• Documentation de l'image Docker Collabora CODE
• Valeurs du graphique Helm en amont de Collabora
• Documentation sur les points de montage Docker