Peruser Builld/Install Ant Properties Reference

Peruser build, installation, and unit testing procedures are all scripted using ant.    Several ant properties are available for you to customize so that these builds and installs work properly in your enviornment.  These properties are set in files found under conf/ant_prop.  Typically you will have one customized properties file here for each host or unique build configuration that you want to manage.  When you start off using the peruser, you will probably have only one such file.

(more about the .prop files and the .sh files)

Property Name

Containing File

Default Value

Description

peruser.lib.dir

yourdomain/yourhost.prop

../peruser_XXX_lib

Root of the directory tree containing third party jar files used to build and run peruser.  This is the directory where you unpacked peruser_XXX_lib.zip.

cocoon.src.tree

yourdomain/yourhost.prop

../cocoon_XXXX_src

Directory containing a source build tree of cocoon.  This should be the directory you unpacked the cocoon distribution into.  The peruser "config-cocoon-src" ant task will copy configuration files into this build tree, and possibly overwrite other customizations you have made to cocoon.

cocoon.install.dir

yourdomain/yourhost.prop

/usr/local/tomcat/webapps/co_dist

Directory where the combined cocoon+peruser webapp should be installed.  Typically this will be inside your Tomcat webapps directory.

Warning:  Some peruser ant tasks will overrwite this directory!

cocoon.lib.dir

yourdomain/yourhost.prop
(for custom values)
OR
use the default from common.prop.

${cocoon_stub.lib.dir}

Library directory containing cocoon jars and related jars which can be used for compiling and running peruser unit tests.  Should either point to your installed cocoon webapp WEB-INF/lib directory, or should contain the same value as ${cocoon_stub.lib.dir}.

main.lib.dir

common.prop

${peruser.lib.dir}/main

Directory containing jar files which are not included with cocoon or most servlet containers. These jar files will usually need to be copied into any container where you are running peruser software.

container.lib.dir

common.prop

${peruser.lib.dir}/container_stub

Directory containing the javax.servlet.jar file defining the java servlet API.  This file is used only at build time, and is not copied into any webapp installation tree.

cocoon_stub.lib.dir

common.prop

${peruser.lib.dir}/cocoon_stub

Directory containing jar files that are needed to build peruser java code and to run peruser unit tests, but which are also found in the cocoon distribution.  These files do not need to be copied into your cocoon installation.

local.lib.dir

common.prop

${peruser.lib.dir}/local

Directory containing jar files specific to your installation.  JDBC drivers and your application-specific jars may be placed here to make them available to Peruser+Cocoon.

peruser.standalone.log4jconfig

common.prop

conf/standalone/log4j/log4j.properties

Location of Log4J properties used during Peruser unit tests and other executions invoked directly from ant.

install.permfix

common.prop

g+w

Argument to "chmod" which peruser applies after installing files into your coocoon.install.dir.