HyperGrid Team/HowTo

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (OpenSim.ini: layout only)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__ {{Template:Quicklinks}} <br>
+
__NOTOC__ {{Quicklinks}} <br />
  
  
  
Refer to: [[Installing_and_Running_Hypergrid]]
+
Refer to: [[Installing and Running Hypergrid]]
  
== Installing ==
+
== Installing ==
  
 
Checkout OpenSim, prebuild and build as normal.  
 
Checkout OpenSim, prebuild and build as normal.  
  
<br>for Linux users that will be command line like below, in this example i will use /opt for the checkout.  
+
<br />for Linux users that will be command line like below, in this example i will use /opt for the checkout.  
  
 
  # cd /opt
 
  # cd /opt
Line 17: Line 17:
 
  # nant
 
  # nant
  
<br>for Windows users that will be command line like below, in this example i will use C:\opensim for the checkout.  
+
<br />for Windows users that will be command line like below, in this example i will use C:\opensim for the checkout.  
  
 
SVN checkout e.g. with TortoiseSVN http://tortoisesvn.net/ by right clicking the opensim folder in explorer and choose SVN Checkout you want to use like C:\opensim and type in this url - http://opensimulator.org/svn/opensim/trunk under "URL of repository", and hit Ok.  
 
SVN checkout e.g. with TortoiseSVN http://tortoisesvn.net/ by right clicking the opensim folder in explorer and choose SVN Checkout you want to use like C:\opensim and type in this url - http://opensimulator.org/svn/opensim/trunk under "URL of repository", and hit Ok.  
Line 27: Line 27:
 
  c:\opensim&gt; compile.bat
 
  c:\opensim&gt; compile.bat
  
<br>
+
<br />
  
*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 <nowiki>"http://<external_host_name>:<http_port>"</nowiki>. See below for the OpenSim.ini
+
* 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 <nowiki>"http://<external_host_name>:<http_port>"</nowiki>. 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.
+
* 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
+
* Make a copy of your /bin/OpenSim.ini.example and rename it to OpenSim.ini
  
<br>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.  
+
<br />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 ===
+
=== OpenSim.ini ===
  
*Example of the OpenSim.ini changes for a standalone:
+
* Example of the OpenSim.ini changes for a standalone:
  
 
  ; Set this to true if you want this OpenSimulator to run the Hypergrid functionality
 
  ; Set this to true if you want this OpenSimulator to run the Hypergrid functionality
Line 46: Line 46:
 
  ; ##
 
  ; ##
 
  ; ## WORLD MAP
 
  ; ## WORLD MAP
 +
; ## Usually set in the included file StandaloneHypergrid.ini
 
  ; ##
 
  ; ##
WorldMapModule = "WorldMap"
 
 
  WorldMapModule = "HGWorldMap"
 
  WorldMapModule = "HGWorldMap"
  
Line 67: Line 67:
 
  messaging_server_url = http://example.com:9000
 
  messaging_server_url = http://example.com:9000
  
<br>
+
<br />
  
*Example of the OpenSim.ini changes for a grided OpenSim:
+
* Example of the OpenSim.ini changes for a grided OpenSim:
  
 
  ; Set this to true if you want this OpenSimulator to run the Hypergrid functionality
 
  ; Set this to true if you want this OpenSimulator to run the Hypergrid functionality
Line 76: Line 76:
 
  ; ##
 
  ; ##
 
  ; ## WORLD MAP
 
  ; ## WORLD MAP
 +
; ## Usually set in the included file GridHypergrid.ini
 
  ; ##
 
  ; ##
WorldMapModule = "WorldMap"
 
 
  WorldMapModule = "HGWorldMap"
 
  WorldMapModule = "HGWorldMap"
  
Line 98: Line 98:
 
  messaging_server_url = http://example.com:8006
 
  messaging_server_url = http://example.com:8006
  
<br>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.  
+
<br />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.  
  
<br>If you already have an OSGrid connected region, and you want that Hypergrid Enabled, just make the changes to OpenSim.ini as described above, only remmeber to keep the http://osgrid.org:port in [network section] and the OSgrid specific keys. "1234"  
+
<br />If you already have an OSGrid connected region, and you want that Hypergrid Enabled, just make the changes to OpenSim.ini as described above, only remember to keep the http://osgrid.org:port in [network section] and the OSgrid specific keys. "1234"  
  
<br>After these OpenSim.ini changes you are ready to proceed with your new Standalone HG Enabled region so read on to start everything up.  
+
<br />After these OpenSim.ini changes you are ready to proceed with your new Standalone HG Enabled region so read on to start everything up.
  
== To start the OpenSim in a basic sqlite setup ==
+
== To start the OpenSimulator in a basic sqlite setup ==
  
 
Start the /opt/opensim/bin/opensim-ode.sh script.  
 
Start the /opt/opensim/bin/opensim-ode.sh script.  
Line 118: Line 118:
 
   c:\&gt;opensim.exe -physics=OpenDynamicsEngine
 
   c:\&gt;opensim.exe -physics=OpenDynamicsEngine
  
<br>On startup answer these questions: (on the External Host Name question type in your Public/External IP Address. 192.168.35.131 in this example. for x,y choose numbers between 8000-12000, put in Local Server Firstname and Lastname)  
+
<br />On startup answer these questions: (on the External Host Name question type in your Public/External IP Address. 192.168.35.131 in this example. for x,y choose numbers between 8000-12000, put in Local Server Firstname and Lastname)  
  
<br>
+
<br />
  
 
  DEFAULT REGION CONFIG: Region Name [OpenSim Test]: ''MyHGRegion''
 
  DEFAULT REGION CONFIG: Region Name [OpenSim Test]: ''MyHGRegion''
Line 138: Line 138:
 
  Region (MyHGRegion) #  
 
  Region (MyHGRegion) #  
  
After the initial setup you OpenSim will have created a default.xml file under /bin/Regions In the default.xml make sure that the x,y coords match the OpenSim.ini's settings  
+
After the initial setup you OpenSimulator will have created a default.xml file under /bin/Regions In the default.xml make sure that the x,y coords match the OpenSim.ini's settings  
  
 
example  
 
example  
Line 147: Line 147:
 
You will also need to open your firewall or router on region ports as specified in default.xml (internal_ip_port="9000") and OpenSim.ini in this example you would have to open port 9000 on TCP/UDP, to be able to access your standalone region from the Internet.  
 
You will also need to open your firewall or router on region ports as specified in default.xml (internal_ip_port="9000") and OpenSim.ini in this example you would have to open port 9000 on TCP/UDP, to be able to access your standalone region from the Internet.  
  
<br>Now to test your Hypergrid settings and start HyperGridding test if you can teleport between regions like below with method 3 of dynamic linking.  
+
<br />Now to test your Hypergrid settings and start HyperGridding test if you can teleport between regions like below with method 3 of dynamic linking.  
  
<br>
+
<br />
  
==== Testing your HyperGrid via Method 3 (dynamic) ====
+
==== Testing your HyperGrid via Method 3 (dynamic) ====
  
 
Starting in svn r8193, if you're in an HG-enabled region, you'll be able to dynamically link sims, and teleport there, in any one of these ways (and probably more). All you need to know is the target address, e.g. from the list below.  
 
Starting in svn r8193, if you're in an HG-enabled region, you'll be able to dynamically link sims, and teleport there, in any one of these ways (and probably more). All you need to know is the target address, e.g. from the list below.  
Line 166: Line 166:
 
  http://www.ics.uci.edu/~lopes/hypergrid/test.html)
 
  http://www.ics.uci.edu/~lopes/hypergrid/test.html)
  
  For example to teleport from your Standalone HG Enabled OpenSim server to an OSGrid region you would use  
+
  For example to teleport from your Standalone HG Enabled OpenSimulator server to an OSGrid region you would use  
 
  secondlife://External_IP_or_DNS_Name_Of_Your_OSGrid_Connected_Server:port:RegionName
 
  secondlife://External_IP_or_DNS_Name_Of_Your_OSGrid_Connected_Server:port:RegionName
  
 
Again, you can link to a specific region within an instance by adding the name of that region at the end, like this: secondlife://ucigrid04.nacs.uci.edu:9007:Gateway 7000/  
 
Again, you can link to a specific region within an instance by adding the name of that region at the end, like this: secondlife://ucigrid04.nacs.uci.edu:9007:Gateway 7000/  
  
<br>
+
<br />
  
== '''Important Notes''' ==
+
== '''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.  
 
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.  
  
<br>Due to a viewer [https://jira.secondlife.com/browse/SVC-2941 bug], you can only TP between regions that are no more than 4096 cells apart in any dimension. What this means in practice is that if you want to link to OSGrid, you must have your own regions reachable from the (10,000; 10,000) point on the map, which is where OSGrid is centered. Place your regions somewhere in the 8,000s or the 12,000s.  
+
Prior to OpenSim release 0.7.6 and when using earlier viewers that had a viewer [https://jira.secondlife.com/browse/SVC-2941 bug], you could only TP between regions that were no more than 4096 cells apart in any dimension. Recent 0.7.6 onwards grids and corrected viewers (Singularity, Kokua, Firestorm as at 1-Nov-2013) should no longer have this restriction.
  
<br>After svn r9321 the startup commandline switch -hypergrid=true is moved into OpenSim.ini as described above.
+
After svn r9321 the startup commandline switch -hypergrid=true is moved into OpenSim.ini as described above.
  
==Related Links==
+
[[Category:Hypergrid]]
 
+
[http://www.cellulite.co.uk/ '''cellulite''']
+

Latest revision as of 11:43, 1 September 2019



Refer to: Installing and Running Hypergrid

[edit] 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


for Windows users that will be command line like below, in this example i will use C:\opensim for the checkout.

SVN checkout e.g. with TortoiseSVN http://tortoisesvn.net/ by right clicking the opensim folder in explorer and choose SVN Checkout you want to use like C:\opensim and type in this url - http://opensimulator.org/svn/opensim/trunk under "URL of repository", and hit Ok.

When svn checkout is done open a command prompt via start - run - cmd 
c:\>cd opensim 
c:\opensim> runprebuild.bat
c:\opensim> compile.bat


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

[edit] 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
; ## Usually set in the included file StandaloneHypergrid.ini
; ##
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
; ## Usually set in the included file GridHypergrid.ini
; ##
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.


If you already have an OSGrid connected region, and you want that Hypergrid Enabled, just make the changes to OpenSim.ini as described above, only remember to keep the http://osgrid.org:port in [network section] and the OSgrid specific keys. "1234"


After these OpenSim.ini changes you are ready to proceed with your new Standalone HG Enabled region so read on to start everything up.

[edit] To start the OpenSimulator in a basic sqlite setup

Start the /opt/opensim/bin/opensim-ode.sh script.

Linux

 # cd /opt/opensim/bin
 # ./opensim-ode.sh

Windows

 c:\>cd \opensim\bin
 c:\>opensim.exe -physics=OpenDynamicsEngine


On startup answer these questions: (on the External Host Name question type in your Public/External IP Address. 192.168.35.131 in this example. for x,y choose numbers between 8000-12000, put in Local Server Firstname and Lastname)


DEFAULT REGION CONFIG: Region Name [OpenSim Test]: MyHGRegion
DEFAULT REGION CONFIG: Grid Location (X Axis) [1000]: 8000 - 12000
DEFAULT REGION CONFIG: Grid Location (Y Axis) [1000]: 8000 - 12000
DEFAULT REGION CONFIG: Internal IP Address for incoming UDP client connections [0.0.0.0]:
DEFAULT REGION CONFIG: Internal IP Port for incoming UDP client connections [9000]:
DEFAULT REGION CONFIG: External Host Name [127.0.0.1]: 192.168.35.131
DEFAULT REGION CONFIG: First Name of Master Avatar [Test]: firstname
DEFAULT REGION CONFIG: Last Name of Master Avatar [User]: lastname
DEFAULT REGION CONFIG: (Sandbox Mode Only)Password for Master Avatar account test]:
21:52:59 - [STARTUP]: No startup command script specified. Moving on...
21:52:59 - [!]:STARTUP COMPLETE
Currently selected region is MyHGRegion
21:52:59 - [STARTUP]: Startup took 0m 52s
Region (MyHGRegion) # 

After the initial setup you OpenSimulator will have created a default.xml file under /bin/Regions In the default.xml make sure that the x,y coords match the OpenSim.ini's settings

example

sim_location_x="8111" 
sim_location_y="8111"  

You will also need to open your firewall or router on region ports as specified in default.xml (internal_ip_port="9000") and OpenSim.ini in this example you would have to open port 9000 on TCP/UDP, to be able to access your standalone region from the Internet.


Now to test your Hypergrid settings and start HyperGridding test if you can teleport between regions like below with method 3 of dynamic linking.


[edit] Testing your HyperGrid via Method 3 (dynamic)

Starting in svn r8193, if you're in an HG-enabled region, you'll be able to dynamically link sims, and teleport there, in any one of these ways (and probably more). All you need to know is the target address, e.g. from the list below.

1) Type for example secondlife://hypervz.hypergrid.dk:9000/ in the public or an im  
chat box, click the chat "history" and click on that new link, if it works it will then show you 
the new region on the Teleport Map.
2) Click the the "Map" button and search for HG's like this:
hypervz.hypergrid.dk:9000
3) Using the viewer's embedded browser visit pages that have links like 
secondlife://ucigrid04.nacs.uci.edu:9007/ (there's one up at
http://www.ics.uci.edu/~lopes/hypergrid/test.html)
For example to teleport from your Standalone HG Enabled OpenSimulator server to an OSGrid region you would use 
secondlife://External_IP_or_DNS_Name_Of_Your_OSGrid_Connected_Server:port:RegionName

Again, you can link to a specific region within an instance by adding the name of that region at the end, like this: secondlife://ucigrid04.nacs.uci.edu:9007:Gateway 7000/


[edit] 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.

Prior to OpenSim release 0.7.6 and when using earlier viewers that had a viewer bug, you could only TP between regions that were no more than 4096 cells apart in any dimension. Recent 0.7.6 onwards grids and corrected viewers (Singularity, Kokua, Firestorm as at 1-Nov-2013) should no longer have this restriction.

After svn r9321 the startup commandline switch -hypergrid=true is moved into OpenSim.ini as described above.

Personal tools
General
About This Wiki