OpenSim Walkthru How to run a serious OpenSim at home Part 2

OpenSim Categories

Who's Online

We have 96 guests online

Users Online


Help support us

How to run a serious OpenSim at home Part 2 PDF Print E-mail
OpenSim - Walkthru
Written by Skidz Tweak   
Saturday, 21 March 2009 05:43
Now that we have our database setup, its now time to set up your sim/grid.

For my configurations, I figured I might as well run in Grid mode. What does this mean? Well OpenSim can run in two ways, which are grid, and standalone. While this might not be the best choice for most people, for me it makes sense since I want to try and experiment as much as possible. When running in grid mode, I could distribute the load of five different servers on different machines if I liked. I don't plan on doing this for the tutorial.
We will be installing this on a Windows 2000 machine. I went with Windows over Linux because I have more experience, and I believe it would be more stable than running it with mono.

We will be compiling it from the code, and configuring everything, which is not near as scary as it sounds.

Step 1

Make sure you Windows 2000 box is up to date.
Start/Windows Update

You might consider turning on automatic updates. The only thing that stinks with this is it reboots sometimes. But in my mind that a small price to pay for security.

Step 2

Setting this computer's network ip address to be static:

Set your this computer to have a static IP address if you are currently using DHCP.

Start/Control Panel/Network Connections/

Right click your network connection (mine is named "Local Area Connection") and click properties.

Under "This connection users the following items:" select "Internet Protocol (TCP/IP)" and then click properties.
A new window will pop up and if "Obtain an IP address automatically" is selected you will want to change that to "Use the following IP address", and fill in the values.

You could even use your current values if you really don't know what to put in there. To see your current values click Start/Run/cmd/OK and type in ipconfig and press enter. You will be able to see your current IP address and could use those values.

What your doing here is just making sure your IP address on this computer is always the same in your local network. This is exactly what you did on the Ubuntu server we sat up in Part 1 of this article.

I used the following settings for my computer:
IP address:
Subnet mask:
Default gateway:

For the DNS server IP addresses you should get those values from your ISP, or your router.

Click OK

Step 3

Now while we have the Connection Propteries window still open lets open wholes in the firewall for the local computer.

Click the advance tab, and then the Settings... button.

If your firewall is off, turn it on and ensure the check box "Don't allow exceptions" IS NOT CHECKED.

Click the exceptions tab and add the following:
pop 110 TCP
smtp 25 TCP
OS1 8000 TCP
OS2 8001 TCP
OS3 8002 TCP
OS4 8003 TCP
OS5 8004 TCP
OS6 8005 TCP
OS7 8895 TCP

Then you need one of these for each sim your going to set up.
SIM11 9000 TCP
SIM12 9000 UDP

You also will want to go to your router and set this computer up as a static ip as well. And if you want others from the internet to connect you, will need to setup port forwarding on your router as well. There are detailed instructions on how to set up port-forwarding on your router on the PortFowarding website. Select your router from the list, then you will be taken to a page that lists most online games that need port-forwarding. At present, neither OpenSim nor OpenLife are listed, so the next best one to choose is Well of Souls, which also uses port 8000, and you can follow the procedure there for setting this one up, then repeating for the other ports listed above.

You will notice in the port above I included a POP and SMTP as well. This is so opensim can take advantage of those in the future.

Step 4

Well, we could start by downloading and installing all the tools needed.

We will need 2 things
1. TortoiseSVN - Download
2. Visual C# Express - Download (The green one)

Tortoise SVN is what will allow us to download the code.
Visual C# Express is a free compiler for the programming language c#.

Install Tortoise SVN with all the default options.


Now, when installing Visual C#. I did not install Silverlight runtime, or the SQL 2008 express edition. It would be a waste of space for what I am needing.

After both are installed you can delete the installs files you downloaded.

Step 5

Now lets get the source code.

Go to and choose the revision you would like.

If you click each revision link on the download page, you can see what exact version number, or revision number that depository is on.

I am going to choose "Bleeding edge alpha". So I copy the url "" for use in a couple minutes.
Should note, I tried the "" version and got errors, that i didn't get in bleeding edge.

Find a place you would like the files to live. I recommend making a folder "C:\OpenSim"

For permissions reasons you would not want something like this on the desktop.

Right click on your folder you just made, and click "SVN Checkout"

Now you need to paste that URL you copied ealier into the field "URL of repository" and click OK. It will begin downloading all the source code.

When the download finishes it will say "Completed a At revision: 8828" (or your current revision number).

Click OK.

Step 6

Time to compile the code. That sounds scary, doesn't it? The development team working on this project is top notch, and have made this so easy.

Go to "C:\OpenSim\" and find the file "runprebuild2008.bat" and run it.

Now run the file "compile.bat". While this stream of text runs by your screen, keep an eye out for the color red. If you see red, there was an error.

Thats it! It's compiled. But if you wanted to open up the project and do it yourself you can double click "OpenSim.sln".

Step 7

Lets create a folder for the production release of your OpenSim Grid. The reason I keep it in a separate file is so that nothing is ever overwritten that i don't want to be.

I recommend you make the folder "C:\OpenSimProd". Now copy everything in "C:\OpenSim\Bin" to the new folder you just made.

Step 8

Now lets set up some configurations in your "C:\OpenSimProd" folder.

Copy the file named "OpenSim.ini.example" then rename the copy to "OpenSim.ini".
First thing we are going to update is the database information.

Add a ";" in front of the following lines without a ";" in front of it already:

Find the following lines and remove the ";" in front of them and change the data source info to the database info from part 1 of this article:
estate_connection_string="Data Source=localhost;Database=opensim;User ID=opensim;Password=*****;";
asset_plugin = "OpenSim.Data.MySQL.dll" ; for mysql
asset_source = "Data Source=localhost;Database=opensim;User ID=opensim;Password=****;"
inventory_plugin = "OpenSim.Data.MySQL.dll"
inventory_source = "Data Source=localhost;Database=opensim;User ID=opensim;Password=****;"
userDatabase_plugin = "OpenSim.Data.MySQL.dll"
user_source = "Data Source=localhost;Database=opensim;User ID=opensim;Password=****;"

For the lines above you will want to replace the following:
Replace "Data Source=localhost;" with "Data Source=IPADDRESSOFTHEMYSQLBOX;".
Replace "User ID=opensim" with "User ID=root"
Replace "****" with your mysql root user password.

Step 9

Now lets start up OpenSim. This will create all the database tables.
It will ask you several questions, which most you can leave blank defaulting the answer to the value in the [].

Region Name [openSim Test] name your region here, anything you like *
Grid Location (X-Axis) [1000] do not change
Grid Location (Y-Axis) [1000] do not change
Internal IP address [] do not change
Internal IP Port [9000] do not change
External Host Name [] keep, for now *
First Name of Master Avatar [Test] change to whatever you like *
Last Name of Master Avatar [User] change to whatever you like *
Password for Master Avatar [test] keep or change to whatever you like *

After it is started up, you can even login if you like.
You would need to modify a shortcut to the SL client adding:

After you have had your fun go ahead and exit out of the sl client, and then type quit in your opensim dos window.

Step 10

Preparing for grid mode.

Open back up "OpenSim.ini"

Change all the following values:
grid_recv_key = "1234"
user_send_key = "1234"
user_recv_key = "1234"
allow_grid_gods = true
gridname = "Something kewl goes here"
gridnick = "skidzgrid"

The values 1234 can be changed. I searched the web for info on these values to determine if I could increase the number of digits, but could not find anything..

Add a ";" in front of the following:
physics = basicphysics

Uncomment out:
physics = OpenDynamicsEngine
This will allow you to jump. I have not tried them all but this one much better than basicphysics.

If you are going to run these sims on another server then you will want to change the following to point to this computer so they can connect. But since we are not now, don't.
login =
asset_server_url = ""
inventory_server_url = ""
user_server_url = ""
grid_server_url = ""

Save and close the OpenSim.ini file. You could spend a whole day reading and researching out all the options in this file. But I found a lot of them were not documented anywhere.

Step 11

Let's start some things up.

Start each one of these applications in this order after answering any questions they have.
Again most of the questions can be left blank and the value in the [] will be used.
For questions involving keys you will want to give the value you place in "grid_send_key" above (1234).
Almost all of the servers ask for a connection string which are formated like inside the ini file. You should write it out and copy it before you start:
Data Source=localhost;Database=opensim;User ID=opensim;Password=****;


To exit out of any of these you can just type quit to shut them down. But don't now, let it run a bit while you go to step 12, testing it out.

Step 12

You can now log onto your sim. You need to change your shortcut again. Now that we are running on the grid, you will login over port 8002. Add the following to the end of an sl link:
-loginuri http://IPOFTHEBOXWEJUSTSATUP:8002/

Step 13

In the future we will look at how to start the server automatically when the computer boots, but for now, I made a bat file to start them for me.
Create a text file and rename it to "StartMyGrid.bat"

Right click and edit, and paste in the following:
start OpenSim.Grid.UserServer.exe
PING -n 1 -w 10000 >NUL
start OpenSim.Grid.GridServer.exe
PING -n 1 -w 10000 >NUL
start OpenSim.Grid.AssetServer.exe
PING -n 1 -w 10000 >NUL
start OpenSim.Grid.InventoryServer.exe
PING -n 1 -w 10000 >NUL
start OpenSim.Grid.MessagingServer.exe
PING -n 1 -w 10000 >NUL
start OpenSim.exe

Save it, and close it.

The next time you want to start all the servers up you can now just run this file by double clicking it. The pings just pause between each server loading.


In the next part we will take a break from the really technical aspects of this, and talk about some basic tips and tricks to get you running on the sim well.

Also future follow ups:
Multiple sims
Logging on from outside your local network
Setting up email server
How to backup and restore opensim and a opensim database
How to upgrade your opensim to the latest build
How to set the servers up so they run automatically when the computer starts
How to set up a web interface for your grid
Last Updated on Sunday, 12 April 2009 08:29


0 #1 Tonya Hobbs 2009-12-23 09:02
Hello I have been spending all day with learning how to do this, i got to this page to step 8. I am totally lost right now on what i am to do on this step. can you help me??

Skidz Partz Shopping

Your cart is empty

Skidz Partz Blog RSS

Skidz Partz

SkidzPartz Login


Should the TMat 4.0 be made of Mesh? This does not mean it will support mesh, just made of mesh..

CB Workflows