Installing The WAR File

  1. Install Apache Tomcat, or another Java server.
  2. Download the WebFlow WAR (web archive).
  3. Install the WAR file: you can do this easily using Tomcat's web-based Manager application, or you may do it manually. See the documentation of your server for more details.
  4. Create the Data directory. By default this is C:/data/ - simply create that directory.
    If you wish, you can change the location by editing the following line (line 68) in the file {SERVER_DIRECTORY}/webapps/FACS/WEB-INF/web.xml.
    <env-entry> <env-entry-name>fcsroot</env-entry-name> <env-entry-value>C:/data/</env-entry-value> <env-entry-type>java.lang.String</env-entry-type> </env-entry>
    Replace the bold text with your desired data storage location. Make sure your location ends with a "/".
  5. Set up the users list for WebFlow. Navigate your browser to http://localhost/FACS/Admin.jsp, log in with your Tomcat administrator username/password, and then follow the instructions on the page.
  6. Now you're ready to use WebFlow. Navigate to the front page: http://localhost/FACS.

Building WebFlow from Source

  1. First, download the JDK. You will also need the Java Enterprise Edition development kit, which you can either download separately or together with some versions of the JDK.
  2. Get ant or an IDE that is compatable with ant buildfiles.
  3. Get WebFlow's source and extract it to a convenient folder - which will henceforth be referred to as the source directory.
  4. Generate a signature for use with JARsigner, using the keytool utility. (This is to create the Upload and Annotator JAR files.) For details as to how to do this, read Sun's documentation here.
  5. Create the build properties file WebFlow.build.properties in the source directory as follows:
    data.dir=C:/data/ java_version=1.5 key.alias=mykey key.pass=mypass j2ee.lib.dir=C:/Program Files/Java/J2EE/lib/
    The data directory represents the directory where FCS files will be stored (ensure that it ends with a "/"). The key.alias and key.pass parameters refer to the key that you generated in step 4. Finally, the j2ee library directory needs to contain j2ee.jar - generally it is the lib directory under the J2EE install directory.
  6. You should now be ready to compile/build WebFlow. Open a command prompt in the source directory and run ant. If the build succeeds, you should get the FACS.war file in the build subdirectory.
  7. Using the WAR file, follow the instructions above to install and run WebFlow.