NetworkChannel

NetworkChannel

Description

This MBean defines a network channel. A network channel is used to configure additional ports for a server beyond its default listen ports. Network channels do not support IIOP.
A network channel can be targeted at multiple clusters and servers. Targeting a channel at a cluster targets it at every server that is a member of that cluster. A server can support multiple channels. A server can fine-tune its network channel settings by using a NetworkAccessPointMBean. The NetworkAccessPointMBean also servers to set the listen address and external DNS name that a server uses for a particular channel.
A server serves up to three default listen ports: ServerMBean ListenPort, ServerMBean AdministrationPort, and SSLMBean ListenPort. The default listen ports form implicit channel(s) of weight 50.
A network channel also defines the creation of server-to-server connections. If a server is initiating a new connection to another server, the highest weighted common (same named) channel that supports the desired protocol is used to determine which port to contact.

Syntax
<NetworkChannel


AcceptBacklog="number


BoundOutgoingEnabled=( "true" | "false" )


COMEnabled=( "true" | "false" )


ChannelWeight="number


ClusterAddress="String


CompleteCOMMessageTimeout="number of seconds


CompleteHTTPMessageTimeout="number of seconds


CompleteT3MessageTimeout="number of seconds


DeploymentOrder="number


Description="String


HTTPEnabled=( "true" | "false" )


HTTPSEnabled=( "true" | "false" )


ListenPort="number


ListenPortEnabled=( "true" | "false" )


LoginTimeoutMillis="number of milliseconds


LoginTimeoutMillisSSL="number of milliseconds


MaxCOMMessageSize="number of bytes


MaxHTTPMessageSize="number of bytes


MaxT3MessageSize="number of bytes


Name="String


Notes="String


OutgoingEnabled=( "true" | "false" )


SSLListenPort="number


SSLListenPortEnabled=( "true" | "false" )


T3Enabled=( "true" | "false" )


T3SEnabled=( "true" | "false" )


Targets="list of Target names


TunnelingClientPingSecs="number of seconds


TunnelingClientTimeoutSecs="number of seconds


TunnelingEnabled=( "true" | "false" )


Type="String



/>
Parent Elements

Domain

Attributes

Attribute

Description

Range of Values and Default
AcceptBacklog Deprecated. Allowed backlog of connection requests on the listen port(s). Individual servers may override this value using a NetworkAccessPointMBean. Setting the backlog to 0 may prevent accepting any incoming connection on some of the OS. Default: 50Minimum: 0
BoundOutgoingEnabled Deprecated. Bind new outgoing server side T3 or T3S connections to the server channel's listen address. Other protocols ignore this field. This field is ignored for connections initiated via URLs, it takes effect if and only if the connection was initiated by accessing a remote reference (such as an EJB or RMI stub.) Default: false
COMEnabled Deprecated. Indicates whether plaintext (non-SSL) COM traffic is enabled. Default: falseSecure value: false
ChannelWeight Deprecated. A weight to give this channel when creating server-to-server connections. Default: 50Minimum: 1Maximum: 100
ClusterAddress Deprecated. This channel's cluster address. If this is not set, the cluster address from the cluster configuration is used in its place. Required: no
CompleteCOMMessageTimeout Deprecated. The maximum number of seconds spent waiting for a complete COM message to be received. This attribute helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending. Individual servers may override this value using a NetworkAccessPointMBean. Units: secondsDefault: 60Secure value: 60Minimum: 0Maximum: 480
CompleteHTTPMessageTimeout Deprecated. The maximum number of seconds spent waiting for a complete HTTP message to be received. This attribute helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending. Individual servers may override this value using a NetworkAccessPointMBean. Units: secondsDefault: 60Secure value: 60Minimum: 0Maximum: 480
CompleteT3MessageTimeout Deprecated. The maximum number of seconds spent waiting for a complete T3 message to be received. This attribute helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending. Individual servers may override this value using a NetworkAccessPointMBean. Units: secondsDefault: 60Secure value: 60Minimum: 0Maximum: 480
DeploymentOrder A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type. For example, the server prioritizes and deploys all EJBs before it prioritizes and deploys startup classes.Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters. Default: 1000Minimum: 0Maximum: 2³¹-1
Description Deprecated. Optional short description of this channel for console display purposes. For long descriptions, use the "Notes" field. Required: no
HTTPEnabled Deprecated. Whether or not plaintext (non-SSL) HTTP traffic is enabled. Default: falseSecure value: false
HTTPSEnabled Deprecated. Whether or not secure (SSL) HTTP traffic is enabled. Default: falseSecure value: true
ListenPort Deprecated. The plaintext (non-SSL) listen port for the channel. Individual servers may override this value, but may not enable the port if disabled here and may not disable the port if enabled here. Individual servers may override this value using a NetworkAccessPointMBean. Default: 8001Minimum: 1Maximum: 65534
ListenPortEnabled Deprecated. Whether or not plaintext port is enabled for the channel. Default: falseSecure value: false
LoginTimeoutMillis Deprecated. The login timeout for the server, in milliseconds. This value must be equal to or greater than 0. Individual servers may override this value using a NetworkAccessPointMBean. Units: millisecondsDefault: 5000Secure value: 5000Minimum: 0Maximum: 100000
LoginTimeoutMillisSSL Deprecated. Duration allowed for an SSL login sequence. If the duration is exceeded, the login is timed out. 0 to disable. Individual servers may override this value using a NetworkAccessPointMBean. Units: millisecondsDefault: 25000Secure value: 25000Minimum: 0Maximum: 2³¹-1
MaxCOMMessageSize Deprecated. The maximum COM message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. Individual servers may override this value using a NetworkAccessPointMBean. Units: bytesDefault: 10000000Secure value: 10000000Minimum: 4096Maximum: 2000000000
MaxHTTPMessageSize Deprecated. The maximum HTTP message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. Individual servers may override this value using a NetworkAccessPointMBean. Units: bytesDefault: 10000000Secure value: 10000000Minimum: 4096Maximum: 2000000000
MaxT3MessageSize Deprecated. The maximum T3 message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. Individual servers may override this value using a NetworkAccessPointMBean. Units: bytesDefault: 10000000Secure value: 10000000Minimum: 4096Maximum: 2000000000
Name Deprecated. The name of the channel. The name must not start with ".WL". Required: no
Notes Optional information that you can include to describe this configuration. Required: no
OutgoingEnabled Deprecated. Whether or not new server-to-server connections may consider this channel when initiating. Default: falseSecure value: true
SSLListenPort Deprecated. The SSL listen port for the channel. Individual server's may override this value, but may not enable the port if disabled here and may not disable the port if enabled here. SSL must be configured and enabled for this port to work. Individual servers may override this value using a NetworkAccessPointMBean. Default: 8002Minimum: 1Maximum: 65534
SSLListenPortEnabled Deprecated. Whether or not SSL port is enabled for the channel. SSL must be configured and enabled in addition to this setting for the SSL port to work. Default: falseSecure value: true
T3Enabled Deprecated. Whether or not plaintext (non-SSL) T3 traffic is enabled. Note that it is not possible to disable T3 traffic on the default channel(s). Default: falseSecure value: false
T3SEnabled Deprecated. Whether or not secure T3 traffic is enabled. Note that it is not possible to disable T3 traffic on the default channel(s). Default: falseSecure value: false
Targets The targets in the current domain on which this item can be deployed. Required: no
TunnelingClientPingSecs Deprecated. Interval (in seconds) at which to ping an http-tunneled client to see if its still alive. Individual servers may override this value using a NetworkAccessPointMBean. Units: secondsDefault: 45
TunnelingClientTimeoutSecs Deprecated. Duration (in seconds) after which a missing http-tunneled client is considered dead. Individual servers may override this value using a NetworkAccessPointMBean. Units: secondsDefault: 40Secure value: 40
TunnelingEnabled Deprecated. Enables tunneling via http. Default: falseSecure value: false
Type Returns the type of the MBean. Required: no

Attribute	Description	Range of Values and Default
AcceptBacklog	Deprecated. Allowed backlog of connection requests on the listen port(s). Individual servers may override this value using a NetworkAccessPointMBean. Setting the backlog to 0 may prevent accepting any incoming connection on some of the OS.	Default: 50Minimum: 0
BoundOutgoingEnabled	Deprecated. Bind new outgoing server side T3 or T3S connections to the server channel's listen address. Other protocols ignore this field. This field is ignored for connections initiated via URLs, it takes effect if and only if the connection was initiated by accessing a remote reference (such as an EJB or RMI stub.)	Default: false
COMEnabled	Deprecated. Indicates whether plaintext (non-SSL) COM traffic is enabled.	Default: falseSecure value: false
ChannelWeight	Deprecated. A weight to give this channel when creating server-to-server connections.	Default: 50Minimum: 1Maximum: 100
ClusterAddress	Deprecated. This channel's cluster address. If this is not set, the cluster address from the cluster configuration is used in its place.	Required: no
CompleteCOMMessageTimeout	Deprecated. The maximum number of seconds spent waiting for a complete COM message to be received. This attribute helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending. Individual servers may override this value using a NetworkAccessPointMBean.	Units: secondsDefault: 60Secure value: 60Minimum: 0Maximum: 480
CompleteHTTPMessageTimeout	Deprecated. The maximum number of seconds spent waiting for a complete HTTP message to be received. This attribute helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending. Individual servers may override this value using a NetworkAccessPointMBean.	Units: secondsDefault: 60Secure value: 60Minimum: 0Maximum: 480
CompleteT3MessageTimeout	Deprecated. The maximum number of seconds spent waiting for a complete T3 message to be received. This attribute helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending. Individual servers may override this value using a NetworkAccessPointMBean.	Units: secondsDefault: 60Secure value: 60Minimum: 0Maximum: 480
DeploymentOrder	A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type. For example, the server prioritizes and deploys all EJBs before it prioritizes and deploys startup classes.Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters.	Default: 1000Minimum: 0Maximum: 2³¹-1
Description	Deprecated. Optional short description of this channel for console display purposes. For long descriptions, use the "Notes" field.	Required: no
HTTPEnabled	Deprecated. Whether or not plaintext (non-SSL) HTTP traffic is enabled.	Default: falseSecure value: false
HTTPSEnabled	Deprecated. Whether or not secure (SSL) HTTP traffic is enabled.	Default: falseSecure value: true
ListenPort	Deprecated. The plaintext (non-SSL) listen port for the channel. Individual servers may override this value, but may not enable the port if disabled here and may not disable the port if enabled here. Individual servers may override this value using a NetworkAccessPointMBean.	Default: 8001Minimum: 1Maximum: 65534
ListenPortEnabled	Deprecated. Whether or not plaintext port is enabled for the channel.	Default: falseSecure value: false
LoginTimeoutMillis	Deprecated. The login timeout for the server, in milliseconds. This value must be equal to or greater than 0. Individual servers may override this value using a NetworkAccessPointMBean.	Units: millisecondsDefault: 5000Secure value: 5000Minimum: 0Maximum: 100000
LoginTimeoutMillisSSL	Deprecated. Duration allowed for an SSL login sequence. If the duration is exceeded, the login is timed out. 0 to disable. Individual servers may override this value using a NetworkAccessPointMBean.	Units: millisecondsDefault: 25000Secure value: 25000Minimum: 0Maximum: 2³¹-1
MaxCOMMessageSize	Deprecated. The maximum COM message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. Individual servers may override this value using a NetworkAccessPointMBean.	Units: bytesDefault: 10000000Secure value: 10000000Minimum: 4096Maximum: 2000000000
MaxHTTPMessageSize	Deprecated. The maximum HTTP message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. Individual servers may override this value using a NetworkAccessPointMBean.	Units: bytesDefault: 10000000Secure value: 10000000Minimum: 4096Maximum: 2000000000
MaxT3MessageSize	Deprecated. The maximum T3 message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests. Individual servers may override this value using a NetworkAccessPointMBean.	Units: bytesDefault: 10000000Secure value: 10000000Minimum: 4096Maximum: 2000000000
Name	Deprecated. The name of the channel. The name must not start with ".WL".	Required: no
Notes	Optional information that you can include to describe this configuration.	Required: no
OutgoingEnabled	Deprecated. Whether or not new server-to-server connections may consider this channel when initiating.	Default: falseSecure value: true
SSLListenPort	Deprecated. The SSL listen port for the channel. Individual server's may override this value, but may not enable the port if disabled here and may not disable the port if enabled here. SSL must be configured and enabled for this port to work. Individual servers may override this value using a NetworkAccessPointMBean.	Default: 8002Minimum: 1Maximum: 65534
SSLListenPortEnabled	Deprecated. Whether or not SSL port is enabled for the channel. SSL must be configured and enabled in addition to this setting for the SSL port to work.	Default: falseSecure value: true
T3Enabled	Deprecated. Whether or not plaintext (non-SSL) T3 traffic is enabled. Note that it is not possible to disable T3 traffic on the default channel(s).	Default: falseSecure value: false
T3SEnabled	Deprecated. Whether or not secure T3 traffic is enabled. Note that it is not possible to disable T3 traffic on the default channel(s).	Default: falseSecure value: false
Targets	The targets in the current domain on which this item can be deployed.	Required: no
TunnelingClientPingSecs	Deprecated. Interval (in seconds) at which to ping an http-tunneled client to see if its still alive. Individual servers may override this value using a NetworkAccessPointMBean.	Units: secondsDefault: 45
TunnelingClientTimeoutSecs	Deprecated. Duration (in seconds) after which a missing http-tunneled client is considered dead. Individual servers may override this value using a NetworkAccessPointMBean.	Units: secondsDefault: 40Secure value: 40
TunnelingEnabled	Deprecated. Enables tunneling via http.	Default: falseSecure value: false
Type	Returns the type of the MBean.	Required: no