...
- Install Sun's Java JDK (make sure you install the "JDK" not the "JRE").
- Download and install Apache Tomcat -- we recommend 6.0.20. Read the directions for help.
- Download and install MySQL.
- Download the websurveytoolbox.war file and copy it into Apache Tomcat's "webapps" folder.
- Add memory to Apache Tomcat's default configuration:
- In Linux: In the directory you installed Apache Tomcat, look for bin/catalina.sh
As the second line, add JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=512m -Xmx1000m"
This will prevent the system from running out of memory. - TODO This needs to be done in Windows, but we don't have the exact commandsIn Windows: In the directory you installed Apache Tomcat, look for bin/catalina.bat and edit it using something like a text editor. Search for "rem ----- Execute The Requested Command" comment (around line 160) and insert one of the following lines after the comment:
set CATALINA_OPTS=%CATALINA_OPTS% -XX:MaxPermSize=512m -Xmx1024m
or
set JAVA_OPTS=$JAVA_OPTS -XX:MaxPermSize=512m -Xmx1000m
This will prevent the system from running out of memory.
- In Linux: In the directory you installed Apache Tomcat, look for bin/catalina.sh
- Run Apache Tomcat and browse to (in Apache Tomcat's default configuration) http://localhost:8080/websurveytoolbox
- If that doesn't work, browse to http://localhost:8080 and you should see this image. If you don't, your Apache Tomcat setup is not configured correctly.
- Set up your database. You may enter the database name as "websurveytoolbox" for example, but it's your choice.
- After clicking "Initialize", you may get a bizarre error message. This is a known bug. Just visit the home page again: http://localhost:8080/websurveytoolbox
...