Sun GlassFish Enterprise Server v3 Domain File Format Reference

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.

Table 1–115 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.

Note –

Network listeners are affected by properties of http-service.

Superelements

network-listeners

Subelements

none

Attributes

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

Table 1–116 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.

Table 1–117 network-listeners Subelements


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