***************************************************************** * * * R2Q2 - Manual Deployment Guide * * * ***************************************************************** This guide offers instructions on how to deploy the R2Q2 system without using the installation wizard. Before installing the R2Q2 files, ensure you have the following tools installed: - Java Runtime Environment 1.5 - Apache Tomcat Server 5.5 - Axis 1.4 All of these tools can be found in the "Resources" folder of this distribution. In addition, ensure that the "/WEB-INF/lib" folder of your Axis install contains the three .jar files found in the "Resources" folder: - activation.jar - mail.jar - xmlsec-1.3.0.jar Once these tools are installed on the host system, R2Q2 can be installed in the following way: 1) Copy all the .jar files from the "R2Q2/lib" folder and the r2q2.jar file from the "R2Q2" folder to the "WEB-INF/lib" folder of your Axis install. 2) Copy everything from the "R2Q2/public_html" folder into your Axis install folder. 3) Restart the Tomcat server. 4) Replace all instances of "BASEPATHGOESHERE" in the deploy.cmd file (found in the "R2Q2/ws" folder) with the path to your Tomcat base folder. 5) Run the deploy.cmd file, passing "deployr2q2.wsdd" as an argument (also found in the "R2Q2/ws" folder). If the program exits with errors, go back and check all of the appropriate files have been copied to the right place. 6) Stop the Tomcat server. 7) Copy the all of the .class files and the "images" directory from "R2Q2\classes" to the "content" directory of your Axis install. 8) Make a directory called "r2q2" in your Tomcat base directory. 9) Copy the r2q2.properties file from "R2Q2" and the following files from "R2Q2/qti": - imsqti_v2p0.xsd - map_response_point.xml - map_response.xml - match_correct.xml to the new "TomcatBase/r2q2" directory. 10) Copy the "R2Q2/qti/packages" folder to the Axis base directory. 11) Replace all instances of "BASEPATHGOESHERE" in the following files with the path to your Tomcat base folder: - *Axis Base Folder*/r2q2home.jsp - *Axis Base Folder*/showxml.jsp - *Tomcat Base Folder*/r2q2/r2q2.properties 12) Change "localhost:8080" in the "r2q2.router.content.httpBasePath" property in "r2q2.properties" to the URL and port of the server you are installing R2Q2 on. Note, if you are testing the system locally and running Tomcat on the default port, this property can be left unchanged. 13) Right-click on the Tomcat monitor icon in the system tray and click "Configure". Click the "Java" tab, and enter this line into the "Java Options" list box: -Dcom.gavinwillingham.util.properties.location=$TOMCAT\r2q2\r2q2.properties Replace "$TOMCAT" with the path to your Tomcat installation, e.g. C:\Apache\Tomcat. Click "OK" when you're done. 14) Restart the Tomcat server one last time. The R2Q2 demonstrator should now be accessible at: http://URL_OF_SERVER:TOMCAT_PORT/axis/home.jsp ***UPDATE 13/3/07 by cah@ecs.soton.ac.uk*** For a windows install be sure to add these escape characters. 15) in r2q2home.jsp change the \'s in the base path to \\'s 16) in r2q2.properties change all \'s in the base paths to \\'s