[Opensource] Suggestion for documentation addition installapp.html and mysqlprops.html

[Marc Schipperheyn at Home]

Hi,

After being on a holiday and not working with Expresso for a while, I
figured it was time to install the new versions and start from scratch with
an app I'm working. Thing is, I couldn't log in to the different database
context I created. The reason was that I had set hassetuptables to 'n'. I
had done this because it was empty to start with and I didn't really know
what I was doing. So I would suggest this addition to installapp.html.

Installation procedure
Install the files
blabla

If you have a database for your application
If you have a seperate database for your application. You need to set it up
in the expresso-config.xml file. Refer to the database specific Installation
Notes for more information.

Register the Application's Schema
Next you must "register" the application's Schema object with Expresso. This
allows Expresso to manage and set up the application for you, as the Schema
object lists all of the other components contained in the application.
Usually, you will want to register your Schema in your own database, as
opposed to the default Expresso database (Hypersonic). In order to do this
you must (in the following order):
* Set up your database in the expresso-config.xml file.
* Create the Expresso tables in your database
    + Open the Expresso Administrator.
    + Go to Setup and click on Create/Verify Database Structure & Perform
Initial Setup.
    + Select your newly created context/database in the dropdown box.
    + Click Run.
* Make sure that the value for hasSetupTables in the expresso-config.xml
file for your database is set to 'y'.
    + If it was set to 'n', you'll have to restart Expresso before
continuing.
* Click Login and select your your application from the dropdown box.

Next you must "register" the application's Schema object with Expresso. This
allows Expresso to manage and set up the application for you, as the Schema
object lists all of the other components contained in the application.
blabla.

I've added my mySQL configuration. The current one in the documentation
misses some required keys (including hasSetupTables).

Kind regards,

Marc

-------------- next part --------------
A non-text attachment was scrubbed...
Name: expresso-config.xml
Type: text/xml
Size: 2956 bytes
Desc: not available
Url : http://mailman.jcorporate.com/pipermail/opensource/attachments/20020929/c4a2e8de/expresso-config-0002.xml