Skip navigation.
Downloads | Product Documentation | Support

WebLogic Server Configuration Reference

# 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 52-1 NetworkChannel 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: 50 Minimum: 0
COMEnabled | Deprecated. Indicates whether plaintext (non-SSL) COM traffic is enabled. | Default: false Secure value: false
ChannelWeight | Deprecated. A weight to give this channel when creating server-to-server connections. | Default: 50 Minimum: 1 Maximum: 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: seconds Default: 60 Secure value: 60 Minimum: 0 Maximum: 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: seconds Default: 60 Secure value: 60 Minimum: 0 Maximum: 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: 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. | Default: 1000 Minimum: 0 Maximum: 231-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: false Secure value: false
HTTPSEnabled | Deprecated. Whether or not secure (SSL) HTTP traffic is enabled. | Default: false Secure 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: 8001 Minimum: 1 Maximum: 65534
ListenPortEnabled | Deprecated. Whether or not plaintext port is enabled for the channel. | Default: false Secure 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: milliseconds Default: 5000 Secure value: 5000 Minimum: 0 Maximum: 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: milliseconds Default: 25000 Secure value: 25000 Minimum: 0 Maximum: 231-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: bytes Default: 10000000 Secure value: 10000000 Minimum: 4096 Maximum: 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: bytes Default: 10000000 Secure value: 10000000 Minimum: 4096 Maximum: 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: bytes Default: 10000000 Secure value: 10000000 Minimum: 4096 Maximum: 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: false Secure 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: 8002 Minimum: 1 Maximum: 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: false Secure 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: false Secure 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: false Secure 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: seconds Default: 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: seconds Default: 40 Secure value: 40
TunnelingEnabled | Deprecated. Enables tunneling via http. | Default: false Secure value: false