Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 23 Next »

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. TODO This needs to be done in Windows, but we don't have the exact commands.
  6. Optional: If you want your system to compute advanced statistics about your project, you'll need to install the R Project.
    1. 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 ..."
    2. 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"

    3. Set up JRI: This step does not always need to be done -- on some systems (currently on Linux 64 bit and on Windows) it may be done automatically for you. If it is not and you recieve an error message saying JRI's not installed...

      1. Install rJava & JRI from source or binaries.(Don't install through R's command line prompt -- it will get you a version that's too old). You'll need rJava version 0.8-0 (or any version that has JRI version 0.5-1 -- the JRI versions are not the same as the rJava versions).
      2. If you downloaded a source package (any unix system will be from source) build JRI.
      3. Look up the installation path that JRI went into. (TODO Can we improve these directions?)
      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
  7. Run Apache Tomcat and browse to (in Apache Tomcat's default configuration) http://localhost:8080/websurveytoolbox
  8. 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.
  9. Set up your database. You may enter the database name as "websurveytoolbox" for example, but it's your choice.
  10. 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).

  • No labels