How to build GDFR

1. Grab the source code which you can find here
2. Unpack the tarball
3. In the base directory you will see a file called config.example.properties. You will need to fill in all the property values. There are comments above each one to indicate its purpose.
4. It's recommended (but not necessary) that a clean build be executed first. This is done with build-oss.sh clean
5. Run the build script by executing the following command: build-oss.sh stage
6. The previous step will compile all of the Java files and stage everything to the stage directory.
7. The build step also creates a tarball called gdfr-dist-oss.tar.gz .

Explanation of the build/deploy Process

When the build script is executed, it compiles everything under src/java (and creates a jar file called registry.jar and then copies all of the application files into the stage directory. When the deploy is executed, it copies everything under the conf directory to Tomcat's webapps/webservices/ directory. Everything under config gets copied to Tomcat's /webapps/webservices/WEB-INF/classes/config directory.

During the deployment, any file that ends in .template will have values filled in. In these .template files, you will notice some places have things that look like #SOME_NAME#. This value gets substituted for whatever value #SOME_NAME# has in your config.properties file.