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.
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