Installation Directions

Owned by AaronW (Unlicensed)
Last updated: Feb 05, 2012Version comment

These installation directions are best read by people who are System Administrators or Informational Technology team. If you've never run a web server or don't know what these instructions mean, these directions will not help you much, and you should probably ask someone with system administration experience for help. Ask us if you need more help!

  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. In 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

If these directions don't answer all of your questions, there's an older, but more walk-through set of directions here (just use the newer versions of each package including the web survey toolbox).