Building and Releasing the Webapp

Once you have read access to a production database and properly configured the webapp settings you can build and release a web application against it. Simply run the following:

cd <somemine>/webapp
ant

This will fetch the model from the database, generate the model java code, and summarise the contents of the database.

Object store summarisation

The summary data generated by this step includes: * counts of the number of objects of each class which speeds up the webapp * a list of fields that are always null/no value, so that the webapp can grey-out those fields * for fields that have a small number of possible value (eg. Organism.taxonId), find and save that values so the the webapp can render a drop down box in those cases

Summarising will take some time but only needs to be performed once per database build. If the database is modified in any way, you should force a resummarisation on the next run of build-production-webapp. Do this by running the summarise-objectstore post-process (in the <mine>/postprocess directory):

ant -v -Daction=summarise-objectstore

For this command to work you will need to add this line:

<post-process name="summarise-objectstore"/>

to the end of the <post-processing> section of your project.xml.

Release the web application in the usual way:

[ant remove-webapp]
ant release-webapp

Troubleshooting

The first thing to try is to run:

ant -v

which will produce a lot of extra output, including more detailed information about errors. Messages like "Unable to find property file: " int the ant -v output may also indicate a problem.