NetworkAccessPoint
Description
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.
Syntax
<NetworkAccessPoint AcceptBacklog="number ChannelWeight="number ClusterAddress="String CompleteMessageTimeout="number of seconds HttpEnabledForThisProtocol=( "true" | "false" ) IdleConnectionTimeout="number of seconds ListenAddress="String ListenPort="number LoginTimeoutMillis="number of milliseconds MaxMessageSize="number of bytes Name="String Notes="String OutboundEnabled=( "true" | "false" ) Protocol=( "t3" | "iiop" | "com" | "http" | "t3s" | "iiops" | "https" | "admin" ) PublicAddress="String PublicPort="number TunnelingClientPingSecs="number of seconds TunnelingClientTimeoutSecs="number of seconds TunnelingEnabled=( "true" | "false" ) Type="String
/>
Parent Elements
Attributes
| AcceptBacklog | Allowed backlog of connection requests on the listen port. -1 implies that this value is inherited from the channel. | Admin Console field label: Accept BacklogDefault: -1Minimum: -1 |
| ChannelWeight | A weight to give this channel when creating server-to-server connections. | Default: 50Minimum: 1Maximum: 100 |
| ClusterAddress | This channel's cluster address. If this is not set, the public address is used and if this is not set then the cluster address from the cluster configuration is used in its place. | Admin Console field label: Cluster AddressRequired: no |
| CompleteMessageTimeout | The maximum number of seconds spent waiting for a complete 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. -1 implies that this value is inherited from the channel. | Admin Console field label: Complete Message TimeoutUnits: secondsDefault: -1Minimum: -1Maximum: 480 |
| HttpEnabledForThisProtocol | Whether or not this port will accept HTTP requests. HTTP is generally required by binary protocols for downloading stubs and other resources. | Admin Console field label: HTTP Enabled for This ProtocolDefault: true |
| IdleConnectionTimeout | The maximum number of seconds an connection is allowed to be idle before it is closed by the server. This attribute helps guard against server deadlock through too many open connections. -1 implies that this value is inherited from the default channel. | Admin Console field label: Idle Connection TimeoutUnits: secondsDefault: -1Minimum: -1 |
| ListenAddress | A value of null indicates that this value is inherited from the server. | Admin Console field label: Listen AddressRequired: no |
| ListenPort | The listen port for the channel. -1 implies that this value is inherited from the server. | Admin Console field label: Listen PortDefault: -1 |
| LoginTimeoutMillis | The login timeout for the server, in milliseconds. This value must be equal to or greater than 0. -1 implies that this value is inherited from the channel. | Admin Console field label: Login TimeoutUnits: millisecondsDefault: -1Minimum: -1Maximum: 100000 |
| MaxMessageSize | Specify the maximum 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. | Admin Console field label: Maximum Message SizeUnits: bytesDefault: 10000000 |
| Name | The name of this NetworkAccessPoint. | Admin Console field label: NameRequired: noDefault: <unknown> |
| Notes | Optional information that you can include to describe this configuration. | Required: no |
| OutboundEnabled | Whether or not new server-to-server connections may consider this channel when initiating a connection. This is only relevant if the connection needs to be bound to the channel's listen address. By default connections are initiated using a local address selected by the underlying hardware. This will only work for binary protocols which support both outbound and inbound traffic. | Admin Console field label: Outbound EnabledDefault: false |
| Protocol | The protocol that will be discriminated by this NetworkAccessPoint. | Admin Console field label: ProtocolRequired: noDefault: t3 |
| PublicAddress | The external address for the current server, which will be sent to clients. This will be required for the configurations in which need to cross a firewall doing Network Address Translation. This property supercedes ExternalDNSName. If unset then this value is inherited, first from the ListenAddress, and then from the ServerMBean. | Admin Console field label: External Listen AddressRequired: no |
| PublicPort | The external listen port for the channel. If unset then this value is inherited, first from the ListenPort, and then from the ServerMBean. | Admin Console field label: External Listen PortDefault: -1 |
| TunnelingClientPingSecs | Interval (in seconds) at which to ping an http-tunneled client to see if its still alive. -1 implies that this value is inherited from the channel. | Admin Console field label: Tunneling Client PingUnits: secondsDefault: -1 |
| TunnelingClientTimeoutSecs | Duration (in seconds) after which a missing http-tunneled client is considered dead. -1 implies that this value is inherited from the channel. | Admin Console field label: Tunneling Client TimeoutUnits: secondsDefault: -1 |
| TunnelingEnabled | Enables tunneling for those protocols that support tunneling. Each channel explicitly defaults to off and you will need to explicitly configure it to be on if you require tunneling. This value is not inherited from the Server. | Admin Console field label: Tunneling EnabledDefault: false |
| Type | Returns the type of the MBean. | Required: no |
|
|
|