==========================================================
OMII Workflow Monitor Web Application - Installation Guide
==========================================================

J.S.Robinson@soton.ac.uk
Created: 28 April 2008
Modified: 29 April 2008

Building from an SVN checkout
=============================

The application is developed as a Maven 2 project.  For details on obtaining and installing Apache Maven see: http://maven.apache.org/

From the top level workflow-monitor/ directory (i.e. the one above this one), run 'mvn install'.  This will build all of the modules including the webapp.

Deployment
==========

The web application archive resulting from the build will be located in workflow-monitor/workflow-monitor-webapp/target/WorkflowMonitor.war.  This can be deployed to a Tomcat instance manually, or using the Tomcat Maven Plugin:

1. Edit workflow-monitor/workflow-monitor-webapp/pom.xml, insderting hostname and port of the target Tomcat server.

<project>
	...
	<build>
		...
		<plugins>
			...
			<plugin>
				<groupId>org.codehaus.mojo</groupId>
				<artifactId>tomcat-maven-plugin</artifactId>
				<configuration>
					<server>deployment-target-tomcat</server>
					<url>http://{HOSTNAME}:{PORT}/manager</url>
				</configuration>
			</plugin>
			...
		</plugins>
		...
	</build>
	...
</project>

2. Edit ~/.m2/settings.xml, adding a stanza like this:

<servers>
	...
	<server>
		<id>deployment-target-tomcat</id>
		<username>{USERNAME}</username>
		<password>{PASSWORD}</password>
	</server>
	...
</servers>

3. From workflow-monitor/workflow-monitor-webapp/ run 'mvn tomcat:deploy'

The REST interface should now be accessible at http://{HOSTNAME}:{PORT}/WorkflowMonitor/Restlet/
A rudimentary servlet interface can be found at http://{HOSTNAME}:{PORT}/WorkflowMonitor/Servlet/