Dépannage : archives, assets et régions
Du symptôme à la cause probable, avec des vérifications concrètes avant toute réparation.
Guide des logs OpenSim et ROBUST
L’OAR semble chargé mais les textures manquent
Vérifiez si l’OAR a été créé avec --noassets, ou si --skip-assets a été employé lors du chargement. Contrôlez la disponibilité des UUID dans votre service assets et recherchez les avertissements dans les logs. Recommencez avec une archive complète si vous disposez des droits et des ressources.
Journaux à examiner : OpenSim.log de la région de destination et Robust.log sur une grille ; en Standalone, journal OpenSim seulement.
Messages à rechercher (indices, pas erreurs garanties) : Rechercher le nom de l'archive, UUID d'asset, erreurs de lecture/stockage et messages de chargement OAR ; les mots exacts varient selon la version.
Vérifications avant de modifier : Comparer les options de l'import/export et tester la récupération d'un UUID auprès du service assets, sans modifier les données.
Correction possible après confirmation : Si les assets ont réellement été exclus, réimporter une archive complète depuis une sauvegarde fiable, après protection du contenu cible.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'asset|oar|archive|exception|error' OpenSim.log | tail -n 80
Les constructions sont déplacées ou hors de la région
Vérifiez d’abord SizeX/SizeY de la région, puis les options --displacement et --rotation. Vérifiez les limites de la destination avant réimportation. Un OAR ne redimensionne pas le fichier Regions.ini à votre place.
Journaux à examiner : OpenSim.log au moment de l’import OAR.
Messages à rechercher (indices, pas erreurs garanties) : Repérer l'opération de chargement et les éventuels avertissements de dimensions ou d'objets ignorés.
Vérifications avant de modifier : Comparer tailles source/destination, déplacements, rotation et coordonnées dans Regions.ini.
Correction possible après confirmation : Refaire un essai sur une région de test avec les options corrigées après sauvegarde.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'oar|rotation|displacement|region|warn|error' OpenSim.log | tail -n 80
Le chargement a remplacé des objets
Une restauration sans --merge peut remplacer une partie importante du contenu cible. Arrêtez les modifications, conservez les logs et revenez à une sauvegarde pré-import. N’essayez pas de réparer un effacement par des fusions successives non contrôlées.
Journaux à examiner : OpenSim.log de la région concernée, logs de sauvegarde si disponibles.
Messages à rechercher (indices, pas erreurs garanties) : Chercher l'heure de l'import et les traces du chargement OAR ; vérifier les options réellement utilisées.
Vérifications avant de modifier : Déterminer si --merge était absent et inventorier les sauvegardes antérieures.
Correction possible après confirmation : Stopper les modifications ; restaurer uniquement depuis un point cohérent validé sur un environnement de test.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'oar|load|archive|error' OpenSim.log | tail -n 100
La sauvegarde IAR est incomplète
Vérifiez le chemin de l’inventaire, les options --exclude et --excludefolder, les filtres --perm et la présence d’assets cassés. L’option --skipbadassets peut exclure des éléments problématiques ; elle n’est pas équivalente à une réparation.
Journaux à examiner : OpenSim.log de l'instance traitant l'IAR et Robust.log si le service inventaire est distant.
Messages à rechercher (indices, pas erreurs garanties) : Chercher IAR, inventory, permission, asset, UUID et les erreurs de sérialisation.
Vérifications avant de modifier : Comparer le chemin inventaire demandé, le contenu exporté et les options d'exclusion.
Correction possible après confirmation : Refaire un export ciblé sans filtres non nécessaires ; ne pas considérer --skipbadassets comme une réparation.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'iar|inventory|asset|permission|error' OpenSim.log | tail -n 100
Les assets étaient absents de l’archive IAR
Un IAR créé avec --noassets conserve des références mais pas les données d’assets. La présence des mêmes assets sur le serveur cible conditionne le résultat. Réexportez avec assets depuis la source si elle est encore disponible.
Journaux à examiner : OpenSim.log au moment de l'export et lors de l'import ; Robust.log côté service assets si disponible.
Messages à rechercher (indices, pas erreurs garanties) : Rechercher IAR, asset not found, erreurs de récupération et UUID concernés ; le vocabulaire dépend de la version.
Vérifications avant de modifier : Inspecter les options de sauvegarde et vérifier si le service de destination possède les UUID.
Correction possible après confirmation : Exporter de nouveau avec les assets depuis la source si possible.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'iar|asset|not found|error' OpenSim.log | tail -n 100
La modification INI n’a aucun effet
Vérifiez que vous avez modifié le fichier actif et non un fichier .example. Recherchez les surcharges bin/config et les inclusions de config-include. Utilisez config show et contrôlez si un redémarrage est nécessaire.
Journaux à examiner : OpenSim.log de l'instance ciblée ; Robust.log si l'option concerne les services centraux.
Messages à rechercher (indices, pas erreurs garanties) : Chercher le chargement des fichiers de configuration, erreurs de parsing, clé ou section inconnue.
Vérifications avant de modifier : Comparer le fichier réellement chargé, les includes et la valeur effective via config show pour le simulateur.
Correction possible après confirmation : Corriger uniquement le fichier actif et redémarrer le composant si le paramètre exige une relecture.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'config|ini|error|warn' OpenSim.log | tail -n 80
La région prend beaucoup de mémoire
Mesurez l’évolution dans le temps et comparez l’activité. Contrôlez les caches, les scripts et les objets. Une valeur RSS élevée ne démontre pas à elle seule une fuite ; surveillez la croissance persistante à charge équivalente.
Journaux à examiner : OpenSim.log et journaux système (OOM, kill, swap) ; statistiques d'utilisation mémoire.
Messages à rechercher (indices, pas erreurs garanties) : Chercher OutOfMemory, memory, GC ou terminaison soudaine, mais ne pas conclure à une fuite sur un seul RSS.
Vérifications avant de modifier : Comparer RSS et activité au fil du temps, scripts, physique, cache et swap.
Correction possible après confirmation : Isoler le sous-système responsable avant réglage ou redémarrage ; conserver les métriques.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'memory|OutOfMemory|exception|fatal' OpenSim.log | tail -n 80 journalctl -k --since '1 hour ago' | grep -Ei 'oom|killed process|out of memory'
Une téléportation reste lente
Contrôlez les logs des deux régions, la résolution DNS, les services ROBUST, la base de données, les communications réseau et les appels aux modules. Évitez d’attribuer automatiquement le problème au moteur physique.
Journaux à examiner : OpenSim.log de la région source ET destination ; Robust.log sur une grille.
Messages à rechercher (indices, pas erreurs garanties) : Chercher horodatages de transfert, timeout, failed, destination, agent et exceptions.
Vérifications avant de modifier : Aligner les horloges, comparer les étapes et chronométrer la phase la plus lente.
Correction possible après confirmation : Corriger la couche fautive (réseau, services, région ou modules) plutôt que changer la physique au hasard.
Lecture seule : adapte les chemins, noms d'unité et valeurs.
grep -nEi 'teleport|transfer|timeout|exception|failed' OpenSim.log | tail -n 100