Commandes console de cache : fcache
Dossier pratique fondé sur le code OpenSimulator 0.9.3.1 : identifier, configurer et diagnostiquer les caches.
Vérifier les commandes disponibles
Ces commandes sont enregistrées par FlotsamAssetCache dans la console du simulateur lorsqu'il est activé. Elles ne doivent pas être présentées comme des commandes universelles de ROBUST. La liste dépend de la version et du module chargé. Consultez l'aide console du processus avant une intervention.
fcache status
Affiche l'état du cache, les taux de hit et le nombre d'assets disque/mémoire quand ces niveaux sont activés. C'est la première commande à utiliser avant d'envisager une purge. Elle peut effectuer un comptage de nombreux fichiers.
fcache clearnegatives
Efface uniquement la liste des assets précédemment introuvables. Pratique après restauration d'un asset ou résolution d'un incident du service : cela n'efface pas le cache disque ni l'inventaire d'un avatar.
fcache clear memory / file
fcache clear memory efface le cache mémoire optionnel ; fcache clear file efface le cache disque. fcache clear sans option tente les deux et réinitialise aussi les entrées négatives. Le code efface également le cache négatif lors de fcache clear memory ou file : il ne faut pas annoncer un isolement absolument strict des effets.
fcache assets
Parcourt les scènes et tente de charger dans le cache les assets référencés par leurs objets, terrains et autres contenus. Il peut effectuer beaucoup de lectures ou de requêtes distantes ; réservez-le aux besoins identifiés et, pour une grande grille, à une plage calme.
fcache expire
Purge les fichiers de cache dont l'ancienneté précède la date demandée. Le code utilise DateTime.TryParse et accepte aussi « now » ; le format est donc soumis aux paramètres culturels du processus. N'exécutez pas fcache expire now sans comprendre la portée : cela peut provoquer un gros rechargement.
Caches d'assets par défaut : commandes avancées
fcache cachedefaultassets charge les assets locaux par défaut dans le cache et peut remplacer leurs versions issues de la grille ; fcache deletedefaultassets supprime ces entrées afin de permettre un rafraîchissement. Le code précise explicitement « use with care ». Évitez de les utiliser pour un dépannage général.
Ce que les commandes ne font pas
fcache clear n'efface pas la table d'assets de ROBUST, les fichiers FSAssets persistants, les objets RegionStore ni le cache local Firestorm. Il n'efface pas non plus les caches d'utilisateurs ou d'inventaire en mémoire des autres composants.
Commandes de diagnostic
Commandes console du simulateur avec Flotsam actif. Commencez par status ; clearnegatives ne touche que les résultats de recherche manquants.
fcache status fcache clearnegatives
Commandes de nettoyage : attention
La dernière commande efface les caches fichier et mémoire (si actifs). Dans tous ces cas, le code efface également le cache négatif. Une purge disque peut entraîner une forte activité de rechargement.
fcache clear memory fcache clear file fcache clear
Opérations lourdes ou avancées
Ne sont pas des commandes de maintenance routinière. expire now est particulièrement agressif et les commandes d'assets par défaut peuvent modifier le contenu du cache face aux assets de la grille.
fcache assets fcache expire now fcache cachedefaultassets fcache deletedefaultassets
Gérer ce cache : méthode pratique
Ordre conseillé des interventions
Pour diagnostiquer : fcache status d'abord. Pour un résultat d'asset introuvable désormais obsolète : fcache clearnegatives. Pour un cache disque réellement problématique : identifier le répertoire, sauvegarder la configuration et décider d'une purge sur période calme. fcache assets est une opération de préchargement qui augmente temporairement les requêtes : elle ne répare pas un service d'assets indisponible.
Précision sur les commandes ciblées
Le code Flotsam efface le cache négatif même après fcache clear memory ou fcache clear file. Il n'existe donc pas d'isolation parfaite des trois niveaux avec ces commandes. Les commandes de cette page appartiennent au module Flotsam et à la console du simulateur, pas à la console ROBUST par défaut.
Cache d’identité : commande dédiée
Les commandes fcache présentées ici appartiennent à Flotsam. La commande reset user cache concerne un autre module (UserManagementModule) et un autre type de cache ; sa procédure figure dans le guide des caches de comptes.
Procédure complète : cache utilisateur, vérifications et commandes
Autres guides du dossier
- Comprendre les caches OpenSimulator
- Flotsam : cache disque, mémoire et cache négatif
- Autres caches internes : inventaire, régions et textures
- Dépanner les caches sans perturber la grille
- FSAssets et stockage d'assets
- Inodes et stockage disque
- Cache Firestorm et lag graphique