Liferay Administrator's Guide
Richard L. Sezov, Jr., General Editor and main author
Copyright © 2008 by Liferay, Inc.
ISBN 978-0-6151-9648-0
This work is offered under the Creative Commons Attribution-Share Alike Unported license.
You are free:
● to share—to copy, distribute, and transmit the work
● to remix—to adapt the work
Under the following conditions:
● Attribution. You must attribute the work in the manner specified by the author or licensor
(but not in any way that suggests that they endorse you or your use of the work).
● Share Alike. If you alter, transform, or build upon this work, you may distribute the resulting
work only under the same, similar or a compatible license.
The full version of this license appears in the appendix of this book, or you may view it online here:
http://creativecommons.org/licenses/by-sa/3.0
Contributors:
Ray Auge, Jian Cao (Steven), Brian Chan, Shepherd Ching, Bryan Cheung, Ivan Cheung, Alexander
Chow, Jorge Ferrer, JR Houn, Scott Lee, Wei Hong Ma (Sai), Charles May, James Min, Alberto Montero,
Jerry Niu, Michael Saechang, Li Ji Shan (Dale), Rich Sezov, Ed Shin, Joseph Shum, Michael Young
Table of Contents
Table of Contents
1. Introduction..............................................................................................................................11
USER-FRIENDLY FEATURES.......................................................................................................................................11
Easy AJAX UI.............................................................................................................................................................11
One-Click Look and Feel Change.............................................................................................................................11
Freeform Portlets / WebOS.....................................................................................................................................12
WebDAV Support.....................................................................................................................................................12
Just In Time Portlet Rendering...............................................................................................................................12
Context-Sensitive Help............................................................................................................................................12
AJAX Interface Tools................................................................................................................................................12
DEVELOPER-FRIENDLY FEATURES................................................................................................................................12
Service Builder.........................................................................................................................................................12
CSS Compliance........................................................................................................................................................12
Themes/Layout Enhancements..............................................................................................................................12
Fine-Grained Permissions System..........................................................................................................................13
Workflow Capability................................................................................................................................................13
WHAT IS A PORTAL?...............................................................................................................................................13
Key Business Benefits:.............................................................................................................................................13
Provide an intuitive and collaborative experience........................................................................13
Consolidate, organize and access all your data and applications via a single point of access..14
Optimize existing IT investments....................................................................................................14
Adapt to the demands of a changing market..................................................................................14
Scale your business without worrying about your IT....................................................................15
Gain the lowest TCO...........................................................................................................................15
2. Initial Setup...............................................................................................................................17
OBTAINING LIFERAY................................................................................................................................................17
INSTALLING A BUNDLE.............................................................................................................................................18
INSTALLING LIFERAY FOR A DEVELOPER........................................................................................................................20
Standalone Liferay...................................................................................................................................................21
Download the Tomcat Bundle...........................................................................................................21
Uncompress the Bundle....................................................................................................................22
Install a Lightweight SQL Database..................................................................................................22
Connect Liferay to the SQL Database...............................................................................................23
Launch Liferay!...................................................................................................................................24
Installing the Liferay Extension Environment......................................................................................................24
Install the Necessary Tools...............................................................................................................25
Obtain the Liferay Source..................................................................................................................29
Create Configuration Files.................................................................................................................30
Create the Extension Environment..................................................................................................32
Install an Application Server............................................................................................................32
Deploy the Extension Environment.................................................................................................33
iii
INSTALLING LIFERAY FOR AN ENTERPRISE......................................................................................................................34
Database Setup.........................................................................................................................................................35
Turning a Bundle into an Enterprise Portal..........................................................................................................36
Further Configuration.......................................................................................................................37
Installing Liferay on an Existing Application Server............................................................................................37
Geronimo 1.1 with Tomcat 5.0.28/5.5.17.........................................................................................38
Glassfish..............................................................................................................................................39
Jetty 5.1.1.............................................................................................................................................41
JBoss 4.03sp1/4.04/4.05 with Jetty 5.1.1..........................................................................................43
JBoss 4.03sp1/4.04/4.05/ 4.2 with Tomcat......................................................................................46
Oracle Application Server (OC4J)......................................................................................................48
Resin 3.0.X / 3.1.X..............................................................................................................................56
Tomcat 5.0.X/5.5.X.............................................................................................................................57
WebLogic8 sp5....................................................................................................................................60
WebLogic 9 / 10..................................................................................................................................63
WebSphere 6.0.X.X.............................................................................................................................65
WebSphere 6.1....................................................................................................................................82
Making Liferay Coexist with Other Java EE Applications.....................................................................................93
3. Configuration............................................................................................................................95
ADVANCED LIFERAY CONFIGURATION...........................................................................................................................95
The portal-ext.properties File................................................................................................................................95
Properties Override............................................................................................................................96
Portal Context.....................................................................................................................................96
Resource Repositories Root...............................................................................................................96
Error Properties.................................................................................................................................97
Technology Compatibility Kit...........................................................................................................97
Schema................................................................................................................................................97
Upgrade...............................................................................................................................................97
Verify...................................................................................................................................................98
Auto Deploy.........................................................................................................................................98
Hot Deploy.........................................................................................................................................100
Plugin.................................................................................................................................................100
Portlet................................................................................................................................................100
Theme................................................................................................................................................101
Resource Actions..............................................................................................................................101
Model Hints.......................................................................................................................................101
Spring................................................................................................................................................101
Hibernate..........................................................................................................................................102
Custom SQL.......................................................................................................................................103
Ehcache.............................................................................................................................................104
Commons Pool..................................................................................................................................104
JavaScript..........................................................................................................................................104
Company...........................................................................................................................................106
iv
Users..................................................................................................................................................107
Groups and Roles..............................................................................................................................107
Organizations and Locations...........................................................................................................108
Languages and Time Zones.............................................................................................................108
Look and Feel....................................................................................................................................109
Request..............................................................................................................................................109
Session...............................................................................................................................................110
JAAS...................................................................................................................................................111
LDAP...................................................................................................................................................112
CAS.....................................................................................................................................................114
NTLM.................................................................................................................................................115
OpenID...............................................................................................................................................115
OpenSSO............................................................................................................................................115
Authentication Pipeline..................................................................................................................115
Auto Login.........................................................................................................................................118
SSO with MAC (Message Authentication Code)............................................................................118
Passwords..........................................................................................................................................119
Permissions.......................................................................................................................................120
Captcha..............................................................................................................................................121
Startup Events..................................................................................................................................121
Shutdown Events..............................................................................................................................121
Portal Events.....................................................................................................................................122
Login event.......................................................................................................................................122
Logout event.....................................................................................................................................122
Default Landing Page.......................................................................................................................122
Default Guest.....................................................................................................................................123
Default User......................................................................................................................................123
Default Admin...................................................................................................................................124
Layouts..............................................................................................................................................124
Portlet URL........................................................................................................................................128
Preferences.......................................................................................................................................128
Struts.................................................................................................................................................128
Images................................................................................................................................................129
Editors...............................................................................................................................................129
Fields..................................................................................................................................................129
Mime Types.......................................................................................................................................129
Amazon License Keys.......................................................................................................................130
Instant Messenger............................................................................................................................130
Lucene Search...................................................................................................................................130
Value Object......................................................................................................................................132
Last Modified....................................................................................................................................133
XSS (Cross Site Scripting)................................................................................................................133
v