Building the Surrogate Container
================================

The container was originally built using Netbeans 6.9 and has the appropriate
project contents checked into Subversion.

To build correctly, you need to define a few libraries in Netbeans:  To do this,
right-click on the RiverSurrogate node in the Projects tab and select
"Properties", then select the "Libraries" node.  Define the following libraries:

ApacheRiverPlatform
    jsk-platform.jar
    jsk-resources.jar
from the River distribution.

ApacheRiverLib
    jsk-lib.jar

ApacheCommonsLogging-1_1_1
    commons-logging-1.1.1.jar
from the Apache Commons Logging v1.1.1 distribution

ApacheCommonsVFS-1_0
    commons-vfs-1.0.jar
from the Apache Commons VFS v1.0 distribution.

ApacheRiverServices
    fiddler.jar
    reggie.jar
    outrigger.jar
    norm.jar
    mahalo.jar
    mercury.jar
from the Apache River distribution.

The project properties should already include these libraries in
the compile classpath.

The permission file parser is generated using the 'JavaCC' tool (version 5.0)
currently available from 'https://javacc.dev.java.net/'.  Download and unpack
the tool to a convenient location, then create a library as above called
'JavaCC' that contains the javacc home directory as its 'sources' directory.

The configuration file schema is bound using JAXB.  It may be necessary to ensure
that Netbeans has the JAXB libraries defined.

Also, once you load the project, check on the runtime setup for the "working directory" in 
the Project Properties --> Run panel.  It should be set to "build/testroot", but may not 
carry over to the runtime environment properly through version control.