A guide for Liferay and gUSE installation

1 Prerequisites

Before preceding the installation, make sure that all the following hardware and software requirements are met :

  • Hardware
    • 2 GB memory
    • x86 CPU (minimum 2.4 GHz, depends on usage)
    • minimum 1GB (portal installation) and additional 20-100 GB HDD for user data
  • Software
    • Linux -Scientific or other (Ubuntu,...)
    • J2SE 6.x
    • Apache Tomcat 6.x (6.0.26, 6.0.29 tested...)
    • mysql (5.1.41 tested) remote or local installed
    • Liferay 6.0.5 (Bundled with Tomcat works)
    • gLite User Interface installation - this isn't necessary when installing without EGEE support (optional) + SC Linux

2 Install MySQL server and client

Use the packet manager for install rpms, start MySQL server and set the root password for MySQL:

 $ yum install mysql mysql-server
 $ service mysqld start
 $ mysqladmin -h fullyqualified.hostname -u root password NEWPASSWORD

2.1 Portal databases

Create empty liferay, wspgrade and portaluser databases.

 $ mysql -h fullyqualified.hostname -u root -pNEWPASSWORD
 > create database liferay;
 > create database wspgrade;
 > create database PortalUser;

2.2 MySQL users and permissions

Create liferay, wspgrade and portaluser users and set privileges for each users on databases.

 $ mysql -h fullyqualified.hostname -u root -pNEWPASSWORD
 > create user liferay identified by 'liferaypassword';   
 > create user wspgrade identified by 'wspgradepassword';   
 > create user PortalUser identified by 'PortalUserpassword';
 > grant all on liferay.* to 'liferay'@'localhost' identified by 'liferaypassword';
 > grant all on wspgrade.* to 'wspgrade'@'localhost' identified by 'wspgradepassword';
 > grant all on PortalUser.* to 'PortalUser'@'localhost' identified by 'PortalUserpassword';   
 > grant all on liferay.* to 'liferay'@'fullyqualified.hostname' identified by 'liferaypassword';
 > grant all on wspgrade.* to 'wspgrade'@'fullyqualified.hostname' identified by 'wspgradepassword';
 > grant all on PortalUser.* to 'PortalUser'@'fullyqualified.hostname' identified by 'PortalUserpassword';

3 Install Liferay

First download the Liferay 6.0.5 package bundle with Tomcat from the URL: http://sourceforge.net/projects/lportal/files/Liferay%20Portal/6.0.5/liferay-portal-tomcat-6.0.5.zip/download .

Now unzip the archive in the /opt folder.

3.1 Edit/Create Liferay properties

Edit the file called portal-ext.properties. If it does not exists, please create a file with this name in the '''tomcat's root folder''', if exists please move it to '''tomcat's root folder'''.

gUSE requires the following settings:

  • jdbc.default.driverClassName = JDBC driver implementation
  • jdbc.default.url = JDBC URL
  • jdbc.default.username = user name to the database
  • jdbc.default.password = user's password to the database
  • jdbc.default.maxIdleTime = connections timeout
For example:

4 gUSE installation and configuration

Download gUSE from http://sourceforge.net/projects/guse/files/latest/download?_test=goal and extract the content of the archive in your home folder.

4.1 gUSE database

Creating database tables for gUSE.

 $ mysql -h fullyqualified.hostname -u wspgrade -pwspgradepassword wspgrade < guse_tables.sql
 $ mysql -h fullyqualified.hostname -u wspgrade -pwspgradepassword wspgrade < guse_table_mess.sql
 $ mysql -h fullyqualified.hostname -u wspgrade -pwspgradepassword wspgrade < guse_tables_index.sql

4.2 Parameterizing runtime environment

In the shell which starts the webcontainer the following environment variables must be set:

 $ export JAVA_OPTS="-server -Xms256m -Xmx1024m -XX:MaxPermSize=512m -Dfile.encoding=UTF8 -Duser.timezone=GMT"

Where :

  • -server : JVM has to be run in server mode
  • -Xms : initial heap size
  • -Xmx : maximum heap size
  • -XX:MaxPermSize=128m : memory to store long term object instances
  • -Dfile.encoding=UTF8 : file encoding
  • -Duser.timezone=GMT" : timezone
Very important:
  • the setting will be effective after reboot
  • make sure that there is always as much available memory as it had been specified in the settings
  • for configuration with high load, Xmx can be increased up to 64 GB
  • the size of XX:MaxPermSize can be configured to be higher for development (TomCat bug)

 $ export X509_USER_PROXY=x509up

If it is not set, voms extension cannot be set for the proxy

 $ export CATALINA_OPTS="-DcrlUpdateInterval=0s -DcrlEnabled=false -Dorg.globus.tcp.port.range=20000,25000 "


  • -DcrlUpdateInterval :
  • -DcrlEnabled :
  • -Dorg.globus.tcp.port.range :Needed to run GT2/GT4, if not set, jobs will stay in PENDING status

In the file /opt/liferay-portal-6.0.5/tomcat-6.0.26/bin/setenv.sh you cancel all the content and replace with JAVA_OPTS="$JAVA_OPTS".

4.3 Copying additional jar files to shared libs directory

Copy the following jar files from libs folder to the servers shared libs' directory ( /opt/liferay-portal-6.0.5/tomcat-6.0.26/lib in tomcat 6.0, /opt/liferay-portal-6.0.5/tomcat-6.0.26/shared/libs in version 5.5).


  • cog-jglobus.jar
  • commons-logging-1.1.1.jar
  • cryptix-asn1.jar
  • cryptix32.jar
  • javaee-api-5.0-1.jar
  • jce-jdk13-131.jar
  • mysql-connector-java-5.1.6-bin.jar
  • puretls.jar
  • dsn.jar
  • imap.jar
  • mailapi.jar
  • mail.jar
  • pop3.jar
  • smtp.jar

4.4 Configuring ws-pgrade installer package

Set "database connection" information of gUSE in information.war/WEB-INF/classes/META-INF/persistence.xml and "service urls" in information.war/WEB-INF/config/service.xml replace http://localhost:8080 with http://fullyqualified.hostname:8080 for all the occurences.

After you configure the file init.jsp with your parameter for faster inizializzation of gUSE.

For do this you must extract the file from the information.war file modify the file and recreate the war file. You can do this using for example Eclipse: import project from WAR, modify the files and export to WAR. The name of archive must be the same.

4.5 Deploying the gUSE war files

After starting Liferay with command:

 $ /opt/liferay-portal-6.0.5/tomcat-6.0.26/bin/startup.sh

from web browser: http://fullyqualified.hostname:8080 navigate to Manage/Control Panel/Plugins Installation/Install More Portlets/Upload File and upload gUSE web applications (all the war files).

4.6 Initialising gUSE services

From web browser go to: http://fullyqualified.hostname:8080/information/init.jsp Please note that initialization interface is protected by username and password within tomcat's manager role! To add a tomcat user and manager role, please modify tomcat-users.xml file in /opt/liferay-portal-6.0.5/tomcat-6.0.26/conf folder. Check your database settings, if necessary, and hit “send”.

It is necessary after every tomcat restart.

5 Portlet installation and configuration

5.1 Create tables for PortalUser


and run:
 $ mysql -h fullyqualified.hostname -u PortalUser -pPortalUserpassword PortaUser < PortalUser.sql
 $ mysql -h fullyqualified.hostname -u PortalUser -pPortalUserpassword PortaUser < PortalUser_IDP.sql

5.2 Deploying the portlets war files

Download the portlets:

Now copy the portlets war file in /opt/liferay-portal-6.0.5/deploy/ folder.

6 Setting IGIPortal layout

Download igiportal.lar and navigate to Manage/Control Panel/Communities/Actions(on a community)/Manage Pages/ExportImport/Import and upload it.

Please note that layout is working with Liferay 6.0.5, different liferay versions may not compatible with it.


-- Diego Michelotto - 11 Nov 2011

Topic attachments
I Attachment Action Size Date Who Comment
Unknown file formatwar Login-1.war manage 16189.3 K 2011-11-10 - 14:21 DiegoMichelotto Portlet Login
Unknown file formatsql PortalUser.sql manage 4.3 K 2011-11-10 - 13:58 DiegoMichelotto Dump of PortalUser database only structure
Unknown file formatsql PortalUser_IDP.sql manage 1.7 K 2011-11-10 - 14:00 DiegoMichelotto Dump of table IDP from PortalUser structure + data
Unknown file formatwar Registration-4.war manage 16805.2 K 2011-11-10 - 14:22 DiegoMichelotto Portlet Registration
Unknown file formatwar VO-manager-portlet-0.1.war manage 18713.7 K 2011-11-10 - 14:23 DiegoMichelotto Portlet VOManager
Unknown file formatlar igiportal.lar manage 1401.5 K 2011-11-10 - 13:52 DiegoMichelotto Liferay layout for IGI Portal

This topic: IGIPortal > InstallationGuide > LiferayGUSEInstallation
Topic revision: r8 - 2011-12-16 - TWikiAdminUser
This site is powered by the TWiki collaboration platformCopyright © 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback