Author: kkolinko Date: Sun Mar 27 20:58:13 2011 New Revision: 1086036 URL: http://svn.apache.org/viewvc?rev=1086036&view=rev Log: Update the docs regarding the shutdown port number. It is a followup to r938430. As Steven Schlansker noted on the users list, disabling the port affects un*x systems, as kill -9 is not a clean shutdown.
Modified: tomcat/tc5.5.x/trunk/container/webapps/docs/config/server.xml tomcat/tc6.0.x/trunk/webapps/docs/config/server.xml tomcat/trunk/webapps/docs/config/server.xml Modified: tomcat/tc5.5.x/trunk/container/webapps/docs/config/server.xml URL: http://svn.apache.org/viewvc/tomcat/tc5.5.x/trunk/container/webapps/docs/config/server.xml?rev=1086036&r1=1086035&r2=1086036&view=diff ============================================================================== --- tomcat/tc5.5.x/trunk/container/webapps/docs/config/server.xml (original) +++ tomcat/tc5.5.x/trunk/container/webapps/docs/config/server.xml Sun Mar 27 20:58:13 2011 @@ -63,10 +63,13 @@ <p>The TCP/IP port number on which this server waits for a shutdown command. This connection must be initiated from the same server computer that is running this instance of Tomcat. Set to <code>-1</code> - to disable the shutdown port. Note: Disabling the shutdown port will - prevent shutdown.bat and catalina.bat from stopping the Tomcat process - on Windows operating systems. Operating systems that use the *.sh scripts - will not be affected by disabling the shutdown port.</p> + to disable the shutdown port.</p> + <p>Note: Disabling the shutdown port works well when Tomcat is started + using <a href="http://commons.apache.org/daemon/";>Apache Commons Daemon</a> + (running as a service on Windows or with jsvc on un*xes). It cannot be + used when running Tomcat with the standard shell scripts though, as it + will prevent shutdown.bat|.sh and catalina.bat|.sh from stopping it + gracefully.</p> </attribute> <attribute name="shutdown" required="true"> Modified: tomcat/tc6.0.x/trunk/webapps/docs/config/server.xml URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/config/server.xml?rev=1086036&r1=1086035&r2=1086036&view=diff ============================================================================== --- tomcat/tc6.0.x/trunk/webapps/docs/config/server.xml (original) +++ tomcat/tc6.0.x/trunk/webapps/docs/config/server.xml Sun Mar 27 20:58:13 2011 @@ -63,10 +63,13 @@ <p>The TCP/IP port number on which this server waits for a shutdown command. This connection must be initiated from the same server computer that is running this instance of Tomcat. Set to <code>-1</code> - to disable the shutdown port. Note: Disabling the shutdown port will - prevent shutdown.bat and catalina.bat from stopping the Tomcat process - on Windows operating systems. Operating systems that use the *.sh scripts - will not be affected by disabling the shutdown port.</p> + to disable the shutdown port.</p> + <p>Note: Disabling the shutdown port works well when Tomcat is started + using <a href="http://commons.apache.org/daemon/";>Apache Commons Daemon</a> + (running as a service on Windows or with jsvc on un*xes). It cannot be + used when running Tomcat with the standard shell scripts though, as it + will prevent shutdown.bat|.sh and catalina.bat|.sh from stopping it + gracefully.</p> </attribute> <attribute name="shutdown" required="true"> Modified: tomcat/trunk/webapps/docs/config/server.xml URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/config/server.xml?rev=1086036&r1=1086035&r2=1086036&view=diff ============================================================================== --- tomcat/trunk/webapps/docs/config/server.xml (original) +++ tomcat/trunk/webapps/docs/config/server.xml Sun Mar 27 20:58:13 2011 @@ -66,11 +66,13 @@ <attribute name="port" required="true"> <p>The TCP/IP port number on which this server waits for a shutdown - command. Set to <code>-1</code> to disable the shutdown port. Note: - Disabling the shutdown port will prevent shutdown.bat and catalina.bat - from stopping the Tomcat process on Windows operating systems. Operating - systems that use the *.sh scripts will not be affected by disabling the - shutdown port.</p> + command. Set to <code>-1</code> to disable the shutdown port.</p> + <p>Note: Disabling the shutdown port works well when Tomcat is started + using <a href="http://commons.apache.org/daemon/";>Apache Commons Daemon</a> + (running as a service on Windows or with jsvc on un*xes). It cannot be + used when running Tomcat with the standard shell scripts though, as it + will prevent shutdown.bat|.sh and catalina.bat|.sh from stopping it + gracefully.</p> </attribute> <attribute name="shutdown" required="true"> --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org