Skip to Content

Wiki source code of WO 5.4 Getting Started

Version 80.1 by Timothy Worman on 2023/11/13 11:55
Hide last authors
Timothy Worman 75.1 1 {{warning}}
Timothy Worman 78.1 2 This is deprecated information!
Timothy Worman 75.1 3 {{/warning}}
4
Pascal Robert 61.1 5
Timothy Worman 78.1 6
7 {{toc maxLevel="1"/}}
8
Pascal Robert 73.1 9 = ProjectBuilder and XCode =
Pascal Robert 61.1 10
Timothy Worman 78.1 11 ProjectBuilder and Xcode are no longer supported IDEs for WebObjects development or deployment. While legacy projects may still use it there is little, if any, support available for it. Existing projects (except Objective-C WebObjects projects, of course) should be [[migrated to WOLips>>doc:WOL.XcodeMigration]]. It isn't as hard as you might think, and WOLips is a much more powerful WebObjects IDE.
Pascal Robert 61.1 12
Pascal Robert 73.1 13 = Installing WebObjects and WOLips =
Pascal Robert 61.1 14
Timothy Worman 78.1 15 1. (((
16 ====== Download Golipse ======
Pascal Robert 61.1 17
Timothy Worman 78.1 18 [[Golipse>>url:http://wocommunity.org/documents/tools/Golipse.app_build_22.zip||shape="rect"]] ([[source>>url:https://github.com/wocommunity/Golipse||shape="rect"]]) will fetch the needed version of Eclipse, WOLips and other tools for WebObjects development.
19 )))
20
Pascal Robert 73.1 21 {{note title="32-bit computers"}}
Timothy Worman 78.1 22 By default Golipse will download and install a 64-bit version of Eclipse. If you have an older 32-bit machine you can specify the download URL for the Eclipse package in 'Golipse > Preferences'. The latest 32-bit package is "http:~/~/ftp.osuosl.org/pub/eclipse/eclipse/downloads/drops/R-3.6.2-201102101200/eclipse-SDK-3.6.2-macosx-cocoa.tar.gz"
Pascal Robert 73.1 23 {{/note}}
24
Timothy Worman 78.1 25 1. (((
26 ====== Install the WebObjects ======
Pascal Robert 61.1 27
Timothy Worman 78.1 28 The best way to install the WebObjects frameworks is according to [[these instructions>>doc:WOL.Using WOLips With Multiple Versions of WebObjects]].
29 )))
30 1. (((
31 ====== Start Eclipse and switch to the WOLips perspective. ======
32
33 * Under the //Window// menu, select //Open Perspective > Other...//.
34 [[image:attach:PerpectiveMenu.png]]
35 *
36
37 ====== Select //WOLips// and click //Ok//. ======
38
39 [[image:attach:PerspectiveChoices.png]]
40
Pascal Robert 73.1 41 {{note title="WOLips Perspective"}}
Pascal Robert 61.1 42 If you don't switch to the WOLips perspective, you won't be able to create new WebObjects projects.
Pascal Robert 73.1 43 {{/note}}
Timothy Worman 78.1 44 )))
Pascal Robert 61.1 45
Pascal Robert 73.1 46 {{info title="Xcode & WebObjects"}}
47 Xcode is no longer the supported IDE for WebObjects development or deployment. However, downloading it and installing it will install tools debugging tools that you might find useful.
Pascal Robert 53.1 48
Timothy Worman 78.1 49 * Apple Developer Site (Free): [[http:~~/~~/developer.apple.com/xcode/>>url:http://developer.apple.com/xcode/||shape="rect"]]
50 * Mac OS X App Store (Free): [[http:~~/~~/itunes.apple.com/us/app/xcode/id448457090>>url:http://itunes.apple.com/us/app/xcode/id448457090||shape="rect"]]
Pascal Robert 73.1 51 {{/info}}
Gavin Eadie 23.1 52
David Avendasora 39.1 53
Timothy Worman 78.1 54
55 {{id name="javamonitor"/}}
56
Pascal Robert 73.1 57 = Running Monitor and wotaskd on Mac OS X =
David Avendasora 39.1 58
Timothy Worman 78.1 59 Monitor and wotaskd are installed, but the launchd scripts to start them are not installed. You can grab them from a 10.5 Server installation, or follow those instructions.
Pascal Robert 61.1 60
Quinton Dolan 63.1 61 Make sure //Web Sharing// is enabled in the //Sharing// panel in //System Preferences// (note: 10.5 comes with Apache 2.2 as the default).
Pascal Robert 61.1 62
Quinton Dolan 63.1 63 Edit ///etc/apache2/httpd.conf// (if you did a fresh install, you may already have these - search httpd.conf first)
Pascal Robert 61.1 64
Timothy Worman 78.1 65 Search for rewrite_module, and above it, add this line:
Pascal Robert 61.1 66
67 {{code}}
68 LoadModule WebObjects_module /System/Library/WebObjects/Adaptors/Apache2.2/mod_WebObjects.so
69
70 {{/code}}
71
Quinton Dolan 63.1 72 Go to the very end and add:
Pascal Robert 61.1 73
74 {{code}}
75 Include /System/Library/WebObjects/Adaptors/Apache2.2/apache.conf
76
77 {{/code}}
78
79 Search for "Directory /" and comment out the Order and Deny lines:
80
81 {{code}}
82 <Directory />
83 Options FollowSymLinks
84 AllowOverride None
85 #Order deny,allow
86 #Deny from all
87 </Directory>
88
89 {{/code}}
90
91 Restart apache
92
93 {{code}}
94 sudo apachectl graceful
95
96 {{/code}}
97
Timothy Worman 78.1 98 If you run //ps auxw | grep httpd// you should see apache now running
Pascal Robert 61.1 99
100 Create ///Library/LaunchDaemons/com.apple.webobjects.wotaskd.plist// with:
Timothy Worman 78.1 101 (for OSX 10.5 make sure the permissions of this file are 644 system/wheel/everyone otherwise launchctl will throw a "dubious permissions" error when you try to load the plist with the commands that follow)
Pascal Robert 61.1 102
103 {{code}}
104 <?xml version="1.0" encoding="UTF-8"?>
105 <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
106 <plist version="1.0">
107 <dict>
108 <key>Disabled</key>
109 <false/>
110 <key>GroupName</key>
111 <string>appserverusr</string>
112 <key>Label</key>
113 <string>com.apple.webobjects.wotaskd</string>
114 <key>OnDemand</key>
115 <false/>
116 <key>Program</key>
117 <string>/System/Library/WebObjects/JavaApplications/wotaskd.woa/wotaskd</string>
118 <key>ProgramArguments</key>
119 <array>
120 <string>wotaskd</string>
121 <string>-WOPort</string>
122 <string>1085</string>
123 </array>
124 <key>ServiceIPC</key>
125 <false/>
126 <key>UserName</key>
127 <string>appserver</string>
128 </dict>
129 </plist>
130
131 {{/code}}
132
Quinton Dolan 63.1 133 Create ///Library/LaunchDaemons/com.apple.webobjects.womonitor.plist// with:
Timothy Worman 78.1 134 (for OSX 10.5 make sure the permissions of this file are 644 system/wheel/everyone otherwise launchctl will throw a "dubious permissions" error when you try to load the plist with the commands that follow)
Pascal Robert 61.1 135
136 {{code}}
137 <?xml version="1.0" encoding="UTF-8"?>
138 <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
139 <plist version="1.0">
140 <dict>
141 <key>Disabled</key>
142 <false/>
143 <key>GroupName</key>
144 <string>appserverusr</string>
145 <key>Label</key>
146 <string>com.apple.webobjects.womonitor</string>
147 <key>OnDemand</key>
148 <false/>
149 <key>Program</key>
150 <string>/System/Library/WebObjects/JavaApplications/JavaMonitor.woa/JavaMonitor</string>
151 <key>ProgramArguments</key>
152 <array>
153 <string>JavaMonitor</string>
154 <string>-WOPort</string>
155 <string>56789</string>
156 </array>
157 <key>ServiceIPC</key>
158 <false/>
159 <key>UserName</key>
160 <string>appserver</string>
161 </dict>
162 </plist>
163
164 {{/code}}
165
166 Start the launchd daemons :
Timothy Worman 78.1 167 (you may need to sudo here)
Pascal Robert 61.1 168
169 {{code}}
170 launchctl load /Library/LaunchDaemons/com.apple.webobjects.wotaskd.plist
171 launchctl load /Library/LaunchDaemons/com.apple.webobjects.womonitor.plist
172
173 {{/code}}
174
Timothy Worman 78.1 175 If you run "ps auxw | grep java" you should see wotaskd and java monitor now running. You should be able to connect to Monitor by this URL:
Pascal Robert 61.1 176
177 {{code}}
178 http://localhost:56789
179
180 {{/code}}