Dépanner une installation OpenSimulator
Diagnostic progressif : compilation, services, réseau, base de données et viewer.
Guide complet : lire les logs OpenSim / ROBUST
Échec de compilation .NET
Vérifiez la présence du SDK 8, pas seulement du runtime. Exécutez runprebuild.sh dans la racine du dépôt et contrôlez les erreurs de dotnet build. Ne mélangez pas des modules compilés pour une autre version.
Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.
dotnet --list-sdks ./runprebuild.sh dotnet build --configuration Release OpenSim.sln
Journaux à examiner : Console de compilation et sortie dotnet build ; aucune trace OpenSim.log n'est garantie tant que l'application n'a pas démarré.
Messages à rechercher (indices, pas erreurs garanties) : Repérer la première erreur de compilation, puis son projet et sa référence ; ne pas se limiter à la dernière erreur en cascade.
Vérifications avant de modifier : Vérifier SDK .NET, sortie runprebuild, révision source et DLL tierces.
Correction possible après confirmation : Corriger la cause initiale puis relancer la compilation, sans changer les dépendances à l'aveugle.
Fichier INI non pris en compte
Vérifiez qu'il s'agit d'un véritable OpenSim.ini ou Robust.ini, et pas d'un fichier .example, d'un fichier portant .txt ou d'un mauvais dossier bin. Les inclusions d'architecture doivent pointer vers les fichiers Common réellement créés.
Journaux à examiner : OpenSim.log ou Robust.log au démarrage, et sortie du gestionnaire de processus si l'application échoue avant journalisation.
Messages à rechercher (indices, pas erreurs garanties) : Chercher config, ini, parse, missing et la première exception liée à un fichier.
Vérifications avant de modifier : Contrôler l'architecture sélectionnée, les includes et le chemin de travail.
Correction possible après confirmation : Corriger le bon fichier INI ; si un changement exige un redémarrage, conserver le log précédent.
Connexion SQL refusée
Vérifiez service MySQL, hôte, utilisateur, droits, mot de passe, méthode d'authentification et journal MySQL. Les valeurs des templates ne conviennent pas directement à la production. Évitez de publier le mot de passe dans une capture.
Journaux à examiner : Robust.log pour les services centraux ; OpenSim.log pour la région ; journal MySQL/MariaDB.
Messages à rechercher (indices, pas erreurs garanties) : Chercher connection refused, authentication, access denied, timeout et l'erreur SQL initiale.
Vérifications avant de modifier : Comparer heure, hôte, port SQL, droits utilisateur, état de la base et réseau privé.
Correction possible après confirmation : Réparer la connexion ou le service fautif ; ne pas publier la base pour contourner le problème.
ROBUST démarre mais les régions ne s'enregistrent pas
Contrôlez l'accessibilité des URI privées depuis la machine de simulation, les constantes de GridCommon.ini, les ports, les services activés et les journaux des deux côtés.
Journaux à examiner : OpenSim.log de la région refusée ET Robust.log, pendant la même tentative d'enregistrement.
Messages à rechercher (indices, pas erreurs garanties) : Chercher grid service, region, register, refused, authentication, timeout et l'exception antérieure.
Vérifications avant de modifier : Contrôler GridServerURI, URI privées, DNS, pare-feu et disponibilité des connecteurs.
Correction possible après confirmation : Corriger l'URL ou le service en échec ; retester l'enregistrement sans multiplier les changements.
Adresse ou port inaccessible
Testez depuis une autre machine. La liaison à 0.0.0.0 ne suffit pas si ExternalHostName annonce un nom non résolu ou une adresse privée. N'ouvrez que les ports nécessaires, surtout ceux des régions et du login public.
Journaux à examiner : OpenSim.log de la région, Robust.log si l'URI publique/privée est impliquée ; pare-feu système.
Messages à rechercher (indices, pas erreurs garanties) : Chercher bind, address already in use, refused, timeout, unknown host.
Vérifications avant de modifier : Vérifier le socket réel, DNS, ExternalHostName, NAT et les flux TCP/UDP nécessaires.
Correction possible après confirmation : Ouvrir seulement les flux nécessaires et éliminer les conflits de port.
La connexion aboutit, mais l'avatar n'entre pas
Séparez l'authentification de la liaison à la région : login/ROBUST peut fonctionner alors que le port UDP de la région est bloqué, ou que la région est mal enregistrée. Comparez les horodatages des logs.
Journaux à examiner : Robust.log au moment de l'authentification et OpenSim.log de la région de destination.
Messages à rechercher (indices, pas erreurs garanties) : Chercher login, agent, presence, seed, caps, teleport, timeout et la première erreur.
Vérifications avant de modifier : Distinguer succès du login et échec d'entrée en région ; vérifier UDP, NAT et annonce externe.
Correction possible après confirmation : Corriger le flux ou le service réellement défaillant plutôt que réinitialiser l'avatar par défaut.
Hypergrid ne fonctionne pas
Vérifiez la configuration Gatekeeper et HomeURI, les noms publics et leur accessibilité réelle depuis une autre grille. Un simple changement Grid.ini vers GridHypergrid.ini ne suffit pas.
Journaux à examiner : OpenSim.log des régions d'origine/destination et Robust.log des grilles impliquées, si accessible.
Messages à rechercher (indices, pas erreurs garanties) : Chercher gatekeeper, useragent, home, teleport, refused, timeout et erreurs d'autorisation.
Vérifications avant de modifier : Contrôler URI, certificats s'ils sont utilisés, DNS, ports publics et modules HG.
Correction possible après confirmation : Corriger la configuration HG ou le routage ; tester les déplacements entrants et sortants.
Revenir à une configuration stable
Avant tout essai, sauvegardez les INI et la base, gardez une copie des DLL et vérifiez les sommes de contrôle si disponibles. Après un échec, revenez au jeu de fichiers cohérent précédent plutôt que de modifier simultanément plusieurs couches.
Journaux à examiner : Conserver les logs d'avant incident et les journaux des sauvegardes.
Messages à rechercher (indices, pas erreurs garanties) : Identifier la première modification corrélée à l'incident et les messages apparus ensuite.
Vérifications avant de modifier : Contrôler date, versions, intégrité et périmètre de sauvegarde.
Correction possible après confirmation : Restaurer un état cohérent après validation ; conserver les logs à des fins d'analyse.