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-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org