OpenSimulator · FR

Installer et configurer Hypergrid

Gatekeeper, HomeURI, inventaire suitcase, fichiers d'architecture, réseau et tests entre grilles.

Exemples vérifiés contre les fichiers de configuration du fork OpenSimulator 0.9.3.1 / .NET 8. Les domaines, IP, ports et règles sont à adapter. Ne changez pas un serveur en production sans sauvegarde.

Comprendre Hypergrid

Hypergrid permet à un avatar de visiter une autre installation OpenSimulator tout en conservant son compte sur sa grille d'origine. Il ne transforme pas deux grilles en une seule base d'utilisateurs. Les services d'identité, Gatekeeper et inventaire doivent être accessibles entre grilles.

Préparer l'accès réseau

Avant d'activer Hypergrid, vérifiez un nom DNS public stable, une URL publique utilisable depuis les autres grilles, les règles NAT et la résolution DNS depuis l'extérieur. L'accès au service public ROBUST ne doit pas être confondu avec les services privés ou le trafic UDP des régions.

Standalone Hypergrid : architecture

Sur une installation Standalone existante, sauvegardez OpenSim.ini. Dans [Architecture], sélectionnez StandaloneHypergrid.ini et non Standalone.ini. Gardez StandaloneCommon.ini : son [Hypergrid] doit contenir HomeURI et GatekeeperURI selon les services réellement hébergés. Le simple changement de ligne n'assure pas que le réseau est correctement configuré.

Exemple à adapter : pas une commande universelle à appliquer sans vérification.

[Architecture]
Include-Architecture = "config-include/StandaloneHypergrid.ini"

; Dans config-include/StandaloneCommon.ini :
[Hypergrid]
HomeURI = "http://world.example.org:9000"
GatekeeperURI = "http://world.example.org:9000"

Grid Hypergrid : fichiers à associer

Pour une grille distribuée, sélectionnez GridHypergrid.ini sur les simulateurs et utilisez un fichier ROBUST HG cohérent, issu de Robust.HG.ini.example. Ces deux configurations sont complémentaires : les modules de région HG ne suffisent pas si Gatekeeper et UserAgent ne sont pas exposés par ROBUST.

Exemple à adapter : pas une commande universelle à appliquer sans vérification.

; Sur chaque simulateur, dans OpenSim.ini :
[Architecture]
Include-Architecture = "config-include/GridHypergrid.ini"

; Sur ROBUST : copier et adapter Robust.HG.ini.example
; puis démarrer ROBUST avec ce fichier INI.

Configuration ROBUST HG et services publics

Robust.HG.ini.example place les services publics sur 8002 et les services privés sur 8003. Parmi les connecteurs HG publics figurent GatekeeperServiceInConnector, UserAgentServerConnector, HeloServiceInConnector, HGFriendsServerConnector, InstantMessageServerConnector, HGInventoryServiceConnector et HGAssetServiceConnector. Ne copiez pas aveuglément les exemples : vérifiez vos ports et les sections actives.

Exemple à adapter : pas une commande universelle à appliquer sans vérification.

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

HomeURI et GatekeeperURI : deux rôles distincts

HomeURI désigne le service d'origine/identité de l'avatar. GatekeeperURI désigne l'entrée Hypergrid vers le monde. Ils peuvent être sur la même URL lorsque les services sont regroupés, mais ce ne sont pas des paramètres interchangeables. Adaptez les sections [Hypergrid] à votre architecture et validez depuis une autre grille.

Exemple à adapter : pas une commande universelle à appliquer sans vérification.

[Hypergrid]
HomeURI = "http://grid.example.org:8002"
GatekeeperURI = "http://grid.example.org:8002"

Inventaire des voyageurs et suitcase

StandaloneHypergrid.ini référence notamment HGInventoryBroker et HGSuitcaseInventoryService. Le mode d'inventaire intergrilles est différent du simple service d'inventaire local. Ne désactivez pas ou remplacez ces services sans connaître l'impact sur les avatars visiteurs.

Configuration des régions

Les régions doivent annoncer un ExternalHostName et un InternalPort cohérents avec les adresses et ports réellement accessibles. La connexion des visiteurs entre grilles peut atteindre Gatekeeper, puis échouer au téléport si les ports de région ou l'adresse externe annoncée sont incorrects.

Exemple à adapter : pas une commande universelle à appliquer sans vérification.

[MaRegion]
RegionUUID = 11111111-2222-3333-4444-555555555555
InternalAddress = 0.0.0.0
InternalPort = 9000
ExternalHostName = region.example.org

Tester dans les deux sens

Testez d'abord la connexion locale et les téléports internes. Puis, depuis un avatar sur une autre grille, tentez la visite entrante ; ensuite testez une visite sortante. Contrôlez nom, apparence, inventaire transportable, retour au domicile et journaux des deux grilles. Une seule visite réussie ne valide pas toutes les fonctions HG.

Sécurité et limites

Une grille Hypergrid accepte du trafic provenant d'administrations distinctes. Évitez d'exposer le port ROBUST privé et la base SQL ; protégez l'inventaire, contrôlez les permissions des régions et conservez des sauvegardes. Ne supposez jamais que tous les scripts ou contenus distants sont fiables.

Sources détaillées