Open Grid Public Beta/Open Sim OGP How To

1. Download a patch and apply it to the OpenSim source.
2. You can download a pre-compiled version of OpenSim with the OGP patch.

The gridnauts IRC channel (irc://irc.freenode.net/#gridnauts) is a place to go with questions while better documentation is being written in the wiki.

Some notes on building on Ubuntu are available here: http://metafuturing.net/index.php/OpenSim_Notebook_1.

Getting Started With The Pre-Built Binary

Before You Get Started:

• Make sure you have joined the Gridnauts group and are able to logon to the aditi beta grid with your normal SL client.
• Make sure you have claimed a set of coordinates on the grid for your sim.
• Download the Gridnaut Special Edition SL Viewer.
• Download and unpack pre-built binaries of the OGP patched OpenSim.

After unpacking the zip file, you will find OpenSim.exe in the bin directory. This must be executed in that directory!

After you start OpenSim.exe, you will be presented with a console and you will need to answer a few questions to help it get your configuration set...

• Region Name What you want displayed in the "About Land" for your regions name
• X Axis The X coordinate of the grid location that you staked out
• Y Axis The Y coordinate of the grid location that you staked out
• internal ip address you can go with the default here to start with, although you may need to make changes here if you have an issue with the client connecting to your region 'after' you are authenticated.
• internal ip port the UDP port you will be listening on. The default of 9000 is appropriate in most cases (if you change this, you will need to edit the value in OpenSim.ini to reflect the changes here)
• external host name Despite the name here, this 'must' be the dotted quad address of your server. The name of the entry is just a ploy to keep the un-initiated scratching their head for a few days :)
• Master Avatar Firstname Your avatar's first name
• Master Avatar Lastname You avatar's last name
• Sandbox Password This won't be used, so the default of "test" is OK.

OpenSim will now write out the configuration files and finish the startup procedure, so type "shutdown" at the prompt.

We need to make a couple of changes to OpenSim.ini before we can run...

• default_location_x Set this to the x coordinate of your stakeout
• default_location_y Set this to the y coordinate of your stakeout
• http_listener_port make sure this matches the UDP port in your Regions/default.xml - internal_ip_port

READY?

• Save the file
• Run OpenSim.exe
• Point your client at your URI
• Get the bear!!

You may experience issues with firewalls/nat, see below for tips or seek help on IRC freenode.net - #gridnauts

Common Issues

• Despite the name of "external_host_address" and the instructions in the OpenSim docs, you _must_ use the external IP Number of your sim in the external_host_name slot of your default.xml. Either answer the External Host Name question with the IP number during the initial startup of your sim, or edit the Regions/default.xml file appropriately.
• If you have trouble with authentication make sure 'accounts_authenticate = false' in your OpenSim.ini
• Firewalls: If your OGP OpenSim is running in standalone mode, then you only need to open the port listed in your region descriptor - bin/Regions/default.xml, <... interernal_ip_port=9000 ...> attribute, 9000 unless you fiddle it. HOWEVER, you must open it for _both_ TPC and UDP in both directions.
• If you are behind a firewall and open your 9000 port for TCP and UDP and still can't teleport to your OGP OpenSim, check the listener channel and open that port as well. You may see the teleport attempt hitting the server in the log but may not be able to connect until the listener port is opened also.