Skip to end of metadata
Go to start of metadata

KFS uses Ant for deployments and unit testing.

Build Properties

Configuration properties may be specified by certain files which are looked for automatically by the script. The first definition of a property will be used by the build, i.e. Ant does not work like many other things where the last value wins. There are three locations that that the build script attempts to load properties from, in the order specified:

  1. ${user home}/

    User Home Locations

    • Unix: /home/username/
    • Mac OS X: /Users/username/
    • Windows XP: C:/Documents and Settings/username/
    • Windows Vista: C:/Users/username/
  2. ${} (location set in the above
  3. (delivered in the root of the project)

For ease of future upgrades, you should avoid modifying the third file. Instead, you can override any or all of those properties in the first two. For example...

  1. Create a second build properties file in the root of the project (e.g.
  2. Ensure that your new properties file will be loaded by adding the following to your ${user home}/ file.
    example institution shared properties reference

Build Target Overview

To deploy a KFS distribution, you can use the dist or dist-local targets of the KFS build.xml. To execute the KFS unit tests, you can use the test-local or continuous-integration targets.  The dist-local and test-local targets assume that you are using an IDE for compilation. If not, you will need to add this line to your build properties file and use the make-source target, too: The continuous-integration target is intended for use within an automated testing tool like Anthill Pro. See the setup instructions and the help target in the build file itself for more information.

Dist Targets Flow: Test Targets Flow:

Directory & File Creation

KFS requires that certain external directories and files exist at runtime.

  • The settings and security directories must be created and populated

    The goal of externalizing some of the application configuration is to allow for modification without a deployment. Also, the secure information contained in some of these files (e.g. database passwords) has different access requirements than code does.

  • The logs and work (attachments, reports, staging) directories must be created
  • Certain files must be added to the application server

The dist-local target accounts for these external dependencies. It copies the files and folders in the build/external directory of the project to their expected locations. The expected locations are configurable via build properties. The configuration properties page lists the default values for the properties that control the expected locations.








${appserver.localhost.dir} or META-INF directory in war





The dist-local and dist targets both generate / extract certain files that reside within the application itself, using the contents of the build/project directory.










Unable to render {include} The included page could not be found.
  • No labels