Building Metacat

Back | Home | Next
Table of Contents
About Building Metacat
Prep the Build Configuration
build.properties
build.xml
Cleaning the Codebase
Automated Build
Manual Build
About Building Metacat

This documentation covers building Metacat on a local development environment. In essence, the local development build is no different than the production build, but a few convenience options have been added to help the developer.

These instructions are meant to augment the Install Metacat War section of the Metacat Installation Guide.

Metacat is built using the Ant build utility. You will need to have Ant installed on your development system to build Metacat

Prep the Build Configuration
build.properties

You will need to edit /build.properties and make sure the following values are correct:

build.xml

There are several adjustments you can make to the build by editing >metacat_workspace</build.xml. Some of the common ones are:

Cleaning the Codebase

The metacat build.xml has several methods for cleaning the codebase. The format for running these is:

ant <clean-target>
The available clean-targets are:
Automated Build

There is an ant target called "dev-install" that was created specifically for local develoment building and deploying. What it does is:

Typical usage would be something like:

ant fullclean dev-install
Manual Build

You can also build the Metacat war file and deploy manually. To build and create the war, run:

ant install-ecogrid

The war file will appear in your >metacat_workspace</dist directory. Copy the war file into your tomcat webapps directory. Delete the existing code that was expanded from the old jar.