KernelMBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

This bean represents the configuration of the core message passing kernel on both WebLogic clients and servers.

ServerMBean extends this bean to represent the configuration of a server.

       
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.KernelMBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Subtypes The following MBeans extend or implement this MBean type:


    Related MBeans

    This section describes attributes that provide access to other MBeans.


    ExecuteQueues

    Returns the execute queues configured for this server.

               
    Factory MethodscreateExecuteQueue (java.lang.String name)

    destroyExecuteQueue (ExecuteQueueMBean queue)

    Factory methods do not return objects.

    See Using factory methods.

    Lookup OperationlookupExecuteQueue(String name)

    Returns a javax.management.ObjectName for the instance of ExecuteQueueMBean named name.

    Privileges Read only
    TypeExecuteQueueMBean[]
    Relationship type: Containment.

    IIOP

    Returns the kernel's IIOP configuration. An IIOP MBean is always linked to a particular Kernel and cannot be changed. Individual attributes on the IIOP MBean may be changed, as documented, but the MBean itself may not.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeIIOPMBean
    Relationship type: Containment.

    Log

    Returns the Log settings for this Kernel. An Log MBean is always linked to a particular Kernel and cannot be changed. Individual attributes on the Log MBean may be changed, as documented, but the MBean itself may not.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeLogMBean
    Relationship type: Containment.

    SSL

    Returns the kernel's SSL configuration. An SSL MBean is always linked to a particular Kernel and cannot be changed. Individual attributes on the SSL MBean may be changed, as documented, but the MBean itself may not.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeSSLMBean
    Relationship type: Containment.


    Attributes

    This section describes the following attributes:


    AddWorkManagerThreadsByCpuCount

    Enables increased efficiency of the self-tuning thread pool by aligning it with the Exalogic processor architecture threading capabilities. Enabling this attribute increases efficiency during I/O in environments with high network throughput and should be used only when configuring a WebLogic domain 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.

           
    Available Since Release 10.3.4.0
    Privileges Read/Write
    Typeboolean

    AdministrationProtocol

    Returns the protocol to be used for administrative connections when none is specified.

           
    Privileges Read/Write
    Typejava.lang.String
    Legal Values
    • t3s
    • https
    • iiops
    • t3
    • http
    • iiop

    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.

    CompleteCOMMessageTimeout

    The maximum number of seconds spent waiting for a complete COM message to be received. This setting does not apply to any network channels that you have configured for this server.

    This timeout helps guard against a denial of service attack in which a caller indicates that they will be sending a message of a certain size which they never finish sending.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

    For more information, see:

           
    Available Since Release 7.0.0.0
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Maximum value480

    CompleteHTTPMessageTimeout

    The maximum number of seconds spent waiting for a complete HTTP message to be received. If you configure network channels for this server, each channel can override this HTTP message timeout.

    This timeout helps guard against a denial of service attack in which a caller indicates that it will be sending a message of a certain size which it never finishes sending.

    A value of -1 indicates that this value should be obtained from network channels configured for this server.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Maximum value480
    Secure value60

    CompleteIIOPMessageTimeout

    The maximum number of seconds spent waiting for a complete IIOP message to be received. 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.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

           
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Maximum value480
    Secure value60

    CompleteMessageTimeout

    The maximum number of seconds that this server waits for a complete message to be received. If you configure network channels for this server, each channel can override this message timeout.

    This timeout helps guard against a denial of service attack in which a caller indicates that it will be sending a message of a certain size which it never finishes sending.

    CompleteMessageTimeout affects the HTTP Response, such that if WebLogic Server discovers sockets inactive for longer than the CompleteMessageTimeout, the server will close these sockets.

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value60
    Minimum value0
    Maximum value480

    CompleteT3MessageTimeout

    The maximum number of seconds spent waiting for a complete T3 message to be received. If you configure network channels for this server, each channel can override this T3 message timeout.

    This timeout helps guard against a denial of service attack in which a caller indicates that it will be sending a message of a certain size which it never finishes sending.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getCompleteMessageTimeout()

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Maximum value480
    Secure value60

    ConnectTimeout

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

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value0
    Minimum value0
    Maximum value240

    DefaultProtocol

    The protocol to use for connections when none is specified.

           
    Privileges Read/Write
    Typejava.lang.String
    Default Valuet3
    Legal Values
    • t3
    • t3s
    • http
    • https
    • iiop
    • iiops

    DefaultSecureProtocol

    The protocol to use for secure connections when none is specified.

           
    Privileges Read/Write
    Typejava.lang.String
    Default Valuet3s
    Legal Values
    • t3s
    • https
    • iiops

    DGCIdlePeriodsUntilTimeout

    The number of idle periods allowed before object is collected.

           
    Privileges Read/Write
    Typeint
    Default Value5

    GatheredWritesEnabled

    Enables gathered writes over NIO socket channels. Enabling this attribute increases efficiency during I/O in environments with high network throughput and should be used only when configuring a WebLogic domain 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.

           
    Privileges Read/Write
    Typeboolean

    IdleConnectionTimeout

    The maximum number of seconds that a connection is allowed to be idle before it is closed by the server. The T3 and T3S protocols ignore this attribute. If you configure network channels for this server, each channel can override this idle connection message timeout.

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

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value65
    Minimum value0
    Secure value65

    IdleIIOPConnectionTimeout

    The maximum number of seconds an IIOP connection is allowed to be idle before it is closed by the server. This timeout helps guard against server deadlock through too many open connections.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getIdleConnectionTimeout()

           
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Secure value60

    IdlePeriodsUntilTimeout

    The number of idle periods until peer is considered unreachable

           
    Privileges Read/Write
    Typeint
    Default Value4
    Minimum value4
    Maximum value65534

    IIOPTxMechanism

    Configures IIOP propagate transactions using either WebLogic-specific JTA or the OMG-specified OTS.

    It is not possible to use both because it affects the way transactions are negotiated.

    Deprecated. 8.1.0.0 use IIOPMBean#getTxMechanism()

           
    Privileges Read/Write
    Typejava.lang.String
    Default Valueots
    Legal Values
    • ots
    • jta

    InstrumentStackTraceEnabled

    Specifies whether the server returns stack traces for RMI calls that generate exceptions.

    With RMI stack tracking enabled, if a client issues an RMI call to a server subsystem or to a module running within the server, and if the subsystem or module generates an exception that includes a stack trace, the server will return the exception as well as the stack trace. With it disabled, the server will return the exception without the stack trace details.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    LogRemoteExceptionsEnabled

    Specifies whether the server message log includes exceptions that are raised in remote systems.

           
    Privileges Read/Write
    Typeboolean
    Secure valuetrue

    MaxCOMMessageSize

    The maximum number of bytes allowed in messages that are received over the COM protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

    This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

    A value of -1 causes the COM protocol to use the maximums that are specified elsewhere along the order of precedence.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

    For more information, see:

           
    Available Since Release 7.0.0.0
    Privileges Read/Write
    Typeint
    Default Value-1

    MaxHTTPMessageSize

    The maximum number of bytes allowed in messages that are received over the HTTP protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

    This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

    A value of -1 causes the HTTP protocol to use the maximums that are specified elsewhere along the order of precedence.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value-1

    MaxIIOPMessageSize

    The maximum number of bytes allowed in messages that are received over the IIOP protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

    This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

    A value of -1 causes the IIOP protocol to use the maximums that are specified elsewhere along the order of precedence.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value-1

    MaxMessageSize

    The maximum number of bytes allowed in messages that are received over all supported protocols, unless overridden by a protocol-specific setting or a custom channel setting.

    The order of precedence for setting message size maximums is as follows:

    1. A channel-wide maximum in a custom network channel.

    2. A protocol-specific setting in the default network channel.
      See



    3. The message maximum in this attribute.

    This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value10000000
    Minimum value4096
    Maximum value2000000000
    Secure value10000000

    MaxOpenSockCount

    The maximum number of open sockets allowed in server at a given point of time.

    When the maximum threshold is reached, the server stops accepting new requests until the number of sockets drops below the threshold.

    A value less than 0 indicates an unlimited size.

           
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Maximum value2147483647

    MaxT3MessageSize

    The maximum number of bytes allowed in messages that are received over the T3 protocol. If you configure custom network channels for this server, each channel can override this maximum message size.

    This maximum message size helps guard against a denial of service attack in which a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

    A value of -1 causes the T3 protocol to use the maximums that are specified elsewhere along the order of precedence.

    Deprecated. 8.1.0.0 use NetworkAccessPointMBean#getMaxMessageSize()

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value-1

    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.

    MessagingBridgeThreadPoolSize

    Returns the size of the messaging bridge execute thread pool.

    Deprecated. 9.0.0.0 replaced by a Work Manager named weblogic.jms.MessagingBridge

           
    Privileges Read/Write
    Typeint
    Default Value5
    Minimum value-1
    Maximum value65534

    MuxerClass

    To enable non-blocking IO, enter weblogic.socket.NIOSocketMuxer in the Muxer Class field.

    The default value is null (not enabled). However, if ExalogicOptimizationsEnabled is true, the value is reset to weblogic.socket.NIOSocketMuxer.

           
    Privileges Read/Write
    Typejava.lang.String

    Name

    The user-specified name of this MBean instance.

    This name is included as one of the key properties in the MBean's javax.management.ObjectName:
    Name=user-specified-name

           
    Privileges Read/Write
    Typejava.lang.String

    NativeIOEnabled

    Specifies whether native I/O is enabled for the server.

    For more information, see:

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    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 the default server channel when initiating a connection. This is only relevant if the connection needs to be bound to the default 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. For the default channel this is usually what is wanted for IP-routing to be effective. Note that since the default is false, other outbound channels will be considered in preference to the default channel.

    Default administration channels, created when the domain-wide administration port is turned on, are always considered and bound when initiating an administrative connection. To allow IP-routing for administration traffic create custom admin with isOutboundEnabled set to false instead of enabling the domain-wide ADMIN port.

    For more information, see:

           
    Privileges Read/Write
    Typeboolean

    OutboundPrivateKeyEnabled

    Specifies whether the SSL identity specified by SSLMBean#ServerPrivateKeyAlias for this server should be used for outbound SSL connections on the default server channel. In normal circumstances the outbound identity is determined by the caller's environment.

    For more information, see:

           
    Privileges Read/Write
    Typeboolean

    Parent

    Return the immediate parent for this MBean

           
    Privileges Read/Write
    Type

    PeriodLength

    The time interval in milliseconds of the heartbeat period. A value of 0 indicates that heartbeats are turned off.

           
    Privileges Read/Write
    Typeint
    Default Value60000
    Minimum value0

    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.

    ReverseDNSAllowed

    Specifies whether the kernel is allowed to perform reverse DNS lookups.

           
    Privileges Read/Write
    Typeboolean

    ScatteredReadsEnabled

    Enables scattered reads over NIO socket channels. Enabling this attribute increases efficiency during I/O in environments with high network throughput and should be used only when configuring a WebLogic domain 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.

           
    Privileges Read/Write
    Typeboolean

    SocketBufferSizeAsChunkSize

    Specifies whether the server's buffer size for sending or receiving data through a raw socket should be set to 4KB.

    Otherwise, the server does not impose a limit to the buffer size and defers to the operating system. This option is useful only on some operating systems for improving performance. It should be disabled in most environments.

           
    Privileges Read/Write
    Typeboolean

    SocketReaders

    The number of socket reader threads

           
    Privileges Read/Write
    Typeint
    Default Value-1
    Minimum value-1
    Maximum value65534

    StdoutDebugEnabled

    Specifies whether the server sends messages of the DEBUG severity to standard out in addition to the log file. (Requires you to enable sending messages to standard out.)

    Deprecated. 9.0.0.0 replaced by LogMBean.StdoutSeverity For backward compatibility the changes to this attribute will be propagated to the LogMBean.

           
    Privileges Read/Write
    Typeboolean

    StdoutEnabled

    Specifies whether the server sends messages to standard out in addition to the log file.

    Other settings configure the minimum severity of a message that the server sends to standard out.

    Deprecated. 9.0.0.0 replaced by LogMBean.StdoutSeverity, for backward compatibility the changes to this attribute will be propagated to the LogMBean.

    For more information, see:

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    StdoutFormat

    The output format to use when logging to the console.

    Deprecated.

           
    Privileges Read/Write
    Typejava.lang.String
    Default Valuestandard
    Legal Values
    • standard
    • noid

    StdoutLogStack

    Specifies whether to dump stack traces to the console when included in logged message.

    Deprecated. 9.0.0.0

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    StdoutSeverityLevel

    The minimum severity of a message that the server sends to standard out. (Requires you to enable sending messages to standard out.)

    Deprecated. 9.0.0.0 Replaced by LogMBean.StdoutSeverity. For backward compatibility the changes to this attribute will be propagated to the LogMBean.

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value32
    Legal Values
    • 256
    • 128
    • 64
    • 16
    • 8
    • 32
    • 4
    • 2
    • 1
    • 0
    Secure value32

    StuckThreadMaxTime

    The number of seconds that a thread must be continually working before this server considers the thread stuck.

    For example, if you set this to 600 seconds, WebLogic Server considers a thread to be "stuck" after 600 seconds of continuous use.

    In Web Logic Server 9.x and later, it is recommended that you use the ServerFailureTriggerMBean in the OverloadProtectionMBean. The ServerFailureTriggerMBean transitions the server to a FAILED state after the specified number of stuck threads are detected. The OverloadProtectionMBean has options to suspend or shutdown a failed server.

    Deprecated. 9.0.0.0 replaced by ServerFailureTriggerMBean.getMaxStuckThreadTime()

           
    Privileges Read/Write
    Typeint
    Default Value600
    Minimum value0
    Maximum value2147483647

    StuckThreadTimerInterval

    The number of seconds after which WebLogic Server periodically scans threads to see if they have been continually working for the configured maximum length of time.

    For more information, see:

           
    Privileges Read/Write
    Typeint
    Default Value60
    Minimum value0
    Maximum value2147483647

    ThreadPoolPercentSocketReaders

    The percentage of execute threads from the default queue that can be used as socket readers.

           
    Privileges Read/Write
    Typeint
    Default Value33
    Minimum value1
    Maximum value99

    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.

    Use81StyleExecuteQueues

    Backward compatibility mode to switch to 8.1 execute queues instead of WorkManagers. Each of the WorkManagers is converted to an individual execute queue. Setting this attribute requires a server restart.

    For more information, see:

           
    Privileges Read/Write
    Typeboolean

    UseConcurrentQueueForRequestManager

    Reduces lock contention by using concurrent buffer queue to park incoming requests. Enabling this attribute increases throughput as requests are scheduled with out acquiring any locks.

           
    Available Since Release 10.3.6.0
    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

    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