You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by re...@apache.org on 2003/07/30 20:37:06 UTC
cvs commit: jakarta-tomcat-catalina/webapps/docs deployer-howto.xml html-manager-howto.xml manager-howto.xml
remm 2003/07/30 11:37:06
Modified: webapps/docs deployer-howto.xml html-manager-howto.xml
manager-howto.xml
Log:
- Manager and deployer docs update.
Revision Changes Path
1.5 +32 -1 jakarta-tomcat-catalina/webapps/docs/deployer-howto.xml
Index: deployer-howto.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/deployer-howto.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- deployer-howto.xml 14 Jul 2003 15:25:57 -0000 1.4
+++ deployer-howto.xml 30 Jul 2003 18:37:06 -0000 1.5
@@ -80,7 +80,32 @@
<section name="Deploying on a running Tomcat server">
<p>If the host "autoDeploy" property is true, the host will attempt to deploy
-and update web applications dynamically, as needed.</p>
+and update web applications dynamically, as needed. The host will need to
+have background processing enabled for automatic reloading to work, which
+is the default.</p>
+
+<p>This includes:
+<ul>
+ <li>Deployment of WARs which are copied to the host appBase.</li>
+ <li>Deployment of expanded web applications which are copied to the host
+ appBase.</li>
+ <li>Redeployment of a web application which has been deployed from a WAR
+ when the WAR is updated: the expanded web application is removed,
+ and the WAR is expanded again. This will not happen if the host is
+ configured so that WARs are not expanded, in which case the webapp
+ will be simply redeployed.</li>
+ <li>Redeployment of the web application if the /WEB-INF/web.xml file is
+ updated.</li>
+ <li>Redeployment of the web application if the context XML file from which
+ the web application has been deployed is updated.</li>
+ <li>Redeployment of the web application if a context XML file (with a
+ name corresponding to the context path of the previously deployed
+ application) is added in the
+ <code>$CATALINA_HOME/conf/[enginename]/[hostname]/</code> folder.</li>
+</ul>
+Note: Web application reloading can also be configured in the loader, in which
+case loaded classes will be tracked for changes.
+</p>
</section>
@@ -96,6 +121,12 @@
validates the webapp's deployment descriptor. The validator task (class
<code>org.apache.catalina.ant.ValidatorTask</code>) allows only one parameter:
the base path of an expanded web application.</p>
+
+<p>The deployer uses an unpacked web application as input (see the list of the
+properties used by the deployer below). A web application which
+is programatically deployed with the deployer may include Tomcat specific
+deployment configuration, by including a Context configuration XML file in
+<code>/META-INF/context.xml</code>.</p>
<p>The deployer package includes a ready to use Ant script, with the following
targets:
1.2 +4 -0 jakarta-tomcat-catalina/webapps/docs/html-manager-howto.xml
Index: html-manager-howto.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/html-manager-howto.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- html-manager-howto.xml 15 Jan 2003 03:40:43 -0000 1.1
+++ html-manager-howto.xml 30 Jul 2003 18:37:06 -0000 1.2
@@ -413,6 +413,10 @@
<p>Use the <i>Browse</i> button to select a WAR file to upload to the
server from your local desktop system.</p>
+<p>The .WAR file may include Tomcat specific deployment configuration, by
+including a Context configuration XML file in
+<code>/META-INF/context.xml</code>.</p>
+
<p>Upload of a WAR file could fail for the following reasons:</p>
<ul>
<li><em>File uploaded must be a .war</em>
1.7 +4 -0 jakarta-tomcat-catalina/webapps/docs/manager-howto.xml
Index: manager-howto.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/manager-howto.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- manager-howto.xml 25 Jun 2003 02:24:51 -0000 1.6
+++ manager-howto.xml 30 Jul 2003 18:37:06 -0000 1.7
@@ -286,6 +286,10 @@
later be undeployed (and the corresponding application directory removed)
by use of the <code>/undeploy</code>.</p>
+<p>The .WAR file may include Tomcat specific deployment configuration, by
+including a Context configuration XML file in
+<code>/META-INF/context.xml</code>.</p>
+
<p>URL parameters include:
<ul>
<li><code>update</code>: When set to true, any existing update will be
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org