4.4. Top-Level Elements
The TLD
server.xml file contains the <Server> top-element, which contains the <Service> elements. Any other elements are nested in these two elements.
4.4.1. Server
The
Server is a container element that represents the entire servlet container and is the only parent of any other element, that is, it is the only top-level element.
It can contain multiple
Service, GlobalNamingResources and Listener elements.
Note
The
Server element in the JBoss Web's server.xml file contains multiple Listener elements. Amongst others, the org.apache.catalina.core.AprLifecycleListener and the org.apache.catalina.core.JasperListener. If the mod_ cluster load balancer is enabled for the profile, also the org.jboss.web.tomcat.service.deployers.MicrocontainerIntegrationLifecycleListener is required.
The
AprLifecycleListener and the JasperListener are used to start up and shut down APR and initialize Jasper. Removing the Listener elements is therefore discouraged just as removing the MicrocontainerIntegrationLifecycleListener.
Table 4.1. Server Element Attributes
| Attribute | Description |
|---|---|
| className |
class implementing the Server
The defined class must implement the org.apache.catalina.Server interface. If no class is specified, the standard implementation is used, that is,
org.apache.catalina.core.StandardServer.
|
| port |
TCP/IP port number on which the server expects the shutdown command
The connection must be initiated from the server computer that runs the JBoss Web server instance.
|
| shutdown |
string that the server must receive on the port specified in the port property to shutdown
|
