/
Install Tomcat 5.5

Install Tomcat 5.5

Apr 17, 2012

  • 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