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

  jdbc.default.driverClassName=com.mysql.jdbc.Driver
  jdbc.default.url=jdbc:mysql://fullyqualified.hostname:3306/liferay?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
  jdbc.default.username=liferay
  jdbc.default.password=liferaypassword
  jdbc.default.maxIdleTime=3600

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

• 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 "

Where:

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

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).

Libraries:

• 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.

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

Download

• PortalUser.sql: Dump of PortalUser database only structure
• PortalUser_IDP.sql: Dump of table IDP from PortalUser structure and data

 $ 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:

• Login-1.war: Portlet Login
• Registration-4.war: Portlet Registration
• VO-manager-portlet-0.1.war: Portlet VOManager

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.

-- Main.TWikiAdminUser - 2011-11-11