We will explain how to install Liferay 6.0.5 CE WAR bundle in an existing Apache Tomcat 6.0.29 and MySQL Server as non ROOT webapp and without Tomcat Manager.

Install Liferay on Tomcat

  1. Download and install Apache Tomcat 6.0.29 standard bundle (with Tomcat Manager included).
  2. Download liferay-portal-6.0.5.war and liferay-portal-dependencies-6.0.5.zip.
  3. Unzip liferay-portal-6.0.5.war file and copy all content into the new Tomcat Context, in this example will be %TOMCAT_HOME%/webapps/liferay605 folder.
  4. Unzip and copy all dependencies to %TOMCAT_HOME%/lib %TOMCAT_HOME%/lib/ext.
  5. Download and copy 2 extra libraries ( jta.jar and mail.jar ) to %TOMCAT_HOME%/lib %TOMCAT_HOME%/lib/ext.
  6. Create liferay605.xml file into %TOMCAT_HOME%/conf/Catalina/localhost folder.
    It looks like this:
     <Context path="" crossContext="true">  

    In my case, DB user is root with empty password. You must create an empty DB in MySQL before, for example lportal605_db.

  7. Create portal-ext.properties into %TOMCAT_HOME%/webapps/liferay605/WEB-INF/classes folder. It looks like this:
  8. If you are using MySQL as database server instead of HSQL, you must copy mysql jdbc lib into %TOMCAT_HOME%/lib %TOMCAT_HOME%/lib/ext folder.
  9. Add the code below to %TOMCAT_HOME%/lib/bin/startup.bat or startup.sh :
      set JAVA_OPTS=%JAVA_OPTS% -Xmx1024m -XX:MaxPermSize=256m
  10. Run startup.bat/sh, you will see in console when liferay creates and populates the portal database automatically. Now, you can open browser window and enter the folow URL http://localhost:8080/liferay605. Use test@liferay.com and test as user and password respectively.

Configure Tomcat Manager

Sometimes you need to deploy liferay in your favorite hosting provider but It is impossible because you can not change files of root context, in this case you can use only control panel of you ISP o Tomcat Manager. Tomcat Manager is included in standard Tomcat bundle but by default It is disabled. If you want to enable it, follow the next steps:

  1. Edit %TOMCAT_HOME%/conf/tomcat-users.xml
  2. Add user, for example:
     <?xml version='1.0' encoding='utf-8'?>  
         <role rolename="tomcat"/>  
         <role rolename="manager"/>  
         <user username="roger" password="roger" roles="tomcat,manager"/>  
  3. Run Tomcat and go to http://localhost:8080/manager
  4. Enter user and password configured in step 2.
  5. Log in to Liferay for example; in Tomcat Manager now you can see an opened session in liferay605 webapp context and to explore values stored in current session.


References :