OpenSimulator · FR

Dépanner les caches sans perturber la grille

Dossier pratique fondé sur le code OpenSimulator 0.9.3.1 : identifier, configurer et diagnostiquer les caches.

Vérifiez le module actif et la configuration chargée avant toute commande. Un cache peut être nettoyé, mais un stockage persistant comme FSAssets ne doit jamais être supprimé comme un cache.

Commencer par délimiter le problème

Déterminez s'il s'agit d'un avatar, d'une région, d'un simulateur ou de toute la grille. Les FPS, la disponibilité des assets, les réponses d'inventaire et les statuts de connexion sont des symptômes différents. Une panne MySQL ou réseau n'est pas réparée en vidant un cache.

Disque plein ou manque d'inodes

Sur Linux, df -h montre l'espace disque et df -i la disponibilité des inodes. Lisez ensuite le chemin CacheDirectory dans les INI. Ne supprimez pas un chemin qui n'a pas été vérifié : fsassets peut ressembler à un cache, mais stocke des contenus permanents.

Rapport Flotsam avant purge

Dans la console du simulateur concerné, fcache status permet de relever les taux de succès et le volume de fichiers. Vérifiez FileCacheTimeout et FileCleanupTimer, ainsi que les logs. Si le cache grossit, déterminez si la purge automatique est désactivée avant de toucher au stockage.

Un asset précédemment absent

Si l'asset a été restauré et que le service le sert désormais, fcache clearnegatives est un premier essai ciblé. Si le service d'origine renvoie toujours « absent », vider le cache local ne produira pas l'asset manquant.

Ne pas confondre avec Firestorm

Le cache de Firestorm se trouve sur le PC de l'utilisateur. Si un seul visiteur voit des textures grises ou subit des FPS faibles, vérifiez sa connexion et ses réglages avant d'intervenir sur les serveurs. Supprimer le cache côté simulateur peut aggraver les rechargements pour tous.

Plan de maintenance prudent

1. Vérifier les logs et l'état des services. 2. Inspecter les réglages de cache réellement chargés. 3. Mesurer le nombre de fichiers et inodes. 4. Préférer la commande ciblée la moins intrusive. 5. Prévoir une période calme pour tout préchargement ou nettoyage important. 6. Comparer les mesures et noter les effets.

Commandes Linux de vérification

Vérifier l'espace, les inodes et la taille du cache. Ces commandes sont en lecture seule ; n'utilisez jamais rm -rf sur un chemin supposé.

df -h
df -i
# Adapter le chemin aux réglages AssetCache :
du -sh /path/to/assetcache

Gérer ce cache : méthode pratique

Choisir une action selon le symptôme

Cache disque Flotsam volumineux : fcache status, puis examiner CacheDirectory, FileCleanupTimer et df -i. Asset redevenu disponible après échec : fcache clearnegatives. Compte ou région brièvement obsolète : vérifier le service d'origine et laisser expirer le cache mémoire. Physique ubOde anormalement lente : examiner [Mesh] et les logs de meshing sans supprimer MeshCache en service. Scripts défaillants : vérifier YEngine et ses états, jamais une purge automatique de ScriptEngines.

Cache d’identité : commande dédiée

Si un UUID affiche un ancien nom, vérifiez d’abord le service utilisateur d’origine. La commande reset user cache n’agit que sur les associations de noms gérées par UserManagementModule. Suivez la procédure ciblée du guide des caches de comptes avant tout redémarrage.

Procédure complète : cache utilisateur, vérifications et commandes

Autres guides du dossier

Sources vérifiées : code OpenSimulator 0.9.3.1