Author: buildbot
Date: Fri May 11 20:48:01 2012
New Revision: 817291
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/main.pageCache
websites/production/cxf/content/tomcat.html
Modified: websites/production/cxf/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/tomcat.html
==============================================================================
--- websites/production/cxf/content/tomcat.html (original)
+++ websites/production/cxf/content/tomcat.html Fri May 11 20:48:01 2012
@@ -140,12 +140,18 @@ Apache CXF -- Tomcat
<p>This page describes how to enable Federation in Tomcat. This Tomcat
instance acts as the Relying Party which means it validates the incoming
SignInResponse which has been created by the Identity Provider (IDP) server.</p>
<h3><a shape="rect" name="Tomcat-Installation"></a>Installation</h3>
-<p>tbd</p>
+<p>You can either build the plugin on your own or download the package here
(tbd). If you have built the plugin on your own you'll find the required
libraries in plugins/tomcat/target/...zip-with-dependencies.zip</p>
+
+
+<ol><li>Create sub-directory <tt>fediz</tt> in
<tt>${catalina.home}/lib</tt></li><li>Update calatina.properties in
${catalina.home}/conf<br clear="none">
+add the previously created directory to the common loader:<br clear="none">
+<tt>common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,${catalina.home}/lib/fediz/*.jar</tt></li><li>Deploy
the libraries to the directory created in (1)</li></ol>
-<h3><a shape="rect" name="Tomcat-Configuration"></a>Configuration</h3>
+<h3><a shape="rect" name="Tomcat-Configuration"></a>Configuration</h3>
+
<p>The current release of the federation plugin requires to configure the
FederationAuthenticator of Fediz like any other Valve in Tomcat which is
described here <a shape="rect" class="external-link"
href="http://tomcat.apache.org/tomcat-7.0-doc/config/valve.html";>here</a>.</p>
<p>A valve can be configured on different levels like <em>Host</em> or
<em>Context</em>. The Fediz configuration file allows to configure all servlet
contexts in one file or choose one file per Servlet Context. If you choose to
have one Fediz configuration file per Servlet Context then you must configure
the FederationAuthenticator on the <em>Context</em> level otherwise on the
<em>Host</em> level in the Tomcat configuration file <em>server.xml</em></p>
@@ -154,32 +160,40 @@ Apache CXF -- Tomcat
<p>You can either configure the context in the server.xml or in
META-INF/context.xml as part of your WAR file.</p>
<h5><a shape="rect"
name="Tomcat-METAINF%2Fcontext.xml"></a>META-INF/context.xml</h5>
-
-<p> <Context> <br clear="none">
- <Valve
className="org.apache.cxf.fediz.tomcat.FederationAuthenticator"<br clear="none">
- configFile="conf/Fediz_config.xml" /><br clear="none">
- </Context> </p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-xml">
+ <span class="code-tag"><Context></span>
+ <Valve className=<span
class="code-quote">"org.apache.cxf.fediz.tomcat.FederationAuthenticator"</span>
+ configFile=<span class="code-quote">"conf/Fediz_config.xml"</span> />
+ <span class="code-tag"></Context></span>
+</pre>
+</div></div>
<h5><a shape="rect" name="Tomcat-Hostlevelinserver.xml"></a>Host level in
server.xml</h5>
-<p> ...<br clear="none">
- <Host name="localhost" appBase="webapps"<br clear="none">
- unpackWARs="true" autoDeploy="true"<br clear="none">
- xmlValidation="false" xmlNamespaceAware="false"><br clear="none">
- <Valve
className="org.apache.cxf.fediz.tomcat.FederationAuthenticator"<br clear="none">
- configFile="conf/Fediz_config.xml" /><br clear="none">
- </Host><br clear="none">
- ...</p>
-
-<h5><a shape="rect" name="Tomcat-Contextlevelinserver.xml"></a>Context level
in server.xml</h5>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-xml">
+ <Host name=<span class="code-quote">"localhost"</span> appBase=<span
class="code-quote">"webapps"</span>
+ unpackWARs=<span class="code-quote">"true"</span> autoDeploy=<span
class="code-quote">"true"</span>>
+ <Valve className=<span
class="code-quote">"org.apache.cxf.fediz.tomcat.FederationAuthenticator"</span>
+ configFile=<span class="code-quote">"conf/Fediz_config.xml"</span>
/>
+ <span class="code-tag"></Host></span>
+</pre>
+</div></div>
+<p> <Host name="localhost" appBase="webapps"</p>
-<p> ...<br clear="none">
- <Context path="/fedizhelloworld" docBase="fedizhelloworld"><br
clear="none">
- <Valve
className="org.apache.cxf.fediz.tomcat.FederationAuthenticator"<br clear="none">
- configFile="conf/Fediz_config.xml" /><br clear="none">
- </Context><br clear="none">
- ...</p>
+<p> unpackWARs="true" autoDeploy="true"></p>
+<h5><a shape="rect" name="Tomcat-Contextlevelinserver.xml"></a>Context level
in server.xml</h5>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<pre class="code-xml">
+ <span class="code-tag"><Context path=<span
class="code-quote">"/fedizhelloworld"</span> docBase=<span
class="code-quote">"fedizhelloworld"</span>></span>
+ <Valve className=<span
class="code-quote">"org.apache.cxf.fediz.tomcat.FederationAuthenticator"</span>
+ configFile=<span class="code-quote">"conf/Fediz_config.xml"</span> />
+ <span class="code-tag"></Context></span>
+</pre>
+</div></div>
+<p>The Fediz configuration file is container independent and described
here.</p>
</div>
</div>
