Versions Compared

Key

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

...

  1. Download tomcat 5.5 - http://tomcat.apache.org/download-55.cgi
    • Windows users should get the zip file instead of installing a service
      It makes viewing the tomcat logs easier and it is easier to configure
  2. Extract to /opt (symlink the apache-tomcat-5.5.x directory to tomcat after extracting)
    • Windows users should just rename the directory since they cannot symlink
  3. Download the java 1.4.2 compat patch (compat.zip)
    • NOTE: You should NOT install this patch if you are using Sakai 2.4 or higher
  4. Extract the files to the same location as tomcat itself
  5. Modify conf/server.xml for international character support
    1. Add URIEncoding="UTF-8" to the Connector element
      • <Connector port="8080" URIEncoding="UTF-8" ...
  6. Set environment variable: CATALINA_HOME=/opt/tomcat
  7. Add $CATALINA_HOME/bin to PATH
  8. Setup the SETENV file in the tomcat/bin directory with JAVA_OPTS (from Install Java 1.5+)
    1. Mac/Linux: Create a file called setenv.sh with the following:
      Code Block
      export JAVA_OPTS="-server -XX:+UseParallelGC -Xmx768m -XX:MaxPermSize=160m -Djava.awt.headless=true"
      
    2. Windows(PC): Create a file called setenv.bat with the following:
      Code Block
      set JAVA_OPTS=-server -XX:+UseParallelGC -Xmx768m -XX:MaxPermSize=160m -Djava.awt.headless=true