Installing and Running Hypergrid/fr

= 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.'''

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 :

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

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

É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

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

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.

Grille
Pour activer l'hypergrid pour une grille, le serveur Robust et les serveurs de région (simulateurs) doivent être configurés de manière appropriée.

OpenSim.ini
Dans la section [Const], vous pouvez définir les constantes qui seront utilisées tout au long des fichiers de configuration du simulateur :

Les serveurs de région (simulateurs) qui se connectent au serveur Robust lisent leur configuration dans le fichier OpenSim.ini. Pour activer l'hypergrid pour ces serveurs, il faut décommenter la ligne appropriée dans la section [Architecture] de OpenSim.ini :

Dans le fichier config-include/GridCommon.ini
Dans la section [Hypergrid] les adresses réseau des sections suivantes doivent être remplacées par votre adresse réseau externe. Vous pouvez également utiliser les constantes définies dans la section [Const]:

Certaines options doivent ou peuvent être définie dans les autres sections :

Services Robust
Le serveur Robust doit être démarré avec le fichier de configuration Robust.HG.ini au lieu de Robust.ini. Si ce fichier n'existe pas encore dans votre installation, créez-le en faisant une copie de Robust.HG.ini.example. Apportez les modifications appropriées à votre environnement (par exemple, ajustez la chaîne de connexion à la base de données). Pour hypergrid, les paramètres suivants sont pertinents.

Si vous souhaitez modifier le(s) port(s) utilisé(s) avec ces adresses, vous devrez modifuer ces ports dans les paramètres PublicPort et PrivatePort de la section [Const].

Note : seuls les configurations à options concernant l'Hypergrid sont mentionnées ci-dessous, pour plus d'informations, veuillez vous référer au fichier Robust.HG.ini.example.

Section Const
Vous pouvez indiquer dans cette section des constantes qui pourront être utilisées tout au long du fichier Robust.HG.ini

Section Hypergrid
ans la section [Hypergrid] les adresses réseau des sections suivantes doivent être remplacées par votre adresse réseau externe. Vous pouvez également utiliser les constantes définies dans la section [Const]:

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

Dans les autres sections du fichier Robust.HG.ini, certaines options concernant l'Hypergrid doivent ou peuvent être définies dans les autres sections. Ce sont par exemple :
 * la région hypergrid par défaut de la grille,
 * l'activation des groupes pour l'hypergrid,
 * le choix de la version utilisée pour l'hypergrid,
 * l'utilisation du système de gestion d'assets Fsassets,
 * les limites d'exportation et d'importation d'assets en fonction de leur type.

Lancer le serveur Robust
Après ces ajustements, le serveur Robust peut être démarré. Sur Windows/.NET : Robust -inifile=Robust.HG.ini Ou, avec Mono (par exemple sur Linux ou OSX) : mono Robust.exe -inifile=Robust.HG.ini

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

= 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 :

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 : 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 :

Pour finir, les régions doivent être configurées en fonction des changements effectués (adresse et ports). Voir.

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 : Dans GridCommon.ini les adresses internet dessections suivantes doivent être remplacées par votre adresse de réseau externe :

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 :

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: 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.

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

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 :

Pour la dernière étape, les régions doivent être configurées conformément aux changements précédents. Voir.

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 :

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

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 :

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 : 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