Introduction

Having a a portable environment to easily share among developers using the zero footprint service approach if possible.

...

To get quickly started download the package that matches your operating system.

Eclipse Setup

You want to download the portal (tar.gz for Linux, zip for Windows) version of Eclipse and not the installer.

...

Download Eclipse IDE for Java EE Developers.

Select Location

Select a drive and directory your computer where you will be keeping everything. The Bonsai Framework uses,

• Windows = C:\apps\
• Linux or Unix = /home/[your home directory]/apps for example, /home/tpham/apps/
• Mac OS X = same as Linux

Mac OS X has a special file system for applications. You can not just browse to it normally. Go to your "apps" directory and you should see Eclipse.app,

1. Right click
2. Select "Show Package Contents"
3. Go into the "Eclipse" folder

Setup Package Java

Download Oracle's JRE (Java Runtime Environment) and follow the manual Java setup instructions.

...

• Windows = C:\apps\eclipse\jre1.6.0_18
• Linux or Unix = /home/tpham/apps/eclipse/opt/jre1.6.0_18
• Mac OS X = same as Linux

Modify eclipse.ini

Modify the eclipse.ini to point to your JRE with by adding -vm and a reference to Java.

Specifically with Mac OS, getting to eclipse.ini takes a few extra steps,

1. Right click the Eclipse package.
2. Select, Show Package Contents.
3. Expand folders, Contents, Eclipse
4. You should see eclipse.ini.

Edit with solid text editor.

...

Here is an example of eclipse.ini for Unix or Linux change the jre line to,

-startuplugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar--launcher.library-startup
plugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.gtk.linux.x86_1.1.2.R36x_v20101019_1345
-product
org.eclipse.epp.package.jee.product
--launcher.defaultAction
openFile
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
# ---------------------------
# Start Bonsai Framework
# -----------------------
# Use local version of Java.
# Note, these lines must come just before -vmwargs
-vm
jre1.6.0_18/bin/java
# -----------------------
# End Bonsai Framework
# --------------------------- 

For Mac OS X the jre line is slightly different and is unique to your own home directory,

# ---------------------------
# Start Bonsai Framework
# -----------------------
# Use local version of Java.
# Note, these lines must come just before -vmwargs
-vm
/Users/tin.pham/apps/eclipse/opt/java/jre1.68.0_18/121.jre/Contents/Home/bin/java
# -----------------------
# End Bonsai Framework
# --------------------------- 
-vmargs
-Dosgi.requiredJavaVersion=1.5
-XX:MaxPermSize=256m
-Xms40m
-Xmx512m

Setup Tomcat

Similar to Eclipse, Tomcat also is also packaged without an installer. For windows we download the x86 .zip and for Linux or Unix download the .tar.gz file. Following the Bonsai Framework standards, decompress to the following folder,

• C:\apps\eclipse\apache-tomcat-6.0.24
• /home/tpham/apps/eclipse/apache-tomcat-6.0.24

Launch Eclipse

Start Eclipse by running the Eclipse executable included with the release. In our example the directories would be,

• Windows = C:\apps\eclipse\eclipse.exe
• Linux or Unix = /home/tpham/apps/eclipse/eclipse
• Mac OS X = same as Linux

If using Mac OS X you may recieve will receive an error due to modification of the STSeclipse.ini file. To fix this switch to the directory where STS.app resides,

There are two ways of fixing this.

Clicking to Add to GateKeeper Rules

By manually adding Eclipse, you can remove yourself in the future.

Open the mac terminal and type the following,

su - setup.admin # My normal Mac User does not have sudo privileges, yours might.
cd ~/apps/
sudo spctl --master-disable

Then the error message turns to,

Click "open". This will add Eclipse into the GateKeeper Rules and everything should start.

Then enable the protection again,

sudo --label "Eclise" STS.app

...

spctl --master-enable

Now Eclipse will start properly.

When time permits, I will do a capture of the all registered rules to see exactly what the new rule fingerprint looks like and document the process here.

Manually Adding Eclipse to GateKeeper Rules

...

Open the mac terminal and type the following,

su - setup.admin # My normal Mac User does not have sudo privileges, yours might.
spctl --add --label "eclipse" Eclipse.app # Eclipse.app is the Eclipse package.

...

Look for the entry,

su - setup.admin # My normal Mac User does not have sudo privileges, yours might.
spctl --master-disable
sudo list | grep -i "eclipse"

You can remove the Eclipse by typing,

su - setup.admin # My normal Mac User does not have sudo privileges, yours might.
spctl --master-enable

I need to test on a fresh machine before saying 100%.

remove --label "eclipse" Eclipse.app # Eclipse.app is the Eclipse package.

Setup Tomcat

Similar to Eclipse, Tomcat also is also packaged without an installer. For windows we download the x86 .zip and for Linux or Unix download the .tar.gz file. Following the Bonsai Framework standards, decompress to the following folder,

• C:\apps\eclipse-servers\apache-tomcat-6.0.24
• /home/tpham/apps/eclipse-servers/apache-tomcat-6.0.24

Configure Eclipse to Use Tomcat

...

Ok this is where we have a problem. Once the Tomcat instance is created there seems to be no way to dynamically specify the various classpath entries... double-click on the server, Overview, Open Launch configuration, Classpath.

...

...