Install Tomcat 5.5

Owned by Former user (Deleted)
Last updated: Apr 17, 2012Version comment
1 min read
  • Apache Tomcat - http://tomcat.apache.org/
  • Note: Always do a fresh install of Tomcat
  • Note: Windows users should ensure that there are no spaces in the complete tomcat path as this causes errors with JSF tools in Sakai
    GOOD: C:\opt\tomcat\, C:\sakaistuff\installs\tomcat\
    BAD: C:\program files\tomcat\, C:\opt\apache tomcat 5.5.18\
  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.shwith the following:

      export JAVA_OPTS="-server -XX:+UseParallelGC -Xmx768m -XX:MaxPermSize=160m -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true"

    2. Windows(PC): Create a file called setenv.batwith the following:

      set JAVA_OPTS=-server -XX:+UseParallelGC -Xmx768m -XX:MaxPermSize=160m -Djava.awt.headless=true -Dhttp.agent=Sakai -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -Dsun.lang.ClassLoader.allowArraySyntax=true