svn commit: r1337349 - /rave/site/trunk/content/documentation/application-containers.mdtext

[ja...@apache.org]

Author: jasha
Date: Fri May 11 19:56:47 2012
New Revision: 1337349

URL: http://svn.apache.org/viewvc?rev=1337349&view=rev
Log:
Documentation for application containers. 

Added:
    rave/site/trunk/content/documentation/application-containers.mdtext   (with props)

Added: rave/site/trunk/content/documentation/application-containers.mdtext
URL: http://svn.apache.org/viewvc/rave/site/trunk/content/documentation/application-containers.mdtext?rev=1337349&view=auto
==============================================================================
--- rave/site/trunk/content/documentation/application-containers.mdtext (added)
+++ rave/site/trunk/content/documentation/application-containers.mdtext Fri May 11 19:56:47 2012
@@ -0,0 +1,48 @@
+Title: Application containers
+Notice:    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.
+
+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.
+
+## Apache Tomcat 7
+No changes are needed for Tomcat 7
+
+## 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. 
+
+In order to let Jetty use the DispatcherServlet:
+
+* Modify the `webdefault.xml`
+* Go to entry for the servlet org.eclipse.jetty.servlet.DefaultServlet
+* Change the value of the init parameter `welcomeServlets` to `true`.
+
+### Root context for Apache Shindig
+The OpenSocial container (Apache Shindig) runs under the root context. In Jetty 6 extra configuration is needed for the root context.
+
+Add a `root.xml` to the contexts folder which will have a simple context defined for Shindig with the following entries:
+
+    <Set name="contextPath">/</Set>
+    <Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/root</Set>
+
+
+## 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

Propchange: rave/site/trunk/content/documentation/application-containers.mdtext
------------------------------------------------------------------------------
    svn:eol-style = native