Installing the Fliquor Portlet

Pre-requisites

  • JDK 1.6+
  • JAVA_HOME environment variable must be set to a path that does not contain spaces
  • No processes running on ports 8005, 8080, or 8887

Download and Unpack the uPortal 3.2 Quickstart

The uPortal developer quickstart may be downloaded from http://www.ja-sig.org/downloads/uportal/uPortal-3.2.0/uPortal-3.2.0-quick-start-dev.tar.gz. This file should be unzipped to a path that does not contain spaces.

Notes for specific operating systems

Windows
On Windows, you must use an unzip utility other than the built-in extractor utility. See: http://www.ja-sig.org/issues/browse/UP-2024

OS X

Move /System/Library/Frameworks/JavaVM.framework/Versions/A/Resources/.compatibility/14compatibility.jar
to /System/Library/Frameworks/JavaVM.framework/Versions/A/Resources/.compatibility/14compatibility.bk

Download and Install the Fliquor Portlet

The Fliquor Portlet is currently available at http://source.fluidproject.org/svn/scratchpad/FliquorPortlet/trunk and can be built via maven.

Before building the portlet, open the main pom.xml file and edit the value of property maven.tomcat.home to match your quickstart installation's path.

To build and deploy the project, run the following from the root of the project:

mvn -Plocaldev clean install uportal:deploy-war

Add the Fliquor Portlet to uPortal

Start up HSQL by running "../ant.sh start" from uPortal-3.2.1-quick-start/uPortal-3.2.1. In a separate window, from the same directory, run

../ant.sh crn-import -Ddir=/path/to/FliquorPortlet/docs/import -Dpattern=fliquor-portlet-3.2.channel

Start up the uPortal quickstart by running "./ant.sh start" from the root of your quickstart installation.