You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pluto-scm@portals.apache.org by es...@apache.org on 2006/09/26 23:29:51 UTC
svn commit: r450218 - in /portals/pluto/trunk/pluto-site/src/site/xdoc/v11:
app-servers.xml deploying.xml getting-started.xml
Author: esm
Date: Tue Sep 26 14:29:50 2006
New Revision: 450218
URL: http://svn.apache.org/viewvc?view=rev&rev=450218
Log:
Prep documentation for 1.1 beta2 release.
Modified:
portals/pluto/trunk/pluto-site/src/site/xdoc/v11/app-servers.xml
portals/pluto/trunk/pluto-site/src/site/xdoc/v11/deploying.xml
portals/pluto/trunk/pluto-site/src/site/xdoc/v11/getting-started.xml
Modified: portals/pluto/trunk/pluto-site/src/site/xdoc/v11/app-servers.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site/src/site/xdoc/v11/app-servers.xml?view=diff&rev=450218&r1=450217&r2=450218
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/v11/app-servers.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/v11/app-servers.xml Tue Sep 26 14:29:50 2006
@@ -39,8 +39,8 @@
<td>5.5.9</td>
<td>WORKING</td>
<td>
- Use pluto-util module to install the the container and portal
- into tomcat.
+ Use <code>mvn pluto:install -DinstallDir=/path/to/tomcat</code>
+ to install the container and portal into Tomcat.
</td>
</tr>
<tr>
@@ -50,6 +50,15 @@
<td>
Tomcat contains a bug and does not recognize the context
configuration. Manual Installation and renaming will work.
+ </td>
+ </tr>
+ <tr>
+ <td>Tomcat</td>
+ <td>5.5.17</td>
+ <td>Working</td>
+ <td>
+ Use <code>mvn pluto:install -DinstallDir=/path/to/tomcat</code>
+ to install the container and portal into Tomcat.
</td>
</tr>
<tr>
Modified: portals/pluto/trunk/pluto-site/src/site/xdoc/v11/deploying.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site/src/site/xdoc/v11/deploying.xml?view=diff&rev=450218&r1=450217&r2=450218
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/v11/deploying.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/v11/deploying.xml Tue Sep 26 14:29:50 2006
@@ -58,20 +58,13 @@
<subsection name="Portlet Assembly and Deployment using Maven 2">
<p>
- As of the first beta release of Pluto 1.1, the Maven 2 plugins for assembly and
+ As of the second beta release of Pluto 1.1, the Maven 2 plugins for assembly and
deployment are partially completed.
Right now the maven-pluto-plugin correctly assembles the war with
the proper <code>PortletServlet</code> records to web.xml, but the
deployment plugin is not yet completed. We have created an example
- Maven 2 pom.xml below that correctly assembles and deploys the portlet.
- This script requires
- that you have installed the pluto-util, pluto-descriptor-api and
- pluto-descriptor-impl into your local Maven 2 repository. You can do this by
- building Pluto from source or installing the files that come with the
- binary build (in PlutoDomain subdirectory) and running the install:install-file goal (see the
- <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1">Maven FAQ</a>,
- using groupId="org.apache.pluto", artifactId="pluto-util or pluto-descriptor-api or pluto-descriptor-impl"
- and version="1.1.0-beta1" when running the install:install-file goal).
+ <!-- TODO: Review use of the word deploys -->
+ Maven 2 pom.xml below that correctly assembles and deploys the portlet.
</p>
<p>
The custom Maven 2 build shown below also deploys
@@ -135,7 +128,7 @@
<!-- Dependency Version Properties ======================================= -->
<properties>
<!-- Change this for a new Pluto version -->
- <pluto.version>1.1.0-beta1</pluto.version>
+ <pluto.version>1.1.0-beta2</pluto.version>
<portlet-api.version>1.0</portlet-api.version>
<servlet-api.version>2.3</servlet-api.version>
<jsp-api.version>2.0</jsp-api.version>
@@ -180,6 +173,7 @@
</plugin>
<!-- bind 'pluto:assemble' goal to 'process-resources' lifecycle -->
<plugin>
+ <groupId>org.apache.pluto</groupId>
<artifactId>maven-pluto-plugin</artifactId>
<version>${pluto.version}</version>
<executions>
@@ -247,15 +241,15 @@
the command 'mvn integration-test'.
</p>
<p>
- Run 'mvn package' to just create the war, which ends up in the target directory.
- If you do this, you need to manually deploy the war file and Tomcat context
- deployment descriptor to your Pluto-1.1 install.
+ If you prefer to manually deploy the war to Tomcat, run 'mvn package' which will
+ create the war file in the <code>target/</code> directory. Then manually deploy
+ the war file and Tomcat context deployment descriptor to your Pluto-1.1 install.
</p>
</subsection>
<subsection name="Portlet Publishing">
<p>
- Currently, as of Pluto-1.1-beta1, the only way to publish an application to the portal
+ Currently, as of Pluto-1.1-beta2, the only way to publish an application to the portal
is to manually update the Portal's configuration file <code>pluto-portal-driver-config.xml</code>
located in the WEB-INF directory of the pluto webapp.
Here's how to do it:
Modified: portals/pluto/trunk/pluto-site/src/site/xdoc/v11/getting-started.xml
URL: http://svn.apache.org/viewvc/portals/pluto/trunk/pluto-site/src/site/xdoc/v11/getting-started.xml?view=diff&rev=450218&r1=450217&r2=450218
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/v11/getting-started.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/v11/getting-started.xml Tue Sep 26 14:29:50 2006
@@ -31,7 +31,7 @@
<ol>
<li>Download a Pluto 1.1 binary distribution from
- a <a href="http://cvs.apache.org/dist/portals/pluto/v1.1.0-beta1/">distribution site</a>.</li>
+ a <a href="http://cvs.apache.org/dist/portals/pluto/v1.1.0-beta2/">distribution site</a>.</li>
<li>Unzip the binary distribution into a directory.</li>
<ol>
<li><PLUTO-1.1-HOME> will be the top level directory.</li>
@@ -42,7 +42,7 @@
<li>Use shutdown.bat/shutdown.sh to stop the portal</li>
</ol>
<li>Browse to <a href="http://localhost:8080/pluto/portal">http://localhost:8080/pluto/portal</a></li>
- <li>Login as tomcat user (password=tomcat).</li>
+ <li>Login as the user pluto (password=pluto).</li>
</ol>
</section>
@@ -54,8 +54,6 @@
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.
- Currently, the source distribution is required to deploy custom portlets
- to Pluto 1.1.
</p>
<subsection name="Obtaining Pluto 1.1 Source Code">
@@ -63,8 +61,8 @@
<a href="http://subversion.tigris.org/">Subversion</a> version control
system. If you're new to Subversion, you can check out the
<a href="http://svnbook.red-bean.com/">online book</a> about Subversion.
- Note that we are currently using Subversion 1.1.x (there are separate
- versions of the book covering 1.0 and 1.1).
+ 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>
@@ -89,8 +87,8 @@
<pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/trunk/ pluto</pre>
</p>
- <p>To check out Pluto 1.1.0-beta1 source to the 'pluto' directory use this command:
- <pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/release-1.1.0-beta1/ pluto</pre>
+ <p>To check out Pluto 1.1.0-beta2 source to the 'pluto' directory use this command:
+ <pre>svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/release-1.1.0-beta2/ pluto</pre>
</p>
<p>
@@ -120,11 +118,11 @@
<p>
The <code>pluto:install</code> goal will take the resulting artifacts
and properly deploy them within the configured Tomcat installation.
- Currently, the Pluto 1.1 install has been tested on Tomcat 5.5.9.
+ Currently, the Pluto 1.1 install has been tested on Tomcat 5.5.9 and Tomcat 5.5.17.
The Tomcat 5 archive can be found <a href="http://archive.apache.org/dist/tomcat/tomcat-5/archive">here</a>.
</p>
<p>
- If installing to a directory that contains spaces, <code>installDir</code>
+ If installing to a directory that contains spaces, <code>installDir</code>
needs to be enclosed within quotes:
</p>
<p>
@@ -137,8 +135,9 @@
<subsection name="Installing Pluto Manually">
<p>
- This section documents the manual installation of Pluto into Tomcat. It replaces
- the pluto:install goal, but requires that the built-in Maven 2 install goal has been run.
+ This section documents the manual installation of Pluto into Tomcat. It replaces
+ the pluto:install goal, but requires that the built-in Maven 2 install goal
+ (<code>mvn install</code>) be run from <code><PLUTO-1.1-SRCHOME></code>.
</p>
<p>
<b>Step 1:</b>
@@ -151,12 +150,12 @@
<b>Step 2:</b> Copy the following to
<code><TOMCAT_HOME>/shared/lib</code>:
<ul>
- <li>castor-0.9.6.jar</li>
+ <li>castor-1.0.jar</li>
<li>portlet-api-1.0.jar</li>
- <li>pluto-container-1.1-beta1.jar</li>
- <li>pluto-descriptor-api-1.1-beta1.jar</li>
- <li>pluto-descriptor-impl-1.1-beta1.jar</li>
- <li>pluto-taglib-1.1.0-beta1.jar</li>
+ <li>pluto-container-1.1-beta2.jar</li>
+ <li>pluto-descriptor-api-1.1-beta2.jar</li>
+ <li>pluto-descriptor-impl-1.1-beta2.jar</li>
+ <li>pluto-taglib-1.1.0-beta2.jar</li>
</ul>
</p>
<p>
@@ -192,7 +191,7 @@
this process.
</p>
</subsection>
-
+
<subsection name="Configuring Source-Built Pluto for Application Scope PortletSession Attributes">
<p>To be able to use application-scoped <code>PortletSession</code> attributes in Pluto, modify
the Connector element for port 8080 in <code><TOMCAT_HOME>/conf/server.xml</code> by