You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 25 Next »

This page is currently under construction.

This page is designed to be a ground floor installation procedure for installing Web Objects in Eclipse via the WOlips plugin.  This guide assumes OSX Lion (10.7), the instructions are the same for Snow Leopard (10.6).

There are four sections to this installation process.

Step 1:  Install the latest version of Eclipse

If you already have Eclipse installed, you may skip this step.

Head over to the Eclipse Foundation and download the latest version of Eclipse suitable for your OS X version.  

Eclipse does not install as a package, rather it is simply a compressed archive.  Installation is as simple as extracting the Eclipse folder, entering it and running the Eclipse executable.  In this context, it is important to remember where the folder resides on your system for future use.

It is important to run the Eclipse executable at this time.  Lion will prompt you to install Java Runtime (if it is not already installed), which is required for the next step.  (Snow Leopard situation?)

Step 2:  Install WOlips plugin and the Web Objects Framework

Please visit Install WOLips through Eclipse update manager.

Once this is done, perform the following terminal commands:

$ sudo mkdir -p /Developer/Versions/WebObjects543
$ curl -O http://webobjects.mdimension.com/wolips/WOInstaller.jar
$ sudo java -jar WOInstaller.jar 5.4.3 /Developer/Versions/WebObjects543
$ mkdir -p "~/Library/Application Support/WOLips"

Step 3:  Link the Framework to WOlips through the properties configuration file

Prerequisite: Eclipse with the WOlips plugin installed, and the WebObjects framework via step 2.

This is the most intricate step in the installation process.  The configuration file found in the WOlips preferences must correctly reference the framework directory structure.  Failure to successfully complete this step will result in broken libraries.

Running the script from step 2 installs the WO framework to the /Developer/WebObjects543 directory on your system. Below is the contents for a configuration file that matches this setup.  Create a new file called wolips.543.properties.  Copy the code below (after modification) into that file.

You must replace <YOUR_USER_NAME_HERE!> with your the username which installed the framework.

wo.system.root=/Developer/Versions/WebObjects543/System
wo.user.frameworks=/Users/<YOUR_USER_NAME_HERE!>/Library/Frameworks
wo.system.frameworks=/Developer/Versions/WebObjects543/System/Library/Frameworks
wo.bootstrapjar=/Developer/Versions/WebObjects543/System/Library/WebObjects/JavaApplications/wotaskd.woa/WOBootstrap.jar
wo.network.frameworks=/Network/Library/Frameworks
wo.api.root=/Developer/ADC%20Reference%20Library/documentation/WebObjects/Reference/API
wo.network.root=/Network
wo.extensions=/Developer/Versions/WebObjects543/Library/WebObjects/Extensions
wo.user.root=/Users/<YOUR_USER_NAME_HERE!>
wo.local.frameworks=/Developer/Versions/WebObjects543/Library/Frameworks
wo.dir.local.library.frameworks=/Developer/Versions/WebObjects543/Library/Frameworks
wo.apps.root=/Developer/Versions/WebObjects543/Library/WebObjects/Applications
wo.local.root=/Developer/Versions/WebObjects543
wo.dir.user.home.library.frameworks=/Users/<YOUR_USER_NAME_HERE!>/Library/Frameworks

Place this file in ~/Library/Application Support/WOLips, this directory should already exist and contain the default wolips.properties file.

The second part of this step is to link the WOlips plugin with the WO framework installed on your system.  This is done through the tab found at Eclipse menu -> Preferences -> WOlips.

It is important to realize that if you change the WOlips Properties File to "wolipse.543.properties" and then hit "apply" it will write out the (now stale) field values to that file.  This could potentially clobber your new wolipse.543.properties file with the default values.  If you suspect this has happend, close the WOlips preferences and inspect the wolipse.543.properties file.

Change the "WOlips Properties File" to wolips.543.properties and click OK.

Address simple issues that may have come up...

*Picture of broken libraries*

(link to wiki page for resolving the "broken libraries" issue).

You may need to manually create a wolips.properties file in ~/Library/Application Support/WOLips, if Eclipse is complaining about unbound libraries and the Libraries dialog (in the Build path) don't show any frameworks.

At this point, you should have a functioning Web Objects platform to work with, visit <hello world link> to test your first Web Objects application.

Step 4:  Import Project Wonder into your Eclipse workspace

 Please follow this guide:  Getting the Wonder Source Code, inside this page there is a link to instructions for importing the Project Wonder source into your Eclipse workspace.

Project Wonder is a significant part of the Web Objects experience.  Where the previous step seems to give new users the most grief now, this step will give you the most pleasure when working with Web Objects.

Step 5:  Install OpenBase (SQL database) and link it to the Enterprise Objects Modeler (EOModel)

  • No labels