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 16:15:32 UTC
svn commit: r1823493 - in /tomcat/tc8.0.x/trunk/webapps/docs:
host-manager-howto.xml html-host-manager-howto.xml
Author: markt
Date: Wed Feb 7 16:15:32 2018
New Revision: 1823493
URL: http://svn.apache.org/viewvc?rev=1823493&view=rev
Log:
Make the Host Manager text Tomcat 8.0 specific.
Modified:
tomcat/tc8.0.x/trunk/webapps/docs/host-manager-howto.xml
tomcat/tc8.0.x/trunk/webapps/docs/html-host-manager-howto.xml
Modified: tomcat/tc8.0.x/trunk/webapps/docs/host-manager-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/tc8.0.x/trunk/webapps/docs/host-manager-howto.xml?rev=1823493&r1=1823492&r2=1823493&view=diff
==============================================================================
--- tomcat/tc8.0.x/trunk/webapps/docs/host-manager-howto.xml (original)
+++ tomcat/tc8.0.x/trunk/webapps/docs/host-manager-howto.xml Wed Feb 7 16:15:32 2018
@@ -67,10 +67,13 @@
</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
+ Both ways enable you to add, remove, start, and stop virtual hosts. Changes
+ are not persisted to the Tomcat configuraiton files. If you want your
+ settings to be persistent, you must write them 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>. 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>
@@ -78,8 +81,8 @@
<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>
+ Tomcat, for example <code>C:\tomcat8</code>, or
+ <code>/usr/share/tomcat8</code>.</em></p>
<p>
The Host Manager application requires a user with one of the following
@@ -125,7 +128,6 @@ localhost:</source>
<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
@@ -213,38 +215,6 @@ localhost:</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
Modified: tomcat/tc8.0.x/trunk/webapps/docs/html-host-manager-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/tc8.0.x/trunk/webapps/docs/html-host-manager-howto.xml?rev=1823493&r1=1823492&r2=1823493&view=diff
==============================================================================
--- tomcat/tc8.0.x/trunk/webapps/docs/html-host-manager-howto.xml (original)
+++ tomcat/tc8.0.x/trunk/webapps/docs/html-host-manager-howto.xml Wed Feb 7 16:15:32 2018
@@ -70,10 +70,13 @@
</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
+ Both ways enable you to add, remove, start, and stop virtual hosts.
+ Changes are not persisted to the Tomcat configuraiton files. If you want
+ your settings to be persistent, you must write them 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>. 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>
@@ -81,8 +84,8 @@
<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>
+ Tomcat, for example <code>C:\tomcat8</code>, or
+ <code>/usr/share/tomcat8</code>.</em></p>
<p>
The Host Manager application requires a user with one of the following
@@ -128,9 +131,6 @@
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>
@@ -189,21 +189,6 @@
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,
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org