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.

<-- This creates the navigation links to :  Home | Help | Index | etc.  -->

Operating System Tips for Wonderland

<-- Your JavaDesktop? article goes here. Please try to include at least one sentence describing this topic. -->

<-- Also please try to include at least one sentence describing where each link goes. -->

<-- Please make sure some other page points to your new article so that others can find it! -->

<-- For more on how to write Javapedia articles please read the WritingArticles? page. -->

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.5 (Leopard).

Can't get beyond login

There is a problem on Mac OS that involves the incorrect version of Java3D being installed on your system. Unfortunately, most Macs ship with an old version of the software, and due to a bug, we are not able to automatically update this software for you. If you are on a Mac and this is your first time running Wonderland and you get as far as the login screen, but no farther, it's likely that this is your problem. Here are the steps to remedy the problem:

• Open a Terminal: Applications -> Utilities -> Terminal, and then enter the following commands:
  • cd /System/Library/Java/Extensions
  • sudo mkdir j3d-old
  • sudo mv j3d* libJ3D* vecmath.jar j3d-old

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)