OpenSimulator · FR

Flotsam : cache disque, mémoire et cache négatif

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.

Activer le module

Dans les modèles GridCommon.ini et StandaloneCommon.ini, [Modules] AssetCaching = FlotsamAssetCache charge le module, et Include-FlotsamCache référence config-include/FlotsamCache.ini. Les paramètres du cache lui-même figurent dans [AssetCache]. Vérifiez que l'inclusion pointe vers un fichier réellement présent.

Cache sur disque

FileCacheEnabled = true active le cache de fichiers. CacheDirectory définit son emplacement, par défaut ./assetcache dans le modèle. Il est résolu en chemin absolu par le module au démarrage. Les fichiers sont des copies : un échec de lecture conduit normalement à rechercher l'asset à la source. Ce stockage est différent de FSAssets.

Cache en mémoire

MemoryCacheEnabled est à false dans le modèle. Une fois activé, MemoryCacheTimeout règle le temps de conservation en heures ; .016 représente environ une minute. Ce cache peut accélérer les demandes répétées, mais augmenter la consommation de RAM. Le code conserve aussi des références faibles qui ne sont pas la même chose que le cache mémoire optionnel.

Cache négatif : les assets introuvables

NegativeCacheEnabled = true et NegativeCacheTimeout = 120 mémorisent temporairement les échecs de recherche, pour ne pas solliciter sans cesse le service d'assets. Une création ou restauration récente peut rester invisible jusqu'à expiration. La commande fcache clearnegatives permet alors un diagnostic plus ciblé qu'une purge complète.

Délais d'expiration et nettoyage automatique

FileCacheTimeout est exprimé en heures (48 dans le modèle). FileCleanupTimer règle l'intervalle des passages de nettoyage ; sa valeur d'exemple 0.0 désactive ces passages périodiques. La présence de FileCacheTimeout = 48 ne signifie donc pas que les fichiers seront automatiquement supprimés après 48 h si le timer est désactivé.

Nombre de répertoires et inodes

CacheDirectoryTiers et CacheDirectoryTierLength répartissent les fichiers en sous-répertoires. CacheWarnAt détermine un seuil d'avertissement sur le nombre de fichiers par dossier. Un changement de répartition doit être préparé et testé ; ce n'est pas un remède universel à une saturation d'inodes.

Le paramètre UpdateFileTimeOnCacheHit

UpdateFileTimeOnCacheHit = false par défaut. L'exemple recommande de ne l'activer que dans un contexte de cache partagé avec nettoyage externe contrôlé. Modifier les dates d'accès change la façon dont les fichiers vieillissent et peut perturber les stratégies d'expiration.

La supervision et les écritures disque

fcache status affiche les entrées et les taux de succès des différents niveaux, et peut parcourir le répertoire pour compter les fichiers. Une opération de recensement ou de préchargement sur un très grand cache a un coût I/O ; évitez d'en faire une tâche en boucle.

Valeurs d'exemple inspirées du fichier officiel. L'inclusion et la section AssetCache peuvent se trouver dans deux fichiers distincts ; ne dupliquez pas [Modules] si elle existe déjà.

[Modules]
AssetCaching = "FlotsamAssetCache"
Include-FlotsamCache = "config-include/FlotsamCache.ini"

[AssetCache]
CacheDirectory = ./assetcache
FileCacheEnabled = true
MemoryCacheEnabled = false
NegativeCacheEnabled = true
NegativeCacheTimeout = 120
MemoryCacheTimeout = .016
FileCacheTimeout = 48
FileCleanupTimer = 0.0
UpdateFileTimeOnCacheHit = false

Gérer ce cache : méthode pratique

Procédure de gestion recommandée

1. Vérifier l'activation de Flotsam et l'inclusion effective de FlotsamCache.ini. 2. Exécuter fcache status sur la console du simulateur concerné. 3. Contrôler CacheDirectory, les inodes et FileCleanupTimer. 4. En cas d'asset récemment restauré mais introuvable, essayer uniquement fcache clearnegatives. 5. Réserver fcache clear file ou fcache clear à une maintenance justifiée et surveiller le rechargement.

Ce qu'il ne faut pas faire

N'utilisez pas une tâche cron supprimant aveuglément le chemin supposé du cache. Un cache partagé par plusieurs simulateurs demande une stratégie de nettoyage coordonnée ; le cache disque n'est pas interchangeable avec FSAssets. La commande fcache status compte potentiellement énormément de fichiers et peut provoquer des I/O sur de gros volumes.

Autres guides du dossier

Sources vérifiées : code OpenSimulator 0.9.3.1