Installing and Running Hypergrid/fr
From OpenSimulator
(→Installer et faire marcher OpenSimulator en mode Hypergrid) |
|||
(12 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
+ | |||
+ | {{Quicklinks|Installing_and_Running_Hypergrid}} | ||
+ | |||
= Installation et fonctionnement de l'Hypergrid= | = Installation et fonctionnement de l'Hypergrid= | ||
Cette page décrit la configuration de l'[[Hypergrid/fr|Hypergrid]] dans le cadre d'une architecture standalone ou d'une architecture grille d'OpenSimulator. | Cette page décrit la configuration de l'[[Hypergrid/fr|Hypergrid]] dans le cadre d'une architecture standalone ou d'une architecture grille d'OpenSimulator. | ||
Line 9: | Line 12: | ||
'''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.''' | '''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 : | ||
+ | |||
+ | <source lang="ini">[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" | ||
+ | </source> | ||
+ | |||
+ | ===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 | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [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" | ||
+ | </source> | ||
+ | |||
+ | |||
+ | 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 | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [Hypergrid] | ||
+ | HomeURI = "http://example.com:9000" | ||
+ | GatekeeperURI = "http://example.com:9000" | ||
+ | </source> | ||
+ | |||
+ | ==== É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 | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [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" | ||
+ | </source> | ||
+ | |||
+ | 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 | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [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" | ||
+ | </source> | ||
+ | |||
+ | ==== 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. | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [Network] | ||
+ | http_listener_port = 9000 | ||
+ | </source> | ||
+ | |||
+ | ==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. | ||
+ | |||
+ | === Simulateur === | ||
+ | ==== 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 : | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [Const] | ||
+ | |||
+ | ;# {BaseHostname} {} {BaseHostname} {"example.com" "127.0.0.1"} "127.0.0.1" | ||
+ | BaseHostname = "127.0.0.1" | ||
+ | |||
+ | ; URL du serveur Robust | ||
+ | BaseURL = "http://127.0.0.1" | ||
+ | |||
+ | ; Port public du serveur Robust | ||
+ | PublicPort = "8002" | ||
+ | |||
+ | ; Port privé du serveur Robust | ||
+ | PrivatePort = "8003" | ||
+ | </source> | ||
+ | |||
+ | 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 : | ||
+ | |||
+ | <source lang="ini">[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 | ||
+ | </source> | ||
+ | |||
+ | ==== 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]: | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [Hypergrid] | ||
+ | ; Décommentez la variable GatekeeperURI dans cette section pour | ||
+ | ; activer la configuration Hypergrid. Sinon, ignorez cette ligne | ||
+ | |||
+ | ;# {GatekeeperURI} {Hypergrid} {URL du portail de ce monde} {} | ||
+ | ;; S'il s'agit d'un monde autonome, il s'agit de l'adresse de cette instance. | ||
+ | ;; S'il s'agit d'un simulateur de grille, il s'agit de l'adresse du | ||
+ | ;; serveur externe robust qui exécute le service Gatekeeper. | ||
+ | ;; Par exemple http://myworld.com:9000 ou http://myworld.com:8002 | ||
+ | GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | ;# {HomeURI} {Hypergrid} {The Home URL of this world} {} | ||
+ | ;; S'il s'agit d'un monde autonome, il s'agit de l'adresse de cette instance. | ||
+ | ;; S'il s'agit d'un simulateur de grille, il s'agit de l'adresse du | ||
+ | ;; erveur externe robust qui exécute UserAgentsService. | ||
+ | ;; Par exemple http://myworld.com:9000 ou http://myworld.com:8002 | ||
+ | HomeURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | </source> | ||
+ | |||
+ | Certaines options doivent ou peuvent être définie dans les autres sections : | ||
+ | |||
+ | <source lang = "ini"> | ||
+ | |||
+ | [GridService] | ||
+ | ; === HG SEULEMENT === | ||
+ | ;; Indiquez l'adresse de votre service Gatekeeper | ||
+ | ;; (généralement regroupés avec le reste des services dans un seul et même | ||
+ | ;; serveur Robust sur le port 8002, mais pas toujours) | ||
+ | Gatekeeper="http://mygridserver.com:8002" | ||
+ | |||
+ | [Messaging] | ||
+ | ; === HG SEULEMENT === | ||
+ | ;; Indiquez l'adresse de votre service Gatekeeper | ||
+ | ;; (généralement regroupés avec le reste des services dans un seul et même | ||
+ | ;; serveur Robust sur le port 8002, mais pas toujours) | ||
+ | Gatekeeper = "http://mygridserver.com:8002" | ||
+ | |||
+ | [HGInventoryAccessModule] | ||
+ | ; | ||
+ | ; === HG SEULEMENT === | ||
+ | ; Adaptez cette configuration à votre serveur | ||
+ | ; accessible depuis d'autres grilles | ||
+ | ; | ||
+ | ;; Si vous voulez protéger vos assets contre la copie par des visiteurs étrangers | ||
+ | ;; mettez cette option à false. Vous voudrez peut-être protéger ainsi des régions | ||
+ | ;; avec un contenu sous licence. | ||
+ | ;; Valeur par défaut True. | ||
+ | ; OutboundPermission = True | ||
+ | |||
+ | ;; Envoyer un rappel visuel aux utilisateurs locaux que leurs inventaires sont indisponibles | ||
+ | ;; pendant qu'ils voyagent et disponibles à leur retour. True par défaut | ||
+ | ;RestrictInventoryAccessAbroad = True | ||
+ | |||
+ | ;; Avertissement : avancé et inusité. La valeur par défaut est false. | ||
+ | ;; Permet les configurations où les grilles partagent les services aux utilisateurs, y compris l'inventaire, | ||
+ | ;; tout en séparant les assets des régions de ceux des utilisateurs. Le transfert des assets entre | ||
+ | ;; le serveur d'assets des utilisateurs et le serveur d'assets des régions se fait à la manière d'un HG. | ||
+ | ; CheckSeparateAssets = false | ||
+ | ; RegionHGAssetServerURI = ${Const|BaseURL}:${Const|PublicPort} | ||
+ | |||
+ | [HGAssetService] | ||
+ | ; | ||
+ | ; === HG SEULEMENT === | ||
+ | ;; Les types d'aassets que cette grille peut exporter vers / importer depuis d'autres grilles | ||
+ | ;; séparés par des virgules. | ||
+ | ;; Les valeurs valides sont tous les types d'assets dans OpenMetaverse.AssetType, à savoir : | ||
+ | ;; Unknown, Texture, Sound, CallingCard, Landmark, Clothing, Object, Notecard, LSLText, | ||
+ | ;; LSLBytecode, TextureTGA, Bodypart, SoundWAV, ImageTGA, ImageJPEG, Animation, Gesture, Mesh | ||
+ | ;; | ||
+ | ;; Laissez en blanc ou commenté si vous ne voulez pas appliquer de restrictions. | ||
+ | ;; Une politique plus stricte, mais toujours raisonnable, peut | ||
+ | ;; consister à interdire l'échange de scripts, comme suit: | ||
+ | ; DisallowExport ="LSLText" | ||
+ | ; DisallowImport ="LSLBytecode" | ||
+ | |||
+ | [HGFriendsModule] | ||
+ | ; Niveau d'utilisateur requis pour pouvoir envoyer des invitations d'amitié à des utilisateurs étrangers | ||
+ | ;LevelHGFriends = 0; | ||
+ | |||
+ | </source> | ||
+ | |||
+ | === 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 | ||
+ | <source lang="ini"> | ||
+ | [Const] | ||
+ | |||
+ | ; URL du serveur Robust | ||
+ | BaseURL = "http://127.0.0.1" | ||
+ | |||
+ | ; Port public du serveur Robust | ||
+ | PublicPort = "8002" | ||
+ | |||
+ | ; Port privé du serveur Robust | ||
+ | PrivatePort = "8003" | ||
+ | </source> | ||
+ | |||
+ | ====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]: | ||
+ | |||
+ | <Source lang = "ini"> | ||
+ | [Hypergrid] | ||
+ | ;# {HomeURI} {Hypergrid} {L'URL d'accueil de cette grille} {} | ||
+ | ;; Il s'agit de l'adresse du serveur externe robuste qui exécute | ||
+ | ;; UserAgentsService, éventuellement ce serveur. | ||
+ | ;; Par exemple http://myworld.com:8002 | ||
+ | ;; Il s'agit d'une valeur par défaut qui peut être remplacée dans certaines sections. | ||
+ | HomeURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | ;# {GatekeeperURI} {Hypergrid} {L'URL du gatekeeper de ce réseau.} {} | ||
+ | ;; Il s'agit de l'adresse du serveur externe robuste qui exécute | ||
+ | ;; le service Gatekeeper, éventuellement ce serveur. | ||
+ | ;; Par exemple http://myworld.com:8002 | ||
+ | ;; Il s'agit d'une valeur par défaut qui peut être remplacée dans certaines sections. | ||
+ | GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | ; ... Configuration complémentaire ... | ||
+ | </source> | ||
+ | |||
+ | ==== 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. | ||
+ | <source lang="ini"> | ||
+ | |||
+ | [LoginService] | ||
+ | ;... configuration supplémentaire | ||
+ | SRV_HomeURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | SRV_InventoryServerURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | SRV_AssetServerURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | SRV_ProfileServerURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | SRV_FriendsServerURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | SRV_IMServerURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | SRV_GroupsServerURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | ;... configuration supplémentaire | ||
+ | </source> | ||
+ | |||
+ | 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. | ||
+ | |||
+ | <source lang="ini"> | ||
+ | [ServiceList] | ||
+ | ;; Additions pour Hypergrid | ||
+ | ;; Décommentez cette ligne si vous voulez que Groups V2 fonctionne en HG | ||
+ | ; HGGroupsServiceConnector = "${Const|PublicPort}/OpenSim.Addons.Groups.dll:HGGroupsServiceRobustConnector" | ||
+ | |||
+ | |||
+ | [GridService] | ||
+ | ;;Nous pouvons spécifier les propriétés des régions, y compris les régions | ||
+ | ;; par défaut et les régions de repli également pour l'hypergrid | ||
+ | ; Region_Welcome_Area = "DefaultRegion, FallbackRegion" | ||
+ | |||
+ | ;; Permettre la création d'hyperliens dans la console | ||
+ | HypergridLinker = true | ||
+ | |||
+ | ;; Si vous avez défini cette option dans [Hypergrid], il n'est pas nécessaire | ||
+ | ;; de la définir ici, laissez-la en commentaire. | ||
+ | ; GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | [LoginService] | ||
+ | ;; Si vous avez déjà défini GatekeeperURI dans [Hypergrid], il n'est pas nécessaire | ||
+ | ;; de la définir ici, laissez-la en commentaire. | ||
+ | ; GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | [HGInventoryService] | ||
+ | ; Pour InventoryServiceInConnector | ||
+ | LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGSuitcaseInventoryService" | ||
+ | ;; alternatives: | ||
+ | ;; HG1.5, plus permissif, non recommandé, mais toujours soutenu | ||
+ | ;LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGInventoryService" | ||
+ | ;; HG1.0, totalement permissif, non recommandé, mais acceptable pour les grilles avec une confiance à 100%. | ||
+ | ;LocalServiceModule = "OpenSim.Services.InventoryService.dll:XInventoryService" | ||
+ | |||
+ | ; HGInventoryService est un service d'inventaire orienté vers le public qui permet aux utilisateurs d'interagir | ||
+ | ; avec les dossiers de leur suitcase quand ils sont sur des grilles étrangères. Il réutilise le connecteur | ||
+ | ; du service d'inventaire général. | ||
+ | ; Par conséquent, si l'utilisateur a configuré l'authentification dans [Network] pour protéger ses services privés | ||
+ | ; assurez-vous qu'elle n'est pas définie ici. | ||
+ | AuthType = None | ||
+ | |||
+ | ;; Peut écraser la valeur par défaut dans [Hypergrid], mais ne devrait probablement pas le faire. | ||
+ | ; HomeURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | [HGAssetService] | ||
+ | ;; Utilisez la deuxième option si le service FSAsset est activé. | ||
+ | LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGAssetService" | ||
+ | ;LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGFSAssetService" | ||
+ | |||
+ | UserAccountsService = "OpenSim.Services.UserAccountService.dll:UserAccountService" | ||
+ | |||
+ | ; HGAssetService est un service public qui permet aux utilisateurs de | ||
+ | ; de lire et de créer des assetss lorsqu'ils se trouvent sur une autre grille. | ||
+ | ; Il réutilise le connecteur du service des assets. | ||
+ | ; Par conséquent, si l'utilisateur a configuré l'authentification dans [Network] | ||
+ | ; pour protéger ses services privés assurez-vous qu'elle est remplacée pour ce service public. | ||
+ | AuthType = None | ||
+ | |||
+ | ;; Peut écraser la valeur par défaut dans [Hypergrid], mais ne devrait probablement pas le faire. | ||
+ | ; HomeURI = "${Const|BaseURL}:${Const|PublicPort}" | ||
+ | |||
+ | ;; Les types d'assets que cette grille peut exporter vers / importer depuis d'autres grilles. | ||
+ | ;; Séparés par es virgules. | ||
+ | ;; Les valeurs valides sont tous les types de biens dans OpenMetaverse.AssetType, à savoir : | ||
+ | ;; Unknown, Texture, Sound, CallingCard, Landmark, Clothing, Object, Notecard, LSLText, | ||
+ | ;; LSLBytecode, TextureTGA, Bodypart, SoundWAV, ImageTGA, ImageJPEG, Animation, Gesture, Mesh | ||
+ | ;; | ||
+ | ;; Laissez en blanc ou commenté si vous ne voulez pas appliquer de restrictions. | ||
+ | ;; Une politique plus stricte, mais toujours raisonnable, peut | ||
+ | ;; consister à interdire l'échange de scripts, comme suit : | ||
+ | ; DisallowExport ="LSLText" | ||
+ | ; DisallowImport ="LSLBytecode" | ||
+ | </source> | ||
+ | |||
+ | ====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 : | ||
+ | <source lang="ini">[Region One] | ||
+ | ; ... (autres configurations dans cette section) ... | ||
+ | ExternalHostName = "example.com" | ||
+ | </source> | ||
= Installation et fonctionnement : instructions pour versions précédentes = | = Installation et fonctionnement : instructions pour versions précédentes = | ||
Line 311: | Line 684: | ||
[[Installing and Running Hypergrid On 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 [[Network Settings|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 [[NAT Loopback Routers/fr|Routeurs NAT Loopback]]. | ||
+ | |||
= Références supplémentaires = | = Références supplémentaires = |
Latest revision as of 20:22, 23 July 2021
[edit] 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.
[edit] Standalone
[edit] 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"
[edit] 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 :
[edit] É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"
[edit] É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"
[edit] 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
[edit] 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.
[edit] Simulateur
[edit] 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 :
[Const] ;# {BaseHostname} {} {BaseHostname} {"example.com" "127.0.0.1"} "127.0.0.1" BaseHostname = "127.0.0.1" ; URL du serveur Robust BaseURL = "http://127.0.0.1" ; Port public du serveur Robust PublicPort = "8002" ; Port privé du serveur Robust PrivatePort = "8003"
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 :
[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
[edit] 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]:
[Hypergrid] ; Décommentez la variable GatekeeperURI dans cette section pour ; activer la configuration Hypergrid. Sinon, ignorez cette ligne ;# {GatekeeperURI} {Hypergrid} {URL du portail de ce monde} {} ;; S'il s'agit d'un monde autonome, il s'agit de l'adresse de cette instance. ;; S'il s'agit d'un simulateur de grille, il s'agit de l'adresse du ;; serveur externe robust qui exécute le service Gatekeeper. ;; Par exemple http://myworld.com:9000 ou http://myworld.com:8002 GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" ;# {HomeURI} {Hypergrid} {The Home URL of this world} {} ;; S'il s'agit d'un monde autonome, il s'agit de l'adresse de cette instance. ;; S'il s'agit d'un simulateur de grille, il s'agit de l'adresse du ;; erveur externe robust qui exécute UserAgentsService. ;; Par exemple http://myworld.com:9000 ou http://myworld.com:8002 HomeURI = "${Const|BaseURL}:${Const|PublicPort}"
Certaines options doivent ou peuvent être définie dans les autres sections :
[GridService] ; === HG SEULEMENT === ;; Indiquez l'adresse de votre service Gatekeeper ;; (généralement regroupés avec le reste des services dans un seul et même ;; serveur Robust sur le port 8002, mais pas toujours) Gatekeeper="http://mygridserver.com:8002" [Messaging] ; === HG SEULEMENT === ;; Indiquez l'adresse de votre service Gatekeeper ;; (généralement regroupés avec le reste des services dans un seul et même ;; serveur Robust sur le port 8002, mais pas toujours) Gatekeeper = "http://mygridserver.com:8002" [HGInventoryAccessModule] ; ; === HG SEULEMENT === ; Adaptez cette configuration à votre serveur ; accessible depuis d'autres grilles ; ;; Si vous voulez protéger vos assets contre la copie par des visiteurs étrangers ;; mettez cette option à false. Vous voudrez peut-être protéger ainsi des régions ;; avec un contenu sous licence. ;; Valeur par défaut True. ; OutboundPermission = True ;; Envoyer un rappel visuel aux utilisateurs locaux que leurs inventaires sont indisponibles ;; pendant qu'ils voyagent et disponibles à leur retour. True par défaut ;RestrictInventoryAccessAbroad = True ;; Avertissement : avancé et inusité. La valeur par défaut est false. ;; Permet les configurations où les grilles partagent les services aux utilisateurs, y compris l'inventaire, ;; tout en séparant les assets des régions de ceux des utilisateurs. Le transfert des assets entre ;; le serveur d'assets des utilisateurs et le serveur d'assets des régions se fait à la manière d'un HG. ; CheckSeparateAssets = false ; RegionHGAssetServerURI = ${Const|BaseURL}:${Const|PublicPort} [HGAssetService] ; ; === HG SEULEMENT === ;; Les types d'aassets que cette grille peut exporter vers / importer depuis d'autres grilles ;; séparés par des virgules. ;; Les valeurs valides sont tous les types d'assets dans OpenMetaverse.AssetType, à savoir : ;; Unknown, Texture, Sound, CallingCard, Landmark, Clothing, Object, Notecard, LSLText, ;; LSLBytecode, TextureTGA, Bodypart, SoundWAV, ImageTGA, ImageJPEG, Animation, Gesture, Mesh ;; ;; Laissez en blanc ou commenté si vous ne voulez pas appliquer de restrictions. ;; Une politique plus stricte, mais toujours raisonnable, peut ;; consister à interdire l'échange de scripts, comme suit: ; DisallowExport ="LSLText" ; DisallowImport ="LSLBytecode" [HGFriendsModule] ; Niveau d'utilisateur requis pour pouvoir envoyer des invitations d'amitié à des utilisateurs étrangers ;LevelHGFriends = 0;
[edit] 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.
[edit] Section Const
Vous pouvez indiquer dans cette section des constantes qui pourront être utilisées tout au long du fichier Robust.HG.ini
[Const] ; URL du serveur Robust BaseURL = "http://127.0.0.1" ; Port public du serveur Robust PublicPort = "8002" ; Port privé du serveur Robust PrivatePort = "8003"
[edit] 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]:
[Hypergrid] ;# {HomeURI} {Hypergrid} {L'URL d'accueil de cette grille} {} ;; Il s'agit de l'adresse du serveur externe robuste qui exécute ;; UserAgentsService, éventuellement ce serveur. ;; Par exemple http://myworld.com:8002 ;; Il s'agit d'une valeur par défaut qui peut être remplacée dans certaines sections. HomeURI = "${Const|BaseURL}:${Const|PublicPort}" ;# {GatekeeperURI} {Hypergrid} {L'URL du gatekeeper de ce réseau.} {} ;; Il s'agit de l'adresse du serveur externe robuste qui exécute ;; le service Gatekeeper, éventuellement ce serveur. ;; Par exemple http://myworld.com:8002 ;; Il s'agit d'une valeur par défaut qui peut être remplacée dans certaines sections. GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" ; ... Configuration complémentaire ...
[edit] 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.
[LoginService] ;... configuration supplémentaire SRV_HomeURI = "${Const|BaseURL}:${Const|PublicPort}" SRV_InventoryServerURI = "${Const|BaseURL}:${Const|PublicPort}" SRV_AssetServerURI = "${Const|BaseURL}:${Const|PublicPort}" SRV_ProfileServerURI = "${Const|BaseURL}:${Const|PublicPort}" SRV_FriendsServerURI = "${Const|BaseURL}:${Const|PublicPort}" SRV_IMServerURI = "${Const|BaseURL}:${Const|PublicPort}" SRV_GroupsServerURI = "${Const|BaseURL}:${Const|PublicPort}" ;... configuration supplémentaire
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.
[ServiceList] ;; Additions pour Hypergrid ;; Décommentez cette ligne si vous voulez que Groups V2 fonctionne en HG ; HGGroupsServiceConnector = "${Const|PublicPort}/OpenSim.Addons.Groups.dll:HGGroupsServiceRobustConnector" [GridService] ;;Nous pouvons spécifier les propriétés des régions, y compris les régions ;; par défaut et les régions de repli également pour l'hypergrid ; Region_Welcome_Area = "DefaultRegion, FallbackRegion" ;; Permettre la création d'hyperliens dans la console HypergridLinker = true ;; Si vous avez défini cette option dans [Hypergrid], il n'est pas nécessaire ;; de la définir ici, laissez-la en commentaire. ; GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" [LoginService] ;; Si vous avez déjà défini GatekeeperURI dans [Hypergrid], il n'est pas nécessaire ;; de la définir ici, laissez-la en commentaire. ; GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}" [HGInventoryService] ; Pour InventoryServiceInConnector LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGSuitcaseInventoryService" ;; alternatives: ;; HG1.5, plus permissif, non recommandé, mais toujours soutenu ;LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGInventoryService" ;; HG1.0, totalement permissif, non recommandé, mais acceptable pour les grilles avec une confiance à 100%. ;LocalServiceModule = "OpenSim.Services.InventoryService.dll:XInventoryService" ; HGInventoryService est un service d'inventaire orienté vers le public qui permet aux utilisateurs d'interagir ; avec les dossiers de leur suitcase quand ils sont sur des grilles étrangères. Il réutilise le connecteur ; du service d'inventaire général. ; Par conséquent, si l'utilisateur a configuré l'authentification dans [Network] pour protéger ses services privés ; assurez-vous qu'elle n'est pas définie ici. AuthType = None ;; Peut écraser la valeur par défaut dans [Hypergrid], mais ne devrait probablement pas le faire. ; HomeURI = "${Const|BaseURL}:${Const|PublicPort}" [HGAssetService] ;; Utilisez la deuxième option si le service FSAsset est activé. LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGAssetService" ;LocalServiceModule = "OpenSim.Services.HypergridService.dll:HGFSAssetService" UserAccountsService = "OpenSim.Services.UserAccountService.dll:UserAccountService" ; HGAssetService est un service public qui permet aux utilisateurs de ; de lire et de créer des assetss lorsqu'ils se trouvent sur une autre grille. ; Il réutilise le connecteur du service des assets. ; Par conséquent, si l'utilisateur a configuré l'authentification dans [Network] ; pour protéger ses services privés assurez-vous qu'elle est remplacée pour ce service public. AuthType = None ;; Peut écraser la valeur par défaut dans [Hypergrid], mais ne devrait probablement pas le faire. ; HomeURI = "${Const|BaseURL}:${Const|PublicPort}" ;; Les types d'assets que cette grille peut exporter vers / importer depuis d'autres grilles. ;; Séparés par es virgules. ;; Les valeurs valides sont tous les types de biens dans OpenMetaverse.AssetType, à savoir : ;; Unknown, Texture, Sound, CallingCard, Landmark, Clothing, Object, Notecard, LSLText, ;; LSLBytecode, TextureTGA, Bodypart, SoundWAV, ImageTGA, ImageJPEG, Animation, Gesture, Mesh ;; ;; Laissez en blanc ou commenté si vous ne voulez pas appliquer de restrictions. ;; Une politique plus stricte, mais toujours raisonnable, peut ;; consister à interdire l'échange de scripts, comme suit : ; DisallowExport ="LSLText" ; DisallowImport ="LSLBytecode"
[edit] 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
[edit] 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"
[edit] 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.
[edit] 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.
[edit] 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.
[edit] 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"
[edit] 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
[edit] 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.
[edit] 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.
[edit] 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"
[edit] 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.
[edit] 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.
[edit] 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"
[edit] 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
[edit] 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
[edit] Installer et faire marcher l'hypergrid pour OpenSimulator 0.6.9
Installing and Running Hypergrid On OpenSimulator 0.6.9
[edit] 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.
[edit] 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