Skip to Content
Last modified by Pascal Robert on 2012/07/27 20:28
From version 12.1
edited by David Holt
on 2008/09/11 19:47
Change comment: There is no comment for this version
To version 19.1
edited by David Holt
on 2007/06/20 19:17
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,23 +1,7 @@
1 1  **Getting Started with BugTracker**
2 2  
3 -~1. Import the source code folders needed for BugTracker either [[from local Wonder source tree>>http://wiki.objectstyle.org/confluence/display/WONDER/Working+with+Wonder+source+in+Eclipse]] or from Wonder CVS server as discussed below.
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:
4 4  
5 -{{info title="Alternate method for getting started with BugTracker"}}
6 -
7 -If you're just exploring BugTracker, you may prefer to use the method outlined on [this page|Getting Started with BugTracker Alternate method] that depends on installed Wonder frameworks instead of importing the Wonder source into your workspace.
8 -
9 -{{/info}}
10 -
11 -The next three screenshots are showing the folders that can be found on the CVS server for Wonder. I have split them up because all the folders don't fit on the screen at once As you can see, the folders that are necessary are found in several different sub-folders.
12 -
13 -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.
14 -
15 -{{warning title="Missing Projects from the screenshots below"}}
16 -
17 -BugTracker has new dependencies on DerbyPlugin and ERChronic since these screenshots were taken. Make sure to import them into your workspace as well.
18 -
19 -{{/warning}}
20 -
21 21  [[image:Context-023.jpg]]
22 22  [[image:Context-024.jpg]]
23 23  [[image:Context-025.jpg]]
... ... @@ -48,57 +48,36 @@
48 48  
49 49  ----
50 50  
51 -{{id value="Configuration"}}{{/id}}
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]]
52 52  
53 -6. 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"
37 +~-~--
38 +Changing the connection dictionary
39 +To do this for Oracle you can either specify on a per model basis or on a global basis.
40 + Global:
41 + dbConnectServerGLOBAL = myDatabaseServer
42 + dbConnectUserGLOBAL = me
43 + dbConnectPasswordGLOBAL = secret
44 + dbConnectPluginGLOBAL = Oracle
45 + Per Model for say model ER:
46 + ER.DBServer = myDatabaseServer
47 + ER.DBUser = me
48 + ER.DBPassword = secret
49 + ER.DBPlugin = Oracle
50 +~-~--
54 54  
55 -{{info title="Update: Sept 11, 2008 How to enable properties for databases other than Derby (FrontBase,PostgreSQL)"}}
52 +Here are the settings I used for FrontBase:
56 56  
57 -* 3 Default Global database properties files are now included with BugTracker. Please see Properties.Derby,Properties.FrontBase,Properties.PostgreSQL
58 -* In the 3 launch configurations (discussed below in point 7) user.name=Derby is now set by default.
59 -* You can swap out Derby for your favourite database (i.e. user.name=FrontBase or user.name=PostgreSQL) in all 3 launch configurations if you want to use your database properties instead of the default Derby
60 -
61 -
62 -{{/info}}
63 -
64 -You can either set Global properties for your database, or you can set them for a specific model. See the Wonder docs for more information about Properties files and database configuration [[ERXConfigurationManager documentation>>http://webobjects.mdimension.com/wonder/api/er/extensions/ERXConfigurationManager.html]]
65 -
66 -Here are the Global database connection settings I used for FrontBase. If you are using a different setup, you may want to ask on the mailing list for guidance:
67 -
68 -ERXConfigurationManager properties moved in from Properties.ak
69 -Original Settings for Postgresql
70 -Changed to Frontbase
54 +#ERXConfigurationManager properties moved in from Properties.ak
55 +#Original Settings for Postgresql
56 +#Changed to Frontbase
71 71  dbConnectURLGLOBAL=jdbc:frontbase:~/~/localhost/bug
72 72  dbConnectUserGLOBAL=//system
73 73  dbConnectPluginGLOBAL=Frontbase
74 -dbConnectDriverGLOBAL=org.postgresql.Driver
75 -dbConnectPasswordGLOBAL =
60 +#dbConnectDriverGLOBAL=org.postgresql.Driver
61 +#dbConnectPasswordGLOBAL =
76 76  dbEOPrototypesEntityGLOBAL=EOJDBCFrontBasePrototypes
77 77  er.javamail.adminEmail=foo@localhost.com//
78 78  
79 -You can see the Properties file that you are editing in the following screenshot:
80 -
81 -[[image:Context-036.jpg]]
82 -
83 -{{info title="MySQL Configuration for BugTracker"}}
84 -
85 -* Create a database named "bug" in your MySQL development database
86 -* Create a user and password with all privileges for that database (or use your mysql root user and password if you wish)
87 -* Add the following properties to the Properties file in BugTracker using the user and password from the previous step
88 -
89 -dbConnectURLGLOBAL=jdbc:mysql://localhost/bug?capitalizeTypenames=true
90 -dbConnectUserGLOBAL=user
91 -dbConnectPasswordGLOBAL=password
92 -dbConnectPluginGLOBAL=
93 -dbConnectDriverGLOBAL=
94 -dbEOPrototypesEntityGLOBAL=EOJDBCMySQLPrototypes
95 -er.javamail.adminEmail=foobar@domain.com
96 -
97 -
98 -{{/info}}
99 -
100 -----
101 -
102 102  Make sure that the build path contains the plugin for your database;
103 103  
104 104  [[image:Context-030.jpg]]
... ... @@ -139,4 +139,4 @@
139 139  
140 140  ----
141 141  
142 -12. Explore
105 +12. Explore!!