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"
  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" )
/>

 

---

Parent Elements

• Domain

 

---

Attributes

Table 46-1 NetworkChannel attributes

Attribute	Description	Range of Values and Default
AcceptBacklog	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.	Admin Console field label: Accept Backlog Required: no Default: 50 Minimum: 0
COMEnabled	Indicates whether or not plaintext (non-SSL) COM traffic is enabled.	Admin Console field label: COM Enabled Required: no Default: false
ChannelWeight	A weight to give this channel when creating server-to-server connections.	Admin Console field label: Channel Weight Required: no Default: 50 Minimum: 1 Maximum: 100
ClusterAddress	This channel's cluster address. If this is not set, the cluster address from the cluster configuration is used in its place.	Admin Console field label: Cluster Address Required: no
CompleteCOMMessageTimeout	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.	Admin Console field label: Complete COM Message Timeout Required: no Units: seconds Default: 60 Secure value: 60 Minimum: 0 Maximum: 480
CompleteHTTPMessageTimeout	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.	Admin Console field label: Complete HTTP Message Timeout Required: no Units: seconds Default: 60 Secure value: 60 Minimum: 0 Maximum: 480
CompleteT3MessageTimeout	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.	Admin Console field label: Complete T3 Message Timeout Required: no Units: seconds Default: 60 Secure value: 60 Minimum: 0 Maximum: 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.	Required: no Default: 1000 Minimum: 0 Maximum: 231-1
Description	Optional short description of this channel for console display purposes. For long descriptions, use the "Notes" field.	Admin Console field label: Description Required: no
HTTPEnabled	Whether or not plaintext (non-SSL) HTTP traffic is enabled.	Admin Console field label: HTTP Enabled Required: no Default: false Secure value: false
HTTPSEnabled	Whether or not secure (SSL) HTTP traffic is enabled.	Admin Console field label: HTTPS Enabled Required: no Default: false Secure value: true
ListenPort	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.	Admin Console field label: Listen Port Required: no Default: 8001 Minimum: 1 Maximum: 65534
ListenPortEnabled	Whether or not plaintext port is enabled for the channel.	Admin Console field label: Listen Port Enabled Required: no Default: false Secure value: false
LoginTimeoutMillis	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.	Admin Console field label: Login Timeout Required: no Units: milliseconds Default: 5000 Secure value: 5000 Minimum: 0 Maximum: 100000
LoginTimeoutMillisSSL	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.	Admin Console field label: SSL Login Timeout Required: no Units: milliseconds Default: 25000 Secure value: 25000 Minimum: 0 Maximum: 231-1
MaxCOMMessageSize	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.	Admin Console field label: Max COM Message Size Required: no Units: bytes Default: 10000000 Secure value: 10000000 Minimum: 4096 Maximum: 2000000000
MaxHTTPMessageSize	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.	Admin Console field label: Max HTTP Message Size Required: no Units: bytes Default: 10000000 Secure value: 10000000 Minimum: 4096 Maximum: 2000000000
MaxT3MessageSize	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.	Admin Console field label: Max T3 Message Size Required: no Units: bytes Default: 10000000 Secure value: 10000000 Minimum: 4096 Maximum: 2000000000
Name	The name of the channel. The name must not start with ".WL".	Admin Console field label: Name Required: no
Notes	Optional information that you can include to describe this configuration.	Admin Console field label: Notes Required: no
OutgoingEnabled	Whether or not new server-to-server connections may consider this channel when initiating.	Admin Console field label: Outgoing Enabled Required: no Default: true Secure value: true
SSLListenPort	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.	Admin Console field label: SSL Listen Port Required: no Default: 8002 Minimum: 1 Maximum: 65534
SSLListenPortEnabled	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.	Admin Console field label: SSL Listen Port Enabled Required: no Default: false Secure value: true
T3Enabled	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).	Admin Console field label: T3 Enabled Required: no Default: false Secure value: false
T3SEnabled	Whether or not secure T3 traffic is enabled. Note that it is not possible to disable T3 traffic on the default channel(s).	Admin Console field label: T3S Enabled Required: no Default: false Secure value: false
Targets	The targets in the current domain on which this item can be deployed.	Required: no
TunnelingClientPingSecs	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.	Admin Console field label: Tunneling Client Ping Required: no Units: seconds Default: 45
TunnelingClientTimeoutSecs	Duration (in seconds) after which a missing http-tunneled client is considered dead. Individual servers may override this value using a NetworkAccessPointMBean.	Admin Console field label: Tunneling Client Timeout Required: no Units: seconds Default: 40 Secure value: 40
TunnelingEnabled	Enables tunneling via http.	Admin Console field label: Tunneling Enabled Required: no Default: false Secure value: false