portals-jetspeed-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From woon...@apache.org
Subject svn commit: r722405 [2/17] - in /portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade: ./ src/ src/site/ src/site/resources/ src/site/resources/css/ src/site/resources/images/ src/site/resources/images/layouts/ src/site/resources/images/portlet...
Date Tue, 02 Dec 2008 08:53:28 GMT
Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/jsaudit.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/jsaudit.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/jsaudit.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/jsaudit.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,67 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+	contributor license agreements.  See the NOTICE file distributed with
+	this work for additional information regarding copyright ownership.
+	The ASF licenses this file to You under the Apache License, Version 2.0
+	(the "License"); you may not use this file except in compliance with
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Jetspeed Auditing Reports</title>
+		<subtitle>Welcome to Jetspeed Auditing Reports App</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+<section name="Catalog of Jetspeed Auditing Reports">
+<p>This portlet application provides a set of report portlets for querying information gathering during administrative operations of the portal.</p>
+<table>
+<tr>
+<th>Portlet</th>
+<th>Description</th>
+</tr>
+<tr>
+<td>AdminActivityReport</td>
+<td>Filtered Report displaying activity of administrators like adding and removing users, adding roles to users, resetting passwords, updating security attributes. Displays before and after values when applicable, as well as timestamp, IP address.</td>
+</tr>
+<tr>
+<td>PasswordResetReport</td>
+<td>Presents a Password Reset activity report on the queried user(s) displaying information about when a password was last reset and by whom (administrator or user), shows IP address from where user reset password</td>
+</tr>
+<tr>
+<td>SystemSecurityReport</td>
+<td>Presents a system security report on the queried user(s) displaying general system security settings: password expire date, number of attempted logins, and security policy settings: 	lockout duration policy, password complexity, user id complexity, password history</td>
+</tr>
+<tr>
+<td>UserCreationReport</td>
+<td>Presents a User Creation activity report on the queried user(s) displaying a log of all user creation activity with timestamps, and which admin user created the user from which IP address</td>
+</tr>
+<tr>
+<td>UserDeletionReport</td>
+<td>Presents a User Deletion activity report on the queried user(s) displaying a log of all user deletion activity with timestamps, and which admin user deleted the user from which IP address</td>
+</tr>
+<tr>
+<td>UserStatusReport</td>
+<td>Presents user login statistics (filtered) about all users who have visited the portal including name, email, last login timestamp, last login IP, last password change timestamp, user status (enabled/disabled), created by administrator</td>
+</tr>
+</table>
+<subsection name='Excel Reports'>
+<p>In order to view the Excel reports, you will need to set this property in the WEB-INF/conf/override.properties:</p>
+<p>
+merge.portal.parameters.with.portlet.parameters=<b>true</b>
+</p>
+</subsection>	
+</section>
+</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/jsaudit.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/jsaudit.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/mfa.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/mfa.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/mfa.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/mfa.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,204 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+	contributor license agreements.  See the NOTICE file distributed with
+	this work for additional information regarding copyright ownership.
+	The ASF licenses this file to You under the Apache License, Version 2.0
+	(the "License"); you may not use this file except in compliance with
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Jetspeed MFA Portlet App</title>
+		<subtitle>Welcome to Jetspeed Portlet Application Multifaceted Authentication</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Using the Jetspeed MFA Portlet">
+		<p>This portlet application provides multi-faceted login portlet functionality including captcha and personal questions. Since this is a login portlet, it has minimal hooks to authenticate against Jetspeed. You should be able to easily adapt this portlet application to other portals by changing the authentication code.</p>
+		<subsection name='Usage with Jetspeed'>
+		<p>There is one portlet found in the portlet.xml: <b>MFALogin</b>. This portlet is configured in the portlet.xml with the following init parameters:</p>
+<table>
+<tr>
+<th>param name</th>
+<th>default value</th>
+<th>description</th>
+</tr>
+<tr>
+<td>cookieLifetime</td>
+<td>345600</td>
+<td>The lifetime of the stored cookie in seconds (4 days)</td> 
+</tr>
+<tr>
+<td>maxNumberOfAuthenticationFailures</td>
+<td>5</td>
+<td>Maximum number of authentication failures before disabling a user</td>
+</tr>
+<tr>
+<td>randomQuestions</td>
+<td>What was the first and last name of our favorite teacher? In what city did you get married? ...</td>
+<td>A list of 24 personal questions which will be displayed to the user in random order separated by question marks (?)</td>
+</tr>
+</table>
+<p><b>IMPORTANT</b>The Jetspeed web.xml must be modified. The <i>LoginProxyServlet</i> servlet must have its <i>credentialsFromRequest</i> init param set to false:</p>
+<source><![CDATA[
+<servlet>
+    <servlet-name>LoginProxyServlet</servlet-name>
+    <servlet-class>org.apache.jetspeed.login.LoginProxyServlet</servlet-class>
+	<init-param>
+		<param-name>credentialsFromRequest</param-name>
+		<param-value>false</param-value>
+	</init-param>        
+</servlet>
+]]></source>		
+		</subsection>
+		<subsection name='Captcha'>
+<p>
+The following  Captcha properties are configured in the mfa.properties found in the WEB-INF directory of your web application.
+</p>
+<h2>Property File</h2>
+<table border='1'>
+<tr>
+<th>Property</th>
+<th>Default Value</th>
+<th>Description</th>
+<tr>
+<td>captcha.directory</td>
+<td>/captchas</td>
+<td>The directory where all captchas will be stored when generated. For web applications, this directory should be a in a public viewable area.
+The directory name is relative to either the running program, or in the case of a web application, relative to the root of the web application</td>
+</tr>
+<tr>
+<td>captcha.effects.noise</td>
+<td>false</td>
+<td>Turn on the default noise generation for a capcha. Noise generation is not yet configurable to a fine grain but instead enables a set of general noise algorithms including
+drawing an XORed oval behind the text, and generating gray noise throughout the image.
+This feature is turned off by default and should not be used with an image background.</td>
+</tr>
+<tr>
+<td>captcha.image.background</td>
+<td>images/jetspeedlogo98.jpg</td>
+<td>Uses an image file as the background for the capcha image. The default provide is a company logo that has been run through a matte effect.</td>
+</tr>
+<tr>
+<td>captcha.image.background.use</td>
+<td>true</td>
+<td>Enable or disable using the background image defined in the captcha.image.background property.</td>
+</tr>
+<tr>
+<td>catcha.image.format</td>
+<td>.jpg</td>
+<td>The image format of the output captcha file. Known supported formats are .jpg and .png</td>
+</tr>
+<tr>
+<td>captcha.font.antialiasing</td>
+<td>true</td>
+<td>Enable or disable antialiasing. By enabling, you will generate a clearer image at the cost of slower rendering times.</td>
+</tr>
+<tr>
+<td>captcha.font.size</td>
+<td>36</td>
+<td>The point size of the font.</td>
+</tr>
+<tr>
+<td>captcha.font.style</td>
+<td>0</td>
+<td>The style of the font. Valid values are: PLAIN == 0, BOLD == 1, ITALIC == 2, BOLD_ITALIC == 3</td>
+</tr>
+<tr>
+<td>captcha.font.names</td>
+<td>Times</td>
+<td>A comma-separated list of font names. Make sure your server supports all listed fonted. When more than one font listed, fonts will be randomized.</td>
+</tr>
+<tr>
+<td>captcha.scanrate.seconds</td>
+<td>300</td>
+<td>Configures the cleanup thread for removal of captchas images. The cleanup thread will run by default every 300 seconds.</td>
+</tr>
+<tr>
+<td>captcha.timetolive.seconds</td>
+<td>120</td>
+<td>Configures the lifetime of a captcha image. Default is 120 seconds before it is deleted.</td>
+</tr>
+<tr>
+<td>captcha.text.maxlength</td>
+<td>8</td>
+<td>The maximum number of characters generated for the captcha string. Randomly used with captcha.text.minlength to vary the size of the captcha string.</td>
+</tr>
+<tr>
+<td>captcha.text.margin.left</td>
+<td>2</td>
+<td>The left-side margin where to start drawing the captcha string in in a device-independent coordinates.</td>
+</tr>
+<tr>
+<td>captcha.text.margin.bottom</td>
+<td>10</td>
+<td>The bottom margin where to start drawing the captcha string in in a device-independent coordinates.</td>
+</tr>
+<tr>
+<td>captcha.text.minlength</td>
+<td>6</td>
+<td>The minimum number of characters generated for the captcha string. Randomly used with captcha.text.maxlength to vary the size of the captcha string.</td>
+</tr>
+<tr>
+<td>captcha.text.rise.range</td>
+<td>30</td>
+<td>The rise from the bottom margin where to start drawing the captcha string. Setting to zero turns off the rising feature.
+If a positive number is used, the rise will randomly vary between the bottom margin and maximum rise value.</td>
+</tr>
+<tr>
+<td>captcha.text.rotation</td>
+<td>10</td>
+<td>Sets the rotation (vertical alignment variance) of a glyph to control this. The value is in radians. 
+Value should be a positive number or zero. For example, setting to 35, will rotate the glyph randomly between -35 and 35 radians.
+Setting this value to 0 will turn off rotation.
+</td>
+</tr>
+<tr>
+<td>captcha.text.shear</td>
+<td>0</td>
+<td>Shearing slides one edge of an image along the X or Y axis, creating a parallelogram.
+The default value is 0, turning off all shearing effects. Shearing effects can make it more difficult for non-human readers to read the image.
+Shear values are specified in radians, with values closer to 1.0 creating a more drastic shearing effect.</td>
+</tr>
+<tr>
+<td>captcha.text.spacing</td>
+<td>2</td>
+<td>The space between captcha characters in device-independent coordinates. 0 is a valid value, but can make it difficult to read glyphes when combined with rotations.</td>
+</tr>
+<tr>
+<td>captcha.timestamp</td>
+<td>true</td>
+<td>Boolean value to enable printing a timestamp at the bottom of the captcha image in a small monospaced font.</td>
+</tr>
+<tr>
+<td>captcha.timestamp.24hr</td>
+<td>true</td>
+<td>Boolean value set to true when using 24 hour clock on timestamp, otherwise 12 hour clock.</td>
+</tr>
+<tr>
+<td>captcha.timestamp.tz</td>
+<td>America/New_York</td>
+<td>The Time Zone ID (TZID). The timestamp will be displayed for this timezone. You can also use timezone abbreviations such as EDT (Eastern Daylight Time).</td>
+</tr>
+<td>captcha.timestamp.font.size</td>
+<td>8</td>
+<td>The font size of the timestamp.</td>
+</tr>
+
+</table>
+		
+		</subsection>
+		</section>
+	</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/mfa.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/applications/mfa.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/images/capabilities-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/images/capabilities-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/images/capabilities-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/images/capabilities-db.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/images/capabilities-db.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/images/capabilities-db.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/index.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/index.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,226 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Capabilities</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Capabilities Overview">
+            <p>
+            Jetspeed-2 capabilities provides a mechanism for mapping the client used to access Jetspeed-2 to media types
+            for page rendering.
+            </p>
+            <subsection name="Capabilities Definitions">
+            <p>
+            The Jetspeed-2 capability engine maps clients to media types to mime types.  Here are some more detailed
+            definitions:
+            <ul>
+            <li>Clients: The application that initiates a request to the Jetspeed-2 portal engine.  Jetspeed-2 uses
+            the <code>User-Agent</code> to determine the client that initiates a request.</li>
+            <li>Media Type:  The type of media requesting the content (HTML, WML, etc.).  Content in Jetspeed-2
+            can be requested by different type of devices through different media.</li>
+            <li>Mime Type:  The type of content being requested.</li>
+            </ul>
+            </p>
+            <p>
+            Jetspeed-2 works with the following media types:
+            <table>
+            	<tr>
+            		<th>Name</th>
+            		<th>Character Set</th>
+            		<th>Description</th>
+            	</tr>
+            	<tr>
+            		<td>html</td>
+            		<td>UTF-8</td>
+            		<td>Rich HTML for HTML 4.0 compliants browsers</td>
+            	</tr>
+            	<tr>
+            		<td>wml</td>
+            		<td>UTF-8</td>
+            		<td>Format for mobile phones and PDAs compatible with WML 1.1</td>
+            	</tr>
+            	<tr>
+            		<td>vxml</td>
+            		<td>UTF-8</td>
+            		<td>Format suitable for use with an audio VoiceXML server</td>
+            	</tr>
+            	<tr>
+            		<td>xml</td>
+            		<td></td>
+            		<td>XML 1.0</td>
+            	</tr>
+            	<tr>
+            		<td>xhtml-basic</td>
+            		<td>UTF-8</td>
+            		<td>XHTML Basic used in WAP devices</td>
+            	</tr>
+           	</table>
+            </p>
+            <p>
+            Jetspeed-2 is configured to recognize the following clients:
+            <table>
+            	<tr>
+            		<th>Client</th>
+            		<th>User Agent Pattern</th>
+            		<th>Manufacturer</th>
+            		<th>Preferred Mime Type</th>
+            	</tr>
+            	<tr>
+            		<td>ie5</td>
+            		<td>.*MSIE 5.*</td>
+            		<td>Microsoft</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>ie6</td>
+            		<td>.*MSIE 6.*</td>
+            		<td>Microsoft</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>ns4</td>
+            		<td>.*Mozilla/4.*</td>
+            		<td>Netscape</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>mozilla</td>
+            		<td>.*Mozilla/5.*</td>
+            		<td>Mozilla</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>lynx</td>
+            		<td>Lynx.*</td>
+            		<td>GNU</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>opera7</td>
+            		<td>.*Opera/7.*</td>
+            		<td>Opera</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>ie5mac</td>
+            		<td>.*MSIE 5.*Mac.*</td>
+            		<td>Microsoft</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>safari</td>
+            		<td>.*Mac.*Safari.*</td>
+            		<td>Apple</td>
+            		<td>html</td>
+            	</tr>
+            	<tr>
+            		<td>xhtml-basic</td>
+            		<td>DoCoMo/2.0.*|KDDI-.*UP\.Browser.*|J-PHONE/5.0.*|Vodafone/1.0/.*</td>
+            		<td>N/A</td>
+            		<td>xhtml</td>
+            	</tr>
+            	<tr>
+            		<td>agentxml</td>
+            		<td>agentxml/1.0.*</td>
+            		<td>N/A</td>
+            		<td>xml</td>
+            	</tr>
+            	<tr>
+            		<td>nokia_generic</td>
+            		<td>Nokia.*</td>
+            		<td>Nokia</td>
+            		<td>wml</td>
+            	</tr>
+            	<tr>
+            		<td>up</td>
+            		<td>UP.*|.*UP\.Browser.*</td>
+            		<td>United Planet</td>
+            		<td>wml</td>
+            	</tr>
+            	<tr>
+            		<td>sonyericsson</td>
+            		<td>Ercis.*|SonyE.*</td>
+            		<td>SonyEricsson</td>
+            		<td>wml</td>
+            	</tr>
+            	<tr>
+            		<td>wapalizer</td>
+            		<td>Wapalizer.*</td>
+            		<td>Wapalizer</td>
+            		<td>wml</td>
+            	</tr>
+            	<tr>
+            		<td>klondike</td>
+            		<td>Klondike.*</td>
+            		<td>Klondike</td>
+            		<td>wml</td>
+            	</tr>
+            	<tr>
+            		<td>wml_generic</td>
+            		<td>.*WML.*|.*WAP.*|.*Wap.*|.*wml.*</td>
+            		<td>N/A</td>
+            		<td>wml</td>
+            	</tr>
+            	<tr>
+            		<td>vxml_generic</td>
+            		<td>.*VoiceXML.*</td>
+            		<td>N/A</td>
+            		<td>vxml</td>
+            	</tr>
+            	<tr>
+            		<td>nuance</td>
+            		<td>Nuance.*</td>
+            		<td>Nuance</td>
+            		<td>vxml</td>
+            	</tr>
+            </table>
+            </p>
+            </subsection>
+            <subsection name="Capabilities and Content Rendering">
+            <p>
+            The <code>media-type</code> is used to locate the appropriate decorations template for the given <code>media-type</code>.
+			See the <a href="../../guides/guide-portal-design.html">portal design guide</a> for more information.
+            </p>
+            </subsection>
+            <subsection name="Capabilities Implementation">
+            <p>
+            The <code>Capabilities</code> component derive a <code>CapabilityMap</code> from the information provided 
+            by the <code>User-Agent</code> request header:
+            <source>
+cm = capabilities.getCapabilityMap(agent);
+            </source>
+            </p>
+            <p>
+            This operation occurs at the very beginning of Jetspeed-2 request pipeline processing.  Once the 
+            <code>CapabilityMap</code> is retrieved, it is added to the Jetspeed-2 <code>org.apache.jetspeed.request.RequestContext</code>
+            and made available to the portal engine for processing the request.
+            </p>
+            <p>
+            The two pictures below describes the <code>Capabilities</code> interfaces and the relational database model
+            backing the implementation.<br/><br/>
+            <img src="images/capabilities-c.gif" border="0"/><br/><br/>
+            <img src="images/capabilities-db.gif" border="0"/>
+            </p>
+            </subsection>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-capability/index.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/images/spring-component-manager-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/images/spring-component-manager-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/images/spring-component-manager-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/index.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/index.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,46 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Component Manager</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Component Manager Overview">
+            <p>
+            The <code>ComponentManager</code> provides a layer of abstraction on top of the component framework that
+            will be used by Jetspeed-2.  This provides a flexible architecture where the component framework used can
+            easily be "swapped".  By default Jetspeed-2 uses the <a href="http://www.springframework.com">spring
+            framework</a>.
+            </p>
+            <subsection name="Component Manager with Spring">
+            <p>
+            The <code>ComponentManager</code> delegates the initialization of the component framework engine
+            to an implementation specific to the component framework as illustrated below.  The <code>SpringComponentManager</code>
+            is responsible for initializing the spring engine and calls to spring components within the Jetspeed-2 engines are wrapped
+            behind generic methods such as <code>getComponent()</code>.
+            </p>
+            <p>
+            <img src="images/spring-component-manager-c.gif" border="0"/><br/><br/>
+            </p>
+            </subsection>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-cm/index.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/deploy-tools.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/deploy-tools.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/deploy-tools.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/deploy-tools.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,89 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Deploy Tools</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="The Role of Jetspeed-2 Deploy Tools">
+        	<subsection name="JetspeedDeploy and the DeploymentManager">
+        	<p>
+        	<code>JetspeedDeploy</code> prepares portlet applications for deployment within Jetspeed-2. When a new
+        	portlet deployment event is registered, the <code>DeployPortletAppEventListener</code> invokes <code>JetspeedDeploy</code>
+        	to prepare the portlet application for deployment.
+        	<source>
+    new JetspeedDeploy(event.getPath(), toFile.getAbsolutePath(), stripLoggers);
+            </source>
+        	</p>
+        	<p>
+        	<code>JetspeedDeploy</code> copies the web application archives (.war) from the input directory to the
+        	output directory and parses the <code>web.xml</code>, <code>portlet.xml</code>, and <code>context.xml</code>
+        	to ensure their compliance with the Jetspeed-2 portal engine. 
+        	</p>
+        	<p>
+            <img src="images/jetspeed-deploy-c.gif" border="0"/><br/><br/>
+            </p>
+            <p>
+            <code>JetspeedDeploy</code> invokes the <code>JetspeedWebApplicationRewriter</code> to infuse the <code>web.xml</code>
+            with the <code>JetspeedContainer</code> servlet if it does not already exist:
+            <source>
+  &lt;servlet&gt;
+    &lt;servlet-name&gt;JetspeedContainer&lt;/servlet-name&gt;
+    &lt;display-name&gt;Jetspeed Container&lt;/display-name&gt;
+    &lt;description&gt;MVC Servlet for Jetspeed Portlet Applications&lt;/description&gt;
+    &lt;servlet-class&gt;org.apache.jetspeed.container.JetspeedContainerServlet&lt;/servlet-class&gt;
+    &lt;init-param&gt;
+      &lt;param-name&gt;contextName&lt;/param-name&gt;
+      &lt;param-value&gt;${portlet-application-name}&lt;/param-value&gt;
+    &lt;/init-param&gt;
+    &lt;load-on-startup&gt;0&lt;/load-on-startup&gt;
+  &lt;/servlet&gt;
+  ...
+  &lt;servlet-mapping&gt;
+    &lt;servlet-name&gt;JetspeedContainer&lt;/servlet-name&gt;
+    &lt;url-pattern&gt;/container/*&lt;/url-pattern&gt;
+  &lt;/servlet-mapping&gt;
+            </source>
+            </p>
+            <p>
+            In the same fashion, the <code>JetspeedDeploy</code> invokes the <code>JetspeedContextRewriter</code> to manipulate
+            a portlet application <code>context.xml</code> file.  For more information about Tomcat <code>context.xml</code>, 
+            see <a href="http://tomcat.apache.org/tomcat-5.0-doc/deployer-howto.html#Context%20descriptors">tomcat's documentation</a>.
+            </p>
+        	</subsection>
+            <subsection name="JetspeedDeploy Standalone Usage">
+            <p>
+            <code>JetspeedDeploy</code> can also be invoke through the command line:
+            <source>
+    java -jar jetspeed-deploy-tools-&lt;version&gt;.jar -s inputWarPath outputWarPath
+            </source>
+            where:
+            <ul>
+            <li><code>-s</code>: flag indicating whether or not to strip to loggers from the application. When the flag is present, the
+            loggers available in the application will be removed.</li>
+            <li><code>inputWarPath</code>: the path of the war to process.</li>
+            <li><code>outputWarPath</code>: the path of the processed war.</li>
+            </ul>
+            </p>  
+            </subsection>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/deploy-tools.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/app-server-mgr-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/app-server-mgr-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/app-server-mgr-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-event-listener-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-event-listener-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-event-listener-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-mgr-assembly.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-mgr-assembly.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-mgr-assembly.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-mgr-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-mgr-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/deployment-mgr-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/jetspeed-deploy-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/jetspeed-deploy-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/images/jetspeed-deploy-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/index.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/index.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,86 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Deploy Tools</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Jetspeed-2 Deployment Overview">
+        	<subsection name="Deploying Portlets in Jetspeed-2: An End User View">
+        	<p>
+        	Deploying custom portlets in Jetspeed-2 is simple.  Portlets are very similar to servlets.
+        	They require a deployment descriptor, <code>portlet.xml</code> which goes in <code>WEB-INF</code>
+            and need to be packaged in a war-like format. You can find quite a few example <code>portlet.xml</code> files within the Jetspeed-2 source tree.
+            For starters take a look at the one under <code>/portal/src/webapp/WEB-INF</code>.  In order to deploy a portlet, Jetspeed-2 requires the user
+            to follow those steps:
+            <ol>
+            <li>Build you portlet as a portlet application just as you would a web application.</li>
+            <li>Package your portlet application into a .war file.</li>
+            <li>Copy the .war file to Jetspeed's deployment directory, by default this is <code>WEB-INF/deploy</code>.
+            Jetspeed will take care of automatically deplying the portlet into the portlet registry and will also deploy the portlet
+            as a web application into the app server Jetspeed is deployed to.</li>
+            <li>The easiest way to view your portlet is to add an entry to the <code>default-page.psml</code> under <code>jetspeed/WEB-INF/pages</code>.
+            The id for the portlet fragment uses a unique combination of <code>${portlet.application.id}::${portlet.name}</code>
+            where <code>${portlet.application.id}</code> is the actual name of the war file (minus the ".war") that contains your portlet app and
+            <code>${portlet.name}</code> needs to be the value in the portlet name tags, <code>&lt;portlet-name&gt;MyPortlet&lt;/portlet-name&gt;</code>.
+            Changes to the psml will be picked up automatically and you should now be able to view your portlet!
+            </li>
+            </ol>
+			</p>        	
+        	</subsection>
+        	<subsection name="Portlet Deployment: How Does it Work?">
+        	<p>
+        	The component hierarchy below describes the assembly dependencies supporting Jetspeed-2 deployment functionality.
+        	</p>
+        	<p>
+            <img src="images/deployment-mgr-assembly.gif" border="0"/><br/><br/>
+            </p>
+        	<p>
+        	The <code>DeploymentManager</code> is configured with the properties specified in
+        	<code>WEB-INF/conf/jetspeed.properties</code>:
+        	<ul>
+        	<li><code>autodeployment.staging.dir</code>: The directory scanned for autodeployment.</li>
+        	<li><code>autodeployment.delay</code>: The frequency of the deploy directory scanning.</li>
+        	</ul>
+        	The <code>DeploymentManager</code> is also configured with 2 types of <code>DeploymentEventListener</code>:
+        	</p>
+        	<p>
+            <img src="images/deployment-event-listener-c.gif" border="0"/><br/><br/>
+            </p>
+            <p>
+            <ul>
+            <li>The <code>DeployPortletAppEventListener</code> handles the hot deployment of portlet applications.</li>
+            <li>The <code>DeployDecoratorEventListener</code>: handles the hot deployment of decorators. See 
+            <a href="../../guides/guide-decorators.html">guide to decorators</a> for more information.</li>
+            </ul>
+            </p>
+        	<p>
+        	Jetspeed-2 provides a <code>StandardDeploymentManager</code>.  The <code>StandardDeploymentManager</code> leverages
+        	a <code>FileSystemScanner</code> to scan for new assets to deploy.  It leverages Jetspeed-2 
+        	<a href="deploy-tools.html">deploy tools</a> to prepare portlet applications prior to deployment.
+            </p>
+            <p>
+            <img src="images/deployment-mgr-c.gif" border="0"/><br/><br/>
+            </p>
+            </subsection>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-deploy-tools/index.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/pipeline-assembly.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/pipeline-assembly.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/pipeline-assembly.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/pipeline-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/pipeline-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/pipeline-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/valve-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/valve-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/images/valve-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/index.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/index.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,38 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Portal</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Portal Overview">
+            <p>
+            The core portal components are:
+            <ul>
+            <li>The portal engine</li>
+            <li>The <a href="pipeline.html">request pipeline</a></li>
+            <li>The aggregation engine</li>
+            <li>The portlet container engine integration</li>
+            </ul>
+            </p>
+        </section>
+    </body>
+</document>

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/index.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/pipeline.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/pipeline.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/pipeline.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/pipeline.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,88 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Portal</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Request Pipeline">
+            <p>
+            In Jetspeed-2, a request pipeline performs individual operations to the request.
+            </p>
+            <subsection name="Pipeline Concepts">
+            <p>
+            A <code>Pipeline</code> is made of <code>Valves</code> chained together in a chain of responsibility pattern.
+            The <code>JetspeedPipeline</code> implementation assembles a ordered list of <code>Valves</code> that are
+            processed sequentially.
+            <br/><br/>
+            <img src="images/pipeline-c.gif" border="0"/><br/><br/>
+            <img src="images/pipeline-assembly.gif" border="0"/>
+            </p>	
+            </subsection>
+            <subsection name="Jetspeed-2 Valves">
+            <p>
+            Jetspeed-2 provides various type of <code>Valve</code> as illustrated below:<br/><br/>
+           	<img src="images/valve-c.gif" border="0"/><br/>
+			The above valves serve the following purpose:
+           	<table>
+            	<tr>
+            		<th>Valve Name</th>
+            		<th>Description</th>
+            	</tr>
+            	<tr>
+            		<td>ActionValve</td>
+            		<td>Check if <code>PortletAction</code> needs to be processed and process it, if required.
+            		Used in the portlet pipeline.</td>
+            	</tr>
+            	<tr>
+            		<td>AggregateValve</td>
+            		<td>Invokes all Layout components in render mode to aggregate the generated contents and
+            		send the result to the client.</td>
+            	</tr>
+            	<tr>
+            		<td>CapabilityValve</td>
+            		<td>Identifies the browser and adds a <code>CapabilityMap</code> to the <code>RequestContext</code>.</td>
+            	</tr>
+            	<tr>
+            		<td>CleanupValve</td>
+            		<td>Looks for JSP pages that were pushed onto the <code>org.apache.jetspeed.renderStack</code>
+					request attribute, and attempts to include them.</td>
+            	</tr>
+            	<tr>
+            		<td>LoginValidationValve</td>
+            		<td>Checks if a login attempt failed and determines the cause.</td>
+            	</tr>
+            	<tr>
+            		<td>PasswordCredentialValve</td>
+            		<td>Checks the PasswordCredential (only once) after a User is logged in and redirects to a 
+            		change password page if necessary.</td>
+            	</tr>
+            	<tr>
+            		<td>SecurityValve</td>
+            		<td>Authenticates the user or redirects to Login if necessary, adds the
+					authenticated Subject to the <code>RequestContext</code>.</td>
+            	</tr>
+            </table>
+           	</p>
+            </subsection>
+        </section>
+    </body>
+</document>

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-portal/pipeline.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/dao.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/dao.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/dao.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/dao.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,73 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 RDBMS</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Data Access Overview">
+            <p>
+            Jetspeed-2 RDBMS component provide some of level of abstraction from the underlying persistence mechanism.    
+            </p>
+            <subsection name="Data Access Using Object Relational Mapping">
+            <p>
+            Jetspeed-2 uses object relational mapping as the underlying technology for persistence.  By default, 
+            <a href="http://db.apache.org/ojb/">Apache OJB</a> is used as an ORM engine.  In order to minimize Jetspeed-2
+            OJB dependencies, the <code>InitablePersistenceBrokerDaoSupport</code> provides a layer of abstraction that minimizes
+            the dependencies on a specific ORM engine.  The class diagram below illustration the Jetspeed-2 implementation classes
+            that leverage <code>InitablePersistenceBrokerDaoSupport</code>:<br/>
+            <img src="images/persistence-broker-dao-c.gif" border="0"/>
+            </p>
+            <p>
+            The <code>InitablePersistenceBrokerDaoSupport</code> extends <code>org.springframework.orm.ojb.support.PersistenceBrokerDaoSupport</code>.
+            </p>
+            </subsection>
+            <subsection name="Spring ORM Support">
+            <p>
+            Spring's adds significant support when using the O/R mapping layer of your choice to create data access applications.  The 
+            <code>InitablePersistenceBrokerDaoSupport</code> extends spring layer of abstraction for persistence support, specifically the
+            OJB <a href="http://static.springframework.org/spring/docs/1.2.x/reference/orm.html#orm-ojb"><code>PersistenceBroker</code> API support</a>.
+            </p>
+            <p>
+            Using such a layer of abstraction has many advantages.  Some of the advantages outlined in Spring's documentation are:
+            <ul>
+            <li>Ease of testing. Spring's inversion of control approach makes it easy to swap the implementations and config locations of persistence manager instances,
+            JDBC DataSources, transaction managers, and mapper object implementations (if needed). This makes it much easier to isolate and test each piece of
+            persistence-related code in isolation.</li>
+            <li>Common data access exceptions. Spring can wrap exceptions from you O/R mapping tool of choice, converting them from proprietary (potentially checked) exceptions
+            to a common runtime DataAccessException hierarchy. This allows you to handle most persistence exceptions, which are non-recoverable, only in the appropriate layers,
+            without annoying boilerplate catches/throws, and exception declarations. You can still trap and handle exceptions anywhere you need to. Remember that JDBC exceptions
+            (including DB specific dialects) are also converted to the same hierarchy, meaning that you can perform some operations with JDBC within a consistent programming model.</li>
+            <li>General resource management. Spring application contexts can handle the location and configuration of persistence managers instances, JDBC DataSources, 
+            and other related resources. This makes these values easy to manage and change. Spring offers efficient, easy and safe handling of persistence resources.</li>
+			<li>Integrated transaction management. Spring allows you to wrap your O/R mapping code with either a declarative, AOP style method interceptor,
+			or an explicit 'template' wrapper class at the Java code level. In either case, transaction semantics are handled for you, and proper transaction handling (rollback, etc)
+			in case of exceptions is taken care of. As discussed below, you also get the benefit of being able to use and swap various transaction managers, without your ORM specific code being affected:
+			for example, between local transactions and JTA, with the same full services (such as declarative transactions) available in both scenarios. As an additional benefit,
+			JDBC-related code can fully integrate transactionally with the code you use to do O/R mapping. This is useful for data access that's not suitable for O/R mapping,
+			such as batch processing or streaming of BLOBs, which still needs to share common transactions with O/R mapping operations.</li>
+			<li>To avoid vendor lock-in, and allow mix-and-match implementation strategies.</li>
+			</ul>
+			</p>
+            </subsection>
+        </section>
+    </body>
+</document>

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/dao.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/images/connection-repository-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/images/connection-repository-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/images/connection-repository-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/images/persistence-broker-dao-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/images/persistence-broker-dao-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/images/persistence-broker-dao-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/index.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-rdbms/index.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,100 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 RDBMS</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="RDBMS Overview">
+            <p>
+            Jetspeed-2 RDBMS component provide a layer of abstraction from the persistence mechanism used by Jetspeed-2.
+            It provides facilities for datasource configuration as well as data access. 
+            </p>
+            <subsection name="Datasource Configuration">
+            <p>
+            Jetspeed-2 uses <a href="http://db.apache.org/ojb/">OJB</a> <code>PersistenceBroker</code> API as its default
+            persistence mechanism.  The <code>ConnectionRepositoryEntry</code> component configures OJB for Jetspeed-2 as well
+            as the properties available under <code>/etc/db-ojb</code> in the Jetspeed-2 source repository or <code>WEB-INF/classes</code>
+            in a deployed instance of Jetspeed-2.
+            </p>
+            <p>
+            The <code>datasource.xml</code> spring assembly configuration file configures <code>ConnectionRepositoryEntry</code> and is located
+            in <code>WEB-INF/assembly/boot</code>.
+            </p>
+            <p>
+            The <code>ConnectionRepositoryEntry</code> configures an entry in OJB's ConnectionRepository according to its properties.
+            The properties <code>driverClassName</code>, <code>url</code>, <code>username</code> and <code>password</code> are used
+			only if no <code>jndiName</code> is set, i.e. if the connection factory uses the driver to create data sources.  The platform
+			settings are derived from the configured  data source or database driver using OJB's <code>JdbcMetadataUtils</code> class.  The default
+			Jetspeed-2 <code>ConnectionRepositoryEntry</code> configuration expose a datasource.
+            <source>
+    &lt;bean id="JetspeedDS" class="org.apache.jetspeed.components.rdbms.ojb.ConnectionRepositoryEntry"&gt;
+      &lt;property name="jndiName"&gt;
+        &lt;value&gt;java:comp/env/jdbc/jetspeed&lt;/value&gt;
+      &lt;/property&gt;
+    &lt;/bean&gt;</source>
+            </p>
+            <p>
+            In order for OJB to be configured properly with Jetspeed-2, the <code>OJB.properties</code> file (located under
+            <code>/etc/db-ojb/OJB.properties</code> in the source tree and <code>WEB-INF/classes</code> in the deployed application)
+            must set:
+            <source>
+    ConnectionManagerClass=org.apache.jetspeed.components.rdbms.ojb.ConnectionManagerImpl</source>
+            instead of:
+            <source>
+    ConnectionFactoryClass=org.apache.ojb.broker.accesslayer.ConnectionFactoryManagedImpl</source>
+            </p>
+            <p>
+            A class diagram of <code>ConnectionRepositoryEntry</code> and <code>ConnectionManagerImpl</code> is
+            provided below:<br/>
+            <img src="images/connection-repository-c.gif" border="0"/>
+            </p>
+            </subsection>
+            <subsection name="OJB Datasource Configuration">
+            <p>
+            The bean name provided in <code>datasource.xml</code> must match the <code>jdbc-connection-descriptor</code>
+            <code>jcd-alias</code> property (by default <code>JetspeedDS</code>) located in OJB <code>repository_database.xml</code>
+            as illustrated below.
+            <source>
+    &lt;jdbc-connection-descriptor
+        jcd-alias="JetspeedDS"
+        default-connection="true"
+        batch-mode="false"&gt;</source>
+            </p>
+            </subsection>
+            <subsection name="Jetspeed-2 Datasource Configuration in Tomcat">
+            <p>
+            Jetspeed-2 configure the following datasource in Tomcat.  In the source tree, the Tomcat datasource configuration
+            is located under <code>/etc/conf/tomcat</code>.  When deployed Jetspeed-2 in a Tomcat instance, the Jetspeed-2
+            datasource configuration are deployed under <code>${tomcat_home}/conf/Catalina/localhost/jetspeed.xml</code>. If a different
+            portal name is being used for Jetspeed-2, the configuration file will be named accordingly.
+            <source>
+    &lt;Resource name="jdbc/jetspeed" auth="Container"
+                 factory="org.apache.commons.dbcp.BasicDataSourceFactory"
+                 type="javax.sql.DataSource" username="" password=""
+                 driverClassName="org.apache.derby.jdbc.EmbeddedDriver"
+                 url="jdbc:derby:/tmp/productiondb;create=true"
+                 maxActive="100" maxIdle="30" maxWait="10000"/&gt;</source>
+            </p>
+            </subsection>
+        </section>
+    </body>
+</document>

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/portlet-search.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/portlet-search.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/portlet-search.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/searchengine-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/searchengine-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/searchengine-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/searchhandlers-c.gif
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/searchhandlers-c.gif?rev=722405&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/images/searchhandlers-c.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/index.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/index.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,83 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Search</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Search Overview">
+            <p>
+            Jetspeed-2 provides an integration with the popular <a href="http://lucene.apache.org/">Apache Lucene</a>, 
+            a high-performance, full-featured text search engine library written entirely in Java; a technology suitable
+            for nearly any application that requires full-text search, especially cross-platform.. 
+            </p>
+            <subsection name="SearchEngine Overview">
+            <p>
+            Jetspeed-2 provides a <code>SearchEngine</code> component configured as a spring component.  The <code>SearchEngine</code>
+            component is configured in <code>WEB-INF/assembly/search.xml</code>.  The default implementation based on the embedded Lucene
+            search engine must specify the location of the search index file, the name of the analyzer class (if null the default analyzer
+            <code>StandardAnalyzer</code> is used), whether to optimize after update and the <code>HandlerFactory</code>:
+            <source>
+    &lt;bean id="org.apache.jetspeed.search.SearchEngine"
+  	  class="org.apache.jetspeed.search.lucene.SearchEngineImpl"&gt;
+  	  &lt;constructor-arg index="0"&gt;&lt;value&gt;${applicationRoot}/WEB-INF/search_index&lt;/value&gt;&lt;/constructor-arg&gt;
+  	  &lt;constructor-arg index="1"&gt;&lt;null /&gt;&lt;/constructor-arg&gt;
+  	  &lt;constructor-arg type="boolean"&gt;&lt;valu&gt;true&lt;/value&gt;&lt;/constructor-arg&gt;
+  	  &lt;constructor-arg&gt;&lt;ref bean="org.apache.jetspeed.search.HandlerFactory"/&gt;&lt;/constructor-arg&gt;
+    &lt;/bean&gt;</source>
+    		</p>
+    		<p>
+    		The <code>HandlerFactory</code> provides the <code>SearchEngine</code> with a list of <code>ObjectHandler</code>
+    		that will handle the various document types supported by Jetspeed-2 for search.  By default, Jetspeed-2 supports
+    		portlet instances and portlet definitions as searchable entities.  When portlets are registered to the portal,
+    		<code>searchEngine.add(pa)</code> and <code>searchEngine.add(pa.getPortletDefinitions())</code> are invoked.  This
+    		action updates the Jetspeed-2 search index.  For more information on how portlets are registered to the search engine,
+    		see <code>org.apache.jetspeed.tools.pamanager.PortletApplicationManager</code>.
+            <br/>
+            <img src="images/searchengine-c.gif" border="0"/>
+            </p>
+            </subsection>
+            <subsection name="Document Handlers Overview">
+            <p>
+            Document Handlers are responsible for the parsing of a specific document type in order to index the relevant document fields.
+            </p>
+            <p>
+            Jetspeed-2 provides 2 document handlers implementations responsible for parsing parsing the documents supported by Jetspeed-2
+            as <code>org.apache.jetspeed.search.ParsedObject</code>.  The <code>ParsedObject</code> specify the list of fields
+            and documents supported by Jetspeed-2 that can then be added to <code>org.apache.lucene.document.Document</code> and
+            written to the index through <code>indexWriter.addDocument(doc)</code> operation of the 
+            <a href="http://lucene.apache.org/java/docs/api/index.html"><code>IndexWriter</code></a>.
+            </p>
+            <p>
+            By default, Jetspeed-2 can index portlet applications and portlet definitions respectively through the
+            <code>PortletApplicationHandler</code> and <code>PortletDefinitionHandler</code>.
+            <br/>
+            <img src="images/searchhandlers-c.gif" border="0"/>
+            </p>
+            </subsection>
+            <subsection name="An Extensible Framework">
+            <p>
+            As most components in Jetspeed-2, the search engine can easily be extended to support addional document types.
+            </p>
+            </subsection>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/index.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/using-search.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/using-search.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/using-search.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/using-search.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,44 @@
+<?xml version="1.0" ?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed-2 Search</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Using Jetspeed Search Engine">
+            <p>
+            Jetspeed-2 <code>SearchEngine</code> exposes a <code>search</code> operation returning <code>SearchResults</code>.
+            The <code>SearchResult</code> can be iterated through to display the result of the search.
+            </p>
+            <subsection name="Portlet Search">
+            <p>
+            Jetspeed-2 <code>SearchEngine</code> is used by the <code>PortletApplicationBrowser</code> portlet to search
+            and retrieve portlet according to a given criteria.
+            <br/>
+            <img src="images/portlet-search.gif" border="0" />
+            </p>
+            <p>
+            Performing a search for &quot;security&quot; returns all the matching portlets and portlet definitions.
+            </p>
+            </subsection>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-search/using-search.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/arch.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/arch.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/arch.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/arch.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,59 @@
+<?xml version="1.0"?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed 2 Security - Architecture Overview</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Architecture Overview">
+            <p>
+                Jetspeed 2 security leverages J2EE authentication and authorization standards for both authentication 
+                and authorization through the implementation of a default <code>LoginModule</code> and a default authorization
+                <code>Policy</code>.
+            </p>
+            <p>
+                Authentication establishes the identity of the user and populates the <code>Subject</code> with all
+                the user principals.  In a portal context, the populated <code>Subject</code> is added to the session
+                in the <code>org.apache.jetspeed.security.SecurityValve</code> implementation.  The <code>Subject</code>
+                principals are then used to authorize the user's access to a given resource.  It leverages JAAS authorization
+                by checking the user's permission with the
+                <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/security/AccessController.html">AccessController</a>.  More details
+                on authorization are provided in the <a href="atz-jaas.html">JAAS authorization section</a> of this documentation.
+            </p>
+            <p>
+                The following diagram describes the high level security architecture:
+            </p>
+            <p align="center">
+                <img src="images/arch-overview.gif" border="0" />
+            </p>
+            <p>
+                Configuration files for each component areas are specified.  For more information, go to the documentation
+                section on <a href="config.html">configuration</a>.
+            </p>
+            <p>
+                Jetspeed security architecture is fully JAAS compliant.  Developers can replace Jetspeed security
+                architecture with their own <code>LoginModule</code> and <code>Policy</code> implementation.  Jetspeed
+                implementation provides management programming and user interfaces as well as an SPI model to facilitate
+                its extension.
+            </p>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/arch.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/arch.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/atn-spi.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/atn-spi.xml?rev=722405&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/atn-spi.xml (added)
+++ portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/atn-spi.xml Tue Dec  2 00:53:22 2008
@@ -0,0 +1,93 @@
+<?xml version="1.0"?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<document>
+    <properties>
+        <title>Jetspeed 2 Security - Authentication SPI</title>
+        <authors>
+            <person name="David Le Strat" email="dlestrat@apache.org" />
+        </authors>
+    </properties>
+    <body>
+        <section name="Authentication SPI Overview">
+            <p>
+                The authentication SPI provides the implementation for managing user principals and their credentials and provides the underlying
+                <code>UserManager</code>
+                coarsed service implementation.
+            </p>
+            <p>
+                The authentication SPI also provides a mechanism for managing users across multiple datastore. The class diagram below describes how the
+                authentication SPI relates to the
+                <code>UserManager</code>
+                .
+            </p>
+            <p>
+                <img src="images/atn-spi-arch-c.gif" border="0" />
+            </p>
+        </section>
+        <section name="Authentication SPI Components">
+            <p>The authentication SPI implements the following components:</p>
+            <table>
+                <tr>
+                    <th>Component</th>
+                    <th>Description</th>
+                </tr>
+                <tr>
+                    <td>
+                        <code>AuthenticationProviderProxy</code>
+                    </td>
+                    <td>
+                        A proxy to the various
+                        <code>AuthenticationProvider</code>
+                        implementations. The
+                        <code>AuthenticationProviderProxy</code>
+                        is responsible of invoking the correct
+                        <code>AuthenticationProvider</code>
+                        to authenticate or manage a specific user against a specific data store.
+                    </td>
+                </tr>
+                <tr>
+                    <td>
+                        <code>AuthenticationProvider</code>
+                    </td>
+                    <td>
+                        Exposes a specific authentication and user management services implementation.  Jetspeed 2
+                        provides 2 implementations: RDBMS and LDAP.  Multiple authentication providers 
+                        can be provided through configuration.  For more information,
+                        see the <a href="config.html#security-providers_xml">security providers</a> configuration.
+                    </td>
+                </tr>
+                <tr>
+                    <td>
+                        <code>CredentialHandler</code>
+                    </td>
+                    <td>
+                        See <a href="config.html#security-spi-atn_xml">security-spi-atn.xml</a> configuration.
+                    </td>
+                </tr>
+                <tr>
+                    <td>
+                        <code>UserSecurityHandler</code>
+                    </td>
+                    <td>
+                        See <a href="config.html#security-spi-atn_xml">security-spi-atn.xml</a> configuration.
+                    </td>
+                </tr>
+            </table>
+        </section>
+    </body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/atn-spi.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JS2-871-pluto-2.0-upgrade/src/site/xdoc/components/jetspeed-security/atn-spi.xml
------------------------------------------------------------------------------
    svn:keywords = Id



---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


Mime
View raw message