Revision as of 07:02, 23 May 2021

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

bin/OpenSim.ini

La configuration Hypergrid est activée dans la section [Architecture] du fichier OpenSim.ini. Assurez-vous que la ligne Include-HGStandalone est la seule à être décommentée dans cette section :

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

bin/config-include/StandaloneCommon.ini

Le fichier StandaloneHypergrid.ini appellera ensuite le fichier StandaloneCommon.ini dans le même répertoire. C'est là que les paramètres Hypergrid seront inclus.

Cette configuration comprend trois étapes :

Étape 1 : Définir HomeURI et GatekeeperURI dans la section [Hypergrid].

Comme, en mode standalone (autonome) le simulateur et les services de grille sont exécutés dans le même processus, l'Hypergrid peut être configuré en mettant votre adresse accessible de l'extérieur dans la section [Hypergrid].

Par exemple dans

[Hypergrid]
  ; Décommentez les variables de cette section uniquement si vous 
  ; êtes en mode Hypergrid. Sinon, ignorez-les.
 
    ;# {HomeURI} {Hypergrid} {The Home URL of this world} {}
  ;; S'il s'agit d'un monde standalone, indiquez l'adresse de cette instance.
  ;; S'il s'agit d'un simulateur de grille,  indiquez  l'adresse du serveur 
  ;; robust externe qui exécute  UserAgentsService.
  ;; Par exemple http://myworld.com:9000 ou http://myworld.com:8002
  ;; Il s'agit d'une valeur par défaut qui peut être remplacée dans certaines sections.
  HomeURI = "http://127.0.0.1:9000"
 
    ;# {GatekeeperURI} {Hypergrid} {The URL of the gatekeeper of this world} {}
  ;; S'il s'agit d'un monde standalone, indiquez l'adresse de cette instance.
  ;; S'il s'agit d'un simulateurde grille, indiquez  l'adresse du serveur 
  ;; robust externe qui exécute le service Gatekeeper.
  ;; Par exemple http://myworld.com:9000 ou http://myworld.com:8002
  ;; Il s'agit d'une valeur par défaut qui peut être remplacée dans certaines sections.
  GatekeeperURI = "http://127.0.0.1:9000"

vous devez remplacer "127.0.0.1" par votre IP externe ou votre nom de domaine pleinement qualifié (FQDN). Par exemple, si votre FQDN était example.com, vos entrées seraient les suivantes

[Hypergrid]
  HomeURI = "http://example.com:9000"
  GatekeeperURI = "http://example.com:9000"

Étape 2 : Définir les adresses SRV_* dans [LoginService]

En plus des entrées [Hypergrid], les mêmes noms de domaine ou adresses IP doivent être définis dans la section [LoginService] de StandaloneCommon.ini.

Par exemple dans

[LoginService]
    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"

Toutes les entrées SRV_* doivent être remplacées par votre adresse IP accessible de l'extérieur ou votre nom de domaine pleinement qualifié (FQDN). Donc, encore une fois, si votre domaine était example.com, ces entrées deviennent

[LoginService]
    SRV_HomeURI = "http://example.com:9000"    
    SRV_InventoryServerURI = "http://example.com:9000"
    SRV_AssetServerURI = "http://example.com:9000"
    SRV_ProfileServerURI = "http://example.com:9000"
    SRV_FriendsServerURI = "http://example.com:9000"
    SRV_IMServerURI = "http://example.com:9000"

Etape 3 : Changer le port http_listener_port dans bin/OpenSim.ini si nécessaire

Le port 9000 est le port par défaut pour une standalone. Si vous souhaitez utiliser un autre port, vous devrez modifier les ports de cette section et le port HTTP utilisé par OpenSimulator dans la section [Network] d'OpenSim.ini.

[Network]
    http_listener_port = 9000

Grille

Grille et Standalone

Enfin, toutes vos régions doivent utiliser la même adresse externe qui est définie pour GatekeeperService, par exemple :

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

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

Accès

Si les utilisateurs doivent accéder à votre installation Hypergrid depuis l'extérieur de votre réseau local, ils doivent être en mesure d'atteindre tous les ports et adresses nécessaires. Pour une installation domestique, cela signifie que les requêtes TCP et UDP doivent être transférées à travers votre routeur et tout pare-feu installé. Voir Paramètres réseau pour les ports et adresses requis.

Si vous ou d'autres utilisateurs doivent également accéder à votre installation Hypergrid à partir du même réseau local, ils doivent également être en mesure de résoudre le nom d'hôte externe, même s'il s'agit d'une adresse Internet (WAN) plutôt que d'une adresse LAN. Tous les routeurs n'ont pas cette capacité. Pour plus d'informations à ce sujet, veuillez consulter Routeurs NAT Loopback.

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