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

1. 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.
2. 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
3. Configure the Domain
   1. Create setenv.bat in [$TOMCAT_HOME}/bin
   2. Edit setenv.bat and add the following:

      if exist "%CATALINA_HOME%/[e-mail]@/win" (
        if not "%JAVA_HOME%" == "" (
        set JAVA_HOME=
        )
        set "JRE_HOME=%CATALINA_HOME%/[e-mail]@/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"

   3. Create the directory {$TOMCAT_HOME}/conf/Catalina/localhost
   4. Create ROOT.xml in {%TOMCAT_HOME}/conf/Catalina/localhost
   5. 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>

   6. 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

   7. 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" />

   8. Navigate to {$TOMCAT_HOME}/webapps and delete support-catalina.jar if it exists.
4. 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.