- 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\
- 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
- Windows users should get the zip file instead of installing a service
- 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
- 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
- Extract the files to the same location as tomcat itself
- Modify conf/server.xml for international character support
- Add URIEncoding="UTF-8" to the Connector element
- <Connector port="8080" URIEncoding="UTF-8" ...
- Add URIEncoding="UTF-8" to the Connector element
- Set environment variable: CATALINA_HOME=/opt/tomcat
- Add $CATALINA_HOME/bin to PATH
- Setup the SETENV file in the tomcat/bin directory with JAVA_OPTS (from Install Java 1.5+)
- 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"
- 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
- Mac/Linux: Create a file called setenv.sh with the following: