There are a number of distributions to choose from depending on your needs.
Maven 2 is utilized as the project management and build system for Pluto 1.1. Pluto currently provides Maven plugins which can be used to install the Pluto Portal, assemble portlet applications, deploy applications, and publish portlet applications to the Pluto Portal.
The Pluto project uses the Subversion version control system. If you're new to Subversion, you can check out the online book about Subversion. Note that we are currently using Subversion 1.3.x (there are separate versions of the book covering the different versions of Subversion).
Web Access to Subversion
To browse the Pluto source code, you can use the ViewCVS web interface to Subversion. This is current at all times.
Normal Subversion Access
Anyone can check code out of Subversion anonymously. However, you need to specify a username and password in order to update the Subversion repository, and only Pluto committers have the permissions to do that. We run Subversion over standard HTTPS, so hopefully you won't have problems with intervening firewalls.
To check out Pluto 1.1.
x source to the 'pluto' directory use this command (substituting '
x' for the
current release number, e.g. 1.1.
svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/pluto-1.1.x pluto
Zipped up Pluto 1.1 source distributions can also be downloaded from a distribution mirror.
If this is your first time building Pluto with Maven 2, edit
and add the <pluginGroups> element:
<settings> ... <pluginGroups> <pluginGroup>org.apache.pluto</pluginGroup> </pluginGroups> ... </settings>
org.apache.plutospecified as a
<pluginGroup>, then the
<PLUTO_SRCHOME> is the local directory where the
Pluto 1.1 source distribution has been checked out or unzipped into.
$> cd <PLUTO_SRCHOME> $> mvn install $> mvn pluto:install -DinstallDir=path/to/appserver
install goal is a built in Maven 2 lifecycle
which builds the project artifacts and installs them into the Maven
pluto:install goal will take the resulting artifacts
and properly deploy them within the configured Tomcat installation.
Currently, the Pluto install has been tested on Tomcat 5.5.9, 5.5.17 and 5.5.20, 5.5.23, and 6.0.13.
The Tomcat 5 archive can be found here.
If installing to a directory that contains spaces,
needs to be enclosed within quotes:
C:\pluto> mvn pluto:install -DinstallDir="C:\Program Files\Apache Software Foundation\Tomcat 5.5"
This section documents the manual installation of Pluto 1.1 into Tomcat. It replaces
the pluto:install goal, but requires that the built-in Maven 2 install goal
mvn install) be run from
$> cd <PLUTO_SRCHOME> $> mvn install
Step 2: Copy the following to
Step 3: For platforms running on Java 1.4 and Pluto 1.1, copy the following to
<TOMCAT_HOME>/common/endorsed (if you are running Java 1.5+, it is recommended to skip this step):
Step 4: Copy the following to
Step 5: Copy the following to
To be able to use application-scoped
PortletSession attributes in Pluto, modify
the Connector element for port 8080 in
adding the following attribute and value: emptySessionPath="true".
The Pluto Testsuite portlet application needs the role '
to run the Security Mapping Test. So before starting tomcat, you should
<TOMCAT_HOME>/conf/tomcat-users.xml, add the
pluto', and add a user in that role. The simplest way
to do this is to edit add the '
pluto' role to the
tomcat' user's record. Here is a sample
<?xml version="1.0" encoding="utf-8"?> <tomcat-users> <role rolename="manager"/> <role rolename="pluto"/> <role rolename="tomcat"/> <role rolename="role1"/> <user username="tomcat" password="tomcat" roles="tomcat,pluto,manager"/> <user username="role1" password="tomcat" roles="role1"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="pluto" password="pluto" roles="pluto,manager"/> </tomcat-users>
Now you are ready to use the Pluto Portal built from source. Start up tomcat by running
startup.bat (for windows) or
<TOMCAT_HOME>/bin, and browse to
http://localhost:8080/pluto/portal. Login to Pluto using
the user and password you just created in
If you added the 'pluto' role to the 'tomcat' user's record, you can
login as 'tomcat/tomcat'.