 |
Home | Changes | Index | Search | Go
Troubleshooting Guide for Wonderland
If you are having trouble getting Wonderland to start or to work properly once started, here are some suggestions that may help.
Basic Troubleshooting Advice
If you are having trouble getting Wonderland to start, the best way to get help from the community is to provide as specific information as possible when you report a problem. The things we need to know are:
- Operating system
- Java version (if known)
- Version of Wonderland
- Type of network setup (eg, direct connection to internet over DSL)
For many problems with Wonderland, the only way for us to figure out what is going wrong is to see the error log. In order to make these messages visible, you need to have the Java Console displayed when Wonderland runs. The method for showing the Java Console is different on different platforms.
Showing Java Console on Windows
- Make sure Wonderland is not running
- From the Start menu, select Control Panel.
- In the Control Panel, click on Java.
- In the Java Control Panel, click on the Advanced tab.
- Click on the + before Debugging and select Enable logging.
- Click on the + before Java console and click on Show console.
- Click OK
Showing Java Console on Mac OS
- Make sure Wonderland is not running
- Navigate to Applications --> Utilities --> Java
- Open Java Preferences
- Click the Advanced tab
- Under the Debugging heading, check Enable logging
- Under the Java console heading, click Show console
- Click Save and close the Java Preference dialog
Running Wonderland with Logging Turned On
Try running Wonderland again. Shortly after you see the Java splash screen, you should get a window titled "Java Console - Project Wonderland." At the point you get stuck, copy the entire contents of the Java Console window into a forum post that includes the information listed above as well as a description of what happened when things didn't work. Here's the general progression of events that should happen if everything is working properly:
- A Java splash screen appears
- The Java Console - Project Wonderland window opens
- Depending on the platform, you may get some messages that ask you to "trust"
- Launching application message appears with a progress bar
- If this is your first time running Wonderland, it should take some time and appear to be downloading content
- The Project Wonderland window opens - it should look black at this point
- Login dialog appears
- You should enter a user name (and password if your system has authentication turned on)
- After clicking Login, it should say "Connecting..."
- It's normal for there to be a delay before this message appears
- There is also no immediate feedback when you click Login (this is on the list to fix), so be patient and wait at least 20 seconds before deciding something is wrong
- The Users window and the Status window appear
- File names quickly show up and disappear in the Asset Manager pane of the Status window
- The 3D world appears
- Depending on the complexity of the world and the speed of your connection, you are likely to see the world appear incrementally
- Your name appears in the Users window in italics
- While the world is loading, your avatar is suspended in the air
- Once the world is fully loaded, your avatar floats down to the ground
- If your audio is properly set up, your name changes from italic to normal in the Users window
- You should now be able to use the arrow keys to move your avatar
- You should be now be able to speak and see the name above your avatar's head flash yellow
In your forum post, please let us know how far along in this progression you got.
Login Dialog Does Not Appear
Occasionally when you launch Wonderland, you will see a black Wonderland window, but the login dialog never appears. Quitting out of Wonderland using File --> Quit and restarting usually solves the problem. The next time Wonderland launches, the login dialog should appear, although some users have reported that they needed to restart a few times before the dialog showed up.
In case you're interested in the details, we believe this may be caused by a bug in Java. There is at least one report that moving to a newer version of Java (e.g. 1.6.0_06) solves this problem, but we haven't been able to confirm this yet. There is a P1 issue (#429) to track this problem.
Audio Does Not Work
Getting audio to work can often be a challenge. Here are some resources that should help you figure out how to set up your system for the best audio experience:
Platform Tips
Each operating system platform presents its own unique challenges -- here's a guide to help you through some of the platform-specific issues we have run accross:
|