This file contains instructions for running locally and to deploy this sample to
Google App Engine platform.
You can compile and deploy either from command line (using ant build) or from
eclipse, instructions are given for both methods.

Preparing to compile
====================
Before compiling the project you need to have installed in your local
environment the latest versions of Google App Engine SDK and Google Web Toolkit.
The current versions are:
- App Engine 1.8.1
- Web Toolkit 2.5.1

Compiling from command line
===========================
We include an ant build.xml file, so, if you have ant binaries installed in your
local environment, you will be able to compile the project from command line.
Before executing, you will need to setup two environment variables:
- APPENGINE_HOME: full path of your GAE SDK
- GWT HOME: full path of your GWT SDK

To do a full compilation, that will generate a valid war folder that you can 
use to deploy, you do this:

$ ant clean build

Compiling from eclipse
======================
The sample folder includes all the required configuration files for an eclipse
project, so you will only need to import the project from eclipse.
To get the required libraries copied to your WEB-INF/lib folder, run the
"build.xml" file, with "libs" as target.
As we are using datanucleus, that requires to "enhance" the presistent classes,
you will need to execute the enhancer everytime you do changes in the persistent
classes. We have a task in the build.xml to do this, and the target to execute
the task is named "datanucleusenhance". So, you will need to execute this task
each time the persistent classes are compiled (for instance, because you removed
class files, or because you made changes in persistent classes).

Deploying from command line
=========================================
Before deploying, manually edit the war/WEB-INF/appengine-web.xml file and set
the application name (in the "application" tag) properly.
To deploy, you must execute a command like this:

$ $APPENGINE_HOME/bin/appcfg.sh update war

you will be asked for the username and password of the user who is deploying,
that must have administrator permission on the application selected in the
appengine-web.xml file.

Deploying from Eclipse with Google Plugin
=========================================
Before deploying you should set the application name (in "project > properties >
Google > App Engine) to the name of one of your valid app engine applications.
Alternatively, you can edit the war/WEB-INF/appengine.web.xml file and set
the application name (in the "application" tag) properly.

To avoid the enhanced classes to be re-compiled, disable the "automatic builds"
in eclipse before deploying.