You can just run Help-Network Diagnostics and see what it says. Or troubleshoot it manually, step-by-step. The diagnostics essentially do what is described below, but sometimes you just need to know more. So this is a list of things to try.
Diagnostics are run once upon installation. You can run them again (Help->Diagnostics).
Try this first:
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. I use 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.
Try this next
Go to Settings -> Expert mode, click the DNS button at top left, and enter '127.0.0.1'. Then restart the grid, and use http://127.0.0.1:8002 as the grid in the viewers "Add Grid" menu.
You should also be able to see the Systems admin web page with a viewer by clicking the above link.
Open up your viewer. Now add the grid http://127.0.0.1:8002 to the viewer. You should now be able to log in on the Server from the Server.
You should see the Welcome region spit out a lot of text as you log in. If this fails, it is not your network, router, or loopback. You probably forgot the password. You can rest it it with the command 'reset user password' in the Robust screen.
How to get on the Hypergrid
Accessing the Hypergrid easily requires a compatible uPnP router with loopback. If your router does not support loopback, you can still join the hypergrid by installing a special pointer in /etc/hosts. Additional Information about known good and known bad routers is available online at the Opensimulator site.
Universal Plus and Play Not Working? (uPnP)
Do you have Plug and Play (uPnP) issues? Your Help menu has a useful tool to look at uPnP in your router:
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.
uPnP not working?
You can still manually forward ports.
Windows will prompt you to allow Opensim to open ports when it first runs. If you say no, you will not be able to log in.
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 of Outworldz.com, and is open source and available for inspection on https://www.github.com/Outworldz.
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.
Step 1) Get your PC LAN IP address by going to a DOS prompt and typing 'ipconfig'.
In the above photo, my IP was 192.168.1.3. Yours is likely to be in the range 192.160.*.*, but it could also be a 10.0.*.* number.
For my Linksys, it looks like this:
The Shoutcast setting is used when you are running the Icecast/Shoutcast server.
Which ports? You need to Port-Forward 8001, 8002, and 8004-8010 (or higher, I usually open up to 8050) 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. In the above photo, I have opened up ports 8004 through 8005.
They need to be open for 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 Opensimulator, and then use a web browser to go to http://www.canyouseeme.org, and enter 8002 when Opensimulator is running. If that works, the ports are fine.
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.org tests. You use your web browser to navigate to http://(YOUR PUBLIC IP):8002. Mine was http://22.214.171.124:8002. Of course, your IP address will be different than shown here, so use whatever CanYouSeeme shows you. If the system is working, you get a web page.
If it works, go the the Settings->Expert Settings menu, and click the DNS Name field.
Click it and you get a pop up, where you can enter your desired DNS name
Either click Next Name until you see one you like, and press Save, or type a name like 'Whatever.Outworldz.net". The name will not work with spaces, and no funny characters. Then click Save, and restart Opensim.
You use your web browser to navigate to http://(YOUR NEW NAME):8002, such as http://Whatever.Outworldz.net:8002. If you get the web page, use that same name to add the Grid Settings to your viewer, and you should be set to go.
What to do if the loopback test fails.
Click Add the Windows Loopback Adapter and follow instructions.
Help with Opensim crashes:
Your Mysql database may be crashed. This is a way to start MYSQL manually.
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"
Any error message it prints may be be helpful. If the above DOS window closes, a MySQL LOG file will be saved in OutworldzFiles\mysql\data as a *.err file. That wil give you a clue as to what to do.
My database still did not start. Try running Outworldzfiles\mysql\bin\Repair_ISAM.bat.
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 the folder "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.
PortsHere is more detail about ports and they way the interact with the outside world such as www.canyouseeme.org 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.
8001 is a TCP/HTTPport that is open for help->Network diagnostics. It is unique to Dreamworld. It is used for a "port forward" test, just like Canyouseeme.org does, and for a loopback test. It also collects data on sim's going up ad down.
Opensim has a web server that web browsers understand, using the same protocol
(TCP/HTTP) that tools like www.canyouseeme.org 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 Dreamworld's
8002 port to 80, and it will work. You can then drop the need to type :8002 at the
end of your hyperlink. http://hg.Osgrid.org 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
If Opensim is not running and your ports are open, it is as if you tried to connect
to www.google.com'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.
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 people can teleport from one region to another. In 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. 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 both TCP and UDP. UDP is used for the viewer. 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.
Running manuallyYou can run Opensimulator without Dreamgrid. Dreamgrid sets up Opensim to run. Once it has run once, you can run Opensim without it.
How to compile Dream Grid
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.
Back to the Best Free Tools in Second Life and OpenSim.