OpenSimulator · FR

Caches des comptes, régions et inventaires

Durées de vie internes, données temporairement obsolètes et distinction entre cache et service d'origine.

Référence : OpenSimulator 0.9.3.1. Vérifier le moteur réellement chargé. Les fichiers ScriptEngines et les assets persistants ne sont pas nécessairement des caches jetables.

Caches de comptes du simulateur

Dans UserAccountCache.cs du simulateur, des entrées sont conservées par UUID et par nom. Le code utilise une heure pour certains comptes ordinaires, 48 heures pour les visiteurs étrangers et 10 minutes pour les recherches négatives. Ces temporisations sont propres à ce composant, non à toutes les bases de comptes d'OpenSimulator.

Le cache du service Hypergrid n'a pas la même durée

OpenSim/Services/HypergridService/UserAccountCache.cs est un autre composant, avec une expiration d'environ cinq minutes. Il ne faut pas le confondre avec le UserAccountCache du simulateur : leur rôle et leurs mécanismes d'invalidation diffèrent.

Comptes créés ou renommés

Un compte récemment créé, renommé ou résolu depuis une grille étrangère peut être représenté temporairement par une ancienne entrée de cache. Une vérification doit établir si le service UserAccount fournit bien l'information actuelle. Recréer un compte dans la base pour « réparer le cache » est une erreur.

Cache du répertoire de régions

RegionInfoCache conserve des informations de découverte par UUID, nom et position. Les valeurs temporaires habituelles expirent autour de 120 secondes dans le code vérifié. Une adresse ou une région modifiée peut rester brièvement présente dans certains processus, sans que la table GridStore soit forcément incorrecte.

Cache de l'inventaire du simulateur

InventoryCache conserve temporairement des dossiers racine, des dossiers types et certaines données d'inventaire, avec une constante d'expiration d'environ une minute. Ce cache mémoire ne doit pas être confondu avec la base InventoryStore ou le cache d'inventaire sur le PC Firestorm.

Commandes console disponibles ?

Les composants étudiés exposent des méthodes d'invalidation utilisées par le logiciel, mais la présence d'une méthode Clear ou Invalidate dans une classe C# ne crée pas automatiquement une commande console. Aucune commande universelle « account cache clear » ou « inventory cache clear » n'est ici attestée. Vérifiez la console du module réellement utilisé plutôt que d'inventer une commande.

Lien avec les amitiés Hypergrid

Un cache de comptes peut temporairement afficher des informations anciennes, mais il ne change pas la relation enregistrée dans FriendsStore de chaque grille. Une migration d'amis étrangers reste un problème de confiance intergrilles et non un simple cache de comptes à vider.

Gérer ce cache : méthode pratique

Gestion des caches de comptes et de régions

Le code fournit des durées de vie et des invalidations internes, non une commande universelle en console. Pour un utilisateur renommé ou un visiteur étranger mal identifié : vérifier le service UserAccount d'origine, noter le UUID et l'heure, examiner les logs, puis laisser passer le délai propre au composant. Pour une région déplacée : vérifier d'abord son enregistrement côté GridStore avant d'accuser RegionInfoCache. Ne modifiez pas les tables SQL pour corriger une valeur temporairement cachée.

Redémarrage : dernier recours, pas commande de cache

Redémarrer un simulateur réinitialise ses caches mémoire locaux, mais interrompt aussi ses régions et utilisateurs et n'efface pas nécessairement des caches disque. Redémarrer ROBUST peut impacter toute la grille ; ne le présentez pas comme une commande de purge de UserAccountCache. Une purge sélective en mémoire exigerait un mécanisme explicite du module.

Cache utilisateur : commandes vérifiées dans le code 0.9.3.1

Commande confirmée : reset user cache

Dans la console du simulateur, lorsque UserManagementModule est actif, reset user cache vide m_userCacheByID, le cache des associations utilisateur/nom géré par ce module. Les commandes show name <uuid> et show names permettent de consulter les informations actuellement connues. Ce n'est pas une purge générale de tous les caches UserAccountCache du simulateur ou des services ROBUST.

Comment procéder en pratique

Si un UUID affiche un ancien nom ou une identité étrangère obsolète : exécutez show name <uuid>, vérifiez les données du service d'origine, puis utilisez reset user cache et contrôlez de nouveau le nom. Ce vidage force la reconstruction de certaines entrées lors des consultations suivantes ; il ne modifie ni les comptes SQL, ni les UUI d'origine, ni les relations FriendsStore.

Console du simulateur, module UserManagement actif. La commande reset user cache ne vide pas tous les autres caches de comptes.

show name <uuid>
show names
reset user cache

Source : UserManagementModule.cs, lignes 1300-1327 — https://github.com/Vlad-BloodMoon/opensim/blob/master/OpenSim/Region/CoreModules/Framework/UserManagement/UserManagementModule.cs

Sources du code OpenSimulator

Autres guides