Modified: portals/site-live/pluto/v20/deploying.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v20/deploying.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v20/deploying.html (original) +++ portals/site-live/pluto/v20/deploying.html Thu Apr 25 17:29:43 2019 @@ -1,291 +1,170 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Deploying Portlet to Pluto Portal</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <a href="../v20/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <strong>Deploying</strong> - </li> - - <li class="none"> - <a href="../v20/embedding.html">Embedding</a> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Deploying_Portlet_to_Pluto_Portal"></a>Deploying Portlet to Pluto Portal</h2> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v20/deploying.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Deploying Portlet to Pluto Portal</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Deploying Portlet to Pluto Portal + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><a href="../v20/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><strong>Deploying</strong></li> + <li class="none"><a href="../v20/embedding.html" title="Embedding">Embedding</a></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + + + <div class="section"> +<h2><a name="Deploying_Portlet_to_Pluto_Portal"></a>Deploying Portlet to Pluto Portal</h2> + + <p> There are 2 steps involved in deploying a portlet application in Pluto 2.0: - <ul><li><b>Assembly</b>: All portlet applications must be run through the + </p> +<ul> + +<li> + <b>Assembly</b>: All portlet applications must be run through the pluto assembler before being deployed. The assembly process injects pluto specific information for deployment. Specifically, a servlet and servlet mapping are added to the deployment descriptor (web.xml). This servlet - <code>org.apache.pluto.container.driver.PortletServlet</code> will be used to dispatch portlet requests to the portlet application. + <tt>org.apache.pluto.container.driver.PortletServlet</tt> will be used to dispatch portlet requests to the portlet application. </li> -<li><b>Deployment</b>: After portlet applications are assembled properly + +<li> + <b>Deployment</b>: After portlet applications are assembled properly they must be deployed to the servlet engine within which the portal application is running. The current bundled distribution uses Tomcat 7.0.21 as the servlet engine. </li> -</ul> -</p> -<div class="section"><h3><a name="Portlet_Assembly"></a>Portlet Assembly</h3> + </ul> + + + +<div class="section"> +<h3><a name="Portlet_Assembly"></a>Portlet Assembly</h3> + <p> The maven-pluto-plugin can be used to assemble a portlet application war. - It will place the proper <code>PortletServlet</code> configuration in web.xml. + It will place the proper <tt>PortletServlet</tt> configuration in web.xml. </p> + <p> The custom Maven 2 build shown below requires a Tomcat context deployment descriptor that has the same name as your artifactId with an xml extension (e.g. HelloWorldPortlet.xml). </p> + <p> To properly assemble your portlet using the Maven 2 plugin, your project's directory structure and artifact placement must conform to Maven's standard: </p> -<p><div class="source"><pre> + +<p> + </p> +<div class="source"> +<pre> HelloWorldPortlet (top level directory) |- pom.xml (the pom file) |- src (Subdir containing main subdirectory) @@ -304,23 +183,28 @@ `- WEB-INF `- portlet.xml (JSR-168 deployment descriptor) `- web.xml (This will be modified by maven-pluto-plugin) - </pre> -</div> -</p> + </pre></div> + + + <p> This is an example of what the Tomcat context deployment descriptor will contain: - <div class="source"><pre> + </p> +<div class="source"> +<pre> <Context path="/HelloWorldPortlet" docBase="HelloWorldPortlet" crossContext="true"/> - </pre> -</div> -</p> + </pre></div> + + <p> To configure the maven-pluto-plugin, you must configure it in your pom. For easy of setup, use this as you pom file, changing the groupId, artifactId and version to values appropriate to your custom portlet. - <div class="source"><pre> + </p> +<div class="source"> +<pre> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> @@ -406,15 +290,19 @@ </build> </project> - </pre> -</div> -</p> + </pre></div> + + <p> Once configured, the war generated by an 'mvn package' (or install) command will contain the appropriate pluto configuration. </p> -</div> -<div class="section"><h3><a name="Portlet_Deployment"></a>Portlet Deployment</h3> + </div> + + +<div class="section"> +<h3><a name="Portlet_Deployment"></a>Portlet Deployment</h3> + <p> To deploy a portlet application, simply deploy the application war using any standard mechanism for your application server. There are many @@ -423,12 +311,15 @@ Pluto bundled distribution and is accessed via the 'Upload and deploy portlet war' link on the page administration portlet. See the Help link on that portlet for more details. </p> + <p> In the bundled distribution that uses Tomcat, deployment of an assembled war can simply be done by dropping the war into the webapps directory. You can automatically achive this by adding the following code within the plugins section of your maven pom.xml: </p> -<div class="source"><pre> + +<div class="source"> +<pre> <plugin> <artifactId>maven-antrun-plugin</artifactId> <executions> @@ -448,8 +339,8 @@ </execution> </executions> </plugin> - </pre> -</div> + </pre></div> + <p> Once the pom.xml file has been updated with this plugin, you can run the full build and deployment using the command: mvn integration-test. The code assumes that you have set @@ -457,25 +348,36 @@ done, just set pluto.home from the command line with the -D flag. The command line would then be: mvn -Dpluto.home=C:/pluto integration-test. </p> -</div> -<div class="section"><h3><a name="Portlet_Publishing"></a>Portlet Publishing</h3> + + </div> + + +<div class="section"> +<h3><a name="Portlet_Publishing"></a>Portlet Publishing</h3> + <p> As soon as the portlet application (war) is deployed to the servlet container the portlet application will be available to the portal and can be added to pages using the page administration portlet. See the help mode in this portlet for details on its use. </p> + + <p><b>Portal Page Configuration</b></p> + <p> If you'd like for your page configuration to be consistent throughout restarts of the application server (currently placements made through the page administration portlet is not persistent), you should then configure the page layout in the portal-driver configuration file (pluto-portal-driver-config.xml). </p> + <p> - The page can then be configured by adding a <code>page</code> child element of the <code>render-config</code> + The page can then be configured by adding a <tt>page</tt> child element of the <tt>render-config</tt> element, like this: - <div class="source"><pre> + </p> +<div class="source"> +<pre> <render-config default="Test Page"> ... ... <page name="Your Portal Page Name" uri="/WEB-INF/fragments/portlet.jsp"> @@ -485,41 +387,35 @@ name="your_portlet_2"/> </page> </render-config> - </pre> -</div> -</p> + </pre></div> + + <p> - The <code>uri</code> attribute defines the theme of your portal page. - If you use <code>/WEB-INF/fragments/portlet.jsp</code> (which is the + The <tt>uri</tt> attribute defines the theme of your portal page. + If you use <tt>/WEB-INF/fragments/portlet.jsp</tt> (which is the default theme of Pluto Testsuite portlet app), your portlets will be displayed in two columns. You can clone this file to customize your layout. - If you do so, make sure the <code>uri</code> attribute points to the new file. + If you do so, make sure the <tt>uri</tt> attribute points to the new file. </p> -</div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + </div> + + </div> + + + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html>
Modified: portals/site-live/pluto/v20/embedding.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v20/embedding.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v20/embedding.html (original) +++ portals/site-live/pluto/v20/embedding.html Thu Apr 25 17:29:43 2019 @@ -1,306 +1,179 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Embedding the Pluto 2.0 Container</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <a href="../v20/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v20/deploying.html">Deploying</a> - </li> - - <li class="none"> - <strong>Embedding</strong> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Embedding_the_Pluto_2.0_Container"></a>Embedding the Pluto 2.0 Container</h2> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v20/embedding.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Embedding the Pluto 2.0 Container</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Embedding the Pluto 2.0 Container + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><a href="../v20/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v20/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><strong>Embedding</strong></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + + + <div class="section"> +<h2><a name="Embedding_the_Pluto_2.0_Container"></a>Embedding the Pluto 2.0 Container</h2> + <p> When not using the Pluto Driver, and when you want to embed the Pluto container in your portal or development environment, you will need the following jar files... </p> + <p> Copy the following files to - <code><TOMCAT_HOME>/lib on Tomcat 6+</code>: - <ul><li>portlet-api_2.0_spec-1.0.jar</li> + <tt><TOMCAT_HOME>/lib on Tomcat 6+</tt>: + </p> +<ul> + +<li>portlet-api_2.0_spec-1.0.jar</li> + <li>ccpp-1.0.jar</li> + <li>pluto-container-api-2.0.3.jar</li> + <li>pluto-container-driver-api-2.0.3.jar</li> + <li>pluto-taglib-2.0.3.jar</li> + <li>portlet-api_2.0_spec-1.0.jar</li> -</ul> -</p> -<p><b>Implementation:</b> Copy into your portal implementation such as WEB-INF/lib: - <ul><li>jaxb-api-2.1.jar</li> + </ul> + + +<p> + <b>Implementation:</b> Copy into your portal implementation such as WEB-INF/lib: + </p> +<ul> + +<li>jaxb-api-2.1.jar</li> + <li>jaxb-impl-2.1.0.jar</li> + <li>pluto-container-2.0.3.jar</li> + <li>stax-api-1.0.2.jar</li> + <li>stax-1.2.0.jar</li> -</ul> -</p> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + </ul> + + </div> + + + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html> Modified: portals/site-live/pluto/v20/getting-started.html URL: http://svn.apache.org/viewvc/portals/site-live/pluto/v20/getting-started.html?rev=1858149&r1=1858148&r2=1858149&view=diff ============================================================================== --- portals/site-live/pluto/v20/getting-started.html (original) +++ portals/site-live/pluto/v20/getting-started.html Thu Apr 25 17:29:43 2019 @@ -1,292 +1,187 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> - - - - - - - - - - - -<html xmlns="http://www.w3.org/1999/xhtml";> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> - <title>Pluto - Getting Started With Pluto</title> - <style type="text/css" media="all"> - @import url("../css/maven-base.css"); - @import url("../css/maven-theme.css"); - @import url("../css/site.css"); - </style> - <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> - </head> - <body class="composite"> - <div id="banner"> - <a href="http://portals.apache.org/pluto/"; id="bannerLeft"> - - <img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="" /> - - </a> - <span id="bannerRight"> - - <img src="http://portals.apache.org/pluto/images/banner.png"; alt="" /> - - </span> - <div class="clear"> - <hr/> - </div> - </div> - <div id="breadcrumbs"> - - - - - - - - - <div class="xleft"> - Last Published: 2018-06-22 - | - <a href="http://portals.apache.org/pluto"; class="externalLink">Home</a> - </div> - <div class="xright"> <a href="../portlet-3.0-apidocs/index.html">Portlet 3.0 API</a> - | - <a href="../portlet-2.0-apidocs/index.html">Portlet 2.0 API</a> - | - <a href="../portlet-1.0-apidocs/index.html">Portlet 1.0 API</a> - | - <a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink">JSR 362 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink">JSR 286 JCP Page</a> - | - <a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink">JSR 168 JCP Page</a> - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - <div id="leftColumn"> - <div id="navcolumn"> - - - - - - - - - <h5>The Pluto Project</h5> - <ul> - - <li class="none"> - <a href="../index.html">About Pluto</a> - </li> - - <li class="none"> - <a href="../mission.html">Mission</a> - </li> - - <li class="none"> - <a href="../download.html">Download</a> - </li> - - <li class="none"> - <a href="../news.html">News</a> - </li> - - <li class="none"> - <a href="../security.html">Security</a> - </li> - - <li class="none"> - <a href="../status.html">Status</a> - </li> - - <li class="none"> - <a href="../architecture.html">Architecture</a> - </li> - - <li class="none"> - <a href="../resources.html">Resources</a> - </li> - - <li class="none"> - <a href="../faq.html">FAQ</a> - </li> - - <li class="none"> - <a href="http://wiki.apache.org/portals/Pluto"; class="externalLink">Wiki</a> - </li> - - <li class="none"> - <a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink">Issue Tracker (JIRA)</a> - </li> - - <li class="none"> - <a href="../helping.html">Get Involved</a> - </li> - </ul> - <h5>Pluto 3.0</h5> - <ul> - - <li class="none"> - <a href="../v301/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v301/deploying.html">Deploying Portlets</a> - </li> - - <li class="none"> - <a href="../v301/portlet-api.html">Portlet Concepts</a> - </li> - - <li class="none"> - <a href="../v301/v3Features.html">Version 3 Features</a> - </li> - - <li class="none"> - <a href="../v301/tck.html">Using the TCK</a> - </li> - - <li class="none"> - <a href="../v301/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Pluto 2.0</h5> - <ul> - - <li class="none"> - <strong>Getting Started</strong> - </li> - - <li class="none"> - <a href="../v20/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v20/embedding.html">Embedding</a> - </li> - - <li class="none"> - <a href="../v20/release-notes.html">Release Notes</a> - </li> - - <li class="none"> - <a href="../v20/app-servers.html">App Servers</a> - </li> - - <li class="none"> - <a href="../v20/powered.html">Powered By Pluto</a> - </li> - </ul> - <h5>Pluto 1.1</h5> - <ul> - - <li class="none"> - <a href="../v11/getting-started.html">Getting Started</a> - </li> - - <li class="none"> - <a href="../v11/deploying.html">Deploying</a> - </li> - - <li class="none"> - <a href="../v11/release-notes.html">Release Notes</a> - </li> - </ul> - <h5>Subprojects</h5> - <ul> - - <li class="none"> - <a href="../subprojects/subprojects.html">Overview</a> - </li> - </ul> - <h5>Project Info</h5> - <ul> - - <li class="none"> - <a href="../project-summary.html">Project Summary</a> - </li> - - <li class="none"> - <a href="../team-list.html">Project Team</a> - </li> - - <li class="none"> - <a href="../license.html">Project License</a> - </li> - - <li class="none"> - <a href="../mail-lists.html">Mailing Lists</a> - </li> - - <li class="none"> - <a href="../source-repository.html">Source Repository</a> - </li> - - <li class="none"> - <a href="../issue-tracking.html">Issue Tracking</a> - </li> - </ul> - <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> - <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img> - </a> - - - - - - - - - </div> - </div> - <div id="bodyColumn"> - <div id="contentBox"> - <div class="section"><h2><a name="Installing_the_Pluto_2.0_Binary_Build"></a>Installing the Pluto 2.0 Binary Build</h2> -<div class="highlightBox"><h4>About Pluto Distributions</h4> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> +<!-- Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/xdoc/v20/getting-started.xml at 2019-04-25 --> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <title>Pluto – Getting Started With Pluto</title> + <style type="text/css" media="all"> + @import url("../css/maven-base.css"); + @import url("../css/maven-theme.css"); + @import url("../css/site.css"); + </style> + <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" /> + <meta http-equiv="Content-Language" content="en" /> + + </head> + <body class="composite"> + <div id="banner"> +<a href="http://portals.apache.org/pluto/"; id="bannerLeft"><img src="http://portals.apache.org/pluto/images/apache-portals.gif"; alt="Pluto"/></a> +<div id="bannerRight"> +<img src="http://portals.apache.org/pluto/images/banner.png"; alt=""/></div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="breadcrumbs"> + <div class="xleft"> + <span id="publishDate">Last Published: 2019-04-25</span> + | <a href="http://portals.apache.org/pluto"; class="externalLink" title="Home">Home</a> > +Getting Started With Pluto + </div> + <div class="xright"><a href="../portlet-3.0-apidocs/index.html" title="Portlet 3.0 API">Portlet 3.0 API</a> | +<a href="../portlet-2.0-apidocs/index.html" title="Portlet 2.0 API">Portlet 2.0 API</a> | +<a href="../portlet-1.0-apidocs/index.html" title="Portlet 1.0 API">Portlet 1.0 API</a> | +<a href="http://jcp.org/en/jsr/detail?id=362"; class="externalLink" title="JSR 362 JCP Page">JSR 362 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=286"; class="externalLink" title="JSR 286 JCP Page">JSR 286 JCP Page</a> | +<a href="http://jcp.org/en/jsr/detail?id=168"; class="externalLink" title="JSR 168 JCP Page">JSR 168 JCP Page</a> </div> + <div class="clear"> + <hr/> + </div> + </div> + <div id="leftColumn"> + <div id="navcolumn"> + <h5>The Pluto Project</h5> + <ul> + <li class="none"><a href="../index.html" title="About Pluto">About Pluto</a></li> + <li class="none"><a href="../mission.html" title="Mission">Mission</a></li> + <li class="none"><a href="../download.html" title="Download">Download</a></li> + <li class="none"><a href="../news.html" title="News">News</a></li> + <li class="none"><a href="../security.html" title="Security">Security</a></li> + <li class="none"><a href="../status.html" title="Status">Status</a></li> + <li class="none"><a href="../architecture.html" title="Architecture">Architecture</a></li> + <li class="none"><a href="../resources.html" title="Resources">Resources</a></li> + <li class="none"><a href="../faq.html" title="FAQ">FAQ</a></li> + <li class="none"><a href="http://wiki.apache.org/portals/Pluto"; class="externalLink" title="Wiki">Wiki</a></li> + <li class="none"><a href="https://issues.apache.org/jira/browse/PLUTO"; class="externalLink" title="Issue Tracker (JIRA)">Issue Tracker (JIRA)</a></li> + <li class="none"><a href="../helping.html" title="Get Involved">Get Involved</a></li> + </ul> + <h5>Pluto 3.1</h5> + <ul> + <li class="none"><a href="../v310/mvcbean-portlets.html" title="MVCBean Portlets">MVCBean Portlets</a></li> + <li class="none"><a href="../v310/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v310/maven-archetypes.html" title="Maven Archetypes">Maven Archetypes</a></li> + <li class="none"><a href="../v310/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v310/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v310/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v310/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v310/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 3.0</h5> + <ul> + <li class="none"><a href="../v301/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v301/deploying.html" title="Deploying Portlets">Deploying Portlets</a></li> + <li class="none"><a href="../v301/portlet-api.html" title="Portlet Concepts">Portlet Concepts</a></li> + <li class="none"><a href="../v301/v3Features.html" title="Version 3 Features">Version 3 Features</a></li> + <li class="none"><a href="../v301/tck.html" title="Using the TCK">Using the TCK</a></li> + <li class="none"><a href="../v301/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Pluto 2.0</h5> + <ul> + <li class="none"><strong>Getting Started</strong></li> + <li class="none"><a href="../v20/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v20/embedding.html" title="Embedding">Embedding</a></li> + <li class="none"><a href="../v20/release-notes.html" title="Release Notes">Release Notes</a></li> + <li class="none"><a href="../v20/app-servers.html" title="App Servers">App Servers</a></li> + <li class="none"><a href="../v20/powered.html" title="Powered By Pluto">Powered By Pluto</a></li> + </ul> + <h5>Pluto 1.1</h5> + <ul> + <li class="none"><a href="../v11/getting-started.html" title="Getting Started">Getting Started</a></li> + <li class="none"><a href="../v11/deploying.html" title="Deploying">Deploying</a></li> + <li class="none"><a href="../v11/release-notes.html" title="Release Notes">Release Notes</a></li> + </ul> + <h5>Subprojects</h5> + <ul> + <li class="none"><a href="../subprojects/subprojects.html" title="Overview">Overview</a></li> + </ul> + <h5>Project Info</h5> + <ul> + <li class="none"><a href="../project-summary.html" title="Project Summary">Project Summary</a></li> + <li class="none"><a href="../team-list.html" title="Project Team">Project Team</a></li> + <li class="none"><a href="../license.html" title="Project License">Project License</a></li> + <li class="none"><a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li class="none"><a href="../source-repository.html" title="Source Repository">Source Repository</a></li> + <li class="none"><a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a></li> + </ul> + <a href="http://maven.apache.org/"; title="Built by Maven" class="poweredBy"> + <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /> + </a> + </div> + </div> + <div id="bodyColumn"> + <div id="contentBox"> + + + + + <div class="section"> +<h2><a name="Installing_the_Pluto_2.0_Binary_Build"></a>Installing the Pluto 2.0 Binary Build</h2> + +<div class="highlightBox"> + +<div class="section"> +<div class="section"> +<h4><a name="About_Pluto_Distributions"></a>About Pluto Distributions</h4> + <p> There are a number of distributions to choose from depending on your needs. - <ul><li><strong>pluto-bundle</strong> - Provides Pluto and Tomcat bundled together. + </p> +<ul> + +<li><b>pluto-bundle</b> - Provides Pluto and Tomcat bundled together. If you are getting started with Pluto, this is the distribution you want.</li> -<li><strong>pluto-source-release</strong> - Provides the Pluto source code; requires + +<li><b>pluto-source-release</b> - Provides the Pluto source code; requires that you build and deploy Pluto on your own.</li> -</ul> -</p> -</div><ol type="1"><li>Download the Pluto 2.0 binary distribution named <strong>pluto-current-bundle</strong> from + </ul> + + </div> + +<ol style="list-style-type: decimal"> + +<li>Download the Pluto 2.0 binary distribution named <b>pluto-current-bundle</b> from a <a class="externalLink" href="http://www.apache.org/dyn/closer.cgi/portals/pluto/";>distribution site</a>.</li> + <li>Unzip the binary distribution into a directory.</li> -<ol type="1"><li><PLUTO-2.0-HOME> will be the top level directory.</li> -</ol> + +<ol style="list-style-type: decimal"> + +<li><PLUTO-2.0-HOME> will be the top level directory.</li> + </ol> + <li>Execute startup.bat (Windows) or startup.sh (Unix) in <PLUTO-2.0-HOME>/bin.</li> -<ol type="1"><li>Use shutdown.bat/shutdown.sh to stop the portal</li> -</ol> + +<ol style="list-style-type: decimal"> + +<li>Use shutdown.bat/shutdown.sh to stop the portal</li> + </ol> + <li>Browse to <a class="externalLink" href="http://localhost:8080/pluto/portal";>http://localhost:8080/pluto/portal</a></li> + <li>Login as user pluto (password=pluto) or tomcat (password=pluto).</li> -</ol> -</div> -<div class="section"><h2><a name="Building_Pluto_2.0_from_Source"></a>Building Pluto 2.0 from Source</h2> + </ol> + + </div></div></div> + + +<div class="section"> +<h2><a name="Building_Pluto_2.0_from_Source"></a>Building Pluto 2.0 from Source</h2> + + <p> Maven 2 is utilized as the project management and build system for Pluto 2.0. 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. </p> -<div class="section"><h3><a name="Obtaining_Pluto_2.0_Source_Code"></a>Obtaining Pluto 2.0 Source Code</h3> + + +<div class="section"> +<h3><a name="Obtaining_Pluto_2.0_Source_Code"></a>Obtaining Pluto 2.0 Source Code</h3> + <p>The Pluto project uses the <a class="externalLink" href="http://subversion.tigris.org/";>Subversion</a> version control system. If you're new to Subversion, you can check out the @@ -294,34 +189,66 @@ in <PLUTO-2.0-HOME>/bin.</li> Note that we are currently using Subversion 1.3.x (there are separate versions of the book covering the different versions of Subversion). </p> + + <p><b>Web Access to Subversion</b></p> + + <p> To browse the Pluto source code, you can use the <a class="externalLink" href="http://svn.apache.org/viewcvs.cgi/portals/pluto/trunk?root=Apache-SVN";>ViewCVS web interface</a> to Subversion. This is current at all times. </p> + + <p><b>Normal Subversion Access</b></p> + <p>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.</p> -<h3>Check out from Subversion</h3><p>Again, anyone can do this. To check out the latest distribution of Pluto 2.0 (trunk) to a directory + + </div> +<div class="section"> +<h3><a name="Check_out_from_Subversion"></a>Check out from Subversion</h3> + + +<p>Again, anyone can do this. To check out the latest distribution of Pluto 2.0 (trunk) to a directory called 'pluto' use this command: - <pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/trunk/ pluto</pre></p> -<p>To check out Pluto 2.0.<code>x</code> source to the 'pluto' directory use this command (substituting '<code>x</code>' for the - current release number, e.g. 2.0.<code>0</code>): - <pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/pluto-2.0.3 pluto</pre></p> + </p> +<div> +<pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/trunk/ pluto</pre></div> + + + +<p>To check out Pluto 2.0.<tt>x</tt> source to the 'pluto' directory use this command (substituting '<tt>x</tt>' for the + current release number, e.g. 2.0.<tt>0</tt>): + </p> +<div> +<pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/pluto-2.0.3 pluto</pre></div> + + + <p> Zipped up Pluto 2.0 source distributions can also be downloaded from a <a class="externalLink" href="http://www.apache.org/dyn/closer.cgi/portals/pluto/";>distribution mirror</a>. - </p> -</div> -<div class="section"><h3><a name="Building_Pluto_with_Maven_2"></a>Building Pluto with Maven 2</h3> + </p> + + </div> + + +<div class="section"> +<h3><a name="Building_Pluto_with_Maven_2"></a>Building Pluto with Maven 2</h3> + <p> - If this is your first time building Pluto with Maven 2, edit <code>~/.m2/settings.xml</code> + If this is your first time building Pluto with Maven 2, edit <tt>~/.m2/settings.xml</tt> and add the <pluginGroups> element: - <p><div class="source"><pre> + +<p> + </p> +<div class="source"> +<pre> <settings> ... <pluginGroups> @@ -329,94 +256,143 @@ in <PLUTO-2.0-HOME>/bin.</li> </pluginGroups> ... </settings> - </pre> -</div> -</p> - - If you don't have <code>org.apache.portals.pluto</code> specified as a <code><pluginGroup></code>, - then the <code>pluto2:install</code> will fail. - </p> -<p><code><PLUTO_SRCHOME></code> is the local directory where the + </pre></div> + + If you don't have <tt>org.apache.portals.pluto</tt> specified as a <tt><pluginGroup></tt>, + then the <tt>pluto2:install</tt> will fail. + + +<p> + <tt><PLUTO_SRCHOME></tt> is the local directory where the Pluto 2.0 source distribution has been checked out or unzipped into. </p> -<p><div class="source"><pre> + +<p> + </p> +<div class="source"> +<pre> $> cd <PLUTO_SRCHOME> $> mvn install $> mvn pluto2:install -DinstallDir=path/to/appserver - </pre> -</div> -</p> + </pre></div> + + <p> - The <code>install</code> goal is a built in Maven 2 lifecycle + The <tt>install</tt> goal is a built in Maven 2 lifecycle which builds the project artifacts and installs them into the Maven repository. </p> + <p> - The <code>pluto2:install</code> goal will take the resulting artifacts + The <tt>pluto2:install</tt> goal will take the resulting artifacts and properly deploy them within the configured Tomcat installation. Currently, the Pluto install has been tested on Tomcat 6.0.33 and 7.0.21. </p> + <p> - If installing to a directory that contains spaces, <code>installDir</code> + If installing to a directory that contains spaces, <tt>installDir</tt> needs to be enclosed within quotes: </p> -<p><div class="source"><pre> + +<p> + </p> +<div class="source"> +<pre> C:\pluto> mvn pluto2:install -DinstallDir="C:\Program Files\Apache Software Foundation\Tomcat 7.0" - </pre> -</div> -</p> -</div> -<div class="section"><h3><a name="Installing_Pluto_Manually"></a>Installing Pluto Manually</h3> + </pre></div> + + + </div> + + +<div class="section"> +<h3><a name="Installing_Pluto_Manually"></a>Installing Pluto Manually</h3> + <p> This section documents the manual installation of Pluto 2.0 into Tomcat. It replaces the pluto2:install goal, but requires that the built-in Maven 2 install goal - (<code>mvn install</code>) be run from <code><PLUTO_SRCHOME></code>. + (<tt>mvn install</tt>) be run from <tt><PLUTO_SRCHOME></tt>. </p> -<p><b>Step 1:</b><div class="source"><pre> + +<p> + <b>Step 1:</b> + </p> +<div class="source"> +<pre> $> cd <PLUTO_SRCHOME> $> mvn install - </pre> -</div> -</p> -<p><b>Step 2:</b> Copy the following files to - <code><TOMCAT_HOME>/lib on Tomcat 6+</code>: - <ul><li>portlet-api_2.0_spec-1.0.jar</li> + </pre></div> + + +<p> + <b>Step 2:</b> Copy the following files to + <tt><TOMCAT_HOME>/lib on Tomcat 6+</tt>: + </p> +<ul> + +<li>portlet-api_2.0_spec-1.0.jar</li> + <li>ccpp-1.0.jar</li> + <li>pluto-container-api-2.0.3.jar</li> + <li>pluto-container-driver-api-2.0.3.jar</li> + <li>pluto-taglib-2.0.3.jar</li> + <li>portlet-api_2.0_spec-1.0.jar</li> -</ul> -</p> -<p><b>Step 3:</b> Copy the following to - <code><TOMCAT_HOME>/conf/Catalina/localhost</code>: - <ul><li><PLUTO_SRCHOME>/pluto-portal/src/main/resources/pluto.xml</li> + </ul> + + +<p> + <b>Step 3:</b> Copy the following to + <tt><TOMCAT_HOME>/conf/Catalina/localhost</tt>: + </p> +<ul> + +<li><PLUTO_SRCHOME>/pluto-portal/src/main/resources/pluto.xml</li> + <li><PLUTO_SRCHOME>/pluto-testsuite/src/main/resources/testsuite.xml</li> -</ul> -</p> -<p><b>Step 4:</b> Copy the following to - <code><TOMCAT_HOME>/webapps</code>: - <ul><li><PLUTO_SRCHOME>/pluto-portal/target/pluto-portal.war</li> + </ul> + + +<p> + <b>Step 4:</b> Copy the following to + <tt><TOMCAT_HOME>/webapps</tt>: + </p> +<ul> + +<li><PLUTO_SRCHOME>/pluto-portal/target/pluto-portal.war</li> + <li><PLUTO_SRCHOME>/pluto-testsuite/target/pluto-testsuite.war</li> -</ul> -</p> -</div> -<div class="section"><h3><a name="Configuring_Source-Built_Pluto_for_Application_Scope_PortletSession_Attributes"></a>Configuring Source-Built Pluto for Application Scope PortletSession Attributes</h3> -<p>To be able to use application-scoped <code>PortletSession</code> attributes in Pluto, modify - the Context element in <code><TOMCAT_HOME>/conf/context.xml</code> by + </ul> + + </div> + + +<div class="section"> +<h3><a name="Configuring_Source-Built_Pluto_for_Application_Scope_PortletSession_Attributes"></a>Configuring Source-Built Pluto for Application Scope PortletSession Attributes</h3> + +<p>To be able to use application-scoped <tt>PortletSession</tt> attributes in Pluto, modify + the Context element in <tt><TOMCAT_HOME>/conf/context.xml</tt> by adding the following attribute and value: sessionCookiePath="/". </p> -</div> -<div class="section"><h3><a name="Configuring_User_and_Role_in_the_Pluto_Source_Build"></a>Configuring User and Role in the Pluto Source Build</h3> + </div> + +<div class="section"> +<h3><a name="Configuring_User_and_Role_in_the_Pluto_Source_Build"></a>Configuring User and Role in the Pluto Source Build</h3> + <p> - The Pluto Testsuite portlet application needs the role '<code>pluto</code>' + The Pluto Testsuite portlet application needs the role '<tt>pluto</tt>' to run the Security Mapping Test. So before starting tomcat, you should - edit <code><TOMCAT_HOME>/conf/tomcat-users.xml</code>, add the - role '<code>pluto</code>', and add a user in that role. The simplest way - to do this is to edit add the '<code>pluto</code>' role to the - '<code>tomcat</code>' user's record. Here is a sample - <code>tomcat-users.xml</code> file: - <div class="source"><pre> + edit <tt><TOMCAT_HOME>/conf/tomcat-users.xml</tt>, add the + role '<tt>pluto</tt>', and add a user in that role. The simplest way + to do this is to edit add the '<tt>pluto</tt>' role to the + '<tt>tomcat</tt>' user's record. Here is a sample + <tt>tomcat-users.xml</tt> file: + </p> +<div class="source"> +<pre> <?xml version="1.0" encoding="utf-8"?> <tomcat-users> <role rolename="manager"/> @@ -428,45 +404,42 @@ $> mvn install <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="pluto" password="pluto" roles="pluto,manager"/> </tomcat-users> - </pre> -</div> -</p> -</div> -<div class="section"><h3><a name="Starting_the_Portal"></a>Starting the Portal</h3> + </pre></div> + + </div> + + + +<div class="section"> +<h3><a name="Starting_the_Portal"></a>Starting the Portal</h3> + <p> Now you are ready to use the Pluto Portal built from source. Start up tomcat by running - <code>startup.bat</code> (for windows) or <code>startup.sh</code> (for - *nix) in <code><TOMCAT_HOME>/bin</code>, and browse to - <code>http://localhost:8080/pluto/portal</code>. Login to Pluto using - the user and password you just created in <code>tomcat-users.xml</code>. + <tt>startup.bat</tt> (for windows) or <tt>startup.sh</tt> (for + *nix) in <tt><TOMCAT_HOME>/bin</tt>, and browse to + <tt>http://localhost:8080/pluto/portal</tt>. Login to Pluto using + the user and password you just created in <tt>tomcat-users.xml</tt>. If you added the 'pluto' role to the 'tomcat' user's record, you can login as 'tomcat/tomcat'. </p> -</div> -</div> - - </div> - </div> - <div class="clear"> - <hr/> - </div> - <div id="footer"> - <div class="xright">© - 2004-2018 - - Apache Software Foundation - - - - - - - - - </div> - <div class="clear"> - <hr/> - </div> - </div> - </body> -</html> + </div> + </div> + + + + + </div> + </div> + <div class="clear"> + <hr/> + </div> + <div id="footer"> + <div class="xright"> + Copyright © 2004–2019 <a href="http://www.apache.org/";>Apache Software Foundation</a>. +All rights reserved. </div> + <div class="clear"> + <hr/> + </div> + </div> + </body> +</html>
![http://portals.apache.org/pluto/images/apache-portals.gif"](http://portals.apache.org/pluto/images/apache-portals.gif"){kind=link}
![http://portals.apache.org/pluto/images/banner.png"](http://portals.apache.org/pluto/images/banner.png"){kind=link}