Readme

1. In order to compile this plugin, following jars must be added to 
buildpath properly

	axis.jar
	cactus.jar
	aspectjrt.jar
	commons-httpclient.jar
	commons-logging.jar
	httpunit.jar
	servlet.jar
	nekohtml.jar
	xml-apis.jar
	xercesImpl.jar
	
2. In order to run unit test, corresponding Tomcat server must be 
configured to support Cactus framework,

	- axis.jar, cactus.jar, aspectjrt.jar, commons-httpclient.jar, 
	  commons-logging.jar, and junit.jar must be copied to Tomcat
	  common lib folder
	  
	- define Cactus servlet mapping in Tomcat configuration web.xml
	
		<!-- ***** cactus server config ***** -->
		<servlet>
 			<servlet-name>ServletRedirector</servlet-name>
			<servlet-class>org.apache.cactus.server.ServletTestRedirector</servlet-class>
			<init-param>
				<param-name>param1</param-name>
				<param-value>value1 used for testing</param-value>
			</init-param>
		</servlet>
		<servlet-mapping>
			<servlet-name>ServletRedirector</servlet-name>
			<url-pattern>/ServletRedirector</url-pattern>
		</servlet-mapping>

	- deploy BIRT runtime package to Tomcat webapps folder
	
	[note] following steps have been automcated if running via ant script, e.g. build.xml
	
	- package required test cases
	
	- deploy required test cases
	
	- startup Tomcat Server
	
	- execute unit test(s)
	
	- shutdown Tomcat Server
	
	- report test result(s)
	
3. Note that config.properties is where you set default system properties to run this test 
plug-in. you can find this file under /src/org/eclipse/birt/report/tests/viewer directory.