OpenSimulator · FR

FSAssets : diagnostiquer les pannes et les logs

Pannes réelles : inodes épuisés, spool bloqué, fichiers manquants, métadonnées SQL et droits.

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.

Première règle : lire Robust.log

Si FSAssets est chargé par ROBUST, ouvrez d’abord Robust.log, et les journaux systemd de ce service si applicable. Repérez la première erreur [FSASSETS] précédant le symptôme et confrontez-la à OpenSim.log de la région. Les messages FSASSETS de démarrage indiquent le spool et la base effectivement utilisés.

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

grep -nEi '\[FSASSETS\]|exception|IOException|database|missing' /chemin/vers/bin/Robust.log | tail -n 150
tail -F /chemin/vers/bin/Robust.log

« No space left on device »

Journaux : Robust.log et journal noyau. Hypothèses : manque d’octets, manque d’inodes, quota ou répertoire temporaire sur une autre partition. Vérifications : df -h, df -i sur data ET spool, findmnt et quotas. Correction : libérer ou étendre le bon volume après sauvegarde ; ne supprimez pas les .gz ou le spool.

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

df -h /srv/opensim/fsassets/data /srv/opensim/fsassets/tmp
df -i /srv/opensim/fsassets/data /srv/opensim/fsassets/tmp
findmnt -T /srv/opensim/fsassets/tmp

Fichiers présents en SQL mais absents sur disque

Journaux : [FSASSETS] missing FS, erreurs de lecture ou décompression ; le code peut consulter FallbackService s’il est configuré. Vérifiez le hash dans la table fsassets et construisez le chemin selon UseOsgridFormat, puis cherchez le .gz ou le spool. Corriger le chemin, le volume ou restaurer les données correspondantes ; ne fabriquez pas un fichier arbitraire sous le hash.

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

SELECT id,hash,name,type FROM fsassets WHERE id='UUID_REEL_ICI';
# En console FSAssets :
show digest UUID_REEL_ICI

Le spool ne se vide plus

Journaux : [FSASSETS] Writer started, Write cycle complete et éventuelles exceptions. Vérifiez l’existence du thread écrivain, les droits de lecture/écriture, la place, les inodes et le disque monté. N’effacez pas le spool : il peut contenir les seules copies de nouvelles données. Un blocage peut exiger une investigation sur l’I/O et le processus avant redémarrage.

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

du -sh /srv/opensim/fsassets/tmp
find /srv/opensim/fsassets/tmp -maxdepth 1 -type f | wc -l
ls -ld /srv/opensim/fsassets/tmp/spool
journalctl -k --since '2 hours ago' | grep -Ei 'I/O error|read-only|ext4|xfs'

Erreurs SQL ou table fsassets absente

Journaux : [FSASSETS] Can't connect to database, Database open failed, erreur de migration ou de permission. Vérifiez [DatabaseService] et l’éventuelle surcharge [AssetService], l’état MySQL, le Realm configuré et la table réellement créée. N’initialisez pas une nouvelle base vide en pensant réparer des données existantes.

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

systemctl status mysql --no-pager
journalctl -u mysql --since '1 hour ago' --no-pager
# SQL (dans le client mysql) :
SHOW TABLES LIKE 'fsassets';
SELECT COUNT(*) FROM fsassets;

Permissions refusées, montage lecture seule

Journaux : UnauthorizedAccessException, IOException, Read-only file system. Vérifications : UID effectif du service, droits des ancêtres, ACL, montage réel, espace et SELinux/AppArmor le cas échéant. Correction : réparer uniquement les droits ou le montage nécessaire ; un chmod -R 777 n’est pas une solution.

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

findmnt -T /srv/opensim/fsassets/data
namei -l /srv/opensim/fsassets/data
ls -ld /srv/opensim/fsassets/data /srv/opensim/fsassets/tmp
systemctl status robust.service --no-pager

Une migration semble réussie mais des assets restent absents

Journaux : erreurs [FSASSETS] et requêtes fallback. Vérifiez si les UUID jamais demandés ont été importés, si la table Realm correspond, si le spool est vidé, si l’ancien service est encore accessible et si les formats de chemins correspondent. Correction : finaliser la migration sous contrôle, pas supprimer l’ancien stockage.

FSAssets s’arrête brutalement

Le code du fork contient des chemins d’erreur de lecture qui journalisent l’exception avant de terminer le processus. Cherchez la toute première exception dans Robust.log puis dans journalctl. Vérifiez erreurs disque, données gzip corrompues, permissions et disponibilité SQL avant de tenter un redémarrage.

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

journalctl -u robust.service -n 200 --no-pager
grep -nEi '\[FSASSETS\]|exception|fatal' /chemin/vers/bin/Robust.log | tail -n 120

Rapport d’incident à préparer

Conservez l’heure, le nom du service, l’UUID et le hash concernés, les résultats df -h / df -i, findmnt, le message complet et les lignes voisines du log, les versions OpenSimulator et les changements récents. Masquez chaînes SQL, clés, IP privées sensibles et informations personnelles avant partage.

Continuer la lecture

Sources vérifiables