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 or a special Windows Device Driver. 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.
You may also have to manually add firewall rules to allow incoming traffic on the ports.
Disabling the firewall manually:
1. On the client operating system, go to Start>Run and type firewall.cpl. The Windows Firewall window opens.
2. Click on the “Advanced Settings” link on the left pane. The Windows Firewall with Advanced security window opens.
3. Click on the “Inbound Rules” option.
4. On the left pane, click on “New rule”.
5. Under “Rule Type” select the option “Port” and click next.
6. Select “TCP”and “specific local ports” options.
7. Key in the port number, the port is 8001-8010 ( or higher for more regions)
8. Click Next.
9. Select the option “Allow the connection”.
10. Click Next, do not change any option here and click Next again.
11. Specify a name for this rule.
12. Click Finish.
14. Repeat the above using UDP for step 6
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.
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.