 |
Home | Changes | Index | Search | Go
Download, Install, Configure and Run Project Wonderland (Binary Distribution)
Contents
This page describes how to download, install, configure, and run Project Wonderland from the binary
distributions of the software.
Prerequisites
Before you download and install the binary release of Project Wonderland, make sure you have met the following requirements:
- Operating Systems Supported: Windows XP/Vista, Linux (Debian/Unbuntu), Solaris 10, Mac OS X. Note: Only 32-bit operating systems are supported.
- Java SE 5 or 6 (either JRE or JDK), http://java.sun.com/javase/downloads/index.jsp
Download the Binary Distribution
To download the binary distribution of Wonderland, please visit the Wonderland binary download page:
https://lg3d-wonderland.dev.java.net/binary-builds.html
You have your choice of downloading either a Stable release or Nightly release. Stable releases are labelled
by a version number (currently, either v0.3 or v0.4. The preferred version is v0.4) and have gone through considerable
testing. Nightly releases are the binary distributions made each day, based upon the latest code.
It is a good idea to read both the README and RELEASE NOTES that come with the binary release and are available
on the binary download page.
Install the Binary Distribution
There are different ways to install the Wonderland binary distribution depending upon your operating system. Once you
have downloaded the Wonderland binary.
For Windows XP/Vista
The Wonderland binary distribution for Microsoft Windows XP/Vista comes with its own installer. To install, double-click
on the lg3d-wonderland*-setup.exe file. It will install Wonderland into C:\Program Files\Project Wonderland\{release-version}.
The installer also creates shortcuts in Start->All Programs->Project Wonderland->Wonderland {release-version}.
NOTE: If you are installing on Windows Vista, read the Release Notes for important information about running Project Wonderland on Vista.
For Mac OS X
A disk image is provided for Mac OS. To install, first download the dmg disk image and then double click it. This will open the disk image.
Now drag the item named Wonderland to your Applications folder.
For all other Operating Systems (Linux, Solaris)
For all other operating sytems, you will download a ZIP bundle of the Wonderland binaries. To install a ZIP bundle, download the ZIP bundle
for your operating system and unzip the file to the directory where you want to install Project Wonderland. This will create a lg3d-wonderland directory.
Configure the Binary Distribution (Basic)
The Project Wonderland software should require little configuration, if any at all. The
configuration options are stored within a properties file within the lg3d-wonderland
directory. The comprehensive list of properties and default values are stored within the
build.properties file.
You can override any of these properties by creating a my.run.properties file in the
Wonderland installation directory. Each entry is a key=value pair.
sgs.host
If you plan on running the Wonderland server on the same machine as the Wonderland
client (for example, for testing purposes), you may leave this property as-is. Otherwise, you
should set the IP address of your server.
For example,
sgs.host=18.203.0.46
Run the Binary Distribution
To run the Wonderland binary distribution, you will need to start three (possibly four) independent
processes: the Wonderland voice bridge, the Wonderland server, the Wonderland client. On Linux
and Solaris systems, you can also run the "Server Master Client" to enable the X11 Application
Sharing mechanism.
For Windows Vista/XP
- Start the Wonderland Voice Bridge: Start->All Programs->Project Wonderland->Wonderland {release}/Wonderland Voice Bridge. A DOS Command window will open and display log messages from the Voice Bridge.
- Start the Wonderland Server: Start->All Programs->Project Wonderland->Wonderland {release}/Wonderland Server. A DOS Command window will open and display log messages from the Server.
- Start the Wonderland Client: Start->All Programs->Project Wonderland->Wonderland {release}/Wonderland Client
- To shutdown Wonderland, exit the client by choosing File->Exit, then quit the Voice Bridge and Server DOS Command windows.
NOTE: If you are installing on Windows Vista, read the Release Notes for important information about running Project Wonderland on Vista.
For Mac OS X
- Use Finder to open the Applications folder and locate the Wonderland application.
- Ctrl-click the Wonderland icon and select Show Package Contents. This will display a list of files.
- Start the Wonderland Voice Bridge: Double click bridge.command to start the Voice Bridge. A Terminal window will open and display log messages from the Voice Bridge.
- Start the Wonderland Server: Double click server.command to start the Wonderland Server. A Terminal window will open and display log messages.
- Start the Wonderland Client: Double click the Wonderland icon in the Applications folder.
- To shut down Wonderland: Exit the client by choosing File->Exit, then quit the Voice Bridge and Server Terminal windows.
NOTE: Please read the RELEASE NOTES for special issues running Wonderland on Mac OS X.
For all other Operating Systems (Linux/Solaris)
- Navigate to the directory where you unzipped the Project Wonderland ZIP file, then change directory to lg3d-wonderland/bin.
- Start the Wonderland Voice Bridge: Run the wonderland-bridge.{version} file.
- Start the Wonderland Server: Run the wonderland-server.{version} file.
- Start the Wonderland Client: Run the wonderland-client.{version} file.
- Start the Server Master Client (Linux and Solaris only): Run the wonderland-smc.sh file.
- To shut down Wonderland: Exit the client by choosing File->Exit, then quit the Voice Bridge, Server and Server Master Client processes.
Uninstalling Wonderland
To uninstall the Project Wonderland binary distribution from your machine, perform the following steps:
For Windows XP/Vista
- To uninstall, use Add or Remove Programs in Control Panel.
For Mac OS X
- To uninstall, move the Wonderland application from your Applications folder into the Trash.
For all other Operating Systems (Solaris, Linux)
- To uninstall, just remove the lg3d-wonderland directory and the downloaded ZIP file.
What's Next
In addition to the basic installation procedures, there are a number of additional installation steps you may take under
different circumstances. The following provides links to other tutorials and articles to describe each:
|