Skip to Content

Wiki source code of Project Wonder Installation

Last modified by Lazy Lazarus on 2025/03/28 12:18
Hide last authors
Bastian Triller 192.1 1 This page is the starting point for beginning development with [[Project Wonder>>doc:WONDER.Home]]. Developing rich web applications with Project Wonder requires the installation of three primary components: the development environment, the WebObjects Frameworks, and the Project Wonder Frameworks. The development environment is comprised of [[Eclipse>>url:http://www.eclipse.org/||shape="rect"]] and [[WOLips>>doc:WOL.Home.WebHome]], the latter being a set of plugins that provide a rich and specialized toolset for developing Wonder applications within the ubiquitous Eclipse Java IDE.
munch 97.1 2
Samuel Pelletier 184.1 3 There is an alternative install guide as part of the [[Learning The Wonders>>url:https://learningthewonders.com/||shape="rect"]] book, which also contains the procedure to install this on Windows.
Timothy Worman 55.1 4
Samuel Pelletier 184.1 5 The guides here assume you are using macOS 10.13 (High Sierra) or higher. There are four sections to this installation process.
6
pyu 161.1 7 Overview of Steps:
Theodore Petrosky 187.1 8 - install Eclipse (if necessary)
9 - install WOLips Plugins for Eclipse
10 - install WebObjects frameworks and configure WOLips
11 - install Project Wonder and import into your workspace
Timothy Worman 55.1 12
Lazy Lazarus 193.1 13 === **Step 1: Install the latest version of Eclipse** ===
Timothy Worman 139.1 14
Lazy Lazarus 193.1 15 First of all, you need a Java JDK installed. If you don't have it yet, get it from [[Adopt Open jdk >>url:https://adoptopenjdk.net||shape="rect"]]. As of January 2020, Eclipse install fails with Java 11-DCEVM, start with Java 8 and Install Java 11 after. To install a DCEVM and Hotswapper Java 11, you download prebuild binary [[here>>url:https://github.com/TravaOpenJDK/trava-jdk-11-dcevm/releases||shape="rect"]] and install by extracting the archive in ##/Library/Java/JavaVirtualMachines/##.
munch 97.1 16
Lazy Lazarus 193.1 17 === (% id="cke_bm_73797S" style="display:none" %) (%%)Important hint/comment for using JDK versions > 11 LTS ===
Theodore Petrosky 187.1 18
Lazy Lazarus 193.1 19 WOLips / WebObjects can be used with jdk-17. However, you need to add
Theodore Petrosky 187.1 20
Lazy Lazarus 193.1 21 {{code language="sh"}}
22 --add-exports java.base/sun.security.action=ALL-UNNAMED
23 {{/code}}
munch 115.1 24
Lazy Lazarus 193.1 25 to the (Debug) Configurations VM arguments or my app would not compile.
26
27 [[image:VM Arguments.png]]
28
29 === Further installtion ===
30
31 Head over to the Eclipse Foundation and [[download>>url:https://www.eclipse.org/downloads/||shape="rect"]] the latest version of **Eclipse IDE **suitable for your OS X version.
32
33 (The last version that runs on Mac OS X 10.15 Catalina is 2023-12, 4.30.)
34
35 Run the installer and follow the process, installing "Eclipse IDE for Java Developers". We don't need the EE stuff for Wonder. After completing the install, launch Eclipse to verify it's working. Close the welcome screen.
36
Maik Musall 173.1 37 [[image:attach:eclipse_installer.png]] [[image:attach:eclipse_installed.png]]
38
Pascal Robert 167.1 39 == **Step 2: Install WOlips plugin and the WebObjects Framework** ==
Timothy Worman 131.1 40
Maik Musall 180.1 41 1. (((
42 ===== Install WOLips Plugin =====
43 )))
44
Pascal Robert 167.1 45 Currently you have a stock Eclipse installation which will allow you to do normal Java development, but it does not contain any of the WOLips plugins, so you will not have any of the WebObjects development tools. To begin your WOLips installation, from within Eclipse, select **Help** => **Install New Software...**
Timothy Worman 131.1 46
Maik Musall 173.1 47 [[image:attach:eclipse_installNewSoftware.png]]
Timothy Worman 131.1 48
Maik Musall 173.1 49 This opens the "Install" panel where you can specify sites for Eclipse to download new software features. This dialog allows you to add/inspect any software features you have downloaded or were included in your default install of Eclipse. To install WOLips you will need to add the WOLips update site to Eclipse. You do this by clicking the "Add" button.  In the Name field you can enter a name for your update site. The name is arbitrary but since you could have multiple similar update sites you should give it a name that leaves no doubt about what it is.
50
51 In the Location field, enter the following URL for Eclipse 2018-12: [[https:~~/~~/jenkins.wocommunity.org/job/WOLips410/lastSuccessfulBuild/artifact/temp/dist/>>url:https://jenkins.wocommunity.org/job/WOLips410/lastSuccessfulBuild/artifact/temp/dist/||shape="rect"]]
52
53 [[image:attach:eclipse04_software_add.png]][[image:attach:eclipse05_software_wolipsRepo.png]]
54
55 You are returned to the "Install" panel, the WOLips site having been added to the list, and fully expanded to display all its offerings. Select features you want. If you're just getting started with WOLips you should select "WOLips" and "WOLips Goodies." Leave the other options until you are more familiar with Eclipse and WOLips and decide that you need them. After selecting the options you want, click "Next." You'll briefly see a progress bar while Eclipse "calculates requirements and dependencies."
56
57 [[image:attach:eclipse06_wolips_packages.png]]
58
59 Click Next, accept the license, confirm the security check with "install anyway", and proceed. After completing the install, Eclipse will ask if it should restart itself. Please do so. After restarting, you can check if WOLips is correctly installed by calling up it's perspective via the menu Window → Perspective → Open Perspective → Other, and then choosing "WOLips". Here's how it should look:
60
61 [[image:attach:eclipse08_perspective2.png]][[image:attach:eclipse09_perspective3.png]]
62
Pascal Robert 167.1 63 ===== 2. Install the WebObjects Framework =====
Timothy Worman 131.1 64
Maik Musall 172.1 65 Once the WOLips plugin is installed, perform the following terminal commands:
Timothy Worman 131.1 66
munch 115.1 67 {{code}}
Maik Musall 183.1 68 $ sudo mkdir -p /Library/WebObjects
D Tim Cummings 188.1 69 $ curl -O https://jenkins.wocommunity.org/job/WOInstaller/lastSuccessfulBuild/artifact/Utilities/WOInstall/WOInstaller.jar
Maik Musall 183.1 70 $ sudo java -jar WOInstaller.jar 5.4.3 /Library/WebObjects
munch 115.1 71
72 {{/code}}
73
Samuel Pelletier 184.1 74 If you already have the WebObjects543.dmg or the automatic download does not works use this variant:
Timothy Worman 131.1 75
jeroenvollenbrock 168.1 76
Samuel Pelletier 185.1 77 Download [[WebObjects543.dmg>>url:https://download.info.apple.com/Mac_OS_X/061-4634.20080915.3ijd0/WebObjects543.dmg||shape="rect"]]
Samuel Pelletier 184.1 78
79 {{code}}
80 cp WebObjects543.dmg /tmp/
81 sudo java -jar WOInstaller.jar dev54 /Library/WebObjects
82 {{/code}}
83
Pascal Robert 167.1 84 == **Step 3: Link the Framework to WOlips through the properties configuration file** ==
munch 97.1 85
Pascal Robert 167.1 86 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.
munch 103.1 87
Maik Musall 183.1 88 Running the script from step 2 installs the WO framework to the {{code language="none"}}/Library/WebObjects{{/code}} directory on your system. Below is the contents for a configuration file that matches this setup. Create a new file called ~~/Library/Application Support/WOLips/{{code language="none"}}wolips.properties{{/code}} if it's not already there.  Copy the code below (after modification) into that file.
munch 115.1 89
90 {{note}}
Maik Musall 172.1 91 You must replace YOUR_USER_NAME_HERE with your the username which installed the framework.
munch 115.1 92 {{/note}}
93
Theodore Petrosky 187.1 94
munch 115.1 95 {{code}}
Maik Musall 183.1 96 wo.system.root=/Library/WebObjects/System
Maik Musall 172.1 97 wo.user.frameworks=/Users/YOUR_USER_NAME_HERE/Library/Frameworks
Maik Musall 183.1 98 wo.system.frameworks=/Library/WebObjects/System/Library/Frameworks
99 wo.bootstrapjar=/Library/WebObjects/System/Library/WebObjects/JavaApplications/wotaskd.woa/WOBootstrap.jar
munch 115.1 100 wo.network.frameworks=/Network/Library/Frameworks
pyu 161.1 101 wo.api.root=/Library/WebObjects/ADC%20Reference%20Library/documentation/WebObjects/Reference/API
munch 115.1 102 wo.network.root=/Network
Maik Musall 183.1 103 wo.extensions=/Library/WebObjects/Library/WebObjects/Extensions
Maik Musall 172.1 104 wo.user.root=/Users/YOUR_USER_NAME_HERE
Maik Musall 183.1 105 wo.local.frameworks=/Library/WebObjects/Library/Frameworks
106 wo.dir.local.library.frameworks=/Library/WebObjects/Library/Frameworks
107 wo.apps.root=/Library/WebObjects/Library/WebObjects/Applications
108 wo.local.root=/Library/WebObjects
Maik Musall 172.1 109 wo.dir.user.home.library.frameworks=/Users/YOUR_USER_NAME_HERE/Library/Frameworks
munch 115.1 110
111 {{/code}}
112
113
Maik Musall 174.1 114 [[image:attach:eclipse10_wolipsPreferences.png]]
munch 125.1 115
Maik Musall 183.1 116 If it's not already prefilled, change the "WOlips Properties File" to {{code language="none"}}wolips.properties{{/code}} and click OK.
munch 119.1 117
Timothy Worman 131.1 118 At this point, you should have a functioning WebObjects platform to work with, visit <hello world link> to test your first WebObjects application.
munch 121.1 119
pyu 161.1 120 (Please note: you can't use the Wonder Frameworks at this point as only WebObjects installed. To use the Wonder Frameworks you must successfully complete step 4 which downloads the Wonder source. You must build the frameworks with that source).
121
Pascal Robert 167.1 122 == Step 4: Import Project Wonder into your Eclipse workspace ==
Timothy Worman 131.1 123
Pascal Robert 191.1 124 Please follow this guide: [[doc:WEB.Home.Getting Started.Getting the Wonder Source Code.WebHome]], which includes the page for [[doc:WEB.Home.Getting Started.Working with Wonder source in Eclipse.WebHome]] into your Eclipse workspace.
Timothy Worman 131.1 125
munch 115.1 126 {{note}}
Pascal Robert 167.1 127 Project Wonder is a significant part of the WebObjects 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 WebObjects.
munch 115.1 128 {{/note}}
129
munch 123.1 130
Maik Musall 174.1 131 At the end of this step, you will have Project Wonder imported into Eclipse under its own working set. If you are unfamiliar with working sets in Eclipse, the following video will help clarify. This video also demonstrates a "Hello World" project creation to validate proper installation. Note: this video is made with a much older version of Eclipse
munch 123.1 132
jeroenvollenbrock 168.1 133
134
jeroenvollenbrock 169.1 135 {{multimedia att--filename="WOInstall_WorkspaceAndHelloWorld.mov"/}}
munch 123.1 136
137
Pascal Robert 167.1 138