Last modified 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 19.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:
Pascal Robert 19.1 10 {{code language="none"}}/Users/<user name>/Library/wobuild.properties{{/code}}
Pascal Robert 18.1 11
12 On Windows, the location for this file is:
Pascal Robert 19.1 13 {{code language="none"}}C:\Documents and Settings\<user name>\Library\wobuild.properties{{/code}}
David Holt 6.1 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}}
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
Pascal Robert 19.1 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:
David Holt 6.1 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
Pascal Robert 18.1 86 = Problem Running Applications =
David Holt 6.1 87
Pascal Robert 19.1 88 If **wobuild.properties** (see above) is not correct, the application won't be able to launch. The error will look like this:
David Holt 6.1 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}}