OpenSimulator · FR

ROBUST : comprendre tous les services centraux

Fonctions, connecteurs, dépendances, accès publics/privés et lecture croisée des journaux.

Ces procédures illustrent des cas courants d’administration OpenSimulator. Vérifiez les paramètres de votre version et préparez une sauvegarde avant toute modification.

ROBUST n'est pas un simulateur

ROBUST centralise notamment comptes, authentification, inventaire, assets et grille ; les instances OpenSim hébergent les régions. Un login réussi n'assure pas la disponibilité des inventaires ou du stockage d'assets. Consultez les connecteurs réellement activés dans [Startup].

PublicPort et PrivatePort

Les modèles Robust.ini.example et Robust.HG.ini.example présentent 8002 comme port public et 8003 comme privé. Ce sont des valeurs d'exemple et non des obligations. Le port privé transporte des connecteurs internes et ne doit être accessible qu'aux simulateurs et services autorisés ; le port public peut héberger login et Gatekeeper selon la configuration.

GridService

Répertorie les régions, leurs coordonnées et leur inscription dans la grille. Si une région ne s'enregistre pas, lisez OpenSim.log et Robust.log, puis vérifiez GridServerURI, ports privés, DNS et erreurs de service. Ne changez pas les coordonnées d'une région en production sans prendre en compte ses voisins et téléports.

AssetService et InventoryService

AssetService fournit les données d'assets tandis qu'InventoryService gère leur organisation dans les inventaires. Une entrée d'inventaire peut exister même quand les données d'asset sont absentes. Si vous utilisez FSAssets, les métadonnées SQL et le volume de fichiers doivent être cohérents.

UserAccountService et AuthenticationService

UserAccountService gère les comptes et leurs attributs ; AuthenticationService vérifie les informations d'authentification. Une erreur de mot de passe n'implique pas automatiquement une panne du service de grille. Consultez d'abord le journal et identifiez quel connecteur répond.

LoginService, PresenceService et GridUserService

LoginService gère l'entrée des viewers. PresenceService suit les présences, GridUserService conserve des informations sur l'état et les emplacements des utilisateurs. Pour une connexion bloquée, distinguez authentification réussie, présence, région de destination et transfert au simulateur.

AvatarService, AgentPreferencesService et FriendsService

Ces services couvrent respectivement les informations d'avatar, les préférences d'agent et les relations entre amis. Des problèmes d'apparence ou de contacts peuvent provenir des services centraux comme des modules régionaux ; vérifiez les logs des deux côtés.

EstateService et MapImageService

EstateService maintient les informations de domaine et propriétaires ; MapImageService traite les cartes de grille. Une carte absente n'est pas nécessairement une panne de GridService : contrôlez la génération régionale des maptiles, les transferts et les connecteurs concernés.

Hypergrid : Gatekeeper, UserAgent, HG services

Robust.HG.ini.example ajoute les connecteurs publics Gatekeeper, UserAgent, HG assets, inventaire et amis. Ces services permettent les échanges intergrilles et doivent être configurés comme un ensemble. Leurs URL publiques ne doivent pas être confondues avec l'API privée ROBUST.

Ordre de démarrage et diagnostics

Lors d'une mise en service, démarrez ROBUST et attendez que les connecteurs nécessaires soient prêts avant d'initialiser les régions. Vérifiez la première erreur pertinente dans Robust.log puis dans OpenSim.log. Le redémarrage ne remplace pas la correction de la cause initiale.

Exemple à adapter et à vérifier sur une instance de test.

grep -nEi 'ERROR|FATAL|exception|refused|timeout' /chemin/vers/Robust.log | tail -n 100
# Sur le serveur de régions :
grep -nEi 'grid|register|asset|inventory|timeout' /chemin/vers/OpenSim.log | tail -n 100

Plusieurs instances et haute disponibilité

Ne partez pas du principe que lancer deux processus ROBUST sur les mêmes fichiers transforme la grille en installation hautement disponible. Certaines fonctions ou écrivains, notamment FSAssets, nécessitent des règles SecondaryInstance ou une architecture de stockage partagée vérifiée. Documentez le service propriétaire de chaque écriture.

Tracer une panne de bout en bout

Pour un asset manquant, partez du viewer puis de la région, du connecteur AssetService, de ROBUST, du service SQL et enfin du disque FSAssets s'il est utilisé. Pour une téléportation, partez des deux logs de région puis des services de grille. Les messages d'erreur doivent guider la vérification.

Pour aller plus loin

Code source et références