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 12 Next »

  • 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.sh with the following: 
      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: 
      set JAVA_OPTS=-server -XX:+UseParallelGC -Xmx768m -XX:MaxPermSize=160m -Djava.awt.headless=true
  • No labels