Author: buildbot
Date: Fri May 11 20:09:44 2012
New Revision: 817281
Log:
Staging update by buildbot for rave
Modified:
websites/staging/rave/trunk/content/ (props changed)
websites/staging/rave/trunk/content/documentation/application-containers.html
Propchange: websites/staging/rave/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri May 11 20:09:44 2012
@@ -1 +1 @@
-1337349
+1337354
Modified:
websites/staging/rave/trunk/content/documentation/application-containers.html
==============================================================================
---
websites/staging/rave/trunk/content/documentation/application-containers.html
(original)
+++
websites/staging/rave/trunk/content/documentation/application-containers.html
Fri May 11 20:09:44 2012
@@ -67,14 +67,37 @@
<div id="content">
<h1 class="title">Application containers</h1>
- <p>The default distribution of Apache Rave contains Apache Tomcat as
application server.
-For local development the Maven Cargo plugin is configured to use Tomcat 6.
Apache Rave should work with other application containers as well, but
sometimes extra configuration is necessary.</p>
+ <p>The default distribution of Apache Rave contains Apache Tomcat 6 as
application server.
+For local development the <a
href="http://docs.codehaus.org/display/JETTY/Welcome+files+not+working";>Cargo
Maven 2 plugin</a> is configured to use Tomcat 6. </p>
+<p>Apache Rave should work with other application containers as well, but
sometimes extra configuration is necessary. If your application container isn't
mentioned on this page, it only means we have not tested it yet. </p>
+<h2 id="custom-apache-tomcat-6-installation">Custom Apache Tomcat 6
installation</h2>
+<p>To install Apache Rave inside an existing Tomcat 6 instance, make the
following changes:</p>
+<h3 id="increase-memory">Increase memory</h3>
+<p>Create <code>bin/setenv.sh</code> with the following contents:</p>
+<table class="codehilitetable"><tr><td class="linenos"><div
class="linenodiv"><pre>1
+2</pre></div></td><td class="code"><div class="codehilite"><pre><span
class="c">#!/bin/sh</span>
+<span class="nb">export </span><span class="nv">JAVA_OPTS</span><span
class="o">=</span><span class="s2">"$JAVA_OPTS -Xmx512m
-XX:MaxPermSize=256m"</span>
+</pre></div>
+</td></tr></table>
+
+<h3 id="add-more-sources-for-the-classpath">Add more sources for the
classpath</h3>
+<p>Modify conf/catalina.properties</p>
+<div class="codehilite"><pre>common.loader=<span class="cp">${</span><span
class="n">catalina</span><span class="o">.</span><span
class="n">base</span><span class="cp">}</span>/common/classes,<span
class="cp">${</span><span class="n">catalina</span><span
class="o">.</span><span class="n">base</span><span
class="cp">}</span>/common/lib/*.jar,<span class="cp">${</span><span
class="n">catalina</span><span class="o">.</span><span
class="n">base</span><span class="cp">}</span>/lib,<span
class="cp">${</span><span class="n">catalina</span><span
class="o">.</span><span class="n">base</span><span
class="cp">}</span>/lib/*.jar,<span class="cp">${</span><span
class="n">catalina</span><span class="o">.</span><span
class="n">home</span><span class="cp">}</span>/lib,<span
class="cp">${</span><span class="n">catalina</span><span
class="o">.</span><span class="n">home</span><span class="cp">}</span>/lib/*.jar
+
+shared.loader=<span class="cp">${</span><span class="n">catalina</span><span
class="o">.</span><span class="n">base</span><span
class="cp">}</span>/shared/classes,<span class="cp">${</span><span
class="n">catalina</span><span class="o">.</span><span
class="n">base</span><span class="cp">}</span>/shared/lib/*.jar
+</pre></div>
+
+
+<h3 id="delete-default-contexts">Delete default contexts</h3>
+<p>In the webapp folder delete existing <code>ROOT</code> and
<code>docs</code> folders. The OpenSocial container (Shindig) needs the
<code>ROOT</code> context.</p>
+<h3 id="copy-artifacts">Copy artifacts</h3>
+<p>Copy the <code>shared/lib</code> folder plus the contents of the
<code>webapp</code> folder to your Tomcat installation. </p>
<h2 id="apache-tomcat-7">Apache Tomcat 7</h2>
-<p>No changes are needed for Tomcat 7</p>
+<p>See the instructions for Tomcat 6.</p>
<h2 id="jetty-6">Jetty 6</h2>
-<h3 id="wzxhzdk1wzxhzdk2welcome-page-redirect"><a
id="jetty-welcome-page"></a>Welcome page redirect</h3>
-<p>Apache Rave works with Jetty 7, but extra configuration is needed to
redirect the user from http://localhost:8080 to the login page on
http://localhost:8080/portal/login.
-By default Jetty <a
href="http://docs.codehaus.org/display/JETTY/Welcome+files+not+working";>uses
the <code>JspServlet</code></a> for the welcome page, Apache Rave uses
<code>org.springframework.web.servlet.DispatcherServlet</code> from the Spring
Framework. </p>
+<h3 id="wzxhzdk3wzxhzdk4welcome-page-redirect"><a
id="jetty-welcome-page"></a>Welcome page redirect</h3>
+<p>Apache Rave works with Jetty 7, but extra configuration is needed to
redirect the user from <code>http://localhost:8080</code> to the login page on
<code>http://localhost:8080/portal/login</code>.
+By default Jetty <a href="http://cargo.codehaus.org/Maven2+plugin";>uses the
<code>JspServlet</code></a> for the welcome page, Apache Rave uses
<code>org.springframework.web.servlet.DispatcherServlet</code> from the Spring
Framework. </p>
<p>In order to let Jetty use the DispatcherServlet:</p>
<ul>
<li>Modify the <code>webdefault.xml</code></li>
