Version 18.1 by Pascal Robert on 2007/12/15 18:37

Hide last authors
Pascal Robert 18.1 1 = Introduction =
David Holt 6.1 2
Pascal Robert 18.1 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.
David Holt 6.1 4
Pascal Robert 18.1 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:
David Holt 6.1 13 ##C:ocuments and Settingsuser name>ibraryobuild.properties##
14
Pascal Robert 18.1 15 Here is an example from Windows:
David Holt 6.1 16
17 {{code}}
18
19 #This file stores the wo specific properties #Sat Mar 29 11:33:34 PST 2003
Pascal Robert 18.1 20 wo.dir.root=U:/Apple
chuckhill 16.1 21 wo.dir.user.home.library.frameworks=C:/Temp
David Holt 6.1 22 wo.woroot=U:/Apple
23 wo.dir.local=U:/Apple/Local
24 wo.wosystemroot=U:/Apple
Pascal Robert 18.1 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
David Holt 6.1 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
chuckhill 16.1 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
Pascal Robert 18.1 59 {{info}}
David Holt 6.1 60
Pascal Robert 18.1 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
David Holt 6.1 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
Pascal Robert 18.1 88 = Problem Running Applications =
David Holt 6.1 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}}