OpenSimulator · FR

Commandes console de cache : fcache

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.

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

Sources vérifiées : code OpenSimulator 0.9.3.1