Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Channel: Configuration

Configuration Options     Advanced Configuration Options     Related Tasks     Related Topics

This page allows you to define the configuration of this network channel.

A network channel is a configurable resource that defines the attributes of a network connection to WebLogic Server. You can use network channels to manage quality of service, meet varying connection requirements, and improve utilization of your systems and network resources.

Configuration Options

Name Description
Name

The name of this Network Channel.

MBean Attribute:
NetworkAccessPointMBean.Name

Changes take effect after you redeploy the module or restart the server.

Protocol

The protocol this network channel should use for connections.

MBean Attribute:
NetworkAccessPointMBean.Protocol

Changes take effect after you redeploy the module or restart the server.

Listen Address

The IP address or DNS name this network channel uses to listen for incoming connections. A value of null indicates that the network channel should obtain this value from the server's configuration.

MBean Attribute:
NetworkAccessPointMBean.ListenAddress

Changes take effect after you redeploy the module or restart the server.

Listen Port

The default TCP port this network channel uses to listen for regular (non-SSL) incoming connections. A value of -1 indicates that the network channel should obtain this value from the server's configuration.

MBean Attribute:
NetworkAccessPointMBean.ListenPort

Changes take effect after you redeploy the module or restart the server.

External Listen Address

The IP address or DNS name representing the external identity of this network channel. A value of null indicates that the network channel's Listen Address is also its external address. If the Listen Address is null,the network channel obtains its external identity from the server's configuration.

This is required for the configurations which need to cross a firewall doing Network Address Translation.

MBean Attribute:
NetworkAccessPointMBean.PublicAddress

External Listen Port

The externally published listen port for this network channel. A value of -1 indicates that the network channel's Listen Port is also its public listen port. If the Listen Port is -1,the network channel obtains its public listen port from the server's configuration.

MBean Attribute:
NetworkAccessPointMBean.PublicPort

Enabled

Specifies whether this channel should be started.

MBean Attribute:
NetworkAccessPointMBean.Enabled

Advanced Configuration Options

Name Description
Outbound Enabled

Specifies whether new server-to-server connections may consider this network channel when initiating a connection. This is only relevant if the connection needs to be bound to the network channel's listen address. This will only work for binary protocols that support both outbound and inbound traffic.

When this feature is not enabled, connections are initiated using a local address selected by the underlying hardware.

The default is true for all admin channels and false otherwise.

Outbound channels are selected at runtime either by virtue of the fact of being the only outbound-enabled channel for the required protocol, or by name in weblogic.jndi.Environment#setProviderChannel.

The HTTP protocol is implicitly enabled for all the outbound channels, but you need to use the WLS client library (HTTP client) and set the channel on the connection. See HttpURLConnection.setSocketFactory().

MBean Attribute:
NetworkAccessPointMBean.OutboundEnabled

Cluster Address

The address this network channel uses to generate EJB handles and failover addresses for use in a cluster. This value is determined according to the following order of precedence:

  1. If the cluster address is specified via the NAPMBean, then that value is used

  2. If this value is not specified, the value of PublicAddress is used.

  3. If PublicAddress is not set, this value is derive from the ClusterAddress attribute of the ClusterMbean.

  4. If ClusterMbean.clusterAddress is not set, this value is derive from the listen address of the NAPMbean.

MBean Attribute:
NetworkAccessPointMBean.ClusterAddress

Accept Backlog

The number of backlogged, new TCP connection requests that this network channel allows. A value of -1 indicates that the network channel obtains its backlog configuration from the server's configuration.

MBean Attribute:
NetworkAccessPointMBean.AcceptBacklog

Minimum value: 0

Maximum Backoff Between Failures

The maximum back off time between failures while accepting client connections. -1 implies that this value is inherited from the server.

MBean Attribute:
NetworkAccessPointMBean.MaxBackoffBetweenFailures

Minimum value: 0

HTTP Enabled for This Protocol

Specifies whether HTTP traffic should be allowed over this network channel.

HTTP is generally required by binary protocols for downloading stubs and other resources.

MBean Attribute:
NetworkAccessPointMBean.HttpEnabledForThisProtocol

Login Timeout

The amount of time that this network channel should wait for a connection before timing out. A value of 0 disables network channel login timeout. A value of -1 indicates that the network channel obtains this timeout value from the server's configuration.

MBean Attribute:
NetworkAccessPointMBean.LoginTimeoutMillis

Minimum value: 0

Maximum value: 100000

Complete Message Timeout

The maximum amount of time this network channel waits for a complete message to be received. A value of 0 disables network channel complete message timeout. A value of -1 indicates that the network channel obtains this timeout value from the ServerMBean.

This timeout 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.

MBean Attribute:
NetworkAccessPointMBean.CompleteMessageTimeout

Minimum value: 0

Maximum value: 480

Idle Connection Timeout

The maximum amount of time (in seconds) that a connection is allowed to be idle before it is closed by this network channel. A value of -1 indicates that the network channel obtains this timeout value from the ServerMBean.

This timeout helps guard against server deadlock through too many open connections.

MBean Attribute:
NetworkAccessPointMBean.IdleConnectionTimeout

Minimum value: 0

Connect Timeout

The amount of time that this network channel should wait to establish an outbound socket connection before timing out. A value of 0 disables network channel connect timeout.

MBean Attribute:
NetworkAccessPointMBean.ConnectTimeout

Minimum value: 0

Maximum value: 240

Timeout Connection With Pending Responses

Determines if connections with pending responses are allowed to timeout. It defaults to false. If set to true, the connection will be timed out for this channel if it exceeds the idleConnectionTimeout value.

Note: This setting only applies to IIOP connections.

MBean Attribute:
NetworkAccessPointMBean.TimeoutConnectionWithPendingResponses

Tunneling Enabled

Specifies whether tunneling via HTTP should be enabled for this network channel. This value is not inherited from the server's configuration.

MBean Attribute:
NetworkAccessPointMBean.TunnelingEnabled

Tunneling Client Ping

The interval (in seconds) at which this network channel should ping an HTTP-tunneled client to see if its still alive. A value of -1 indicates that the network channel obtains this interval from the ServerMBean. (Requires you to enable tunneling for the network channel.)

MBean Attribute:
NetworkAccessPointMBean.TunnelingClientPingSecs

Minimum value: 1

Tunneling Client Timeout

The amount of time (in seconds) after which this network channel considers a missing HTTP-tunneled client to be dead. A value of -1 indicates that the network channel obtains this timeout value from the ServerMBean. (Requires you to enable tunneling for the network channel.)

MBean Attribute:
NetworkAccessPointMBean.TunnelingClientTimeoutSecs

Minimum value: 1

Maximum Message Size

The maximum message size allowable in a message header.

This maximum 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.

MBean Attribute:
NetworkAccessPointMBean.MaxMessageSize

Minimum value: 4096

Maximum value: 100000000

Channel Weight

A weight to give this channel when creating server-to-server connections.

MBean Attribute:
NetworkAccessPointMBean.ChannelWeight

Minimum value: 1

Maximum value: 100

Maximum Connected Clients

The maximum number of clients that can be connected on this network channel.

MBean Attribute:
NetworkAccessPointMBean.MaxConnectedClients

Use Optimized Serialization

Specifies whether to use non-standard object serialization for performance. This option works in different ways for different protocols. In particular under IIOP this option uses Java serialization rather than RMI-IIOP serialization. In general using non-standard serialization is not suitable for interop scenarios and may imply some feature loss.

MBean Attribute:
NetworkAccessPointMBean.UseFastSerialization

Enable SDP Protocol

Enables Socket Direct Protocol (SDP) on this channel. Enable this attribute when configuring session replication enhancements for Managed Servers in a WebLogic cluster for Oracle Exalogic. For more information, see "Enabling Exalogic-Specific Enhancements in Oracle WebLogic Server 11g Release 1 (10.3.4)" in the Oracle Exalogic Deployment Guide.

MBean Attribute:
NetworkAccessPointMBean.SDPEnabled

Changes take effect after you redeploy the module or restart the server.

Related Tasks

Related Topics


Back to Top