Return-Path: 
 <tomcat-dev-return-9179-qmlist-jakarta-archive-tomcat-dev=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-tomcat-dev-archive@apache.org
Received: (qmail 40724 invoked from network); 19 Apr 2002 00:35:16 -0000
Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131)
  by daedalus.apache.org with SMTP; 19 Apr 2002 00:35:16 -0000
Received: (qmail 4606 invoked by uid 97); 19 Apr 2002 00:35:18 -0000
Delivered-To: qmlist-jakarta-archive-tomcat-dev@jakarta.apache.org
Received: (qmail 4588 invoked by uid 97); 19 Apr 2002 00:35:18 -0000
Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:tomcat-dev-unsubscribe@jakarta.apache.org>
List-Subscribe: <mailto:tomcat-dev-subscribe@jakarta.apache.org>
List-Help: <mailto:tomcat-dev-help@jakarta.apache.org>
List-Post: <mailto:tomcat-dev@jakarta.apache.org>
List-Id: "Tomcat Developers List" <tomcat-dev.jakarta.apache.org>
Reply-To: "Tomcat Developers List" <tomcat-dev@jakarta.apache.org>
Delivered-To: mailing list tomcat-dev@jakarta.apache.org
Received: (qmail 4536 invoked from network); 19 Apr 2002 00:35:17 -0000
Sender: dlr@despot.finemaltcoding.com
To: tomcat-dev@jakarta.apache.org
Reply-To: dlr@finemaltcoding.com
Mail-Followups-To: dlr@finemaltcoding.com
Subject: [PATCH/COMMENTS] Automatic Application Deployment and Host.liveDeploy
Content-Type: text/plain; charset=US-ASCII
From: Daniel Rall <dlr@finemaltcoding.com>
Date: Thu, 18 Apr 2002 17:35:22 -0700
Message-ID: <m3pu0wh6et.fsf@despot.finemaltcoding.com>
Lines: 51
User-Agent: Gnus/5.090004 (Oort Gnus v0.04) XEmacs/21.1 (Cuyahoga Valley)
MIME-Version: 1.0
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

Added missing closing paren.

Index: host.xml
===================================================================
RCS file: /home/cvspublic/jakarta-tomcat-4.0/webapps/tomcat-docs/config/host.xml,v
retrieving revision 1.12
diff -u -u -r1.12 host.xml
--- host.xml	20 Mar 2002 12:33:01 -0000	1.12
+++ host.xml	19 Apr 2002 00:11:30 -0000
@@ -245,7 +245,7 @@
     <p>If you are using the standard <strong>Host</strong> implementation,
     the following actions take place automatically when Catalina is first
     started, if the <code>autoDeploy</code> property is set to
-    <code>true</code> (which is the default value:</p>
+    <code>true</code> (which is the default value):</p>
     <ul>
     <li>Any XML file in this directory is assumed to contain a
         <a href="context.html">Context</a> element (and its associated

This "Automatic Application Deployment" section should also mention
the new liveDeploy flag.  This flag must be used in conjunction with
autoDeploy if the name of your web application directory differs from
the name of the Context where you mount your web app (when you want
_only_ the Context entries defined in server.xml to be deployed).

Consider the following layout:

$CATALINA_BASE/
  webapps/
    secretapp/

...with a server.xml like:

      <Host name="mysite.com" appBase="webapps" autoDeploy="false">
        ...
        <Context path="mycontext" docBase="secretapp" reloadable="true"/>
      </Host>

The initial startup occurs, and secretapp is mounted at "/mycontext".
After the initial startup, if I haven't included liveDeploy="false" in
my <Host> entry, Catalina's live deployment thread wanders over, spots
the "secretapp" directory under my Host's appBase, and decides to load
it as another web app (even though it has already been loaded and
mounted at "/mycontext").  Wasted resources aside, this can be painful
(example: consider the case where your web app's servlets open TCP
listener sockets).

Definitely worth mentioning in the doc, and perhaps protecting against
in some fashion in the code (if possible).

- Dan

--
To unsubscribe, e-mail:   <mailto:tomcat-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:tomcat-dev-help@jakarta.apache.org>