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]

Reply via email to