OpenSimulator · FR

FSAssets : sauvegarde, restauration et intégrité

Sauvegardes cohérentes des fichiers, de la base SQL et du spool, avec contrôles et reprise après incident.

Guide fondé sur les fichiers sources du fork OpenSimulator 0.9.3.1 / .NET 8. Vérifiez la version et sauvegardez avant toute modification en production.

Ne pas sauvegarder seulement le dossier data

FSAssets dépend à la fois des fichiers de BaseDirectory, des métadonnées SQL et de la zone SpoolDirectory. Une sauvegarde qui ignore le spool peut manquer les dernières écritures ; une sauvegarde fichiers sans métadonnées SQL ne garantit pas la récupération des assets par UUID. Ajoutez les INI et les paramètres du service ROBUST.

Choisir une fenêtre cohérente

La méthode la plus simple à fiabiliser est une sauvegarde planifiée après arrêt contrôlé des écritures : arrêtez les simulateurs producteurs et ROBUST, puis capturez les fichiers et la base en tant qu’ensemble. Pour réduire la durée d'arrêt, vous pouvez d'abord pré-copier les FSAssets pendant le fonctionnement avec rsync, puis geler les écritures, effectuer la dernière passe et sauvegarder SQL dans la même fenêtre. Une sauvegarde strictement sans arrêt nécessite une stratégie de snapshots coordonnés et testés, pas deux copies prises à des heures différentes.

Sauvegarde SQL : compte et portée

Identifiez la base réelle et la table Realm (fsassets par défaut). Les données d’une grille comprennent généralement d’autres tables et services en plus de FSAssets ; un dump de la seule table fsassets n’est pas une sauvegarde de la grille. Privilégiez les mécanismes de secrets sûrs du client SQL, plutôt que de placer le mot de passe sur la ligne de commande.

Exemple à adapter : ne jamais appliquer aveuglément en production.

# Exemple MySQL : adapter le nom de la base et les identifiants
mysqldump --single-transaction --routines --triggers --events --databases opensim > /backup/opensim.sql
# Pour une restauration complète : conserver aussi configs, assets et versions.

Copie des fichiers et du spool

Après arrêt contrôlé, copiez data et tmp vers une destination disposant d’inodes et d’espace suffisants. Conservez UID/GID, modes, liens et horodatages. Ne déduisez pas l’intégrité d’un code de sortie rsync uniquement : contrôlez fichiers, tailles et restauration d’un échantillon.

Exemple à adapter : ne jamais appliquer aveuglément en production.

sudo rsync -aHAX --numeric-ids /srv/opensim/fsassets/data/ /backup/fsassets/data/
sudo rsync -aHAX --numeric-ids /srv/opensim/fsassets/tmp/ /backup/fsassets/tmp/
df -h /backup/fsassets
df -i /backup/fsassets

Contrôles des archives et des fichiers

Vérifiez le résultat du dump, les journaux de sauvegarde, le nombre de métadonnées, un échantillon de .gz par test gzip -t, et la présence des UUID choisis dans SQL. Tester l’intégralité des millions de fichiers est potentiellement long ; planifiez les vérifications lourdes.

Exemple à adapter : ne jamais appliquer aveuglément en production.

# Choisir un chemin .gz réel, ne pas modifier les assets :
gzip -t /srv/opensim/fsassets/data/CHEMIN/HASH.gz
# Interroger la base réelle ; Realm peut différer de fsassets :
SELECT COUNT(*) FROM fsassets;

Restauration sur une instance de test

Restaurez d’abord le dump SQL et le stockage dans un environnement isolé, avec la même version du connecteur et le même UseOsgridFormat. Contrôlez les UUID connus avec show digest, puis la connexion et l’affichage des objets dans un viewer. Ne démarrez pas deux écrivains FSAssets sur la même arborescence sans architecture multi-instances explicitement validée.

Rétention, hors site et tests réguliers

Gardez plusieurs points de restauration, dont au moins une copie hors de la machine de production. Un disque dédié à FSAssets n’est pas une sauvegarde. Documentez un RPO/RTO réaliste et testez périodiquement la restauration complète, y compris les nouvelles écritures du spool.

Ne jamais supprimer les fichiers orphelins à l’aveugle

La déduplication implique qu’un même hash peut être référencé par plusieurs UUID. La suppression manuelle de fichiers apparemment inutilisés peut casser des assets encore référencés. Les commandes delete asset et force import sont destructives ou modifiantes ; toute opération de nettoyage doit être justifiée par une analyse SQL/fichiers complète.

Procédure à chaud : exemples rsync détaillés

La procédure de précopie douce, screen, --dry-run, synchronisation finale SQL/fichiers et retour arrière est documentée séparément pour éviter de répéter ici toute la méthode.

Lire le guide de sauvegarde à chaud

Continuer la lecture

Sources vérifiables