Version 18.1 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 ##/Users/<user name>/Library/wobuild.properties##
11
12 On Windows, the location for this file is:
13 ##C:ocuments and Settingsuser name>ibraryobuild.properties##
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
61 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/
62
63 {{/info}}
64
65 = Environment Variables =
66
67 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:
68
69 {{code}}
70
71 HOMEDRIVE=C:
72 HOMEPATH=\Documents and Settings\<USER NAME>
73 JAVA_HOME=U:\Sun\j2sdk1.4.2_05
74 JRE_HOME=U:\Sun\j2sdk1.4.2_05\jre
75 NEXT_ROOT=U:/Apple
76 NEXT_SYSTEM_ROOT=U:/Apple
77 OS=Windows_NT
78 SystemDrive=C:
79 SystemRoot=C:\WINNT
80 TEMP=C:\TEMP
81 TMP=C:\TEMP
82 WEBOBJECTS_JAVA_EXTENSIONS=U:\Sun\j2sdk1.4.2_05/JRE/lib/ext
83 WEBOBJECTS_JAVA_HOME=U:\Sun\j2sdk1.4.2_05
84 windir=C:\WINNT
85
86 {{/code}}
87
88 = Problem Running Applications =
89
90 If **wobuild.properties** (see above) is not correct, the application won't be able to launch. The error will look like this:
91
92 {{code}}
93
94 [2007-01-23 20:09:33 PST] <main> Unable to initialize WOProperties for reason: Cannot find JavaWebObjects framework !
95 java.lang.NullPointerException
96 [2007-01-23 20:09:33 PST] <main> A fatal exception occurred: null: <WOApplication>: Cannot be initialized.
97 [2007-01-23 20:09:33 PST] <main> com.webobjects.foundation.NSForwardException for java.lang.NullPointerException
98 at com.webobjects.appserver._private.WOProperties.initUserDefaultsKeys (WOProperties.java:188)
99 at com.webobjects.appserver.WOApplication._initWOApp (WOApplication.java:5081)
100 at com.webobjects.appserver.WOApplication.<init>(WOApplication.java:551)
101
102 {{/code}}