You can download a pre-built Pluto bundle, or you can build Pluto from the source code.
Pluto uses Maven 3 as its project management and build system. Pluto currently provides Maven plugins and ant scripts which can be used to install the Pluto Portal.
The Pluto project uses the Git version control system. If you're new to Git, you can find many books and online resources to help you.
In order to build Pluto, you will need to have the following software packages installed on your system. For help in obtaining and installing the packages, please access the appropriate web resources.
To browse the Pluto source code online, access the Apache Pluto Github mirror. This is current at all times.
Anyone can clone the Pluto repository from the Github mirror. However, in order to update the repository, you will need to be an Apache pluto committer. To clone the repository, switch to the directory in which you would like the code to reside, and execute the following command:
git clone https://github.com/apache/portals-pluto.git pluto
You now have the complete Pluto source code in the ./pluto subdirectory.
The source code versions are tagged in the respository. If you want to build version 3.1.0 rather than the current development version, checkout the 'pluto-3.1.0' tag:
git checkout pluto-3.1.0
This is the easiest way to build Pluto. The Ant build script will use first build the binaries from source, then download and unpack the appropriate Apache Tomcat web container for the code version being built. It will then install pluto on Tomcat, adjusting the Tomcat configuration as necessary.
The dist-build.xml build script allows a number of options for building and packaging the code. View the file for details. The options used in the following command causes the demo portlets to be deployed and retains the tomcat directory created during the build process rather than deleting it. Execute the following command:
ant -f dist-build.xml -DincludeDemos=true -DnoClean=true
You now have Pluto built and deployed in the ./pluto/target/dist subdirectory. You can now switch to the ./pluto/target/dist/<tomcat>/bin subdirectory and start Tomcat and Pluto as described in the next section.
The Pluto distribution contains four version 3.1.0 portlet applications that illustrate the use of all aspects of JSR 362 portlet programming.
The best way to view the source code would be to import the modules mentioned above into your favorite IDE.
Refer to the Maven Archetypes page in order to learn how to quickly generate a new portlet project from a starter template.