Update the Tomcat distribution so that SCA contributions can be deployed to exsiting Hosts instead of running in the Tuscany webapp. This means they run just like a regular web application and can be managed with the usual Tomcat admin and use all the usual Tomcat Host and Context features. Also update to configure the domain from the context so the domain nad be customized fro the Tomcat instance and each contribution via a context parameter. That removes the need for the singleton install option so that is removed. Also update the install page to have a bit of text about whats going on in the intsall

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@887223 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 33 insertions, 1 deletions

diff --git a/sca-java-2.x/trunk/distribution/tomcat/tomcat-war/src/main/webapp/installer.jsp b/sca-java-2.x/trunk/distribution/tomcat/tomcat-war/src/main/webapp/installer.jsp
index a6c3e4acaa..355976676b 100644
--- a/sca-java-2.x/trunk/distribution/tomcat/tomcat-war/src/main/webapp/installer.jsp
+++ b/sca-java-2.x/trunk/distribution/tomcat/tomcat-war/src/main/webapp/installer.jsp
@@ -48,7 +48,6 @@
        <B>Install Tuscany</B><BR>

        To install Tuscany into Tomcat, click:

                 <form action='installer' method='post'>

-                <input type='checkbox' name='singleton' value='true'>The Tuscany runtime is shared by all web applications if checked.<p>

                 <input type='submit' name='action' value='Install'>

                 </form>

        <BR>

@@ -70,5 +69,38 @@
     <% }%>

     </B> 

 

+

+    <p>

+    <h2>What does this do?</h2>

+

+     This Tuscany install makes two updates to Tomcat:

+     <UL>

+       <LI>copies the jars from the tomcat-lib directory in this webapp into the Tomcat lib directory 

+       <LI>updates the Tomcat conf/server.xml to include a &lt;Listener&gt; definition for Tuscany

+     </UL>

+     Those changes cause the Tuscany listener to be called at Tomcat startup and that locates all the Host

+     defiinitions and patches them to use the TuscanyStandardContext. This enables support for deploying

+     SCA enabled webapps and plain SCA jar, zip, or folder contributions to the Host in the same way 

+     that .war files are deployed. 

+    <p>

+    The SCA domain used for running the contributions defaults to "vm:default". This can be configured 

+    by using an initilization parameter, most easiliy by defining that parameter in a context.xml file.

+    The Tomcat file conf/context.xml file defines the global defaults so that can be used for setting the 

+    deafult domain for all SCA contributions. Individual contributions can also use their own context.xml

+    files to override that default. 

+    See the <a href="http://tomcat.apache.org/tomcat-6.0-doc/config/context.html">Tomcat doc</a> for more information on using context.xml files. 

+    <p>

+    An example of setting the domain as a context.xml parameter:

+       <br>&lt;Context&gt;

+          <br>. . .

+          <br>&lt;Parameter name="org.apache.tuscany.sca.defaultDomainURI" value="tribes:myDomain" override="false"/&gt;

+          <br>. . .

+       <br>&lt;/Context&gt;

+    <p>

+    For more information visit the Tuscany website page on <a href="http://tuscany.apache.org/tuscany-tomcat-distribution.html">Tomcat Integration</a>.

+    <p>

+    Note also that this is work in progress so is liable to change as Tuscany 2.0 is developed. Feedback is welcome and appreciated so if you've any comments or requests on this Tomcat integration please email <href="mailto:dev@tuscany.apache.org">dev@tuscany.apache.org</a>.

+    <p>

+

   </body>

 </html>