Installation et fonctionnement de l'Hypergrid

Cette page décrit la configuration de l'Hypergrid dans le cadre d'une architecture standalone ou d'une architecture grille d'OpenSimulator.

Avant OpenSimulator 0.7.6, les entrées HomeURI et Gatekeeper devaient être ajoutées séparément dans les sections de configuration des modules individuels et des services.

Cependant, il existe maintenant un moyen plus pratique de le faire en configurant ces paramètres une seule fois dans la nouvelle section [Hypergrid] des fichiers de configuration appropriés (par exemple bin/config-include/StandaloneCommon.ini pour l'architecture standalone et bin/config-include/GridCommon.ini et bin/Robust.HG.ini pour l'architecture de grille).

Vous trouverez ci-dessous des instructions spécifiques pour l'utilisation de l'architecture standalone et pour l'utilisation de l'architecture en mode grille. Pour terminer, une section est dédiée aux actions qui doivent être effectuées pour les deux types d'architectures.

Note : Dans la version française de cette page, les commentaires inclus dans les extraits de fichiers de configuration ont été traduits. Dans les fichiers ini d'OpenSimlulator ils seront en anglais.

Standalone

Grille

Grille et Standalone

Accès

Références complémentaires

Installation et fonctionnement : instructions pour versions précédentes

Pour qu'OpenSimulator soit accessible dans l'hypergrid, vous devez utiliser une adresse IP externe visible ou un nom de domaine. Vous aurez également besoin de rediriger tous les portq (TCP et UDP) qu'OpenSimulator et les régions du simulateur utilisent. Généralement, ce sera le port 8002 pour une installation en mode grille et le port 9000 pour le mode standalone. Habituellement, les régions utilisent les ports à partir de 9000. Pour plus d'informations, voir Network Settings.

Standalone

La configuration pour l'hyopergrid est activée dans la section [Architecture] du fichier OpenSim.ini. Assurez-vous que la ligne Include-HGStandalone soit la seule ligne décommentée dans cette section :

[Architecture]
    ;Include-Standalone    = "config-include/Standalone.ini"
    Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
    ;Include-Grid         = "config-include/Grid.ini"
    ;Include-HGGrid       = "config-include/GridHypergrid.ini"
    ;Include-SimianGrid   = "config-include/SimianGrid.ini"

Dans le fichier StandaloneCommon.ini l'adresse internet des sections suivantes doit être remplacée par celle de votre propre adresse de réseau externe :

[HGInventoryService]
    ProfileServerURI = "http://127.0.0.1:9000/profiles"
 
[HGAssetService]
    ProfileServerURI = "http://127.0.0.1:9000/profiles"
 
[HGInventoryAccessModule]
    ProfileServerURI = "http://127.0.0.1:9000/profiles"
    Gatekeeper = "http://127.0.0.1:9000"
 
[GridService]
    Gatekeeper = "http://127.0.0.1:9000"
 
[Messaging]
    Gatekeeper = "http://127.0.0.1:9000"
 
[LoginService]
    ; ... (other settings in this section) ...
    GatekeeperURI = "http://127.0.0.1:9000"
 
    SRV_HomeURI = "http://127.0.0.1:9000"
    SRV_InventoryServerURI = "http://127.0.0.1:9000"
    SRV_AssetServerURI = "http://127.0.0.1:9000"
    SRV_ProfileServerURI = "http://127.0.0.1:9000"
    SRV_FriendsServerURI = "http://127.0.0.1:9000"
    SRV_IMServerURI = "http://127.0.0.1:9000"
 
[GatekeeperService]
    ; ... (other settings in this section) ...
    ExternalName = "http://example.com:9000"

Si vous voulez utiliser un port différent pour votre adresse, vous devez remplacer le port d'écoute HTTP dans le section [Network] dans le fichier OpenSim.ini par le port que vous aurez associé à votre adresse :

[Network]
    ; ... (other settings in this section) ...
    http_listener_port = 9000

Pour finir, les régions doivent être configurées en fonction des changements effectués (adresse et ports). Voir #Region Setup for both Grid and Standalone.

Grille

Pour activer l'hypergrid en mode Grille, le serveur Robust et les serveurs de région (simulateurs) doivent être configurés de façon appropriée.

Les simulateurs

Les serveurs de région (simulateurs) qui sont connectés au serveur Robust lisent leur configuration dans le fichier OpenSim.ini. Pour activer l'hypergrid pour ces serveurs la ligne Include-HGGrid dans la section [Architecture] doit être décommantée :

[Architecture]
    ;Include-Standalone    = "config-include/Standalone.ini"
    ;Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
    ;Include-Grid         = "config-include/Grid.ini"
    Include-HGGrid       = "config-include/GridHypergrid.ini"
    ;Include-SimianGrid   = "config-include/SimianGrid.ini"

Dans GridCommon.ini les adresses internet dessections suivantes doivent être remplacées par votre adresse de réseau externe :

[GridService]
    ; === HG ONLY === 
    ;; Change this to the address of your Gatekeeper service
    ;; (usually bundled with the rest of the services in one 
    ;; Robust server in port 8002, but not always)
    Gatekeeper="http://mygridserver.com:8002"
 
[Messaging]
    ; === HG ONLY === 
    ;; Change this to the address of your Gatekeeper service
    ;; (usually bundled with the rest of the services in one 
    ;; Robust server in port 8002, but not always)
    Gatekeeper = "http://mygridserver.com:8002"
 
[HGInventoryAccessModule]
    ;
    ; === HG ONLY ===
    ; Change this to your server
    ; accessible from other grids
    ;
    ProfileServerURI = "http://mygridserver.com:8002/user"
    Gatekeeper = "http://mygridserver.com:8002"
 
[UserAgentService]
    ;
    ; === HG ONLY ===
    ; Change this to your user agent server (HG robust)
    ;
    UserAgentServerURI = "http://mygridserver.com:8002"

Serveur Robust

Le serveur Robust va démarrer en utilisant le fichier de configuration Robust.HG.ini à la place de Robust.ini. Si ce fichier n'existe pas dans votre installation, créez le en faisant une copie de Robust.HG.ini.example. Réalisez les modifications appropriée pour votre environnement (par exemple adaptez la chaîne de connexion de la base de données). Pour l'hypergrid, utilisez la configuration suivante :

[LoginService]
    GatekeeperURI = "http://127.0.0.1:8002"
 
    SRV_HomeURI = "http://127.0.0.1:8002"
    SRV_InventoryServerURI = "http://127.0.0.1:8002"
    SRV_AssetServerURI = "http://127.0.0.1:8002"
    SRV_ProfileServerURI = "http://127.0.0.1:8002/user"
    SRV_FriendsServerURI = "http://127.0.0.1:8002"
    SRV_IMServerURI = "http://127.0.0.1:8002"
 
[GatekeeperService]
    ; ... (other settings in this section) ...
    ExternalName = "http://127.0.0.1:8002"
 
[HGInventoryService]
    ProfileServerURI = "http://127.0.0.1:8002/user"
 
; * The interface that local users get when they are in other grids.
; * This restricts the access that the rest of the world has to
; * the assets of this world.
; *
[HGAssetService]
    ProfileServerURI = "http://127.0.0.1:8002/user"

Si vous voulez modifier le(s) port(s) utilisez avec les adresses, vous devrez aussi modifier le port de façon appropriée pour le paramètre 'ServiceConnectors' dans la section [Startup] et probablement le port configuré dans la section [Network].

Après avoir réalisé ces ajustements, le serveur Robust peut être redémarré. Pour Windows/.NET:

Robust -inifile=Robust.HG.ini

Ou avec Mono (sous Linux ou OSX):

mono Robust.exe -inifile=Robust.HG.ini

Configuration de la région en mode Grille et en mode Standalone

Pour finir, toutes les régions doivent utiliser l'adresse externe indiquée pour GatekeeperService, par exemple:

[Region One]
    ; ... (other settings in this section) ...
    ExternalHostName = "example.com"

Les ports utilisés par vos régions doivent tous être redirigés et ouvert dans le pare-feu qui sécurise votre installation pour TCP et UDP.

La limite 4096 des régions

En raison d'un probmème de viewer, il n'est pas possible de se téléporter vers des destinations supérieures à 4096 régions dans une direction. La plupart des viewers appliqueront la téléportation mais la destination ne sera par rendue et ainsi sera invisible.En pratique, cela signifie que si vous désirez vous téléporter depuis une région dont les coordonnées sont (1000, 1000) vous ne pourrez pas aller plus loin que (5095, 5095). Pour atteindre une destination plus éloignée, vous devrez soit placer votre propre région plus près de la destination, ou utiliser des régions intermédiaires qui pourront atteindre votre région et la région de destination.

Référez-vous à Public Hypergrid Nodes pour connaître la localisation de quelques standalones et grilles connues.

Configuration à partir de la version OpenSimulator 0.7.3

Il y a quelques changements mineurs dans la configuration d'hypergrid entre OpenSimulator 0.7.3 et 0.7.2. Par rapport à la 0.7.2, les parametres ProfileURI deviennent les parametres HomeURI et perdent leurs extensions (ex: ProfileServerURI = "http://127.0.0.1:9000/profiles" dans [HGInventoryService] dans StandaloneCommon.ini devient HomeURI = "http://127.0.0.1:9000"

Standalone

La configuration pour hypergrid est activée dans la section [Architecture] dans le fichier OpenSim.ini. Assurez vous que la ligne Include-HGStandalone soir la seule à ne pas être commentée.

[Architecture]
    ;Include-Standalone    = "config-include/Standalone.ini"
    Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
    ;Include-Grid         = "config-include/Grid.ini"
    ;Include-HGGrid       = "config-include/GridHypergrid.ini"
    ;Include-SimianGrid   = "config-include/SimianGrid.ini"

Dans StandaloneCommon.ini les adresses réseau de la section suivante peuvent être changées pour votre adresse externe de réseau :

[HGInventoryService]
    HomeURI = "http://127.0.0.1:9000"
 
[HGAssetService]
    HomeURI = "http://127.0.0.1:9000"
 
[HGInventoryAccessModule]
    HomeURI = "http://127.0.0.1:9000"
    Gatekeeper = "http://127.0.0.1:9000"
 
[GridService]
    Gatekeeper = "http://127.0.0.1:9000"
 
[Messaging]
    Gatekeeper = "http://127.0.0.1:9000"
 
[LoginService]
    ; ... (autres réglages dans cette section) ...
    GatekeeperURI = "http://127.0.0.1:9000"
 
    SRV_HomeURI = "http://127.0.0.1:9000"
    SRV_InventoryServerURI = "http://127.0.0.1:9000"
    SRV_AssetServerURI = "http://127.0.0.1:9000"
    SRV_ProfileServerURI = "http://127.0.0.1:9000"
    SRV_FriendsServerURI = "http://127.0.0.1:9000"
    SRV_IMServerURI = "http://127.0.0.1:9000"
 
[GatekeeperService]
    ; ... (autres réglages dans cette section) ...
    ExternalName = "http://1270.0.1:9000"

Si vous voulez utiliser un port différent avec ces adresses, vous devez alors aussi ajuster le port du listener HTTP dans la section [Network] dans OpenSim.ini :

[Network]
    ; ... (other settings in this section) ...
    http_listener_port = 9000

Pour la dernière étape, les régions doivent être configurées conformément aux changements précédents. Voir #Region Setup for both Grid and Standalone.

Grille

Pour activer hypergrid pour une grille, le serveur Robust et le serveur de région (simulateur) doivent être configurés de façon à être compatibles.

Simulateur

Les serveurs de régions (simulateurs) qui se connectent au serveur Robust lisent leur configuration depuis le fichier OpenSim.ini. Pour leur activer hypergrid, la ligne contenant Include-HGGrid dans la section [Architecture] doit être dé-commentée :

[Architecture]
    ;Include-Standalone    = "config-include/Standalone.ini"
    ;Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
    ;Include-Grid         = "config-include/Grid.ini"
    Include-HGGrid       = "config-include/GridHypergrid.ini"
    ;Include-SimianGrid   = "config-include/SimianGrid.ini"

Dans GridCommon.ini les adresses réseau dans les sections suivantes doivent être changées pour votre adresse externe de réseau :

[GridService]
    ; === HG ONLY === 
    ;; Changez ceci pour l'adresse de votre service Gatekeeper
    ;; (habituellement inclus avec les autres services dans un
    ;; serveur Robust sur le port 8002, mais pas tout le toujours)
    Gatekeeper="http://mygridserver.com:8002"
 
[Messaging]
    ; === HG ONLY === 
    ;; Changez ceci pour l'adresse de votre service Gatekeeper
    ;; (habituellement inclus avec les autres services dans un
    ;; serveur Robust sur le port 8002, mais pas tout le toujours)
    Gatekeeper = "http://mygridserver.com:8002"
 
[HGInventoryAccessModule]
    ;
    ; === HG ONLY ===
    ; Changez ceci pour votre serveur
    ; accessible de puis les autres grilles
    ;
    HomeURI = "http://mygridserver.com:8002"
    Gatekeeper = "http://mygridserver.com:8002"
 
[UserAgentService]
    ;
    ; === HG ONLY ===
    ; Changez ceci pour votre serveur de user agent (HG robust)
    ;
    UserAgentServerURI = "http://mygridserver.com:8002"

Serveur Robust

Le serveur Robust est démarré& avec le fichier de configuration Robust.HG.ini à la place de Robust.ini. Si ce fichier n'existe pas dasn votre installation, créez le en effectuant une copie de Robust.HG.ini.example. Effectuez les changements appropriés à votre environnement (ex: ajustez la connexion à la base de données). Pour hypergrid, les réglages suivants sont pertinents :

[LoginService]
    GatekeeperURI = "http://127.0.0.1:8002"
 
    SRV_HomeURI = "http://127.0.0.1:8002"
    SRV_InventoryServerURI = "http://127.0.0.1:8002"
    SRV_AssetServerURI = "http://127.0.0.1:8002"
    SRV_ProfileServerURI = "http://127.0.0.1:8002/user"
    SRV_FriendsServerURI = "http://127.0.0.1:8002"
    SRV_IMServerURI = "http://127.0.0.1:8002"
 
[GatekeeperService]
    ; ... (autres réglages dans cette section) ...
    ExternalName = "http://127.0.0.1:8002"
 
[HGInventoryService]
    HomeURI = "http://127.0.0.1:8002"
 
; * L'interface qu'obtiennent les utilisateurs locaux quand ils sont sur une autre grille.
; * Ceci restreint l'acces qu'a le reste du monde sur
; * les assets de ce monde.
; *
[HGAssetService]
    HomeURI = "http://127.0.0.1:8002"

Si vous voulez changer le(s) port(s) utilisés pour ces adresses, vous allez aussi devoir ajuster les ports dans la parametre 'ServiceConnectors' dans la section [Startup] et probablement le port configuré dans la section [Network] bien évidemment.

Apres ces ajustements, le serveur Robust peut être démarré. Sur Windows/.NET:

Robust -inifile=Robust.HG.ini

Ou, avec Mono (ex: sur Linux ou OSX):

mono Robust.exe -inifile=Robust.HG.ini

Configuration de la région en mode Grille et en mode Standalone

Finalement, toutes vos régions doivent utiliser la même adresse externe que celle définir pour le GatekeeperService, par exemple :

[Region One]
    ; ... (autres réglages dans cette section) ...
    ExternalHostName = "example.com"

Pour les ports qui sont utilisés pour vos régions, les requêtes TCP et UDP doivent être transférées à travers un pare feu ce qui sécurise votre réseau

Installer et faire marcher l'hypergrid pour OpenSimulator 0.6.9

Installing and Running Hypergrid On OpenSimulator 0.6.9

Références supplémentaires

Fonctions osFunctions implémentées: OSSL Implemented

Activer osFunctions: OSSL Enabling Functions

Sécurité HyperGrid: Hypergrid Security

Bannir les utilisateurs étrangers dans Hypergrid: Banning Foreign Users in Hypergrid

Liste de noeuds hypergrid publics: Public Hypergrid Nodes

Acces à l'inventaire par hypergrid: Hypergrid Inventory Access (proposal)

CATEGORIE: Hypergrid