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 commands.
    Optional: If you want your system to compute advanced statistics about your project, you
  6. 'll need to install the R Project.
  7. Install R and JGR:
    1. On Ubuntu,  read how to install on Ubuntu-- in these directions, you can probably ignore the first few directions and skip straight to "apt get ..."
  8. Edit your tomcat launch file. You'll have to set the "R_HOME" environment variable to where your R home directory is:
    1. In Linux:
      1. Find your R_HOME location -- probably something like /usr/lib/R or /usr/lib64/R.
      2. Edit catalina.sh and add this after the first line: "export R_HOME=/path/to/your/R/installation"
  9. Include PageWST:Setting up JRIWST:Setting up JRI
    1. Edit your tomcat launch file.
      1. In Linux, edit apache tomcat/bin/catalina.sh and add to your JAVA_OPTS line at the end before the quote: -Djava.library.path=/path/to/jri/installation
    Run Apache Tomcat and browse to (in Apache Tomcat's default configuration) http://localhost:8080/websurveytoolbox
  10. 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.
  11. Set up your database. You may enter the database name as "websurveytoolbox" for example, but it's your choice.
  12. 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

...