Setting Up Liferay Portal 6.2 on Tomcat 6

Liferay Support does not recommend or endorse specific third-party products over others. Liferay is not responsible for any instructions herein or referenced regarding these products. Any implementation of these principles is the responsibility of the subscriber.

This article is on how to set up Liferay Portal 6.2 EE using a war on Tomcat 6.

Resolution

Gather the Necessary Files
1. Download and unzip the most recent supported version of Tomcat 6 http://tomcat.apache.org/download-60.cgi
2. Download the most recent Liferay.war file and Liferay Portal dependencies. Liferay WAR and dependencies.
Dependency Jars
1. Create a folder {$TOMCAT_HOME}/lib/ext
2. Extract the dependencies files to {$TOMCAT_HOME}/lib/ext
3. Copy the following jars from {$build}/lib/development to $TOMCAT_HOME/lib/ext: (These can also be taken from an existing bundle.)
  - activation.jar
  - jms.jar
  - jta.jar
  - jutf7.jar
  - mail.jar
  - persistence.jar
4. Remove the ccpp.jar for Tomcat 6.
  - Copy the followings jars from {$build}/lib/development to {$TOMCAT_HOME}/temp/liferay/com/liferay/portal/deploy/dependencies:
    - resin.jar
    - script-10.jar
5. Download the latest MySQL JDBC driver (MySQL Connector) and extract mysql-connector-java-{$version}-bin.jar to {$TOMCAT_HOME}/lib/ext

Configure the Domain

Create setenv.bat in [$TOMCAT_HOME}/bin

Edit setenv.bat and add the following:

if exist "%CATALINA_HOME%/jre@java.version@/win" (
  if not "%JAVA_HOME%" == "" (
  set JAVA_HOME=
  )
  set "JRE_HOME=%CATALINA_HOME%/jre@java.version@/win"
)

set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF8 -Djava.net.preferIPv4Stack=true -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false -Duser.timezone=GMT -Xmx1024m -XX:MaxPermSize=256m"

Create the directory {$TOMCAT_HOME}/conf/Catalina/localhost
Create ROOT.xml in {%TOMCAT_HOME}/conf/Catalina/localhost

Edit ROOT.xml and add the following:

<Context path="" crossContext="true">
<!-- JAAS -->

<!--<Realm
  className="org.apache.catalina.realm.JAASRealm"
  appName="PortalRealm"
  userClassNames="com.liferay.portal.kernel.security.jaas.PortalPrincipal"
  roleClassNames="com.liferay.portal.kernel.security.jaas.PortalRole"
/>-->

<!-- Uncomment the following to disable persistent sessions across reboots. --> 

<!-- <Manager pathname="" /> -->

<!--
  Uncomment the following to not use sessions. See the property
  "session.disabled" in portal.properties.
-->

<!-- <Manager className="com.liferay.support.tomcat.session.SessionLessManagerBase" /> -->
</Context>

Edit {$TOMCAT_HOME}/conf/catalina.properties and replace

common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar

with

common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${catalina.home}/lib/ext,${catalina.home}/lib/ext/*.jar

Edit {$TOMCAT_HOME}/conf/server.xml and replace

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

with

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />

Navigate to {$TOMCAT_HOME}/webapps and delete support-catalina.jar if it exists.

Deploy Liferay
1. Navigate to {$TOMCAT_HOME}/webapps/ROOT and delete the contents
2. Extract the contents of liferay-portal-6.2.0.war to {$TOMCAT_HOME}/webapps/ROOT
3. Open a command console to {$TOMCAT_HOME}/bin and type in startup.bat to start the server.