Installing and Running Hypergrid - Revision history

JeffKelley: Note added, fixed confusing 127.0.0.1 in grid configuration

2022-06-18T20:29:25Z

Note added, fixed confusing 127.0.0.1 in grid configuration

Ubit: /* Simulator */

2020-11-12T21:44:11Z

‎Simulator

Justincc: Add access section

2014-07-21T22:34:01Z

Add access section

Justincc: Add installation title

2014-07-21T22:29:06Z

Add installation title

Justincc: /* Simulator */

2014-07-21T22:17:58Z

‎Simulator

Justincc at 22:17, 21 July 2014

2014-07-21T22:17:08Z

Justincc: Undo revision 39347 by Justincc (talk)

2014-07-21T22:16:45Z

Undo revision 39347 by Justincc (talk)

Justincc: /* bin/OpenSim.ini */

2014-07-21T22:15:54Z

‎bin/OpenSim.ini

Justincc: /* Grid */

2014-05-07T18:26:59Z

‎Grid

Justincc at 17:52, 7 May 2014

2014-05-07T17:52:56Z

@@ Line 10: / Line 10: @@
 =Installation=
 == Standalone ==
@@ Line 16: / Line 19: @@
 The configuration for hypergrid is activated in section [Architecture] in file OpenSim.ini. Ensure that the line for Include-HGStandalone is the only one that is uncommented in this section:
 <source lang="ini">[Architecture]
-     ;Include-Standalone    = "config-include/Standalone.ini"
+     ;Include-Architecture   = "config-include/Standalone.ini"
-     Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
+     Include-Architecture    = "config-include/StandaloneHypergrid.ini"
-     ;Include-Grid         = "config-include/Grid.ini"
+     ;Include-Architecture   = "config-include/Grid.ini"
-     ;Include-HGGrid       = "config-include/GridHypergrid.ini"
+     ;Include-Architecture   = "config-include/GridHypergrid.ini"
-     ;Include-SimianGrid   = "config-include/SimianGrid.ini"</source>
+     ;Include-Architecture   = "config-include/SimianGrid.ini"</source>
 === bin/config-include/StandaloneCommon.ini ===
@@ Line 59: / Line 62: @@
 <source lang="ini">
   [Hypergrid]
-   HomeURI = "http://example.com:9000"
+   HomeURI = "${Const|BaseURL}:${Const|PublicPort}"
-   GatekeeperURI = "http://example.com:9000"
+   GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}"
 </source>
@@ Line 83: / Line 86: @@
 <source lang="ini">
 [LoginService]
-     SRV_HomeURI = "http://example.com:9000"
+     SRV_HomeURI = "${Hypergrid|HomeURI}"
-     SRV_InventoryServerURI = "http://example.com:9000"
+     SRV_InventoryServerURI = "${Const|BaseURL}:${Const|PublicPort}"
-     SRV_AssetServerURI = "http://example.com:9000"
+     SRV_AssetServerURI = "${Const|BaseURL}:${Const|PublicPort}"
-     SRV_ProfileServerURI = "http://example.com:9000"
+     SRV_ProfileServerURI = "${Const|BaseURL}:${Const|PublicPort}"
-     SRV_FriendsServerURI = "http://example.com:9000"
+     SRV_FriendsServerURI = "${Const|BaseURL}:${Const|PublicPort}"
-     SRV_IMServerURI = "http://example.com:9000"
+     SRV_IMServerURI = "${Const|BaseURL}:${Const|PublicPort}"
 </source>
@@ Line 111: / Line 114: @@
 The region servers (simulators) that connect to the Robust server read their configuration from file OpenSim.ini. To activate hypergrid for them, the line for Include-HGGrid in the section [Architecture] of OpenSim.ini must be uncommented:
 <source lang="ini">[Architecture]
-     ;Include-Standalone    = "config-include/Standalone.ini"
+     ;Include-Architecture    = "config-include/Standalone.ini"
-     ;Include-HGStandalone = "config-include/StandaloneHypergrid.ini"
+     ;Include-Architecture    = "config-include/StandaloneHypergrid.ini"
-     ;Include-Grid         = "config-include/Grid.ini"
+     ;Include-Architecture    = "config-include/Grid.ini"
-     Include-HGGrid       = "config-include/GridHypergrid.ini"
+     Include-Architecture     = "config-include/GridHypergrid.ini"
 </source>
@@ Line 124: / Line 127: @@
      ;; (usually bundled with the rest of the services in one
      ;; Robust server in port 8002, but not always)
-     Gatekeeper="http://mygridserver.com:8002"
+     Gatekeeper ="${Const|BaseURL}:${Const|PublicPort}"
 [Messaging]
@@ Line 131: / Line 135: @@
      ;; (usually bundled with the rest of the services in one
      ;; Robust server in port 8002, but not always)
-     Gatekeeper = "http://mygridserver.com:8002"
+     Gatekeeper = "${Const|BaseURL}:${Const|PublicPort}"
 [HGInventoryAccessModule]
@@ Line 139: / Line 143: @@
      ; accessible from other grids
+     ;
-     HomeURI = "http://mygridserver.com:8002"
+     HomeURI = "${Const|BaseURL}:${Const|PublicPort}"
-     Gatekeeper = "http://mygridserver.com:8002"
+     Gatekeeper = "${Const|BaseURL}:${Const|PublicPort}"
 [UserAgentService]
@@ Line 147: / Line 151: @@
      ; Change this to your user agent server (HG robust)
+     ;
-     UserAgentServerURI = "http://mygridserver.com:8002"
+     UserAgentServerURI = "${Const|BaseURL}:${Const|PublicPort}"
 </source>
@@ Line 156: / Line 160: @@
 <source lang="ini">
 [LoginService]
-     GatekeeperURI = "http://127.0.0.1:8002"
+     SRV_HomeURI = "${Const|BaseURL}:${Const|PublicPort}"
-     SRV_HomeURI = "http://127.0.0.1:8002"
+     GatekeeperURI = "${Const|BaseURL}:${Const|PublicPort}"
-    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"
+     ExternalName = "${Const|BaseURL}:${Const|PublicPort}"
 [HGInventoryService]
-     HomeURI = "http://127.0.0.1:8002"
+     HomeURI = "${Const|BaseURL}:${Const|PublicPort}"
 ; * The interface that local users get when they are in other grids.
@@ Line 177: / Line 182: @@
 ; *
 [HGAssetService]
-     HomeURI = "http://127.0.0.1:8002"
+     HomeURI = "${Const|BaseURL}:${Const|PublicPort}"
 </source>

@@ Line 115: / Line 115: @@
      ;Include-Grid         = "config-include/Grid.ini"
      Include-HGGrid       = "config-include/GridHypergrid.ini"
 </source>

@@ Line 194: / Line 194: @@
      ExternalHostName = "example.com"
 </source>
 = Previous Instructions =

@@ Line 9: / Line 9: @@
 Below follow specific instructions when using the standalone architecture and when using the grid architecture.  Finally, there is a section for actions that need to be performed in both architectures.
-== Standalone installation ==
+=Installation=
 === bin/OpenSim.ini ===
@@ Line 101: / Line 103: @@
 As a last step, the regions must be configured so that they supply external addresses that are the same as the Hypergrid addresses (e.g. example.com). See [[#Region Setup for both Grid and Standalone]].
-== Grid installation ==
+== Grid ==
 '''Note: These instructions are still under construction.  They need to be changed to incorporate the [Hypergrid] setting shortcut detailed in the standalone section'''.
@@ Line 150: / Line 152: @@
 </source>
-=== Robust Server ===
+=== Robust Services ===
 The Robust server is started with configuration file Robust.HG.ini instead of Robust.ini. If this file does not yet exist in your installation, create it by making a copy of Robust.HG.ini.example. Make the changes appropriate for your environment (e.g. adjust the database connection string). For hypergrid, the following settings are relevant:

@@ Line 107: / Line 107: @@
 === Simulator ===
-The region servers (simulators) that connect to the Robust server read their configuration from file OpenSim.ini. To activate hypergrid for them, the line for Include-HGGrid in section [Architecture] must be uncommented:
+The region servers (simulators) that connect to the Robust server read their configuration from file OpenSim.ini. To activate hypergrid for them, the line for Include-HGGrid in the section [Architecture] of OpenSim.ini must be uncommented:
 <source lang="ini">[Architecture]
      ;Include-Standalone    = "config-include/Standalone.ini"
@@ Line 116: / Line 116: @@
 </source>
-In GridCommon.ini the network addresses in the following sections must be changed to your external network address:
+In config-include/GridCommon.ini the network addresses in the following sections must be changed to your external network address:
 <source lang="ini">
 [GridService]

@@ Line 3: / Line 3: @@
 These are instructions for setting up the [[Hypergrid]] in OpenSimulator's standalone and grid architectures.
-= Configuration for OpenSimulator 0.7.6 onwards =
+Before OpenSimulator 0.7.6, the HomeURI and Gatekeeper entries had to be added separately in individual modules and services configuration sectios.
-The Hypergrid configuration for OpenSimulator 0.7.5 and before is still valid, where the HomeURI and Gatekeeper had to be configured separately in individual modules and services.
 However, there is now a more convenient way to do this by configuring these parameters just once in a new [Hypergrid] section of the appropriate configuration files (e.g. bin/config-include/StandaloneCommon.ini for the standalone architecture and bin/config-include/GridCommon.ini and bin/Robust.HG.ini for the grid architecture).