N

network-config

Configures the communication network for the Enterprise Server. The network configuration includes most of the features that were in the HTTP Service in previous Enterprise Server releases. HTTP Service elements that are no longer supported are converted to network configuration elements. For additional information, see http-service.

Superelements

config

Subelements

The following table describes subelements for the network-listeners element.

network-listeners Subelements

Element Required Description network-listeners only one Contains network listeners. protocols only one Contains protocols. transports only one Contains transports.

network-listener

Configures a network listener.

When you first install the Enterprise Server, three network-listener elements exist by default, with name values of admin-listener, http-listener1, and http-listener2. The http-listener2, which is set up with SSL, is disabled by default.

Superelements

network-listeners

Subelements

none

Attributes

The following table describes attributes for the network-listener element.

network-listener Attributes

Attribute Default Description name none The unique listener name. A network-listener name cannot begin with a number. address none IP address of the listener. Can be in dotted-pair or IPv6 notation. Can be any (for INADDR_ANY) to listen on all IP addresses. Can be a hostname. enabled true (optional) Determines whether the listener is active. If set to false, any attempts to connect to the listener result in a socket exception (java.net.ConnectException). In Enterprise Server versions prior to 9.1, a listener whose enabled attribute was set to false returned a 404 response code for any requests sent to it. To achieve this behavior in the current Enterprise Server version, set the listener's enabled attribute to true, and set every associated virtual server's state to off. A virtual-server lists its associated listeners in its network-listeners attribute. jk-enabled false (optional) If true, enables mod_jk support for this listener. port none Port number on which the listener listens. Legal values are 1 - 65535. On UNIX, creating sockets that listen on ports 1 - 1024 requires superuser privileges. Configuring an SSL listener to listen on port 443 is standard. protocol none Specifies the name of the protocol associated with this network listener. Although this attribute is required, a protocol is automatically created with the same name as the network listener when you use the asadmin create-http-listener command to create a network listener. thread-pool none (Optional) Specifies the name of the thread-pool associated with this network listener. transport none Specifies the name of the transport associated with this network listener. Although this attribute is required, the default transport is used when you use the asadmin create-http-listener command to create a network listener.

network-listeners

Contains network listeners.

Superelements

network-config

Subelements

The following table describes subelements for the network-listeners element.

network-listeners Subelements

Element Required Description network-listener one or more Configures a network listener.