Skip to Content
Version 39.1 by David Avendasora on 2011/04/26 13:21
Show last authors
1 **Getting Started with BugTracker**
2
3 There are different ways to build the BugTracker application. If you are going to be making changes to the project and its dependent frameworks and experimenting with them, you will probably want to open the projects in eclipse with WOLips. If you just want to see the app work, you can check out the code, build it with ant and run it from the /Roots directory. See [[Getting the Wonder Source Code]] page for information on getting the projects' source and building it.
4
5 If you build the app with ant, launching it may be as simple (once some things are set up) as:
6
7 {{code}}
8
9 ( cd ~/Roots/BugTracker.woa ;
10   ./BugTracker \
11     -Der.javamail.centralize=false \
12     -Der.extensions.ERXApplication.developmentMode=true \
13     -DdbConnectURLGLOBAL=jdbc:mysql://localhost/bug?capitalizeTypenames=true \
14     -DdbConnectUserGLOBAL=ray \
15     -DdbConnectPasswordGLOBAL=secretSauce \
16     -DdbConnectPluginGLOBAL= \
17     -DdbConnectDriverGLOBAL= \
18     -DdbEOPrototypesEntityGLOBAL=EOJDBCMySQLPrototypes )
19
20 {{/code}}
21
22 If you want to build the application in eclipse, you may need to set the framework dependencies of the project. There are two ways of doing this. You can either open all the dependent frameworks in eclipse and then eclipse will track and build everything, or you can point the open project(s) to installed versions of the framework, as installed. Instructions for these two methods of managing framework dependencies is at [[Add a Framework Dependency>>Add a Framework Dependency]]. The frameworks that the BugTracker application may depend on are:
23
24 * Ajax.framework
25 * BTBusinessLogic.framework
26 * DerbyPlugin.framework
27 * ERCalendar.framework
28 * ERCaptcha.framework
29 * ERCoreBusinessLogic.framework
30 * ERDirectToWeb.framework
31 * ERExcelLook.framework
32 * ERExtensions.framework
33 * ERJars.framework
34 * ERJavaMail.framework
35 * ERPlot.framework
36 * ERPrototypes.framework
37 * ERRest.framework
38 * ERSelenium.framework
39 * JavaWOExtensions.framework
40 * WOOgnl.framework
41 * ExcelGenerator.framework
42 * FrontBasePlugin.framework
43 * PostgresPlugin.framework
44
45 ----
46
47 if you open all the dependent projects in eclipse, your workspace should look roughly like this once it has completed rebuilding:
48
49 [[image:Context-027.jpg]]
50
51 ----
52
53 {{id value="Configuration"}}{{/id}}
54
55 Change the Properties located in the resources folder to match the requirements for your database. Wonder applications need Properties files to manage their configuration correctly. There are a number of different places in the Wonder frameworks that application properties will be read from. In the original example, the Database connection properties are taken from a logged in user's properties file, in this case it is named "Properties.ak". I moved the relevant lines to the Application Properties file that described the Global connection dictionary for BugTracker to access my FrontBase database. Alternatively (a recommended way) you can create your own "Properties.username" file by duplicating "Properties.ak". Or you may uncomment the property set that you want to use in the Resources/Properties file. See Project Wonder Properties FilesWO:Project Wonder Properties Files for more information on configuring the application.
56
57 You can see a Properties file in the following screenshot:
58
59 [[image:Context-036.jpg]]
60
61 ----
62
63 Make sure that the build path contains the plugin for your database that you are using:
64
65 [[image:Context-030.jpg]]
66
67 ----
68
69 There is support for launching the app in different ways so that, the database tables can be created or deleted and then re-created.
70
71 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.
72
73 [[image:Context-031.jpg]]
74
75 ----
76
77 Select the 'Run As...' menu option from the 'Run' menu in eclipse:
78
79 [[image:Context-032.jpg]]
80
81 ----
82
83 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.
84
85 [[image:Context-033.jpg]]
86
87 ----
88
89 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.
90
91 Now select BugTracker as your launch configuration to start the application:
92
93 [[image:Context-034.jpg]]
94
95 ----
96
97 You should see a login screen. Your default administrative user is "admin" with password "admin"
98
99 [[image:Context-035.jpg]]
100
101 ----
102
103 Explore