Author: jasha
Date: Fri May 11 20:09:39 2012
New Revision: 1337354
URL: http://svn.apache.org/viewvc?rev=1337354&view=rev
Log:
CMS commit to rave by jasha
Modified:
rave/site/trunk/content/documentation/application-containers.mdtext
Modified: rave/site/trunk/content/documentation/application-containers.mdtext
URL:
http://svn.apache.org/viewvc/rave/site/trunk/content/documentation/application-containers.mdtext?rev=1337354&r1=1337353&r2=1337354&view=diff
==============================================================================
--- rave/site/trunk/content/documentation/application-containers.mdtext
(original)
+++ rave/site/trunk/content/documentation/application-containers.mdtext Fri May
11 20:09:39 2012
@@ -16,16 +16,41 @@ Notice: Licensed to the Apache Softwa
specific language governing permissions and limitations
under the License.
-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.
+The default distribution of Apache Rave contains Apache Tomcat 6 as
application server.
+For local development the [Cargo Maven 2 plugin][1] is configured to use
Tomcat 6.
+
+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.
+
+## Custom Apache Tomcat 6 installation
+To install Apache Rave inside an existing Tomcat 6 instance, make the
following changes:
+
+### Increase memory
+Create `bin/setenv.sh` with the following contents:
+
+ #!/bin/sh
+ export JAVA_OPTS="$JAVA_OPTS -Xmx512m -XX:MaxPermSize=256m"
+
+### Add more sources for the classpath
+Modify conf/catalina.properties
+
+
common.loader=${catalina.base}/common/classes,${catalina.base}/common/lib/*.jar,${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar
+
+
shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar
+
+### Delete default contexts
+In the webapp folder delete existing `ROOT` and `docs` folders. The OpenSocial
container (Shindig) needs the `ROOT` context.
+
+### Copy artifacts
+
+Copy the `shared/lib` folder plus the contents of the `webapp` folder to your
Tomcat installation.
## Apache Tomcat 7
-No changes are needed for Tomcat 7
+See the instructions for Tomcat 6.
## Jetty 6
### <a id="jetty-welcome-page"></a>Welcome page redirect
-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 [uses the `JspServlet`][1] for the welcome page, Apache Rave
uses `org.springframework.web.servlet.DispatcherServlet` from the Spring
Framework.
+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 [uses the `JspServlet`][2] for the welcome page, Apache Rave
uses `org.springframework.web.servlet.DispatcherServlet` from the Spring
Framework.
In order to let Jetty use the DispatcherServlet:
@@ -45,4 +70,5 @@ Add a `root.xml` to the contexts folder
## Jetty 7
The [Welcome page redirect](#jetty-welcome-page) configuration is also needed
for Jetty 7. Jetty 7 does not need the extra configuration for the root context.
-[1]:http://docs.codehaus.org/display/JETTY/Welcome+files+not+working
\ No newline at end of file
+[1]:http://docs.codehaus.org/display/JETTY/Welcome+files+not+working
+[2]:http://cargo.codehaus.org/Maven2+plugin
\ No newline at end of file
