Tomcat Installation (2.9)
Tomcat 7.0: we recommend Tomcat 7
Tomcat 5.5. and earlier is no longer supported
JAVA_OPTS: running Sakai 2.x in Tomcat 5.5.27+ requires JAVA_OPTS
modifications (see below).
Sakai installations should always be accompanied by a fresh install of Tomcat. It provides a clean environment that simplifies troubleshooting if problems are encountered during the startup phase.
Unpack the Tomcat archive into your installation directory of choice, e.g. /opt/
. Unix/Mac users should create a symbolic link (e.g., ln -s apache-tomcat-5.5.33
) while Windows users should simply rename the base Tomcat directory to /tomcat
to simplify the path.
Tomcat pathnames
Windows users should ensure that the Tomcat path includes no spaces as this causes errors with JavaServer Faces (JSF) tools in Sakai.
Good: C:\opt\tomcat\, C:\sakaistuff\installs\tomcat\
Bad: C:\program files\tomcat\, C:\opt\apache tomcat 7.0.34\
Tomcat permissions
Unix/Mac users should make sure that they have write permissions to the Tomcat servlet container files and directories before proceeding or startup permission errors may occur.