Getting Started with Pluto
It is expected that the user is familiar with the Apache
Maven project tool.
Requirements:
- Maven 1.0-beta-10
or higher
- Java 1.4 or higher
- Servlet 2.3 compatible container: Tomcat 5.5 is suggested
1. 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 |
You can copy the build.properties.sample
file and name it
build.properties
and use this is a starting point.
2. 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
3. Start Tomcat
Run Tomcat, go to http://localhost:8080/pluto/portal.
What if I just want the Pluto container jar (like for Jetspeed 2)?
- cd to /api directory
- maven jar:install
- cd to /container directory
- 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?
- Follow all the steps from "What if I just want the Pluto container
jar (like for Jetspeed 2)?"
- cd to the /portal directory.
- maven (with no goal)
This will invoke the default maven goal for the /portal sub-project, deployPlutoToTomcat.
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?
- Follow all the steps from "What if I decide I want to deploy the
test suite portlets after I deploy JUST the Pluto portal?"
- cd to the /testsuite directory.
- maven (with no goal)
This will invoke the default maven goal for the /testsute sub-project, deployTestsuite.
This willbuild and deploy the test suite portlets into your already deployed
Pluto portal.