web.xml

Other

The Server Component

Table of Contents

Introduction

A Server element represents the entire Catalina
servlet container. Therefore, it must be the single outermost element
in the conf/server.xml configuration file. Its attributes
represent the characteristics of the servlet container as a whole.

Attributes

Common Attributes

All implementations of Server
support the following attributes:

Attribute

Description

className

Java class name of the implementation to use. This class must
implement the org.apache.catalina.Server interface.
If no class name is specified, the standard implementation will
be used.

address

The TCP/IP address on which this server waits for a shutdown
command. If no address is specified, localhost is used.

port

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.

shutdown

The command string that must be received via a TCP/IP connection
to the specified port number, in order to shut down Tomcat.

Standard Implementation

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):