(r4) LiferayGUSEInstallation < IGIPortal

You are here: TWiki>
IGIPortal Web>InstallationGuide>LiferayGUSEInstallation (revision 4) (raw view)
<noautolink>

---+!! A guide for Liferay and gUSE installation

%TOC%

---# 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

---# Install MySQL server and client

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

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

---## Portal databases

Create empty liferay, wspgrade and portaluser databases.

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

---## MySQL users and permissions

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

<verbatim>
 $ 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';
</verbatim>

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

---## 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:
<verbatim>
  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
</verbatim>

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

---## gUSE database

Creating database tables for gUSE.

<verbatim>
 $ 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
</verbatim>

---## Parameterizing runtime environment

In the shell which starts the webcontainer the following environment variables must be set:
<verbatim>
 $ export JAVA_OPTS="-server -Xms256m -Xmx1024m -XX:MaxPermSize=512m -Dfile.encoding=UTF8 -Duser.timezone=GMT"
</verbatim>

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)

<verbatim>
 $ export X509_USER_PROXY=x509up
</verbatim>

If it is not set, voms extension cannot be set for the proxy
<verbatim>
 $ export CATALINA_OPTS="-DcrlUpdateInterval=0s -DcrlEnabled=false -Dorg.globus.tcp.port.range=20000,25000 "
</verbatim>

Where:

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

---## 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

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

---## Deploying the gUSE war files

After starting Liferay with command:

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

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

---## 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 &ldquo;send&rdquo;.

*It is necessary after every tomcat restart.*

---# Portlet installation and configuration

---## Create tables for PortalUser

Download
   * [[%ATTACHURL%/PortalUser.sql][PortalUser.sql]]: Dump of PortalUser database only structure
   * [[%ATTACHURL%/PortalUser_IDP.sql][PortalUser_IDP.sql]]: Dump of table IDP from PortalUser structure and data
and run:
<verbatim>
 $ mysql -h fullyqualified.hostname -u PortalUser -pPortalUserpassword PortaUser < PortalUser.sql
 $ mysql -h fullyqualified.hostname -u PortalUser -pPortalUserpassword PortaUser < PortalUser_IDP.sql
</verbatim>

---## Deploying the portlets war files

Download the portlets:
   * [[%ATTACHURL%/Login-1.war][Login-1.war]]: Portlet Login
   * [[%ATTACHURL%/Registration-4.war][Registration-4.war]]: Portlet Registration
   * [[%ATTACHURL%/VO-manager-portlet-0.1.war][VO-manager-portlet-0.1.war]]: Portlet VOManager
Now copy the portlets war file in =/opt/liferay-portal-6.0.5/deploy/= folder.

---# Setting IGIPortal layout

Download [[%ATTACHURL%/igiportal.lar][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
Attachments
Topic attachments
I	Attachment	Action	Size	Date	Who	Comment
war	Login-1.war	manage	16189.3 K	2011-11-10 - 14:21	DiegoMichelotto	Portlet Login
sql	PortalUser.sql	manage	4.3 K	2011-11-10 - 13:58	DiegoMichelotto	Dump of PortalUser database only structure
sql	PortalUser_IDP.sql	manage	1.7 K	2011-11-10 - 14:00	DiegoMichelotto	Dump of table IDP from PortalUser structure + data
war	Registration-4.war	manage	16805.2 K	2011-11-10 - 14:22	DiegoMichelotto	Portlet Registration
war	VO-manager-portlet-0.1.war	manage	18713.7 K	2011-11-10 - 14:23	DiegoMichelotto	Portlet VOManager
lar	igiportal.lar	manage	1401.5 K	2011-11-10 - 13:52	DiegoMichelotto	Liferay layout for IGI Portal
Topic revision: r4 - 2011-11-11 - DiegoMichelotto
User Guide
Administration Guide
Documents
Create New Topic
TWIKI.NET
IGIPortal

~~Edit~~
~~Attach~~