Liferay 5.2.3 on external tomcat 6.0 – Community forums – Liferay


I’m going to assume that you know how to install tomcat.  If not, you’ll need to reference the documents on the Apache Tomcat website for assistance with that step, as it is outside the scope of this document.

Make sure your tomcat installation starts and runs before continuing.

Install the Liferay Dependencies bundle in your tomcat installation first.  This largely involves copying some files into the $tomcat/lib directory.

To install the WAR file, go to your TOMCAT MANANGER and upload the WAR file.   NOTE:  The TOMCAT MANAGER is *not* part of the default TOMCAT package any more.  You will need to install that seperately.

In case you don’t have the TOMCAT MANAGER installed (part of tomcat) then you will need to deploy it by hand.  You can find more information here on ways to do that.

You may have to stop and restart tomcat in order to get it to unpack the WAR (if you had to deploy by hand)

Once that is done, you will need to change some of the defaults:

1) Moved ROOT.xml to liferay.xml under TOMCAT_HOME\conf\Catalina\localhost
2) Copied all files under TOMCAT_HOME\webapps\ROOT to webapps\mynewdirectory
3) Added entry portal.ctx=/mynewdirectory to file (don’t forget the “/”)
4) edit TOMCAT_HOME\conf\Catalina\localhost\liferay.xml : <Context path=”/mynewdirectory” crossContext=”true”>


I’m going to assume that you can adjust the file paths for your Windows machines.  I’ve only done that on my workstation once.  And as always, any change in OS can result in a change in directions.  This seems to work really well for *nix systems of various flavors.

  1. Download and install the SUN-JAVA6 JDK and JRE.  (When we get to performance tuning, you’ll see why…)
  2. Install UNZIP since you’ll need it to unpack the bundle.
  3. Set your environment variables JAVA_HOME and JRE_HOME
  4. Set your hostname to something with a FQDN (Fully Qualified Domain Name).  If you don’t have one or know what it is, see your Network Administrator.  Domain Names are outside the scope of this document.
  5. Install the database of your choice.
  6. Upload the bundle to your server and move it to /opt (Note: This is *nix specific.  If you’re on Windows, put it in an out of the way place where it can have plenty of disk space.)  It’s good system administration practice ot keep it out of /var.  /var is where most logs are written and if that partition fills, your server will fail.  It’s also good system admistration practice to keep it out of user space (/usr and /home) for security reasons.  Same goes for installing it in / or most of the other partitions.
  7. Unpack the bundle.
  8. Go into /opt/liferaydirectory/tomcat-version/bin and run the or startup.bat (on Windows)
  9. Make sure that Liferay starts and runs before trying to edit any of the more advanced configurations.
    1. Open a browser and point it to and make sure that you see the Liferay home page.