<body>
+<section name="Table of Contents">
+<toc/>
+</section>
+
<section name="Introduction">
<p>In many production environments it is very useful to have the capability
Tomcat. This document is for the HTML web interface to the web application
<a href="manager-howto.html">manager</a>.</p>
-<p>The interface is divided into six sections:
+<p>The interface is divided into six sections:</p>
<ul>
<li><strong>Message</strong> - Displays success and failure messages.</li>
<li><strong>Manager</strong> - General manager operations like list and
<li><strong>Server Information</strong> - Information about the Tomcat
server.</li>
</ul>
-</p>
</section>
<section name="Manager">
-<p>The Manager section has three links:
+<p>The Manager section has three links:</p>
<ul>
<li><strong>List Applications</strong> - Redisplay a list of web
applications.</li>
<li><strong>Manager Help</strong> - A link to the comprehensive Manager
App HOW TO.</li>
</ul>
-</p>
</section>
<p>The Applications section lists information about all the installed web
applications and provides links for managing them. For each web application
-the following is displayed:
+the following is displayed:</p>
<ul>
<li><strong>Path</strong> - The web application context path.</li>
<li><strong>Display Name</strong> - The display name for the web application
</ul>
</li>
</ul>
-</p>
<subsection name="Start">
</source>
<p>Otherwise, the Message will start with <code>FAIL</code> and include an
-error message. Possible causes for problems include:
+error message. Possible causes for problems include:</p>
<ul>
<li><em>Encountered exception</em>
<blockquote>
The <code>path</code> parameter is required.
</blockquote></li>
</ul>
-</p>
</subsection>
deployed. Any request that comes in while an application is
stopped will see an HTTP error 404, and this application will show as
"stopped" on a list applications command.</p>
-
+
<p>If this command succeeds, you will see a Message like this:</p>
<source>
OK - Stopped application at context path /examples
</source>
-
+
<p>Otherwise, the Message will start with <code>FAIL</code> and include an
-error message. Possible causes for problems include:
+error message. Possible causes for problems include:</p>
<ul>
<li><em>Encountered exception</em>
<blockquote>
The <code>path</code> parameter is required.
</blockquote></li>
</ul>
-</p>
</subsection>
</source>
<p>Otherwise, the Message will start with <code>FAIL</code> and include an
-error message. Possible causes for problems include:
+error message. Possible causes for problems include:</p>
<ul>
<li><em>Encountered exception</em>
<blockquote>
the application again to pick up your changes.
</blockquote></li>
</ul>
-</p>
</subsection>
reuse later). This command is the logical opposite of the
<code>/deploy</code> Ant command, and the related deploy features available
in the HTML manager.</p>
-
+
<p>If this command succeeds, you will see a Message like this:</p>
<source>
OK - Undeployed application at context path /examples
</source>
-
+
<p>Otherwise, the Message will start with <code>FAIL</code> and include an
-error message. Possible causes for problems include:
+error message. Possible causes for problems include:</p>
<ul>
<li><em>Encountered exception</em>
<blockquote>
The <code>path</code> parameter is required.
</blockquote></li>
</ul>
-</p>
</subsection>
<p>In this example the web application located in the directory
<code>C:\path\to\foo</code> on the Tomcat server (running on Windows)
-is deployed as the web application context named <code>/footoo</code>.
+is deployed as the web application context named <code>/footoo</code>.</p>
<source>
Context Path: /footoo
WAR or Directory URL: file:C:/path/to/foo
</source>
-</p>
+
<p>In this example the ".war" file <code>/path/to/bar.war</code> on the
Tomcat server (running on Unix) is deployed as the web application
context named <code>/bar</code>. Notice that there is no <code>path</code>
parameter so the context path defaults to the name of the web application
-archive file without the ".war" extension.
+archive file without the ".war" extension.</p>
<source>
WAR or Directory URL: jar:file:/path/to/bar.war!/
</source>
-</p>
+
<h3>Deploy a Directory or War from the Host appBase</h3>
<code>foo</code> in the Host appBase directory of the Tomcat server is
deployed as the web application context named <code>/foo</code>. Notice
that there is no <code>path</code> parameter so the context path defaults
-to the name of the web application directory.
+to the name of the web application directory.</p>
<source>
WAR or Directory URL: foo
</source>
-</p>
+
<p>In this example the ".war" file <code>bar.war</code> located in your
Host appBase directory on the Tomcat server is deployed as the web
-application context named <code>/bartoo</code>.
+application context named <code>/bartoo</code>.</p>
<source>
Context Path: /bartoo
WAR or Directory URL: bar.war
</source>
-</p>
+
<h3>Deploy using a Context configuration ".xml" file</h3>
<p>A Context configuration ".xml" file can contain valid XML for a
web application Context just as if it were configured in your
Tomcat <code>server.xml</code> configuration file. Here is an
-example for Tomcat running on Windows:
+example for Tomcat running on Windows:</p>
<source>
<Context path="/foobar" docBase="C:\path\to\application\foobar"
debug="0">
</Context>
</source>
-</p>
+
<p>Use of the <i>WAR or Directory URL</i> is optional. When used
to select a web application ".war" file or directory it overrides any
docBase configured in the context configuration ".xml" file.</p>
<p>Here is an example of installing an application using a Context
-configuration ".xml" file for Tomcat running on Windows.
+configuration ".xml" file for Tomcat running on Windows.</p>
<source>
XML Configuration file URL: file:C:/path/to/context.xml
</source>
-</p>
+
<p>Here is an example of installing an application using a Context
configuration ".xml" file and a web application ".war" file located
-on the server (Tomcat running on Unix).
+on the server (Tomcat running on Unix).</p>
<source>
XML Configuration file URL: file:/path/to/context.xml
WAR or Directory URL: jar:file:/path/to/bar.war!/
</source>
-</p>
+
</subsection>
</xsl:if>
</td>
<td>
- <font face="arial,helvetica,sanserif">
- <h1><xsl:value-of select="$project/title"/></h1>
- </font>
+ <h1><font face="arial,helvetica,sanserif"><xsl:value-of select="$project/title"/></font></h1>
</td>
<td>
<xsl:comment>APACHE LOGO</xsl:comment>
<tr>
<xsl:comment>LEFT SIDE NAVIGATION</xsl:comment>
- <td width="20%" valign="top" nowrap="true" class="noPrint">
+ <td width="20%" valign="top" nowrap="nowrap" class="noPrint">
<xsl:apply-templates select="project/body/menu"/>
</td>
</xsl:template>
+ <!-- Generate table of contents -->
+ <xsl:template match="toc">
+ <ul><xsl:apply-templates mode="toc" select="following::section"/></ul>
+ </xsl:template>
+
+ <xsl:template mode="toc" match="section|subsection">
+ <xsl:variable name="name">
+ <xsl:value-of select="@name"/>
+ </xsl:variable>
+ <li><a href="#{$name}"><xsl:value-of select="@name"/></a>
+ <xsl:if test="subsection">
+ <ol><xsl:apply-templates mode="toc" select="subsection"/></ol>
+ </xsl:if>
+ </li>
+ </xsl:template>
+
+
<!-- Process a source code example -->
<xsl:template match="source">
<xsl:variable name="void">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
<td bgcolor="{$source-color}" width="1" height="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
<td bgcolor="{$source-color}" height="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
<td bgcolor="{$source-color}" width="1" height="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
</tr>
<tr>
<td bgcolor="{$source-color}" width="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
<td bgcolor="#ffffff" height="1"><pre>
<xsl:value-of select="."/>
</pre></td>
<td bgcolor="{$source-color}" width="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
</tr>
<tr>
<td bgcolor="{$source-color}" width="1" height="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
<td bgcolor="{$source-color}" height="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
<td bgcolor="{$source-color}" width="1" height="1">
- <img src="{$void}" width="1" height="1" vspace="0" hspace="0" border="0"/>
+ <img src="{$void}" alt="" width="1" height="1" vspace="0" hspace="0" border="0"/>
</td>
</tr>
</table>
projects / tomcat7.0 / commitdiff