This wiki does not contain official documentation and is currently deprecated and read only. Please try reading the documentation on the Liferay Developer Network, the new site dedicated to Liferay documentation. DISCOVER Build your web site, collaborate with your colleagues, manage your content, and more. DEVELOP Build applications that run inside Liferay, extend the features provided out of the box with Liferay's APIs. DISTRIBUTE Let the world know about your app by publishing it in Liferay's marketplace. PARTICIPATE Become a part of Liferay's community, meet other Liferay users, and get involved in the open source project. Installing 5.2 SP3 WAR on Tomcat 6
This only applies to Windows. At the time of writing this wiki, the author used Tomcat 6.0.26
Preface#
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.
Dependencies#
Install the Liferay Dependencies bundle in your Tomcat installation first. Do this by copying the files from the Dependencies .zip into the $TOMCAT_HOME/lib directory. It should be noted that Tomcat requires 2 extra files:
- jta.jar
- mail.jar
Be sure to include those 2 files in the $tomcat/lib directory in addition to the Liferay Dependencies.
Deploying the WAR file#
1) Delete all files under TOMCAT_HOME\webapps\ROOT, then copy all of the files from the Liferay WAR to that directory.
2) Move the files from the .war to the now empty ROOT folder. The simplest way to do this is to open it with an archiver program such as 7zip or WinRAR, then copy/extract all of the files into ROOT.
3) Add the code
set "JAVA_OPTS=%JAVA_OPTS% -Xmx1024m -XX:MaxPermSize=256m"
in the startup.bat file located in the $TOMCAT_HOME/bin directory. This line of code will prevent Java memory issues.
Finally, to startup Tomcat, execute "startup.bat"
Hooray!