A Server element represents the entire Catalina
servlet container. Therefore, it must be the single outermost element
conf/server.xml configuration file. Its attributes
represent the characteristics of the servlet container as a whole.
All implementations of Server support the following attributes:
Java class name of the implementation to use. This class must
If no class name is specified, the standard implementation will
The TCP/IP address on which this server waits for a shutdown
command. If no address is specified,
localhost is used.
The TCP/IP port number on which this server waits for a shutdown
command. Set to
-1 to disable the shutdown port.
Note: Disabling the shutdown port works well when Tomcat is started using Apache Commons Daemon (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.
The offset to apply to
port and to the ports of any
nested connectors. It must be a non-negative integer. If not specified,
the default value of
0 is used.
The command string that must be received via a TCP/IP connection to the specified port number, in order to shut down Tomcat.
The number of threads this Service will use for
various utility tasks, including recurring ones. The special value
of 0 will result in the value of
used. Negative values will result in
Runtime.getRuntime().availableProcessors() + value being
used unless this is less than 1 in which case 1 thread will be used.
The default value is 1.
The standard implementation of Server is org.apache.catalina.core.StandardServer. It supports the following additional attributes (in addition to the common attributes listed above):
Set the daemon flag value for the utility threads. The default value
This value represents the delay in seconds between periodic lifecycle event invocation of the lifecycle listeners configured on this Server. The value is in seconds, and a negative or zero value will disable the invocations. If not specified, the default value for this attribute is 10 seconds.
The following components may be nested inside a Server element:
There are no special features associated with a Server.