Installing Sun Wonderland on OpenSolaris 2008.11
Wondering how to Install Sun Wonderland on OpenSolaris ???
Well, as a part of our research, we have installed a Sun Wonderland Server instance on OpenSolaris 2008.11, as well as on Ubuntu 8.10. Installing Sun Wonderland is Easy. You can finish it in 7 easy steps.This tutorial assumes that you have the basic knowledge of working on a Unix Based machine.If you are new bee.. No worries.... Just follow the steps.I have illustrated the modus-operandi to be followed to install a Sun Wonderland Instance on an OpenSolaris Operating System. We will be building the Wonderland instance from the source. My machine configuration is as follows. The Wonderland Server instance ran absolutely fine with this configuration
Machine Configuration:
$ dmesg | grep CPU
Processor: Intel(r) Core(tm)2 Duo CPU T7250 @ 2.00GHz
$ prtconf
System Configuration: Sun Microsystems i86pc
Memory size: 4095 Megabytes
Graphics Card : NVIDIA GeForce 8600M GT: 256 Megabytes.
$ uname -a
SunOS Kapil-PC 5.11 snv_101b i86pc i386 i86pc Solaris
$ isainfo -v
64-bit amd64 applications
ssse3 cx16 mon sse3 sse2 sse fxsr mmx cmov amd_sysc cx8 tsc fpu
32-bit i386 applications
ssse3 ahf cx16 mon sse3 sse2 sse fxsr mmx cmov sep cx8 tsc fpu
This output means this system is capable of supporting both 32-bit and 64-bit applications.
Pre-Requisites:
Following softwares will be required for you to proceed with your installation. A detailed methodology to install these softwares are illustrated below. A wikipedia link has been associated with each of these prerequisites to give you a brief idea on these technologies.
- Apache ANT 1.7.1
- Java SE Development Kit (JDK 6)
- OpenSolaris 2008.11
- The machine should be based on an X86 Architecture, as X86 alone supports the application sharing functionality.
- Concurrent Versions System (CVS)
- SubVersion (SVN)
STEP 1
Apache ANT Installation:
-
You may download the latest Apache-ANT release from the following link. http://ant.apache.org/bindownload.cgi
-
I have installed the Apache-ANT version 1.7.1
$ ant -version
Apache Ant version 1.7.1 compiled on June 27 2008
-
Unzip the downloaded version to your desktop (or to any of your file system). I have unzipped it to my desktop and I have the following directory structure.
$ pwd
/export/home/Kapil/Desktop/apache-ant
-
Update the .profile file with the following values to the variables
a) Update the “PATH” variable with the location of the /apache-ant/bin directory. Please have a look at the following example. The underlined part is the one which I have added.
Example: PATH=/usr/gnu/bin:/usr/bin:/usr/X11/bin:/usr/sbin:/sbin:/usr/java/bin:/export/home/Kapil/Desktop/apache-ant/bin
b) Add a new variable ANT_HOME and provide it with the location of apache-ant directory.
Example: export ANT_HOME=/export/home/Kapil/Desktop/apache-ant
-
The altered .profile file will look like the one cited below.
$ pwd
/export/home/Kapil
$ gedit .profile
#
# Simple profile places /usr/gnu/bin at front,
# adds /usr/X11/bin, /usr/sbin and /sbin to the end.
# Use less(1) as the default pager for the man(1) command.
#
export PATH=/usr/gnu/bin:/usr/bin:/usr/X11/bin:/usr/sbin:/sbin:/usr/java/bin
:/export/home/Kapil/Desktop/apache-ant/bin
export MANPATH=/usr/gnu/share/man:/usr/share/man:/usr/X11/share/man
export PAGER="/usr/bin/less -ins"
export ANT_HOME=/export/home/Kapil/Desktop/apache-ant
export JAVA_HOME=/usr/java
#
# Define default prompt to <username>@<hostname>:<path><"($|#) ">
# and print '#' for user "root" and '$' for normal users.
PS1='${LOGNAME}@$(/usr/bin/hostname):$(
[[ "${LOGNAME}" == "root" ]] && printf "%s" "${PWD/${HOME}/~}# " ||
printf "%s" "${PWD/${HOME}/~}\$ ")'
-
You can either re-run the ~/.profile file or log-off and log-back in to facilitate a proper installation. This is done to enable the shell to load the newly defined environment variables.
-
You may check whether ANT is properly installed by issuing the command “ant -version” in the terminal. A proper installation will return you the following.
$ ant -version
Apache Ant version 1.7.1 compiled on June 27 2008
STEP: 2
Java Development Kit Installation
- Download the JDK 6 from the following link.http://java.sun.com/javase/downloads/index.jsp
- Select Java SE Development Kit (JDK) 6 and click on “Download”
- Select platform as “Solaris – X86” and download the JDK.
- There is a detailed blog on the installation of JDK and NetBeans IDE on Solaris in the following link. Thanks Brian ;-)http://weblogs.java.net/blog/bleonard/archive/2008/06/opensolaris_200_1.html
- Make sure you add the JAVA_HOME and PATH Variables in .profile file appropriately.
- You may need to log-off and log-on to facilitate a proper installation. This is done to enable the shell to load the newly defined variables.
- You may check whether JDK is properly installed by issuing the command “java -version” in the terminal.A proper installation will return you the following.
$ java -version
java version "1.6.0_10"
Java(TM) Platform, Standard Edition for Business (build 1.6.0_10-b33)
Java HotSpot(TM) Server VM (build 11.0-b15, mixed mode)
STEP: 3
Install CVS
- You may use the Solaris Package Manager to install the CVS Package.
- System → Administration → Package Manager to invoke the package manager.
- In the search box of the Package Manager ,search for “CVS” from the repository “opensolaris.org”
- This will return “SUNWcvs”. Just Select it and click the “Install/Update” button.
- This will install CVS on your Solaris Instance.
- The following link will provide the information on CVS
- http://www.nongnu.org/cvs/
- You may check whether CVS is properly installed by issuing the command “cvs -version” in the terminal.A proper installation will return you the following.
$ cvs -version
Concurrent Versions System (CVS) 1.12.13 (client/server)
Copyright (C) 2005 Free Software Foundation, Inc.
Senior active maintainers include Larry Jones, Derek R. Price,
and Mark D. Baushke. Please see the AUTHORS and README files from the CVS
distribution kit for a complete list of contributors and copyrights.
CVS may be copied only under the terms of the GNU General Public License,
a copy of which can be found with the CVS distribution kit.
Specify the --help option for further information about CVS
STEP: 4
Install SVN
- You may use the Solaris Package Manager to install the SVN Package.
- Traverse to System → Administration → Package Manager to invoke the package manager.
- In the search box of the Package Manager, search for “svn” from the repository “opensolaris.org”
- This will return “SUNWsvn”. Just select it and click the “Install/Update” button.
- This will install CVS on your Solaris Instance.
- The following link will provide more information on CVS. http://subversion.tigris.org/

STEP: 5
Open an account in Java.net.
- If you dont have an account in java.net, follow the below mentioned process.
- Traverse to the link https://www.dev.java.net/servlets/Join
- Register yourself as a user.
STEP: 6
Well now we are all set to Install Wonderland.
-
Create a Folder Wonderland on your file system.
-
I have created the folder on my desktop.
$ pwd
/export/home/Kapil/Desktop/Wonderland
-
Traverse to the folder 'Wonderland' which you have created.
-
The next step is to download the Wonderland work space from the CVS repository to your local machine..
-
Now issue the following commands from your terminal.
$ cd ~/Desktop /Wonderland
$ cvs -d :pserver:<username>@cvs.dev.java.net:/cvs login
$ cvs -d :pserver:<username>@cvs.dev.java.net:/cvs checkout lg3d-wonderland
-
You should provide your username, which you have created at Java.net to login to the CVS repository. Replace the :<username> with your username at Java.net.
-
You will then be prompted for your password at java.net and you can notice that the Wonderland work space will be downloaded to your local machine.
-
The project name will be lg3d-wonderland and after download, a new folder lg3d-wonderland will be present in the Wonderland directory.
-
Now we need to install the wonderland add-ons. These add-ons consist of a collection of add-on modules like the PDF Viewer, and the audio and video recorder for Sun Wonderland. The source for these add-on modules is available via a subversion workspace. You should place your wonderland-modules workspace in the same directory as your lg3d-wonderland workspace.
-
Now issue the following commands from your terminal.
$ cd ~/Desktop/Wonderland
$ svn checkout https://wonderland-modules.dev.java.net/svn/wonderland-modules/trunk wonderland-modules --username <username>
-
You should replace <username> with your java.net user name.
-
You will then be prompted for your password at java.net and you can notice that the wonderland-modules work space will be downloaded to your local machine.Download the lg3d-wonderland-art workspace You should download the artwork if you plan to host the artwork that comes with Project Wonderland yourself (e.g. if you are behind a firewall and can't access the public art web server), or if you plan on creating new worlds that include the Project Wonderland artwork along with your own, new art. Now issue the following commands from your terminal.
$ cd ~/Desktop/Wonderland/lg3d-wonderland
$ pwd
/export/home/Kapil/Desktop/Wonderland/lg3d-wonderland
2. From this location issue the following command. This will compile all the java sources and will make the built.
$ant
3. Now open a new terminal and traverse to the ~/Desktop/Wonderland/lg3d-wonderland directory.
$ cd ~/Desktop/Wonderland/lg3d-wonderland
4. From this location issue the command “ant run-sgs”. This will start the Sun Wonderland Server.
$ ant run-sgs
Once the server is ready you will get the following information in the console.
[java] INFO: Wonderland: application is ready
5. Now we need to startup the voice bridge. Open up a new terminal and issue the following commands.
$cd ~/Desktop/Wonderland/lg3d-wonderland
$ant run-bridge
6. Now we need to start up the Wonderland Client. Open up a new terminal again and issue the following commands.
$cd ~/Desktop/Wonderland/lg3d-wonderland
$ant run
Now you can see that a new window opens up and will be prompted for a username and password.
You can provide a name of your wish and get started with the Sun Wonderland. Welcome to Wonderland.