Skip to Content
Last modified by Pascal Robert on 2007/12/15 18:37
Show last authors
1 = Introduction =
2
3 If you are having problems building or running, here are some things to check. The examples are given for Windows as that seems to be the source of the most problems. The principles apply, though the paths are different, for OS X.
4
5 = wobuild.properties =
6
7 Many things will not work if this is missing, incorrect, or incomplete.
8
9 On Mac OS X, the location for this file is:
10 {{code language="none"}}/Users/<user name>/Library/wobuild.properties{{/code}}
11
12 On Windows, the location for this file is:
13 {{code language="none"}}C:\Documents and Settings\<user name>\Library\wobuild.properties{{/code}}
14
15 Here is an example from Windows:
16
17 {{code}}
18
19 #This file stores the wo specific properties #Sat Mar 29 11:33:34 PST 2003
20 wo.dir.root=U:/Apple
21 wo.dir.user.home.library.frameworks=C:/Temp
22 wo.woroot=U:/Apple
23 wo.dir.local=U:/Apple/Local
24 wo.wosystemroot=U:/Apple
25 #wo.dir.user.home.library=C:/Documents and Settings/Chuck Hill/Local/Library
26 wo.dir.user.home.library=C:/Temp
27 wo.dir.library=U:/Apple/Library
28 wo.dir.local.library=U:/Apple/Local/Library
29 wo.dir.library.frameworks=U:/Apple/Library/Frameworks
30 wo.dir.local.library.frameworks=U:/Apple/Local/Library/Frameworks
31 wo.wolocalroot=U:/Apple/Local
32 wo.dir.system=U:/Apple
33 eclipse.home=U:/Programs/eclipse
34
35 {{/code}}
36
37 For the curious, here is an example from OS X:
38
39 {{code}}
40
41 #This file stores the wo specific properties
42 #Wed Oct 11 19:51:09 PDT 2006
43 wo.dir.root=/
44 wo.woroot=/System
45 wo.dir.user.home.library.frameworks=/Users/chuck/Library/Frameworks
46 wo.dir.local=/
47 wo.wosystemroot=/System
48 wo.dir.library=/System/Library
49 wo.dir.user.home.library=/Users/chuck/Library
50 wo.dir.local.library=/Library
51 wo.dir.library.frameworks=/System/Library/Frameworks
52 wo.dir.local.library.frameworks=/Library/Frameworks
53 wo.wolocalroot=/
54 wo.dir.system=/System
55 wo.dir.reference.api=/Developer/ADC%20Reference%20Library/documentation/WebObjects/Reference/API/
56
57 {{/code}}
58
59 {{info}}
60 Note that for MacOSX 10.5 installs the last line above must be changed to wo.dir.reference.api=/Developer/Documentation/DocSets/com.apple.ADC_Reference_Library.WebObjectsReference.docset/Contents/Resources/Documents/reference/
61 {{/info}}
62
63 = Environment Variables =
64
65 WebObjects makes use of some environmental variables. I am not sure which ones need to be set with WOLips, but these are the likely candidates:
66
67 {{code}}
68
69 HOMEDRIVE=C:
70 HOMEPATH=\Documents and Settings\<USER NAME>
71 JAVA_HOME=U:\Sun\j2sdk1.4.2_05
72 JRE_HOME=U:\Sun\j2sdk1.4.2_05\jre
73 NEXT_ROOT=U:/Apple
74 NEXT_SYSTEM_ROOT=U:/Apple
75 OS=Windows_NT
76 SystemDrive=C:
77 SystemRoot=C:\WINNT
78 TEMP=C:\TEMP
79 TMP=C:\TEMP
80 WEBOBJECTS_JAVA_EXTENSIONS=U:\Sun\j2sdk1.4.2_05/JRE/lib/ext
81 WEBOBJECTS_JAVA_HOME=U:\Sun\j2sdk1.4.2_05
82 windir=C:\WINNT
83
84 {{/code}}
85
86 = Problem Running Applications =
87
88 If **wobuild.properties** (see above) is not correct, the application won't be able to launch. The error will look like this:
89
90 {{code}}
91
92 [2007-01-23 20:09:33 PST] <main> Unable to initialize WOProperties for reason: Cannot find JavaWebObjects framework !
93 java.lang.NullPointerException
94 [2007-01-23 20:09:33 PST] <main> A fatal exception occurred: null: <WOApplication>: Cannot be initialized.
95 [2007-01-23 20:09:33 PST] <main> com.webobjects.foundation.NSForwardException for java.lang.NullPointerException
96 at com.webobjects.appserver._private.WOProperties.initUserDefaultsKeys (WOProperties.java:188)
97 at com.webobjects.appserver.WOApplication._initWOApp (WOApplication.java:5081)
98 at com.webobjects.appserver.WOApplication.<init>(WOApplication.java:551)
99
100 {{/code}}