Version 22.1 by David Holt on 2007/06/20 19:25

Hide last authors
David Holt 11.1 1 **Getting Started with BugTracker**
2
David Holt 19.1 3 ~1. Import the following source code folders from CVS according to the [[tutorial>>http://wiki.objectstyle.org/confluence/display/WOL/Project+Wonder+woa+with+Linked+Source]]. You may need to adjust the exact folders you import depending on the database you plan to use. In this case, I have added the FrontBase plugin as well as all the other frameworks that BugTracker expects to find in its build path:
David Holt 11.1 4
5 [[image:Context-023.jpg]]
6 [[image:Context-024.jpg]]
7 [[image:Context-025.jpg]]
8
9 ----
10
David Holt 19.1 11 2. Check out the folders into their own projects in your workspace.
David Holt 11.1 12
13 [[image:Context-026.jpg]]
14
15 ----
16
David Holt 19.1 17 3. Your workspace should look roughly like this once it has completed rebuilding:
David Holt 11.1 18
19 [[image:Context-027.jpg]]
20
21 ----
22
David Holt 19.1 23 4. First order of business is to find your Properties file by turning off the filter that is on by default:
David Holt 11.1 24
25 [[image:Context-028.jpg]]
26
27 ----
28
David Holt 19.1 29 5. Uncheck the item selected in the image below:
David Holt 11.1 30
31 [[image:Context-029.jpg]]
32
33 ----
34
David Holt 19.1 35 6. Change the properties located in the resources folder to match the requirements for your database. I use Frontbase. You can either set Global properties for your database, or by model as per the instructions in [[ERXConfigurationManager documentation>>http://webobjects.mdimension.com/wonder/api/er/extensions/ERXConfigurationManager.html]]
David Holt 11.1 36
David Holt 17.1 37 Here are the settings I used for FrontBase:
Kieran Kelleher 15.1 38
David Holt 17.1 39 #ERXConfigurationManager properties moved in from Properties.ak
40 #Original Settings for Postgresql
41 #Changed to Frontbase
David Holt 11.1 42 dbConnectURLGLOBAL=jdbc:frontbase:~/~/localhost/bug
43 dbConnectUserGLOBAL=//system
44 dbConnectPluginGLOBAL=Frontbase
David Holt 17.1 45 #dbConnectDriverGLOBAL=org.postgresql.Driver
46 #dbConnectPasswordGLOBAL =
David Holt 11.1 47 dbEOPrototypesEntityGLOBAL=EOJDBCFrontBasePrototypes
48 er.javamail.adminEmail=foo@localhost.com//
49
50 Make sure that the build path contains the plugin for your database;
51
52 [[image:Context-030.jpg]]
53
54 ----
55
David Holt 19.1 56 7. Now we want to run the app. The Wonder team has set it up so that you can generate all necessary tables and populate them when you launch the BugTracker application for the first time using a special launch configuration.
David Holt 11.1 57
58 You'll see BugTracker launch configurations for creating, creating without dropping, and normal launching. We need to select the BugTracker (create without drop) launch configuration for the initial setup.
59
60 [[image:Context-031.jpg]]
61
62 ----
63
David Holt 19.1 64 8. We do that by selecting Run as > Run...
David Holt 11.1 65
66 [[image:Context-032.jpg]]
67
68 ----
69
David Holt 19.1 70 9. In the resulting dialog box, select BugTracker (create without drop). If you try to use (create) you'll get a bunch of errors complaining about lack of tables in the database.
David Holt 11.1 71
72 [[image:Context-033.jpg]]
73
74 ----
75
David Holt 19.1 76 10. You'll see a long list of things being done in your console window that takes several minutes. When you get the final Done message, your database is set up and ready to go. You can log into your database to confirm that the tables have been magically created and populated.
David Holt 11.1 77
78 Now select BugTracker as your launch configuration to start the application:
79
80 [[image:Context-034.jpg]]
81
82 ----
83
David Holt 19.1 84 ~11. You should see a login screen. Your default administrative user is "admin" with password "admin"
David Holt 11.1 85
86 [[image:Context-035.jpg]]
87
88 ----
89
David Holt 19.1 90 12. Explore!!