Skip to Content

Wiki source code of Deploying on Windows

Version 50.1 by Pascal Robert on 2012/02/11 08:43
Show last authors
1 {{toc/}}
2
3 = What you need =
4
5 * Windows 2003 Server; WIndows 2008 R2 (64 or 32 bit); Windows XP Professional
6 * Apache 2.2
7 * Java 1.5 or later
8 * a Mac with WebObjects 5.3 or 5.4 installed
9
10 = Install Java and Apache =
11
12 * Download and install [[Java J2SE 5.0>>url:http://www.oracle.com/technetwork/java/javase/downloads/index-jdk5-jsp-142662.html||shape="rect"]]
13 * {{note title="Java Version"}}You must install the multilingual option.{{/note}}Download and install [[apache 2.2>>url:http://httpd.apache.org||shape="rect"]]
14
15 {{note title="Installation Path"}}
16 You cannot have any spaces in the installation path otherwise mod_webobjects won't work properly.
17 {{/note}}
18
19 = Copy WebObjects files from your Mac =
20
21 In this description WebObjects will be installed on drive C: and apache is located under c:/apache.
22
23 Create the following directory tree under Windows
24
25 {{code}}
26
27 C:/Apple
28 Library
29 Frameworks
30 WebObjects
31 Configuration
32 JavaApplications
33 Local
34 Library
35 Frameworks
36 WebObjects
37 Applications
38 Configuration
39 Extensions
40
41 {{/code}}
42
43 Copy the listed Frameworks from /System/Library/Frameworks to C:/Apple/Frameworks:
44
45 {{code}}
46 JavaDirectToWeb.framework
47 JavaDTWGeneration.framework
48 JavaEmbedding.framework
49 JavaEOAccess.framework
50 JavaEOApplication.framework
51 JavaEOControl.framework
52 JavaEODistribution.framework
53 JavaEOGeneration.framework
54 JavaEOInterface.framework
55 JavaEOInterfaceCocoa.framework
56 JavaEOInterfaceSwing.framework
57 JavaEOProject.framework
58 JavaEORuleSystem.framework
59 JavaEOTool.framework
60 JavaFoundation.framework
61 JavaFrameEmbedding.framework
62 JavaJDBCAdaptor.framework
63 JavaJNDIAdaptor.framework
64 JavaWebObjects.framework
65 JavaWebServicesClient.framework
66 JavaWebServicesGeneration.framework
67 JavaWebServicesSupport.framework
68 JavaWOExtensions.framework
69 JavaWOJSPServlet.framework
70 {{/code}}
71
72 {{note title="Copying Frameworks"}}
73 On MacOSX Frameworks are "versioned" using the symbolic link trick, this doesn't work on Windows.
74 Once copied, check each framework to make sure that the "Resources" and "WebServerResources" folders are in the ".framework" directory and not in a subdirectory (usually "Verisions\A\")
75 {{/note}}
76
77 Copy JavaMonitor.woa and wotaskd.woa from /System/Library/WebObjects/JavaApplications to c:/Apple/Library/JavaApplications
78
79 Copy the content of /System/Library/WebObjects/WODocumentRoot to your apache document root directory. If you don't use D2W or D2JC I think you can omit the both Java folders.
80
81 If you are installing WebObjects 5.3 copy /System/Library/PrivateFrameworks/ to C:/Apple/Library
82
83 At least copy the jar files from /Library/WebObjects/Extensions to c:/Apple/Local/Library/WebObjects/Extensions.
84
85 {{code}}
86
87 axis.jar
88 axis-ant.jar
89 commons-discovery-0.2.jar
90 commons-logging-1.0.4.jar
91 derby.jar
92 derbyclient.jar
93 jaxrpc.jar
94 log4j-1.2.14.jar
95 saaj.jar
96 serializer.jar
97 servlet.jar
98 wsdl4j-1.5.1.jar
99 xalan.jar
100 xercesImpl.jar
101 xml-apis.jar
102
103 {{/code}}
104
105 = Add environment variable =
106
107 Under "System" add the environment variable NEXT_ROOT = C:/Apple
108
109 = Installing the Apache Adaptor =
110
111 Copy the [[mod_WebObjects.so>>url:http://wocommunity.org/documents/tools/mod_WebObjects/Apache2.2/windows/mod_WebObjects.so||shape="rect"]] file to c:/apache/modules
112
113 {{info title="Hint"}}
114 In some cases apache won't launch on a Windows Server system with this module.
115 In this case you should install the .Net Framework (3.x) on your system.
116 {{/info}}
117
118 = Configuring Apache =
119
120 Open the httpd.conf file in c:/apache/conf and search for the line "LoadModule rewrite_module modules/mod_rewrite.so" and put the following
line right befor that:
121
122 {{code}}
123
124 LoadModule WebObjects_module modules/mod_WebObjects.so
125
126 {{/code}}
127
128 At the end of the httpd.conf file add the following lines:
129
130 {{code}}
131
132 # WebObjects 5.4: Enable the WebObjects module. loadModule should be added before mod_rewrite
133 Include conf/extra/httpd-webobjects.conf
134
135 {{/code}}
136
137 Find the <Directory /> entry and comment out the last two lines
138
139 {{code}}
140
141 <Directory />
142 Options FollowSymLinks
143 AllowOverride None
144 # Order deny,allow
145 # Deny from all
146 </Directory>
147
148 {{/code}}
149
150 Create the file httpd-webobjects.conf in your c:/apache/conf/extra folder:
151
152 {{code}}
153
154 # WebObjects 5.4: Enable the WebObjects module. Should be loaded before mod_rewrite
155 # LoadModule WebObjects_module modules/mod_WebObjects.so
156
157 # Path to the Document Root of your Webserver,
158 # it should contain a directory named WebObjects
159 WebObjectsDocumentRoot c:/apache/htdocs
160
161 # You can change the 'cgi-bin' part of WebObjectsAlias to whatever you
162 # prefer (such as Apps), but the 'WebObjects' part is required.
163 WebObjectsAlias /Apps/WebObjects
164
165 # Here are the 3 possible configuration modes.
166 # The apache module uses one of them to get information
167 # about your deployed applications.
168 # 1085 is the reserved port on which wotaskd processes listen to by default.
169
170 # Host List Configuration
171 # wotaskd is started automatically on supported platforms,
172 # so this is the default mode.
173 # The apache module gets its configuration from the wotaskds
174 # listed on the configuration line
175 # For multiple hosts:
176 # WebObjectsConfig http://<name-of-a-host>:<port-on-a-host>,http://<name-of-another-host>:<port-on-a-host> <interval>
177 # For localhost:
178 WebObjectsConfig http://localhost:1085 10
179
180 # Multicast Configuration
181 # The apache module gets its configuration from all wotaskds
182 # that respond to the multicast call on the subnet
183 # WebObjectsConfig webobjects://239.128.14.2:1085 10
184
185 # File Configuration
186 # The apache module gets its configuration from one file
187 # WebObjectsConfig file://<path-to-a-xml-config-file> 10
188
189 # To enable public access to the WOAdaptorInfo page, uncomment the following line
190 # WebObjectsAdminUsername public
191
192 # To enable the WOAdaptorInfo page with restricted access,
193 # uncomment the next two lines and set the user and password
194 # To access the WOAdaptorInfo page with restricted access,
195 # use a URL like: http://webserver/cgi-bin/WebObjects/WOAdaptorInfo?user+password.
196 # WebObjectsAdminUsername user
197 # WebObjectsAdminPassword password
198
199 # To change the logging options, read the following comments:
200 # The option name is "WebObjectsLog" and the first value indicates the path of the log file.
201 # The second value indicates the log level. There are five, in decreasing informational order:
202 # "Debug", "Info", "Warn", "Error", "User"
203 #
204 # Note: To enable logging, touch '/tmp/logWebObjects' as the administrator user (usually root).
205 # Under Windows create c:\TEMP\logWebObjects
206
207 # The following line is the default:
208 # WebObjectsLog /Library/WebObjects/Logs/WebObjects.log Debug
209
210 {{/code}}
211
212 You had to restart your Apache Service to apply your changes.
213
214 = Installing WOTaskDaemon as a Windows Service =
215
216 === Using Microsoft Windows 2003 resource kit ===
217
218 Microsoft provides free tools to register applications as services : instsrv and srvany.
219 Both are bundled with "Microsoft Windows 2003 resource kit" which can be downloaded [[here>>url:http://www.microsoft.com/downloads/details.aspx?familyid=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en||shape="rect"]].
220
221 Below a quick translation of the [[KB469536>>url:http://support.microsoft.com/kb/469536/fr||shape="rect"]] which describes their usage:
222
223 First create a new service using instsrv that refers to the srvany executable
224
225 {{code}}
226
227 C:\>C:\Program Files\Windows Resource Kits\Tools\Instsrv WOTaskD C:\Program Files\Windows Resource Kits\Tools\srvany.exe
228
229 {{/code}}
230
231 Then fire regedit and navigate to **HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WOTaskD**
232 Add a sub-key named "Parameters".
233 In this sub-key add a new REG_SZ key named "Application" and put the path of the WOTaskD.cmd file.
234
235 Your reg key should now look like below :
236 [[image:attach:wotaskd_reg.png]]
237 To try your newly created service simply start it by typing :
238
239 {{code}}
240
241 C:\>net start WOTaskD
242
243 {{/code}}
244
245 You should be aware that srvany is just a laucher, this means that the "service" has no control over WOTaskD's sub-processes:
246 stopping the service has no effect on WOTaskD. For now the only solution I found is to use the following lines in a cmd file :
247
248 {{code}}
249
250 net stop apache2.2
251 net stop wotaskd
252 taskkill /F /IM java.exe /T
253
254 {{/code}}
255
256 === Using FireDameon ===
257
258 You can use FireDaemon and add a new Service:
259 Executable: C:\Apple\Library\WebObjects\JavaApplications\wotaskd.woa\wotaskd.CMD
260 Working Directory:C:\Apple\Library\WebObjects\JavaApplications\wotaskd.woa
261
262 To test the system you can also install WO Monitor as a service:
263 Executable: C:\Apple\Library\WebObjects\JavaApplications\JavaMonitor.woa\JavaMonitor.CMD
264 Working Directory:C:\Apple\Library\WebObjects\JavaApplications\JavaMonitor.woa
265
266 = Testing the installation =
267
268 Now that everything should be set up properly, it is time for a small test. First, let's look if wotaskd is working.
269
270 Open a browser and go to http:~/~/<myhost>:1085If it works, you should see the host's configuration displayed in the browser. Now, start WOMonitor (double click on ...\JavaMonitor.woa\JavaMonitor.CMD) if it is not already running as a service.
271 Wait a few seconds, then point the browser to http:~/~/<myhost>:56789
272
273 You should see Monitor's main window. Now you can start deploying your applications.
274
275 = Solving issues =
276
277 === The requested URL [WO:...] was not found ===
278
279 By default as configured in the httpd-webobjects.conf file the alias for the adaptor is "/Apps/WebObjects".
280
281 {{code}}
282
283 WebObjectsAlias /Apps/WebObjects
284
285 {{/code}}
286
287 You can change this and restore the "/cgi-bin/WebObjects" path by changing this variable.
288
289 If you wish to keep the default value (or use a custom value) do not forget to change the adaptor path in the "Site" tab of JavaMonitor