The Apache Tomcat Servlet/JSP Container

Apache Tomcat 7

Version 7.0.35, Jan 17 2013
Apache Logo

Links

Top Level Elements

Executors

Connectors

Containers

Nested Components

Cluster Elements

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:

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

AttributeDescription
Nested Components

The following components may be nested inside a Server element:

Special Features

There are no special features associated with a Server.

Comments

Notice: This is not a Q&A section. The Apache Comments System is explained here. Comments should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic.

Questions on how to configure or use Apache Tomcat should be directed to our mailing lists. If you need help, ask on the users mailing list.


Copyright © 1999-2013, Apache Software Foundation