NetworkAccessPointMBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

A server can specifiy additional network connections by using a NetworkAccessPointMBean. The NetworkAccessPointMBean is also used to set the listen address and external DNS name that a server uses for a particular channel.

       
Since7.0.0.0
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.configuration.NetworkAccessPointMBean

For more information, see:

Factory Methods


Attributes

This section describes the following attributes:


AcceptBacklog

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.

For more information, see:

       
Privileges Read/Write
Typeint
Minimum value0

CachingDisabled

Private property that disables caching in proxies.

       
Privileges Read only
Typeboolean
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

ChannelIdentityCustomized

Whether or not the channel's custom identity should be used. This setting only has an effect if the server is using a customized keystore. By default the channel's identity is inherited from the server's identity.

For more information, see:

       
Privileges Read/Write
Typeboolean

ChannelWeight

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

       
Privileges Read/Write
Typeint
Default Value50
Minimum value1
Maximum value100

ClientCertificateEnforced

Specifies whether clients must present digital certificates from a trusted certificate authority to WebLogic Server on this channel.

       
Privileges Read/Write
Typeboolean
Secure valuetrue

ClusterAddress

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.

For more information, see:

       
Privileges Read/Write
Typejava.lang.String

CompleteMessageTimeout

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 ServerTemplateMBean.

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.

       
Privileges Read/Write
Typeint
Minimum value0
Maximum value480

ConnectTimeout

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.

       
Privileges Read/Write
Typeint
Minimum value0
Maximum value240

CustomPrivateKeyAlias

The string alias used to store and retrieve the channel's private key in the keystore. This private key is associated with the server's digital certificate. A value of null indicates that the network channel uses the alias specified in the server's SSL configuration.

For more information, see:

       
Privileges Read/Write
Typejava.lang.String

CustomPrivateKeyPassPhrase

The passphrase used to retrieve the server's private key from the keystore. This passphrase is assigned to the private key when it is generated. A value of null indicates that the network channel uses the pass phrase specified in the server's SSL configuration.

For more information, see:

       
Privileges Read/Write
Typejava.lang.String
Encryptedtrue

CustomPrivateKeyPassPhraseEncrypted

The encrypted form of passphrase used to retrieve the server's private key from the keystore.

       
Privileges Read/Write
Typebyte[]
Encryptedtrue

DynamicallyCreated

Return whether the MBean was created dynamically or is persisted to config.xml

       
Privileges Read only
Typeboolean
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

Enabled

Specifies whether this channel should be started.

       
Privileges Read/Write
Typeboolean
Default Valuetrue

HttpEnabledForThisProtocol

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

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

       
Privileges Read/Write
Typeboolean
Default Valuetrue

Id

Return the unique id of this MBean instance

       
Privileges Read only
Typelong
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

IdleConnectionTimeout

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 ServerTemplateMBean.

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

       
Privileges Read/Write
Typeint
Minimum value0

ListenAddress

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.

For more information, see:

       
Privileges Read/Write
Typejava.lang.String

ListenPort

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.

For more information, see:

       
Privileges Read/Write
Typeint

LoginTimeoutMillis

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.

For more information, see:

       
Privileges Read/Write
Typeint
Minimum value0
Maximum value100000

MaxBackoffBetweenFailures

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

       
Privileges Read/Write
Typeint
Minimum value0

MaxConnectedClients

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

       
Privileges Read/Write
Typeint
Default Value2147483647

MaxMessageSize

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.

       
Privileges Read/Write
Typeint
Minimum value4096
Maximum value100000000

MBeanInfo

Returns the MBean info for this MBean.

Deprecated.

       
Privileges Read only
Typejavax.management.MBeanInfo
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

Name

The name of this network channel.

       
Privileges Read/Write
Typejava.lang.String
Default Value<unknown>

Notes

Optional information that you can include to describe this configuration.

WebLogic Server saves this note in the domain's configuration file (config.xml) as XML PCDATA. All left angle brackets (<) are converted to the XML entity &lt;. Carriage returns/line feeds are preserved.

Note:

If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.

       
Privileges Read/Write
Typejava.lang.String

ObjectName

Returns the ObjectName under which this MBean is registered in the MBean server.

Deprecated.

       
Privileges Read only
Typeweblogic.management.WebLogicObjectName
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

OutboundEnabled

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 false.

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.

For more information, see:

       
Privileges Read/Write
Typeboolean

OutboundPrivateKeyAlias

The string alias used to store and retrieve the outbound private key in the keystore. This private key is associated with either a server or a client digital certificate. This attribute value is derived from other settings and cannot be physically set.

The returned value is determined as follows:



For more information, see:

       
Privileges Read only
Typejava.lang.String

OutboundPrivateKeyEnabled

Specifies whether the identity specifed by CustomPrivateKeyAlias should be used for outbound SSL connections on this channel. In normal circumstances the outbound identity is determined by the caller's environment.

       
Privileges Read/Write
Typeboolean

OutboundPrivateKeyPassPhrase

The passphrase used to retrieve the outbound private key from the keystore. This passphrase is assigned to the private key when it is generated. This attribute value is derived from other settings and cannot be physically set.

The returned value is determined as follows:



For more information, see:

       
Privileges Read only
Typejava.lang.String

Parent

Return the immediate parent for this MBean

       
Privileges Read/Write
Type

PrivateKeyAlias

The string alias used to store and retrieve the channel's private key in the keystore. This private key is associated with the server's digital certificate. This value is derived from other settings on the channel and cannot be physically set.

For more information, see:

       
Privileges Read only
Typejava.lang.String

PrivateKeyPassPhrase

The passphrase used to retrieve the server's private key from the keystore. This passphrase is assigned to the private key when it is generated. This value is derived from other settings on the channel and cannot be physically set.

For more information, see:

       
Privileges Read only
Typejava.lang.String

Protocol

The protocol this network channel should use for connections.

       
Privileges Read/Write
Typejava.lang.String
Default Valuet3

ProxyAddress

The IP address or DNS name of the HTTP proxy to use for outbound connections on this channel. The HTTP proxy must support the CONNECT tunneling command.

This option is only effective when OutboundEnabled is set on the channel.

       
Privileges Read/Write
Typejava.lang.String

ProxyPort

The port of the HTTP proxy to use for outbound connections on this channel. The HTTP proxy must support the CONNECT tunneling command.

This option is only effective when OutboundEnabled and ProxyHost are set on the channel.

       
Privileges Read/Write
Typeint
Default Value80

PublicAddress

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.

For more information, see:

       
Privileges Read/Write
Typejava.lang.String

PublicPort

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.

For more information, see:

       
Privileges Read/Write
Typeint

Registered

Returns false if the MBean represented by this object has been unregistered.

Deprecated.

       
Privileges Read only
Typeboolean
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

SDPEnabled

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.

       
Privileges Read/Write
Typeboolean

TimeoutConnectionWithPendingResponses

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.

       
Privileges Read/Write
Typeboolean

TunnelingClientPingSecs

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 ServerTemplateMBean. (Requires you to enable tunneling for the network channel.)

For more information, see:

       
Privileges Read/Write
Typeint
Minimum value1

TunnelingClientTimeoutSecs

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 ServerTemplateMBean. (Requires you to enable tunneling for the network channel.)

For more information, see:

       
Privileges Read/Write
Typeint
Minimum value1

TunnelingEnabled

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

       
Privileges Read/Write
Typeboolean

TwoWaySSLEnabled

Specifies whether this network channel uses two way SSL.

       
Privileges Read/Write
Typeboolean
Secure valuetrue

Type

Returns the type of the MBean.

       
Privileges Read only
Typejava.lang.String
Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

UseFastSerialization

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.

       
Privileges Read/Write
Typeboolean


Operations

This section describes the following operations:


freezeCurrentValue

If the specified attribute has not been set explicitly, and if the attribute has a default value, this operation forces the MBean to persist the default value.

Unless you use this operation, the default value is not saved and is subject to change if you update to a newer release of WebLogic Server. Invoking this operation isolates this MBean from the effects of such changes.

Note:

To insure that you are freezing the default value, invoke the restoreDefaultValue operation before you invoke this.

This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute for which some other value has been set.

Deprecated. 9.0.0.0

   
Operation Name"freezeCurrentValue"
ParametersObject [] {  attributeName }

where:

  • attributeName is an object of type java.lang.String that specifies:

    attributeName

SignatureString [] { "java.lang.String" }
Returns void
Exceptions
  • javax.management.AttributeNotFoundException
  • javax.management.MBeanException

getInheritedProperties

return all properties' names whose value is inherited from template mbean. this is a convenient method to get inheritance info on multiple properties in one jmx call.

   
Operation Name"getInheritedProperties"
ParametersObject [] {  propertyNames }

where:

  • propertyNames is an object of type [Ljava.lang.String; that specifies:

    properties to check

SignatureString [] { "[Ljava.lang.String;" }
Returns class

isInherited

Check if the value of a property is inherited from template mbean or not.

   
Operation Name"isInherited"
ParametersObject [] {  propertyName }

where:

  • propertyName is an object of type java.lang.String that specifies:

    the name of the property

SignatureString [] { "java.lang.String" }
Returns boolean

isSet

Returns true if the specified attribute has been set explicitly in this MBean instance.

   
Operation Name"isSet"
ParametersObject [] {  propertyName }

where:

  • propertyName is an object of type java.lang.String that specifies:

    property to check

SignatureString [] { "java.lang.String" }
Returns boolean

restoreDefaultValue

If the specified attribute has a default value, this operation removes any value that has been set explicitly and causes the attribute to use the default value.

Default values are subject to change if you update to a newer release of WebLogic Server. To prevent the value from changing if you update to a newer release, invoke the freezeCurrentValue operation.

This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute that is already using the default.

Deprecated. 9.0.0.0

   
Operation Name"restoreDefaultValue"
ParametersObject [] {  attributeName }

where:

  • attributeName is an object of type java.lang.String that specifies:

    attributeName

SignatureString [] { "java.lang.String" }
Returns void
Exceptions
  • javax.management.AttributeNotFoundException

unSet

Restore the given property to its default value.

   
Operation Name"unSet"
ParametersObject [] {  propertyName }

where:

  • propertyName is an object of type java.lang.String that specifies:

    property to restore

SignatureString [] { "java.lang.String" }
Returns void