OpenSimulator · FR

Installer une grille OpenSimulator avec ROBUST

Séparer les services centraux ROBUST, les données et les simulateurs de régions.

Parcours pédagogique pour OpenSimulator 0.9.3.1 / .NET 8. Adaptez les domaines, les secrets, les versions et les ports à votre installation. Vérifiez toujours les sources avant la production.

Schéma de fonctionnement

Le viewer se connecte aux services de connexion de la grille ; ROBUST fournit les services centraux et les simulateurs hébergent les régions. ROBUST et OpenSim peuvent être sur la même machine ou sur des hôtes différents, mais les URL publiques et privées doivent rester cohérentes.

Préparer l'infrastructure

Prévoyez DNS du service de grille, adresses privées entre ROBUST et simulateurs, la base SQL, les sauvegardes et les ports des régions. Notez les IP sortantes réelles et les règles réseau. Ne publiez pas les services internes par simplicité.

Déployer les binaires compatibles

Installez et compilez la même base OpenSimulator .NET 8 pour ROBUST et les simulateurs. Lors de mises à jour, gardez compatibles les modules et vérifiez qu'une DLL d'une autre version ne remplace pas un composant sans validation.

Préparer MySQL

Pour une grille durable, préparez une base et un compte SQL dédiés, avec autorisations limitées et accès restreint au réseau privé. Le modèle ROBUST utilise la section [DatabaseService] avec StorageProvider et ConnectionString. Ne publiez pas MySQL sur Internet.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

CREATE DATABASE opensim CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'opensim'@'localhost' IDENTIFIED BY 'REPLACE_WITH_STRONG_SECRET';
GRANT ALL PRIVILEGES ON opensim.* TO 'opensim'@'localhost';
-- Pour un serveur SQL distant, adaptez l'hôte et les restrictions réseau.

Créer Robust.ini

Copiez Robust.ini.example vers Robust.ini et personnalisez [Const], [DatabaseService], les connecteurs et les services. Le modèle contient PublicPort=8002 et PrivatePort=8003 : ce sont des valeurs du modèle, pas une obligation pour toutes les grilles. Assurez-vous que le port privé n'est pas ouvert à Internet.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

cd bin
test ! -e Robust.ini && cp Robust.ini.example Robust.ini

Comprendre les constantes ROBUST

BaseHostname désigne l'adresse du serveur, BaseURL sa base HTTP/HTTPS et PublicPort/PrivatePort les ports de services du modèle. Vérifiez les usages des constantes dans chaque section au lieu de changer seulement le port du login.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

[Const]
BaseHostname = "grid.example.org"
BaseURL = "http://${Const|BaseHostname}"
PublicPort = "8002"
PrivatePort = "8003"

Démarrer ROBUST d'abord

Lancez ROBUST avant les régions, depuis son dossier bin, en indiquant explicitement Robust.ini. Attendez l'initialisation des services et vérifiez les journaux. Une page de login ne prouve pas que les services assets et inventaire sont fonctionnels.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

cd bin
dotnet Robust.dll -inifile=Robust.ini

Configurer OpenSim.ini pour Grid

Sur chaque simulateur, copiez OpenSim.ini.example et GridCommon.ini.example vers leurs noms actifs. Dans [Architecture], choisissez Grid.ini ou GridHypergrid.ini (uniquement si votre grille est configurée pour Hypergrid). Ne mélangez pas Standalone.ini et Grid.ini.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

cd bin
test ! -e OpenSim.ini && cp OpenSim.ini.example OpenSim.ini
test ! -e config-include/GridCommon.ini && cp config-include/GridCommon.ini.example config-include/GridCommon.ini
# Dans OpenSim.ini :
[Architecture]
Include-Architecture = "config-include/Grid.ini"

Relier les simulateurs à ROBUST

Les URI de GridCommon.ini (assets, inventaire, grid, avatar, etc.) doivent pointer vers les services ROBUST réels. Le modèle utilise des constantes PrivURL, PrivatePort, BaseURL et PublicPort. Les URL privées doivent être routables depuis les simulateurs, y compris si ROBUST est sur une autre VM.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

[AssetService]
AssetServerURI = "${Const|PrivURL}:${Const|PrivatePort}"
[InventoryService]
InventoryServerURI = "${Const|PrivURL}:${Const|PrivatePort}"
[GridService]
GridServerURI = "${Const|PrivURL}:${Const|PrivatePort}"

Créer la première région

Chaque région requiert un RegionUUID unique, des coordonnées compatibles, un InternalPort non conflictuel et un ExternalHostName joignable depuis le viewer. Vérifiez port TCP/UDP, pare-feu et NAT. Un même numéro de port ne doit pas être attribué à plusieurs processus concurrents sur la même adresse.

Démarrer le simulateur et vérifier

Après l'initialisation complète de ROBUST, lancez OpenSim depuis bin, créez une région et assurez-vous qu'elle s'enregistre. Le bon ordre simplifie le diagnostic, mais un redémarrage manuel n'est pas une solution aux erreurs persistantes de connexion.

Exemple à adapter : vérifiez les chemins, domaines, droits et paramètres.

cd bin
./opensim.sh
# Dans la console du simulateur :
show region
stats show

Hypergrid : variante, pas une case magique

Les fichiers GridHypergrid.ini et Robust.HG.ini.example décrivent une architecture supplémentaire avec Gatekeeper, HomeURI et UserAgentService. Vérifiez DNS, routes, adresses annoncées, permissions et configuration des services avant d'activer Hypergrid. Ce parcours Grid simple ne configure pas automatiquement Hypergrid.

Sécurité et sauvegardes

Séparez les secrets SQL, protégez les ports ROBUST privés, sauvegardez les données, assets et configurations avant chaque mise à jour. Faites un test de restauration sur une grille de validation avant toute modification majeure.

Étapes suivantes et références

Configurer Hypergrid : ROBUST HG, Gatekeeper et HomeURI

Réseau, ports TCP/UDP, DNS et pare-feu