remm 2003/07/14 08:25:57
Modified: webapps/docs deployer-howto.xml
Log:
- Document the deployer's properties and targets.
Revision Changes Path
1.4 +35 -8 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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- deployer-howto.xml 14 Jul 2003 14:21:19 -0000 1.3
+++ deployer-howto.xml 14 Jul 2003 15:25:57 -0000 1.4
@@ -100,17 +100,44 @@
<p>The deployer package includes a ready to use Ant script, with the following
targets:
<ul>
- <li>compile (default): compile and validate the web application</li>
- <li>deploy: deploy a web application (compiled or not) to a Tomcat
- server</li>
- <li>undeploy: undeploy a web application</li>
- <li>start: start web application</li>
- <li>reload: reload web application</li>
- <li>stop: stop web application</li>
+ <li><code>compile</code> (default): Compile and validate the web
+ application. This can be used standalone, and does not need a running
+ Tomcat server. The compiled application will only run on the associated
+ Tomcat 5.0.x server release, and is not guaranteed to work on another
+ Tomcat release, as the code generated by Jasper depends on its runtime
+ component. It should also be noted that this target will also compile
+ automatically any Java source file located in the
+ <code>/WEB-INF/classes</code> folder of the web application.</li>
+ <li><code>deploy</code>: Deploy a web application (compiled or not) to
+ a Tomcat server</li>
+ <li><code>undeploy</code>: Undeploy a web application</li>
+ <li><code>start</code>: Start web application</li>
+ <li><code>reload</code>: Reload web application</li>
+ <li><code>stop</code>: Stop web application</li>
</ul>
-The following properties can be specified, either as a system property, or by
+The following properties can be specified, either as system properties, or by
using a <code>deployer.properties</code> file located in the root folder of the
deployer package:
+<ul>
+ <li><code>build</code>: The build folder used will be, by default,
+ <code>${build}/webapp${path}</code>. After the end of the execution
+ of the <code>compile</code> target, the web application WAR will be
+ located at <code>${build}/webapp${path}.war</code>.</li>
+ <li><code>webapp</code>: Folder containing the expanded web application
+ which will be compiled and validated. By default, the folder is
+ <code>myapp</code>.</li>
+ <li><code>path</code>: Deployed context path of the web application,
+ by default <code>/myapp</code>.</li>
+ <li><code>url</code>: Absolute URL to the manager web application of a
+ running Tomcat server, which will be used to deploy and undeploy the
+ web application. By default, the deployer will attempt to access
+ a Tomcat instance running on localhost, at
+ <code>http://localhost:8080/manager</code>.</li>
+ <li><code>username</code>: Username to be used to connect to the Tomcat
+ manager.</li>
+ <li><code>password</code>: Password to be used to connect to the Tomcat
+ manager.</li>
+</ul>
</p>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
