June 17, 2019

Liferay quick setup

Liferay is a Java open source web platform used in many enterprise portals implementations. Liferay features are commonly required for the development of intranet/extranet websites and portals, for content management and web publishing. It also provides a collaboration suite for sharing and knowledge management services like wikis, blogs, forums and so on.

In this article I will perform a quick setup of Liferay Portal. For this I’ll use a test virtualized environment running on Virtualbox, an hypervisor that allows you to very quickly configure virtual machines useful for test and development environments. This is a “quick-setup” so I will use the “bundled” version of Liferay, a distro that already contains the application server and all that is needed to run the web site properly. Specifically, I will use the version with Tomcat Application Server. Here the details of the system.

Virtual Hypervisor: Virtualbox 4.2
Guest Operative System: Linux Centos 6.3 x86_64
Liferay Portal: 6.1.1 GA2 Community Edition
Java JDK: 1.6.0_33

If you don’t have setup the virtual environment you can setup it first downloading Virtualbox here. Get also a “minimal” CentOS iso of the guest operative system  here (about 340MB).You can assign to the Guest, 2GB of RAM and a 7GB virtual hard disk (use dynamically allocated storage option).


Start the guest machine and proceed with the Liferay installation. I usually make a dedecated user account for Liferay runtime environment (avoid using root to manage Liferay application layer; it’s generally a best practice to increase the security level).

Setup the user configuration for file handler and add the dns record for hostname in /etc/hosts file. We can also open the port 8080 updating the iptables configuration file for the http access to the portal.

We download the Community Edition “bundled with Tomcat” Liferay directly using wget command. Get also a version of Linux x64 Java JDK from here (the access to the archive containing the older versions requires a user registration)

Now unzip the archive by using the user application “liferay” and install the JDK.

Setup the JAVA_HOME variable for “liferay” user.

Finally check the java home and start the Liferay Tomcat application server.

To monitor the Tomcat bootstrap we can do a “tail” on the log file.

If there are no errors, Liferay start with the HSQL database instance (it’s installed by default in the archive unpacked earlier). Point your browser at port 8080 of the machine where Liferay is running to access to the welcome page of the portal.


Related posts

Leave a Reply

Your email address will not be published.