HyperGrid Team/HowTo

Installing

Checkout OpenSim, prebuild and build as normal.

for Linux users that will be command line like below, in this example i will use /opt for the checkout.

# cd /opt
# svn co http://opensimulator.org/svn/opensim/trunk opensim
# cd opensim 
# ./runprebuild.sh
# nant

• If you want to run in standalone mode and you want it to be network-able, or if you have your grid on loopback (127.0.0.1) change all the [Network] server addresses to "http://<external_host_name>:<http_port>". See below for the OpenSim.ini

• To make sure the hypergrid is running type this on your console: link-region. If you don't get/hear anything back, the hypergrid is not properly Enabled/Installed.

• Make a copy of your /bin/OpenSim.ini.example and rename it to OpenSim.ini

The following is an example of what needs to be changed in OpenSim.ini to have your Region HyperGrid Enabled note: If you have several regions on one OpenSim.exe, all regions will after these changes be HyperGrid Enabled.

OpenSim.ini

• Example of the OpenSim.ini changes for a standalone:

; Set this to true if you want this OpenSimulator to run the Hypergrid functionality
hypergrid = true

; ##
; ## WORLD MAP
; ##
WorldMapModule = "WorldMap"
WorldMapModule = "HGWorldMap"

[Network]
http_listener_port = 9000
default_location_x = choose a number between 8000 - 12000 (if you want to HG to and from OSGrid)
default_location_y = choose a number between 8000 - 12000 (if you want to HG to and from OSGrid)

grid_server_url = http://example.com:9000
grid_send_key = null
grid_recv_key = null

user_server_url = http://example.com:9000
user_send_key = null
user_recv_key = null

asset_server_url = http://example.com:9000
inventory_server_url = http://example.com:9000
messaging_server_url = http://example.com:9000

• Example of the OpenSim.ini changes for a grided OpenSim:

; Set this to true if you want this OpenSimulator to run the Hypergrid functionality
hypergrid = true

; ##
; ## WORLD MAP
; ##
WorldMapModule = "WorldMap"
WorldMapModule = "HGWorldMap"

[Network]
http_listener_port = 9000
default_location_x = choose a number between 8000 - 12000 (if you want to HG to and from OSGrid)
default_location_y = choose a number between 8000 - 12000 (if you want to HG to and from OSGrid)

grid_server_url = http://example.com:8001
grid_send_key = null
grid_recv_key = null

user_server_url = http://example.com:8002
user_send_key = null
user_recv_key = null

asset_server_url = http://example.com:8003
inventory_server_url = http://example.com:8004
; Port 8005 reserved
messaging_server_url = http://example.com:8006

In your OpenSim.ini . HGWorldMapModule will, after teleporting to another grid, clean up tiles in your map left over from the grid on which you were previously.

Important Notes

Make sure you have a 'home' set. If your home region doesn't exist, the hyperlink TPs may not work. To set your home, go to one of your local regions and "Set Home" from the viewer.

After svn build 9321 the -hypergrid=true is moved into OpenSim.ini as described above.