Home | Changes | Index | Search | Go

Operating System Tips for Wonderland

This article contains tips and known issues for various operating system platforms.

If you're looking for general information about using Wonderland, please refer to the following documents:

• End User Guide
• Project Wonderland Keystroke and Mouse Quick Reference

All Platforms

Firewall ports used by Wonderland

Wonderland uses a range of ports for various features, including in-world audio and application sharing. Your firewall must be configured to permit traffic on this ports in order for Wonderland features to work correctly. In many cases your firewall may already be configured to allow this traffic, but if you experience problems, such as no audio, or issues with starting shared applications, you should review your firewall's configuration.

For further details refer to:

• Project Wonderland and Firewalls

Troubleshooting

Wonderland produces a log of its activity which can be very helpful to developers and support engineers in diagnosing problems. For information about enabling logging, refer to the following guide:

• Troubleshooting Guide

Vista issues

You must be administrator to run Wonderland on Windows Vista

On Windows Vista you must be logged in as the Administrator user to run Wonderland. For further details refer to http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6519127 and bug 305.

Windows Vista system crash when running Wonderland

A known problem with Windows Vista may cause a system crash when running Wonderland. This issue is documented in a Microsoft Knowledge Base article http://support.microsoft.com/kb/938194: "the computer stops responding or restarts unexpectedly when you play video games or perform desktop operations".

If you experience this problem, it is relatively easy to resolve. First, make sure your copy of Vista is up-to-date. In particular, make sure you have applied the update recommended in the referenced article. Then make sure your graphics card driver is up-to-date. Graphics driver updates may be listed under "optional updates", which you can find from the Start menu:

Start -> Control Panel -> Windows Update -> View available updates

You will need to manually select the optional update for your graphics card and install the update. If an update is not available and you still experience the system crash, check your manufacturer's web site for driver updates.

Further details are documented in bug 297.

Mac OS issues

Java 6 is not required

Wonderland now supports Java SE 5, so there is no need to install Java SE 6 to run Wonderland (unless you're running the Wonderland 0.3 release).

Java SE 5 is installed by default on Mac OS X 10.4 (Tiger) and 10.5 (Leopard).

To set the default Java version on Mac OS:

• Launch Applications...Utilities...Java...Java Preferences
• In the Java Application Runtime Settings section, drag J2SE 5.0 to the top of the list. Do not select the 64-bit Java runtime.

Can't get beyond login

Unless you have already removed the old Java 3D version from your system, you will need to follow the instructions here MacJava3DRemoval

Once you have done this, try starting Wonderland again.

Linux issues

Sun Java SE Runtime required

Many Linux distributions include the open source GNU Java Compiler (GCJ). This is not compatible with Wonderland. In order to run Wonderland on Linux you must install a Sun Java SE release. You can download Sun's Java SE Runtime Environment from:

• Sun Java SE Downloads

You do not need to download the Java Development Kit (JDK) if you only plan to run the Wonderland client. Wonderland is developed using the J2SE^? 5.0 JDK for platform compatibility. So, if you plan to get involved with Wonderland development, install JDK 5.0:

• JDK 5.0

The check which version of java you have installed, run the following command from a Terminal:

• java -version

If you have Sun's Java SE Runtime installed, you should see something like this:

java version "1.5.0_15"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_15-b04)
Java HotSpot?(TM) Client VM (build 1.5.0_15-b04, mixed mode, sharing)