Skip to Content

Wiki source code of Project Wonder Installation

Version 55.1 by Timothy Worman on 2012/09/05 16:07
Show last authors
1 This page is the starting point for beginning development with [[Project Wonder>>http://wiki.wocommunity.org/display/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>>http://www.eclipse.org/]] and [[WOLips>>http://wiki.wocommunity.org/display/WOL/Home]], the latter being a set of plugins that provide a rich and specialized toolset for developing Wonder applications within the ubiquitous Eclipse Java IDE.
2
3 The guides here assume you are using OS X 10.6 (Snow Leopard) or higher. There are four sections to this installation process.
4
5 Overview of Steps:
6 install Eclipse (if necessary)
7 install WOLips Plugins for Eclipse
8 install WebObjects frameworks and configure WOLips
9 install Project Wonder and import into your workspace
10
11 == **Step 1:  Install the latest version of Eclipse** ==
12
13 {{note}}
14 If you already have Eclipse installed, you may skip this step.
15 {{/note}}
16
17 **Easy Install**:
18
19 You can download and run Golipse. Golipse will download Eclipse and WOLips, and configure the environment in a fashion consistent with best practices for Wonder development. At launch, Golipse will simply ask for target install directory. After installing, you should launch Eclipse.app. If you are running OS X 10.7 or higher, this may force a download of a Java runtime if not already installed. Workspace Mechanic will offer to make initial and beneficial configuration changes.
20
21 After successfully running Golipse, you can skip to the download and install of the WebObjects frameworks.
22
23 [[Download Golipse>>http://wocommunity.org/documents/tools/Golipse.app_latest.zip]]
24
25 **Manual Install**:
26
27 Head over to the Eclipse Foundation and [[download>>http://www.eclipse.org/downloads/packages/release/indigo/sr2]] the latest version of Eclipse suitable for your OS X version.  
28
29 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.
30
31 {{note}}
32
33 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 comes with Java runtime installed
34 \\
35
36 {{/note}}
37
38 **{+}Video of Eclipse Install:+***
39
40 {{multimedia name="WOInstallPart1.mov"}}{{/multimedia}}
41
42 == **Step 2:  Install WOlips plugin and the WebObjects Framework** ==
43
44 1. h5. Install WOLips Plugin
45
46 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...**
47 [[image:InstallNewSoftware.png||border="1"]]
48 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. You can click "Available Software Sites" to see what was included by default.
49 [[image:InstallPanel.png||border="1"]]
50
51 1.
52 11. 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.
53 [[image:EclipseScreenSnapz023.png||border="1"]]
54 In the Location field, enter the following URL:
55 11*. **Stable**: (For Elipse 3.7) [[http://jenkins.wocommunity.org/job/WOLips37Stable/lastSuccessfulBuild/artifact/temp/dist/]]
56 11. 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. (Here are some [[WO:Other WOLips Install Options]].)  After selecting the options you want, click "Next." You'll briefly see a progress bar while Eclipse "calculates requirements and dependencies."
57 [[image:EclipseScreenSnapz024.png||border="1"]]
58 11. You'll see an "Install" panel, asking you to Review and Confirm selected items to be installed.
59 [[image:EclipseScreenSnapz025.png||border="1"]]
60 11. Click **Next >**. The next dialog contains the license agreements for the selected features. After reviewing the agreements (you DO review your license agreements, right :-)  ), select "I accept the terms of the license agreement." Selecting this radio button will accept the license agreements for **all** of the features listed. Click **Finish** to continue. You may also get a warning about "unsigned content." Click "OK" to dismiss that dialog and continue the install.
61 [[image:LicenseConfirm.png||border="1"]]
62 11. Eclipse will now download and install all the selected features and plugins. When it has completed, it will prompt you to restart Eclipse. Select "Restart Now."
63 [[image:restart.png||border="1"]]
64
65 ===== 2.  Install the WebObjects Framework =====
66
67 Once the WOlips plugin is installed, perform the following terminal commands:
68
69 {{code}}
70
71 $ sudo mkdir -p /Library/WebObjects/Versions/WebObjects543
72 $ curl -O http://wocommunity.org/documents/tools/WOInstaller.jar
73 $ sudo java -jar WOInstaller.jar 5.4.3 /Library/WebObjects/Versions/WebObjects543
74
75 {{/code}}
76
77 **{+}Video of Step 2:+**
78
79 {{multimedia name="WOInstallPart2.mov"}}{{/multimedia}}
80
81 == **Step 3:  Link the Framework to WOlips through the properties configuration file** ==
82
83 {{note}}
84 Prerequisite: Eclipse with the WOlips plugin installed, and the WebObjects framework via step 2.
85 {{/note}}
86
87 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.
88
89 Running the script from step 2 installs the WO framework to the /Library/WebObjects/Versions/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.
90
91 {{note}}
92
93 You must replace <YOUR_USER_NAME_HERE\!> with your the username which installed the framework.
94
95 {{/note}}
96
97 {{code}}
98
99 wo.system.root=/Library/WebObjects/Versions/WebObjects543/System
100 wo.user.frameworks=/Users/<YOUR_USER_NAME_HERE!>/Library/Frameworks
101 wo.system.frameworks=/Library/WebObjects/Versions/WebObjects543/System/Library/Frameworks
102 wo.bootstrapjar=/Library/WebObjects/Versions/WebObjects543/System/Library/WebObjects/JavaApplications/wotaskd.woa/WOBootstrap.jar
103 wo.network.frameworks=/Network/Library/Frameworks
104 wo.api.root=/Library/WebObjects/ADC%20Reference%20Library/documentation/WebObjects/Reference/API
105 wo.network.root=/Network
106 wo.extensions=/Library/WebObjects/Versions/WebObjects543/Library/WebObjects/Extensions
107 wo.user.root=/Users/<YOUR_USER_NAME_HERE!>
108 wo.local.frameworks=/Library/WebObjects/Versions/WebObjects543/Library/Frameworks
109 wo.dir.local.library.frameworks=/Library/WebObjects/Versions/WebObjects543/Library/Frameworks
110 wo.apps.root=/Library/WebObjects/Versions/WebObjects543/Library/WebObjects/Applications
111 wo.local.root=/Library/WebObjects/Versions/WebObjects543
112 wo.dir.user.home.library.frameworks=/Users/<YOUR_USER_NAME_HERE!>/Library/Frameworks
113
114 {{/code}}
115
116 Place this file in /Library/Application Support/WOLips, this directory should already exist and contain the default wolips.properties file.
117
118 The second part of this step is to link the WOlips plugin with the WO framework installed on your system. &nbsp;This is done through the tab found at Eclipse menu > Preferences > WOlips.
119
120 [[image:WOLipsConfig.png]]
121
122 {{note}}
123 It is important to realize that if you change the WOlips Properties File to "wolips.543.properties" and then hit "apply" it will write out the (now stale) field values to that file. &nbsp;This could potentially clobber your new wolips.543.properties file with the default&nbsp;values. &nbsp;If you suspect this has happened, close the WOlips preferences and inspect the wolips.543.properties file.
124
125 {{/note}}
126
127 Change the "WOlips Properties File" to wolips.543.properties and click OK.&nbsp;
128
129 At this point, you should have a functioning WebObjects platform to work with, visit <hello world link> to test your first WebObjects application.
130
131 (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).
132
133 **{+}Video of Step 3:+**
134
135 {{multimedia name="WOInstallPart3.mov"}}{{/multimedia}}
136
137 == Step 4: &nbsp;Import Project Wonder into your Eclipse workspace ==
138
139 &nbsp;Please follow this guide: &nbsp;[[Getting the Wonder Source Code>>http://wiki.wocommunity.org/display/documentation/Getting+the+Wonder+Source+Code]], which includes the page for [[importing the Project Wonder source>>http://wiki.wocommunity.org/display/documentation/Working+with+Wonder+source+in+Eclipse]]&nbsp;into your Eclipse workspace.
140
141 {{note}}
142
143
144 Project Wonder is a significant part of the WebObjects experience. &nbsp;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.
145
146 {{/note}}
147
148 **{+}Video of Step 4:+**
149
150 {{multimedia name="WOInstallPart4.mov"}}{{/multimedia}}
151
152 \\
153
154 At the end of this step, you will have Project Wonder imported into Eclipse under its own working set. &nbsp;If you are unfamiliar with working sets in Eclipse, the following video will help clarify. &nbsp;This video also demonstrates a "Hello World" project creation to validate proper installation.
155
156 {{multimedia name="WOInstall_WorkspaceAndHelloWorld.mov"}}{{/multimedia}}
157
158
159 \\&nbsp;&nbsp;