Building WebApollo

View On GitHub

To build WebApollo, we first edit the configuration files, and then run the apollo scripts to create a WAR package. This allows webapollo to be fully configured for deployment so that you can just copy the WAR file into the webapps folder instead of editing things inside the webapps folder.

Before you build

You need to configure your instance using a and a config.xml file, which are copied into the war file.

  • Copy the sample config / logging files to the right location. You can use the sample_config.xml defaults but make sure to edit
cp sample_config.xml config.xml
cp sample_log4j2.json log4j2.json
cp sample_log4j2-test.json log4j2-test.json
  • Edit the file to point to the appropriate directories. A sample config might look like:
organism=Pythium ultimum

IMPORTANT: the directory should not be placed anywhere inside the Tomcat webapps folder, not even using symlinks!! To avoid data loss when doing Tomcat Undeploy operations, users are advised not to be modifying the contents of the webapps folder for anything besides deploying new WAR files

Building the servlet

Web Apollo uses maven to create a WAR package which bundles your config files. After setting up the config, you can use the command:

./apollo deploy

This will produce the a WAR file in WEB_APOLLO_DIR/target/ (e.g. target/apollo-1.0-SNAPSHOT.war) that is ready to deploy. See deploying webapollo for the next steps for deploying.

Alternatively, developers or user's with custom builds are advised to review the developer's guide for further instructions on creating their own builds.