Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Install Sun's Java JDK (make sure you install the "JDK" not the "JRE").
  2. Download and install Apache Tomcat -- we recommend 6.0.20. Read the directions for help.
  3. Download and install MySQL.
  4. Download the websurveytoolbox.war file and copy it into Apache Tomcat's "webapps" folder.
  5. Add memory to Apache Tomcat's default configuration:
    1. 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.
    2. 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.
  6. Run Apache Tomcat and browse to (in Apache Tomcat's default configuration) http://localhost:8080/websurveytoolbox
  7. 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.
  8. Set up your database. You may enter the database name as "websurveytoolbox" for example, but it's your choice.
  9. 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

...