Join us in Outworldz at or follow us:

Troubleshooting manually

You can just run Help-Network Diagnostics and see what it says. Or troubleshoot it manually. The diagnostics do what is described below , but sometimes you just need to know more. So this is a list of things to try.

Running manually

There is a 'Go.bat' file that can start individual regions, e.g., 'go Welcome'.

Likewise Mysql has a StartManually.bat, and robust has a Robust.bat. You should start them in Mysql, then Robust, then each region order:

@remarkable batch file to start Dreamgrid manually.
@rem DreamGrid Only
cd mysql\bin
start startmanually.bat
cd ..\..\opensim
call runrobust.bat
call go Welcome
@ rem call go Someotherregion	

How to compile Dream World

The vast majority of this software is just Opensimlator and MySQL with edits in the INI files to allow auto-configuration by XML and INI editing.

The source code package "How_to_Compile.txt" explains how it is compiled, and what changes are made.

Universal Plus and Play Not Working? (uPnP)

Do you have Plug and Play (uPnP) issues?

This is a useful tool to look at uPnP in your router:

Free Upnp (Universal Plug and Play) Tool for Windows

You can add, delete and modify the settings without a password, assuming you have uPnP enabled. This is included in Dreamworld and Dreamgrid in the Help menu.

Download UpnP Tool 1.0


Windows will prompt you to allow Opensim to open ports when it first runs. If you say no, you will not be able to hypergrid out.

If you are using an Anti-virus with a firewall, such as ZoneAlarm, AVG Internet Suite, or anything else, running Start.exe my trigger the 3rd party firewall popup warnings. Opensim.exe needs to be allowed internet access, and Start.exe should be allowed to make changes. This code is digitally signed by me, Fred Beckhusen and, and is open source and available for inspection on


If it will acts wonky or is missing files, look in Help->Check for Updates. If it crashes and you cannot get to the updater, try a manual update. Save the following EXE in the folder where start.exe is and run it. It will repair any missing files.

There are two versions, one for Dreamworld, and one for Dreamgrid. Be sure to use the correct one.

If you have valuable content in your sim, make a copy of the entire folder somewhere, first. It will have copies of the region files and database we can recover if it is still broken.



Networking issues:

It needs two things: Open ports, and loopback.

First take a look at this on Port Forwarding.

It has a list of routers and instructions and links to which can help once you identify your router type.

Which ports? You need to open 8001, 8002, and 8004-8010( or higher) to have room for expansion. Don't do 8003 for security reasons. These can be done in ranges, like 8001-8002 and 8004-8010. The latter ones are for regions - you need one port per region, so this would let you have 7 regions. Add more if you want - nothing wrong with opening up to 8020 or 8030 or so. And they need to be both TCP and UDP. Your router will have a button or a pulldown to select UDP, TCP, or both.

How do I know this worked? You can tell if it worked by starting Opensim, and then use a web browser to go to, and enter 8002 when opensim is running. If that works, the ports are fine.

Mine looks like this: screen

Loopback Tests:

The second part that has to work is loopback - either your router supports it, or not. You can immediately tell if your loopback works after running the above CanYouSeeme tests. You use your web browser to navigate to http://(YOUR PUBLIC IP):8002/wifi . Mine was Of course, your IP address will be different than shown above, so use whatever it shows you. If the system is working, you get a web page, if not, it will just hang.

If it works, go the the Settings->Advanced Settings menu, and click the DNS Name field:

Advanced Menu

Click it and you get a pop up:


Either click Next Name until you see one you like, and press Save, or type a name like '". The name will not work with spaces, and no funny characters. Then click Save, and restart Opensim.

Now use that same name to add the Grid Settings to your viewer, (or just use Onlook, it knows already) and you should be set to go.

What to do if the loopback test fails.

Click this link and add the built-in windows driver. Then start over at "Loopback tests".

Add the Windows Loopback Adap[ter


This uses Universal Plug And Play (uPnP) and several diagnostics to configure compatible routers automatically. uPnP may be disabled, or fail. If your router does not support uPnP, you must manually open ports in your router and Port Forward them to your PC.

Diagnostics are run once upon installation. You can run them again (Help-Diagnostics) if you change the router setting manually. You may need to reset your router by cycling the router power if you change settings from the defaults. UPnP settings are removed when the program is stopped to keep your system safe.

Accessing the Hypergrid requires a compatible router with loopback. If your router does not support loopback, you can still join the hypergrid by installing a special Windows device driver. Additional Information of Routers and their confuiguration is available online at the Opensimulator site.

Help with Opensim crashes:

Your Mysql database may be crashed. This is a way to start MYSQL manually.

First, run the diagnostics in the Help menu. Then Navigate to the Outworldzfiles\mysql bin folder. Press and hold the Shift Key and right click the BLANK area next to the files. Or navigate there , as I did below, by typing in commands. Then run "StartManually.bat"

Opensim running

Any error message it prints may be be helpful. If it crashes, a MySQL LOG file will be saved in OutworldzFiles\mysql\data as a *.err file. That may also give you a clue.

Starting over with a blank database

You can wipe ALL data out and recreate it from OAR and IAR files. This WILL LOSE ALL DATA. If you MUST wipe out the database and start over, delete the ib_logfile0, ib_logfile1 and ibdata1 file in OutworldzFiles\mysql\data ( leave the folders). Then delete just the contents of data\opensim\*. Leave mysql\data\mysql alone. This will make it start over at the very beginning and you need to re-enter your Avatar name and password and reload everything.

Running Opensim without Dreamworld

You can run Opensim manually after your run Dreamworld and get everything set up.

Start Mysql: There is a batch program in Outworldzfiles\mysql\bin\ named StartManually.bat. It will run Mysql and get it ready. You can also install mysql as a service by running mysqd.exe --install --inifile="path to yy.ini\my.ini". You have to fuill the path in to the my.ini file.

Start Opensim. Navigate to the Outworldzfiles\opensim\bin folder for V 0.8.2./1, or Outworldzfiles\opensim-0.9\bin folder for version 0.9.0. Run opensim.exe.


Here is more detail about ports and they way the interact with the outside world such as and to my diagnostics tests.

Put simply, only port 8002 can report back to those tools as to being open, and can do so only when Opensim is running.

Port 8001:

8001 is a TCP/HTTPport that is open only for a brief moment, and only when you run help->Network diagnostics. It is unique to Dreamworld. It is used twice, once for a "port forward" test, just like does, and once for a loopback test, and is closed immediately after each test occurs. So it will not answer to your request, as the web server is offline.

In the new V2 Dream Grid, port 8001 remains open to HTTP requests. This is for regions to communicate to Dreamgrid so it knows when a region LOGIN is enabled. At the moment, all it does it turn on a green icon.

Port 8002:

Opensim has a web server that web browsers understand, using the same protocol (TCP/HTTP) that tools like support. Put simply, Opensim is the only thing that listens to port 8002 and answers to http:// requests on 8002. Port 8002 is like port 80, the default port for web pages. You can actually set Drteamworld's 8002 port to 80, and it will work. You can then drop the need to type :8002 at the end of your hyperlink. does this. There would be no need to type the :80, as literally http:// means "add a :80 to the end of it". So only 8002 works with web-based probe tools. If you do switch it to 80, then you forfeit using an additional web server on your home machine. Only one program can listen to a port.

If Opensim is not running and your ports are open, it is as if you tried to connect to's web server, but their web server is down. Nothing will happen, though your packets can get through the Google firewall because it is still open to traffic and is steering it to a dead server. You will get no answer. Similarly, if Openim is not running, there is no web server to answer the request.

Port 8003:

This port is heard by Opensim, so regions can chat to the server database for login, presence, and other services such as the region database so peopel can teleport from one region to another. in standalone HG sims like DreamWorld, regions must be on the same machine. In Dreamgrid, just like osGrid or any other remotely attachable grid, the regions can run on any machine anywhere in the world.

If you opened port 8003 to anyone on the web, you expose the internal database protocol to the web. will not get a HTTP response, thus the tools report the port as not open. Anyone with the right knowledge could attach a region to your sim. If you run a DreamGrid and host regiona outside your LAN, it is recommended you use firewall rules to only allow access from know IP addresses running approved regions.

Port 8004 and upwards:

The region ports (8004-upward) run UDP, using a protocol that does not support HTTP. UDP is a one-way, lossy, streaming protocol, and is not HTTP-based, so those web sites have no idea how to stimulate a response, so they think the port is closed. But a viewer does know how. Likewise, trying to run on port 8004 aor any port upwards is like trying to fetch a Mpeg4 movie from a Netflix streaming channel without knowing the protocol or logging in.

UDP is used in Opensim as the viewer is allowed to drop packets at any time and for any reason at all. UDP cuts the load on the server dramatically as there is no need to automatically always ACK every packet. As one example, no one cares if a audio stream gets briefly interrupted as you cannot hear it anyway, and it is too late to use it if it comes later in a retry. It just gets discarded.

Back to the Best Free Tools in Second Life and OpenSim.