Version 0.5 Latest Release (Updated monthly)
Descarga de Binarios (Spanish translation of this page)
Looking for source? Download, configure, build and run Open Wonderland source code.
This page describes how to install a Wonderland server from a binary "jar" file. This is an activity we recommend for system administrators, software developers, or advanced users. After installing a binary build, you will end up with an instance of a Wonderland server, including a web server component and several default Wonderland worlds. You will be able to provide users with a link to a web page which has a button to launch a Wonderland client.
Important Note: Even if you have successfully run a Wonderland client on your system, you may still need to upgrade Java to be able to run the Wonderland server. See the "Java SE 6 JDK" bullet below.
Before you download and install the binary release of Open Wonderland, make sure you have met the following requirements:
- Supported Operating Systems: Windows XP/Vista, Linux (Debian/Ubuntu), OpenSolaris, Mac OS X. If Wonderland does not seem to run on your system, see the note below on platform exceptions.
- Access to a command line: You will need to know how to use a terminal or command window to enter a few simple commands.
- Java SE 6 JDK: To set up a Wonderland server you need the Sun Java SE 6 JDK, version 1.6.0 update 14 or later (although the latest released version is preferred). If you already have Java installed verify that you have the JDK and not the JRE and that it's the Sun Java SE 6 version. Some Linux distributions include OpenJDK which may not be compatible with Wonderland. To verify that you have the Sun Java SE 6 JDK installed, follow these platform specific instructions:
Linux and OpenSolaris
Check to see if you have a /usr/jdk or /usr/jdk1.6.0_nn directory (where nn is a number such as 16). If you do, enter the following command to check the version you have installed:
If you have the Sun Java SE 6 JDK installed, you should see 1.6.0 in the command output:
java version "1.6.0_16" Java(TM) SE Runtime Environment (build 1.6.0_16-b01)Windows
Java HotSpot(TM) Server VM (build 14.2-b01, mixed mode)
Check to see if you have a C:\Program Files\Java\jdk1.6.0_nn directory. If you're running a 64-bit version of Windows, also check C:\Program Files (x86)\Java\jdk1.6.0_nn.
Mac OS X
The JDK comes pre-installed on most Macs, so you should already have it, but you need to be sure that Java SE 6 is set as the active Java version. Go to Applications > Utilities > Java Preferences, and make sure that "Java SE 6" is first on the list under "Java Applications." If not, drag "Java SE 6" to the top of the list If you don't see "Java SE 6" in the list, you will need to upgrade the version of Java installed on your system.
Note: Apple only provides the Java 6 JDK for recent 64-bit systems. If you have an older 32-bit system you will not be able to run the Wonderland server on your system.
Installing the Sun Java SE 6 JDK
If you are running a 64-bit operating system, please refer to the platform exceptions section for important notes on selecting the correct JDK. If you have a version of the JDK earlier than 1.6.0, then you will need to download the Sun Java SE 6 JDK from here: http://java.sun.com/javase/downloads/index.jsp Scroll down the page until you see "Java SE Development Kit (JDK)" and download the current update of the JDK 6 for your platform.
To download Java SE 6, follow these instructions: http://suport.apple.com/kb/HT3649
Install a Binary Build
If you are installing the stable release, click on the link named "wonderland.jar" above. This release is updated on the first day of every month. Each night (US Pacific time), a new Wonderland binary build is also created. These are known as the "nightly builds," or simply as a "nightly." To install the latest nightly build click on the "lastest nightly build" link above.
In either case, use the following steps to install Wonderland:
- Right click on either "Wonderland.jar" or the "latest nightly build" and save it to your computer. Note: Do not change the name of the jar file when you save it. If you want to keep track of which nightly is which, create a folder and name it with the date of the nightly. Then save the jar file in that folder. The jar files are large, so the download will take some time.
- Open a terminal or command window.
- Change directory to the location where you downloaded the jar file.
java -jar Wonderland.jar
java -server -jar Wonderland.jar
"\Program Files\Java\jdk1.6.0_16\bin\java" -jar Wonderland.jar
"\Program Files (x86)\Java\jdk1.6.0_16\bin\java" -jar Wonderland.jar
- Be patient while the Wonderland server starts up. You should soon see lots of messages fly by in the terminal window, including lots of warnings. Expect some pauses. The process will take a minute or two.
- Eventually you will see a message that includes the text "Wonderland web server started successfully." The entire message will look something like this:
Wonderland web server started successfully.
Log files are in /Users/username/.wonderland-server/0.5/log
Web server running on http://myserver:8080/
- Make a note of the log file directory. You will need this information when you wish to delete this build from your computer. In addition, this directory may contain useful information for reporting Wonderland problems.
- Copy and paste the URL in the last line of the message into a browser window to navigate to the Wonderland launch page. This is the URL you can give to end users to launch Wonderland.
- Click the "Launch" button on the web page.
Shutting Down the Wonderland Server
When you run Wonderland following the instructions above, the Wonderland server will stay running until you stop it. To stop the server, find the terminal window where you started it and type "Ctrl-C" to end the process. Closing the terminal window or shutting down the terminal program will have the same effect, so be careful to leave the window open and the terminal program running for as long as you or anyone else is still using Wonderland.
For most installations, there's no need to configure the Wonderland software, but if you have properties you would like to change, you can add them at the command line. For example:
java -Dwonderland.webserver.host=localhost -jar Wonderland.jar
Or you can pass in a properties file as an argument:
java -jar Wonderland.jar my.run.properties
To uninstall the Wonderland binary distribution from your machine, perform the following steps:
- Delete the Wonderland.jar file. If you placed the jar file in a directory with the date of the build, delete the directory.
- Delete the directory
~/.wonderland-server/[version-number]. The "~" notation means your home directory. The complete directory name was printed in your terminal window when you started the Wonderland server (see the log file location in Step 8 above).
There are a number of additional configuration steps you might be interested in, depending on how you plan to deploy Open Wonderland. The following articles and tutorials cover more advanced configuration options:
- Open Wonderland v0.5 Web-Based Administration
- Configuring a Open Wonderland Server Behind a Firewall or NAT
- Configuring Authentication
- Launching Wonderland Clients using Java Webstart
- Mac OS
- Apple only provides a 64-bit Java SE JRE/JDK, so you must have a 64-bit system (hardware). Note that the 32-bit server restriction above doesn't apply to Mac OS. The Wonderland server will run on the 64-bit JDK on Mac OS.
- Open Wonderland's Glassfish application server fails to find the JDK even if you set the JAVA_HOME environment variable. Please use the following workaround, adjusting the paths according to your Java installation:
"\Program Files\Java\jdk1.6.0_16\bin\java" -Djava.home="C:\Program Files\Java\jdk1.6.0_16" -jar Wonderland.jar
- If you have a 64-bit Windows operating system, you must install the 32-bit version of the Sun Java SE 6 JDK to run the Wonderland server. The Wonderland server is not compatible with the 64-bit JDK. If you just want to run the Wonderland client, you can use the 32-bit or 64-bit JRE. You don't need the JDK to run the client.
- Some Linux distributions include the OpenJDK which is not compatible with Wonderland. You must install the Sun Java SE 6 JDK. It's a good idea to uninstall OpenJDK. You can do this with the Package Manager. Search for "openjdk-6" and uninstall all packages with this prefix.