You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2018/02/07 15:36:20 UTC

svn commit: r1823481 - in /tomcat/trunk: java/org/apache/catalina/manager/host/LocalStrings.properties webapps/docs/changelog.xml webapps/docs/host-manager-howto.xml webapps/docs/html-host-manager-howto.xml webapps/docs/index.xml webapps/docs/project.xml

Author: markt
Date: Wed Feb  7 15:36:20 2018
New Revision: 1823481

URL: http://svn.apache.org/viewvc?rev=1823481&view=rev
Log:
Fix https://bz.apache.org/bugzilla/show_bug.cgi?id=48672
Add documentation for the Host Manager web application. Patch provided by Marek Czernek.

Added:
    tomcat/trunk/webapps/docs/host-manager-howto.xml   (with props)
    tomcat/trunk/webapps/docs/html-host-manager-howto.xml   (with props)
Modified:
    tomcat/trunk/java/org/apache/catalina/manager/host/LocalStrings.properties
    tomcat/trunk/webapps/docs/changelog.xml
    tomcat/trunk/webapps/docs/index.xml
    tomcat/trunk/webapps/docs/project.xml

Modified: tomcat/trunk/java/org/apache/catalina/manager/host/LocalStrings.properties
URL: http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/manager/host/LocalStrings.properties?rev=1823481&r1=1823480&r2=1823481&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/manager/host/LocalStrings.properties (original)
+++ tomcat/trunk/java/org/apache/catalina/manager/host/LocalStrings.properties Wed Feb  7 15:36:20 2018
@@ -53,9 +53,9 @@ htmlHostManagerServlet.messageLabel=Mess
 htmlHostManagerServlet.manager=Host Manager
 htmlHostManagerServlet.list=List Virtual Hosts
 htmlHostManagerServlet.helpHtmlManagerFile=../docs/html-host-manager-howto.html
-htmlHostManagerServlet.helpHtmlManager=HTML Host Manager Help (TODO)
+htmlHostManagerServlet.helpHtmlManager=HTML Host Manager Help
 htmlHostManagerServlet.helpManagerFile=../docs/host-manager-howto.html
-htmlHostManagerServlet.helpManager=Host Manager Help (TODO)
+htmlHostManagerServlet.helpManager=Host Manager Help
 htmlHostManagerServlet.hostName=Host name
 htmlHostManagerServlet.hostAliases=Host aliases
 htmlHostManagerServlet.hostTasks=Commands

Modified: tomcat/trunk/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/changelog.xml?rev=1823481&r1=1823480&r2=1823481&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/changelog.xml (original)
+++ tomcat/trunk/webapps/docs/changelog.xml Wed Feb  7 15:36:20 2018
@@ -45,6 +45,14 @@
   issues do not "pop up" wrt. others).
 -->
 <section name="Tomcat 9.0.6 (markt)" rtext="in development">
+  <subsection name="Web applications">
+    <changelog>
+      <add>
+        <bug>48672</bug>: Add documentation for the Host Manager web
+        application. Patch provided by Marek Czernek. (markt)
+      </add>
+    </changelog>
+  </subsection>
 </section>
 <section name="Tomcat 9.0.5 (markt)" rtext="release in progress">
   <subsection name="Catalina">

Added: tomcat/trunk/webapps/docs/host-manager-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/host-manager-howto.xml?rev=1823481&view=auto
==============================================================================
--- tomcat/trunk/webapps/docs/host-manager-howto.xml (added)
+++ tomcat/trunk/webapps/docs/host-manager-howto.xml Wed Feb  7 15:36:20 2018
@@ -0,0 +1,250 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!DOCTYPE document [
+  <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="host-manager-howto.html">
+  &project;
+
+  <properties>
+        <title>Host Manager App -- Text Interface</title>
+  </properties>
+<body>
+
+<section name="Table of Contents">
+  <toc/>
+</section>
+
+<section name="Introduction">
+  <p>
+    The <strong>Tomcat Host Manager</strong> application enables you to create,
+    delete, and otherwise manage virtual hosts within Tomcat. This how-to guide
+    is best accompanied by the following pieces of documentation:
+  </p>
+  <ul>
+    <li>
+      <a href="virtual-hosting-howto.html">Virtual Hosting How-To</a> for more
+      information about virtual hosting.
+    </li>
+    <li>
+      <a href="config/host.html">The Host Container</a> for more information
+      about the underlying xml configuration of virtual hosts and description
+      of attributes.
+    </li>
+  </ul>
+
+  <p>
+    The <strong>Tomcat Host Manager</strong> application is a part of
+    Tomcat installation, by default available using the following
+    context: <code>/host-manager</code>. You can use the host manager in the
+    following ways:
+  </p>
+
+  <ul>
+    <li>
+      Utilizing the graphical user interface, accessible at:
+      <code>{server}:{port}/host-manager/html</code>.
+    </li>
+    <li>
+      Utilizing a set of minimal HTTP requests suitable for scripting.
+      You can access this mode at:
+      <code>{server}:{port}/host-manager/text</code>.
+    </li>
+  </ul>
+  <p>
+    Both ways enable you to add, remove, start, and stop virtual hosts. All
+    of the operations are persistent on Tomcat 9 and newer versions if you use
+    the <code>persist</code> option. This document focuses on the text interface.
+    For further information about the graphical interface, see
+    <a href="html-host-manager-howto.html">Host Manager App -- HTML Interface</a>.
+  </p>
+</section>
+
+<section name="Configuring Manager Application Access">
+  <p><em>The description below uses <code>$CATALINA_HOME</code> to refer the
+    base Tomcat directory. It is the directory in which you installed
+    Tomcat, for example <code>C:/tomcat9</code>, or
+    <code>/usr/share/tomcat9</code>.</em></p>
+
+  <p>
+    The Host Manager application requires a user with one of the following
+    roles:
+  </p>
+
+  <ul>
+    <li>
+      <code>admin-gui</code> - use this role for the graphical web interface.
+    </li>
+    <li>
+      <code>admin-script</code> - use this role for the scripting web interface.
+    </li>
+  </ul>
+
+  <p>
+    To enable access to the text interface of the Host Manager application,
+    either grant your Tomcat user the appropriate role, or create a new one with
+    the correct role. For example, open
+    <code>${CATALINA_BASE}/conf/tomcat-users.xml</code> and enter the following:
+  </p>
+  <source><![CDATA[<user username="test" password="chang3m3N#w" roles="admin-script"/>]]></source>
+  <p>
+    No further settings is needed. When you now access
+    <code>{server}:{port}/host-manager/text/${COMMAND}</code>,you are able to
+    log in with the created credentials. For example:
+    <source>$ curl -u ${USERNAME}:${PASSWORD} http://localhost:8080/host-manager/text/list
+OK - Listed hosts
+localhost:</source>
+  </p>
+  <p>
+    Note that in case you retreive your users using the
+    <code>DataSourceRealm</code>, <code>JDBCRealm</code>, or
+    <code>JNDIRealm</code> mechanism, add the appropriate role in the database
+    or the directory server respectively.
+  </p>
+</section>
+<section name="List of Commands">
+  <p>The following commands are supported:</p>
+  <ul>
+    <li>list</li>
+    <li>add</li>
+    <li>remove</li>
+    <li>start</li>
+    <li>stop</li>
+    <li>persist - this command is available only for Tomcat 9 and newer.</li>
+  </ul>
+  <p>
+    In the following subsections, the username and password is assumed to be
+    <b>test:test</b>. For your environment, use credentials created in the
+    previous sections.
+  </p>
+  <subsection name="List command">
+    <p>
+      Use the <b>list</b> command to see the available virtual hosts on your
+      Tomcat instance.
+    </p>
+    <p><i>Example command</i>:</p>
+    <code>curl -u test:test http://localhost:8080/host-manager/text/list</code>
+    <p><i>Example response</i>:</p>
+    <source>OK - Listed hosts
+localhost:</source>
+  </subsection>
+  <subsection name="Add command">
+    <p>
+      Use the <b>add</b> command to add a new virtual host. Parameters used
+      for the <b>add</b> command:
+    </p>
+    <ul>
+      <li>String <b>name</b>: Name of the virtual host. <b>REQUIRED</b></li>
+      <li>String <b>aliases</b>: Aliases for your virtual host.</li>
+      <li>String <b>appBase</b>: Base path for the application that will be
+      served by this virtual host. Provide relative or absolute path.</li>
+      <li>Boolean <b>manager</b>: If true, the Manager app is added to the
+      virtual host. You can access it with the <i>/manager</i> context.</li>
+      <li>Boolean <b>autoDeploy</b>: If true, Tomcat automatically redeploys
+      applications placed in the appBase directory.</li>
+      <li>Boolean <b>deployOnStartup</b>: If true, Tomcat automatically deploys
+      applications placed in the appBase directory on startup.</li>
+      <li>Boolean <b>deployXML</b>: If true, the <i>/META-INF/context.xml</i>
+      file is read and used by Tomcat.</li>
+      <li>Boolean <b>copyXML</b>: If true, Tomcat copies <i>/META-INF/context.xml</i>
+      file and uses the original copy regardless of updates to the application's
+      <i>/META-INF/context.xml</i> file. Available only for
+      <b>Tomcat 8 and newer</b>.</li>
+    </ul>
+    <p><i>Example command</i>:</p>
+    <source><![CDATA[curl -u test:test http://localhost:8080/host-manager/text/add?name=www.awesomeserver.com&aliases=awesomeserver.com&appBase/mnt/appDir&deployOnStartup=true]]></source>
+    <p><i>Example response</i>:</p>
+    <source>add: Adding host [www.awesomeserver.com]</source>
+  </subsection>
+  <subsection name="Remove command">
+    <p>
+      Use the <b>remove</b> command to remove a virtual host. Parameters used
+      for the <b>remove</b> command:
+    </p>
+    <ul>
+      <li>String <b>name</b>: Name of the virtual host to be removed.
+      <b>REQUIRED</b></li>
+    </ul>
+    <p><i>Example command</i>:</p>
+    <source><![CDATA[curl -u test:test http://localhost:8080/host-manager/text/remove?name=www.awesomeserver.com]]></source>
+    <p><i>Example response</i>:</p>
+    <source>remove: Removing host [www.awesomeserver.com]</source>
+  </subsection>
+  <subsection name="Start command">
+    <p>
+      Use the <b>start</b> command to start a virtual host. Parameters used
+      for the <b>start</b> command:
+    </p>
+    <ul>
+      <li>String <b>name</b>: Name of the virtual host to be started.
+      <b>REQUIRED</b></li>
+    </ul>
+    <p><i>Example command</i>:</p>
+    <source><![CDATA[curl -u test:test http://localhost:8080/host-manager/text/start?name=www.awesomeserver.com]]></source>
+    <p><i>Example response</i>:</p>
+    <source>OK - Host www.awesomeserver.com started</source>
+  </subsection>
+  <subsection name="Stop command">
+    <p>
+      Use the <b>stop</b> command to stop a virtual host. Parameters used
+      for the <b>stop</b> command:
+    </p>
+    <ul>
+      <li>String <b>name</b>: Name of the virtual host to be stopped.
+      <b>REQUIRED</b></li>
+    </ul>
+    <p><i>Example command</i>:</p>
+    <source><![CDATA[curl -u test:test http://localhost:8080/host-manager/text/stop?name=www.awesomeserver.com]]></source>
+    <p><i>Example response</i>:</p>
+    <source>OK - Host www.awesomeserver.com stopped</source>
+  </subsection>
+  <subsection name="Persist command">
+    <p>
+      Use the <b>persist</b> command to persist a virtual host into
+      <b>server.xml</b>. Parameters used for the <b>persist</b> command:
+    </p>
+    <ul>
+      <li>String <b>name</b>: Name of the virtual host to be persist.
+      <b>REQUIRED</b></li>
+    </ul>
+    <p>
+      Tomcat 9 and newer versions can use the <b>persist</b> command. If you use
+      an older version of Tomcat, note that everything done in the Host Manager
+      application is non-persistent. While that is suitable for some, if you
+      want your settings to be persistent, you must write it into the
+      <i>server.xml</i> configuration file manually. For full documentation
+      about the configuration, see
+      <a href="config/host.html">The Host Container</a>.
+    </p>
+    <p>
+      This functionality is disabled by default. To enable this option, you must
+      configure the <code>StoreConfigLifecycleListener</code> listener first.
+      To do so, add the following listener to your <i>server.xml</i>:
+    </p>
+    <source><![CDATA[<Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>]]></source>
+    <p><i>Example command</i>:</p>
+    <source><![CDATA[curl -u test:test http://localhost:8080/host-manager/text/persist?name=www.awesomeserver.com]]></source>
+    <p><i>Example response</i>:</p>
+    <source>OK - Configuration persisted</source>
+    <p><i>Example manual entry</i>:</p>
+    <source><![CDATA[<Host appBase="www.awesomeserver.com" name="www.awesomeserver.com" deployXML="false" unpackWARs="false">
+</Host>]]></source>
+  </subsection>
+</section>
+</body>
+</document>
\ No newline at end of file

Propchange: tomcat/trunk/webapps/docs/host-manager-howto.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: tomcat/trunk/webapps/docs/html-host-manager-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/html-host-manager-howto.xml?rev=1823481&view=auto
==============================================================================
--- tomcat/trunk/webapps/docs/html-host-manager-howto.xml (added)
+++ tomcat/trunk/webapps/docs/html-host-manager-howto.xml Wed Feb  7 15:36:20 2018
@@ -0,0 +1,215 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!DOCTYPE document [
+  <!ENTITY project SYSTEM "project.xml">
+]>
+
+<document url="html-host-manager-howto.html">
+  &project;
+
+  <properties>
+        <title>Host Manager App -- HTML Interface</title>
+  </properties>
+<body>
+  <section name="Table of Contents">
+    <toc/>
+  </section>
+  <section name="Introduction">
+    <p>
+      The <strong>Tomcat Host Manager</strong> application enables you to create,
+      delete, and otherwise manage virtual hosts within Tomcat. This how-to guide
+      is best accompanied by the following pieces of documentation:
+    </p>
+    <ul>
+      <li>
+        <a href="virtual-hosting-howto.html">Virtual Hosting How-To</a> for more
+        information about virtual hosting.
+      </li>
+      <li>
+        <a href="config/host.html">The Host Container</a> for more information
+        about the underlying xml configuration of virtual hosts and description
+        of attributes.
+      </li>
+      <li>
+        <a href="host-manager-howto.html">Host Manager App -- Text Interface</a>
+        for full description of the commands.
+      </li>
+    </ul>
+
+    <p>
+      The <strong>Tomcat Host Manager</strong> application is a part of
+      Tomcat installation, by default available using the following
+      context: <code>/host-manager</code>. You can use the host manager in the
+      following ways:
+    </p>
+
+    <ul>
+      <li>
+        Utilizing the graphical user interface, accessible at:
+        <code>{server}:{port}/host-manager/html</code>.
+      </li>
+      <li>
+        Utilizing a set of minimal HTTP requests suitable for scripting.
+        You can access this mode at:
+        <code>{server}:{port}/host-manager/text</code>.
+      </li>
+    </ul>
+    <p>
+      Both ways enable you to add, remove, start, and stop virtual hosts. All
+      of the operations are persistent on Tomcat 9 and newer versions if you use
+      the <code>persist</code> option. This document focuses on the HTML interface.
+      For further information about the graphical interface, see
+      <a href="host-manager-howto.html">Host Manager App -- Text Interface</a>.
+    </p>
+  </section>
+
+  <section name="Configuring Manager Application Access">
+    <p><em>The description below uses <code>$CATALINA_HOME</code> to refer the
+      base Tomcat directory. It is the directory in which you installed
+      Tomcat, for example <code>C:/tomcat9</code>, or
+      <code>/usr/share/tomcat9</code>.</em></p>
+
+    <p>
+      The Host Manager application requires a user with one of the following
+      roles:
+    </p>
+
+    <ul>
+      <li>
+        <code>admin-gui</code> - use this role for the graphical web interface.
+      </li>
+      <li>
+        <code>admin-script</code> - use this role for the scripting web interface.
+      </li>
+    </ul>
+
+    <p>
+      To enable access to the HTML interface of the Host Manager application,
+      either grant your Tomcat user the appropriate role, or create a new one with
+      the correct role. For example, open
+      <code>${CATALINA_BASE}/conf/tomcat-users.xml</code> and enter the following:
+    </p>
+    <source><![CDATA[<user username="test" password="chang3m3N#w" roles="admin-gui"/>]]></source>
+    <p>
+      No further settings is needed. When you now access
+      <code>{server}:{port}/host-manager/html</code>,you are able to
+      log in with the created credentials.
+    </p>
+    <p>
+      Note that in case you retreive your users using the
+      <code>DataSourceRealm</code>, <code>JDBCRealm</code>, or
+      <code>JNDIRealm</code> mechanism, add the appropriate role in the database
+      or the directory server respectively.
+    </p>
+  </section>
+
+  <section name="Interface Description">
+    <p>The interface is divided into six sections:</p>
+    <ul>
+      <li><strong>Message</strong> - Displays success and failure messages.</li>
+      <li><strong>Host Manager</strong> - Provides basic Host Manager operations
+      , like list and help.</li>
+      <li><strong>Host name</strong> - Provides a list of virtual Host Names and
+      enables you to operate them. </li>
+      <li><strong>Add Virtual Host</strong> - Enables you to add a new Virtual
+      Host.</li>
+      <li><strong>Persist configuration</strong> - Enables you to persist your
+      current Virtual Hosts. This option is available on Tomcat 9 and newer
+      versions.</li>
+      <li><strong>Server Information</strong> - Information about the Tomcat
+          server.</li>
+    </ul>
+  </section>
+
+  <section name="Message">
+
+  <p>
+  Displays information about the success or failure of the last Host Manager
+  command you performed:
+  </p>
+  <ul>
+    <li>Success: <strong>OK</strong> is displayed
+    and may be followed by a success message.</li>
+    <li>Failure: <strong>FAIL</strong>
+    is displayed followed by an error message.</li>
+  </ul>
+  <p>
+    Note that the console of your Tomcat server may reveal more information
+    about each command.
+  </p>
+  </section>
+
+  <section name="Host Manager">
+
+  <p>The Host Manager section enables you to:</p>
+  <ul>
+    <li><strong>List Virtual Hosts</strong> - Refresh a list of
+    currently-configured virtual hosts.</li>
+    <li><strong>HTML Host Manager Help</strong> - A documentation link.</li>
+    <li><strong>Host Manager Help</strong> - A documentation link.</li>
+    <li><strong>Server Status</strong> - A link to the <strong>Manager</strong>
+    application. Note that you user must have sufficient permissions to access
+    the application.</li>
+  </ul>
+  </section>
+
+  <section name="Host Name">
+
+  <p>The Host name section contains a list of currently-configured virtual host
+    names. It enables you to:</p>
+  <ul>
+    <li>View the host names</li>
+    <li>View the host name aliases</li>
+    <li>Perform basic commands, that is <strong>start</strong>,
+    <strong>stop</strong>, and <strong>remove</strong>.</li>
+  </ul>
+  </section>
+
+  <section name="Add Virtual Host">
+
+  <p>The Add Virtual Host section enables you to add a virtual host using a
+  graphical interface. For a description of each property, see the
+  <a href="host-manager-howto.html">Host Manager App -- Text Interface</a>
+  documentation. Note that any configuration added via this interface is
+  non-persistent.</p>
+  </section>
+
+  <section name="Persist Configuration">
+
+  <p>The Persist Configuration section enables you to persist your current
+  configuration into the <i>server.xml</i> file. This option is available for
+  Tomcat 9 and newer versions.</p>
+
+  <p> This functionality is disabled by default. To enable this option, you must
+  configure the <code>StoreConfigLifecycleListener</code> listener first.
+  To do so, add the following listener to your <i>server.xml</i>:</p>
+  <source><![CDATA[<Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>]]></source>
+
+  <p>After you configure the listener, click <strong>All</strong> to make your
+  configuration persistent.</p>
+  </section>
+
+  <section name="Server Information">
+    <p>
+      Provides a basic information about the currently-running Tomcat instance,
+      the JVM, and the underlying operating system.
+    </p>
+  </section>
+
+</body>
+</document>
\ No newline at end of file

Propchange: tomcat/trunk/webapps/docs/html-host-manager-howto.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: tomcat/trunk/webapps/docs/index.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/index.xml?rev=1823481&r1=1823480&r2=1823481&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/index.xml (original)
+++ tomcat/trunk/webapps/docs/index.xml Wed Feb  7 15:36:20 2018
@@ -70,6 +70,9 @@ Apache Tomcat, and using many of the Apa
 <li><a href="manager-howto.html"><strong>Manager</strong></a> -
     Operating the <strong>Manager</strong> web app to deploy, undeploy, and
     redeploy applications while Apache Tomcat is running.</li>
+<li><a href="host-manager-howto.html"><strong>Host Manager</strong></a> -
+    Operating the <strong>Host Manager</strong> web app to add and remove
+    virtual hosts while Apache Tomcat is running.</li>
 <li><a href="realm-howto.html"><strong>Realms and Access Control</strong></a>
     - Description of how to configure <em>Realms</em> (databases of users,
     passwords, and their associated roles) for use in web applications that

Modified: tomcat/trunk/webapps/docs/project.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/project.xml?rev=1823481&r1=1823480&r2=1823481&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/project.xml (original)
+++ tomcat/trunk/webapps/docs/project.xml Wed Feb  7 15:36:20 2018
@@ -39,42 +39,43 @@
         <item name="3) First webapp"        href="appdev/index.html"/>
         <item name="4) Deployer"            href="deployer-howto.html"/>
         <item name="5) Manager"             href="manager-howto.html"/>
-        <item name="6) Realms and AAA"      href="realm-howto.html"/>
-        <item name="7) Security Manager"
+        <item name="6) Host Manager"        href="host-manager-howto.html"/>
+        <item name="7) Realms and AAA"      href="realm-howto.html"/>
+        <item name="8) Security Manager"
               href="security-manager-howto.html"/>
-        <item name="8) JNDI Resources"      href="jndi-resources-howto.html"/>
-        <item name="9) JDBC DataSources"
+        <item name="9) JNDI Resources"      href="jndi-resources-howto.html"/>
+        <item name="10) JDBC DataSources"
               href="jndi-datasource-examples-howto.html"/>
-        <item name="10) Classloading"       href="class-loader-howto.html"/>
-        <item name="11) JSPs"               href="jasper-howto.html"/>
-        <item name="12) SSL/TLS"            href="ssl-howto.html"/>
-        <item name="13) SSI"                href="ssi-howto.html"/>
-        <item name="14) CGI"                href="cgi-howto.html"/>
-        <item name="15) Proxy Support"      href="proxy-howto.html"/>
-        <item name="16) MBeans Descriptors"
-              href="mbeans-descriptors-howto.html"/>
-        <item name="17) Default Servlet"    href="default-servlet.html"/>
-        <item name="18) Clustering"         href="cluster-howto.html"/>
-        <item name="19) Load Balancer"      href="balancer-howto.html"/>
-        <item name="20) Connectors"         href="connectors.html"/>
-        <item name="21) Monitoring and Management"
+        <item name="11) Classloading"       href="class-loader-howto.html"/>
+        <item name="12) JSPs"               href="jasper-howto.html"/>
+        <item name="13) SSL/TLS"            href="ssl-howto.html"/>
+        <item name="14) SSI"                href="ssi-howto.html"/>
+        <item name="15) CGI"                href="cgi-howto.html"/>
+        <item name="16) Proxy Support"      href="proxy-howto.html"/>
+        <item name="17) MBeans Descriptors"
+              href="means-descriptors-howto.html"/>
+        <item name="18) Default Servlet"    href="default-servlet.html"/>
+        <item name="19) Clustering"         href="cluster-howto.html"/>
+        <item name="20) Load Balancer"      href="balancer-howto.html"/>
+        <item name="21) Connectors"         href="connectors.html"/>
+        <item name="22) Monitoring and Management"
               href="monitoring.html"/>
-        <item name="22) Logging"            href="logging.html"/>
-        <item name="23) APR/Native"         href="apr.html"/>
-        <item name="24) Virtual Hosting"    href="virtual-hosting-howto.html"/>
-        <item name="25) Advanced IO"        href="aio.html"/>
-        <item name="26) Additional Components"
+        <item name="23) Logging"            href="logging.html"/>
+        <item name="24) APR/Native"         href="apr.html"/>
+        <item name="25) Virtual Hosting"    href="virtual-hosting-howto.html"/>
+        <item name="26) Advanced IO"        href="aio.html"/>
+        <item name="27) Additional Components"
               href="extras.html"/>
-        <item name="27) Mavenized"          href="maven-jars.html"/>
-        <item name="28) Security Considerations"
+        <item name="28) Mavenized"          href="maven-jars.html"/>
+        <item name="29) Security Considerations"
               href="security-howto.html"/>
-        <item name="29) Windows Service"    href="windows-service-howto.html"/>
-        <item name="30) Windows Authentication"
+        <item name="30) Windows Service"    href="windows-service-howto.html"/>
+        <item name="31) Windows Authentication"
               href="windows-auth-howto.html"/>
-        <item name="31) Tomcat's JDBC Pool"
+        <item name="32) Tomcat's JDBC Pool"
               href="jdbc-pool.html"/>
-        <item name="32) WebSocket"          href="web-socket-howto.html"/>
-        <item name="33) Rewrite"            href="rewrite.html"/>
+        <item name="33) WebSocket"          href="web-socket-howto.html"/>
+        <item name="34) Rewrite"            href="rewrite.html"/>
     </menu>
 
     <menu name="Reference">



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org