Installation

Prerequisites

It is expected that the user is familiar with the Apache Maven project tool.

Requirements

  • Maven 1.0.2
  • Java 1.4 or higher (If using JDK 1.4 in Tomcat 5.5, see Running.txt in Tomcat's home directory for modification instructions)
  • Servlet 2.3 compatible container: Tomcat 5.5 is suggested

Get Maven Ready

If you have not already done so, download and install Maven.

2. build.properties settings:

Please set these values in your build.properties file:

property example what is it?
maven.tomcat.home /tomcat location of the Tomcat install where you want to deploy Pluto
maven.tomcat.version.major 5 Major version of Tomcat

You can copy the build.properties.sample file and name it build.properties and use this is a starting point.

Building and deploying

  • change your directory to root of the Pluto project.
  • maven fullDeployment
  • This will take care of everything for you including copying shared jars, and deploy the base Pluto portal along with the Portlet Test Suite

Start Tomcat

Run Tomcat, go to http://localhost:8080/pluto/portal.

What if I just want the Pluto container jar (like for Jetspeed 2)?

  1. cd to /container directory
  2. maven jar:install

This will create the container jar in /container/target and also copy into you maven repository.

What if I just want to deploy the Pluto portal without the test suite?

  1. Follow all the steps from "What if I just want the Pluto container jar (like for Jetspeed 2)?"
  2. cd to the /portal directory.
  3. maven (with no goal)

This will invoke the default maven goal for the /portal sub-project, tomcat:deploy. This will build and deploy the Pluto portal minus the test suite into tomcat.

What if I decide I want to deploy the test suite portlets after I deploy the Pluto portal by itself?

  1. Follow all the steps from "What if I decide I want to deploy the test suite portlets after I deploy JUST the Pluto portal?"
  2. cd to the /testsuite directory.
  3. maven (with no goal)

This will invoke the default maven goal for the /testsute sub-project, deployTestsuite. This will build and deploy the test suite portlets into your already deployed Pluto portal.

Install Portlets

    To install portlets after you successfully installed Pluto, invoke Maven from the deploy subdirectory of the base install directory to deploy the portlet's war by executing:
    maven deploy -Ddeploy=FULL_PATH_TO_YOUR_PORTLET_WAR
    Alternatively, you could use the Admin Portlet Application to install custom portlets.