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: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]