ServerMBean
Overview | Related MBeans | Attributes | Operations
Overview
This class represents a WebLogic Server. A WebLogic Server is a Java process that is a container for J2EE applications.
Fully Qualified Interface Name If you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.configuration.ServerMBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Related MBeans
This section describes attributes that provide access to other MBeans. For more information about the MBean hierarchy, refer to WebLogic Server MBean Data Model.
CandidateMachines
Limits the list of candidate machines that the cluster specifies. (Requires you to enable this server for automatic migration and to configure the cluster with a set of candidate machines.)
If this server fails and if it is enabled for automatic migration, Node Manager automatically restarts it. By default, Node Manager restarts the server on any of the candidate machines that the cluster specifies (in order of preference that you configured in the cluster). To change the default, you use this server's list of candidate machines to create a subset of the cluster-wide candidates. You can also change the order of preference.
For more information, see:
Privileges Read/Write Type MachineMBean[] Relationship type: Reference. Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
Cluster
The cluster, or group of WebLogic Server instances, to which this server belongs.
If set, the server will listen for cluster multicast events.
For more information, see:
Privileges Read/Write Type ClusterMBean Relationship type: Reference. Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
COM
Returns the server's COM configuration.
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type COMMBean Relationship type: Containment.
DefaultFileStore
Controls the configuration of the default persistent store on this server. Each server has a default store, which is a file-based object repository used by various subsystems.
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type DefaultFileStoreMBean Relationship type: Containment.
DomainLogFilter
Determines which messages this server sends to the domain log. (Requires you to enable domain logging for this server.)
If you specify
none, the server sends all messages of severityWARNING and higher. This list contains all Domain Log Filters that have been defined for the domain. A server can user only one Domain Log Filter.Deprecated.
9.0.0.0 Replaced by LogMBean.LogBroadcastFilter The severity of messages going to the domain log is configured separately through LogMBean.LogBroadcastSeverity, For backward compatibility the changes to this attribute will be propagated to the LogMBean.
Privileges Read/Write Type DomainLogFilterMBean Relationship type: Reference.
ExecuteQueues
Returns the execute queues configured for this server.
Factory Methods createExecuteQueue (java.lang.String name)
destroyExecuteQueue (ExecuteQueueMBean queue)Factory methods do not return objects.
Lookup Operation lookupExecuteQueue(String name)Returns a
javax.management.ObjectName for the instance ofExecuteQueueMBean namedname.Privileges Read only Type ExecuteQueueMBean[] Relationship type: Containment.
FederationServices
Gets the Federation Services MBean
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type FederationServicesMBean 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 Type IIOPMBean Relationship type: Containment.
JTAMigratableTarget
Returns the JTAMigratableTargetMBean that is used to deploy the JTA Recovery Service to (is the server's cluster is not null).
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type JTAMigratableTargetMBean 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 Type LogMBean Relationship type: Containment.
Machine
The WebLogic Server host computer (machine) on which this server is meant to run.
If you want to use a Node Manager to start this server, assign the server to a machine and configure the machine for the Node Manager.
You cannot change this value if a server instance is already running.
Privileges Read/Write Type MachineMBean Relationship type: Reference. Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
NetworkAccessPoints
Network access points, or "NAPs", define additional ports and addresses that this server listens on. Additionally, if two servers both support the same channel for a given protocol, then new connections between them will use that channel.
Factory Methods createNetworkAccessPoint (java.lang.String name)
destroyNetworkAccessPoint (NetworkAccessPointMBean accessPoint)Factory methods do not return objects.
Lookup Operation lookupNetworkAccessPoint(String name)Returns a
javax.management.ObjectName for the instance ofNetworkAccessPointMBean namedname.Privileges Read/Write Setter method for this attribute is deprecated. 9.0.0.0 Use createNetworkAccessPoint() instead.
Type NetworkAccessPointMBean[] Relationship type: Containment.
OverloadProtection
get attributes related to server overload protection
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type OverloadProtectionMBean Relationship type: Containment.
ReliableDeliveryPolicy
The reliable delivery policy for web services.
Privileges Read/Write Type WSReliableDeliveryPolicyMBean Relationship type: Reference. Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
ServerDiagnosticConfig
The diagnostic configuration for the servers
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type WLDFServerDiagnosticMBean Relationship type: Containment.
ServerStart
Returns the ServerStartMBean that can be used to start up this server remotely.
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type ServerStartMBean Relationship type: Containment.
SingleSignOnServices
Gets the Single Sign-On Services MBean
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type SingleSignOnServicesMBean 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 Type SSLMBean Relationship type: Containment.
WebServer
Returns the web server for this server. A server has exactly one WebServer. A server may also have one or more VirtualHosts. A VirtualHost is a subclass of WebServer.
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type WebServerMBean Relationship type: Containment.
WebService
Gets Web service configuration for this server
Factory Methods No explicit creator method. The child shares the lifecycle of its parent. Privileges Read only Type WebServiceMBean Relationship type: Containment.
XMLEntityCache
The server's XML entity cache, which is used to configure the behavior of JAXP (Java API for XML Parsing).
For more information, see:
Privileges Read/Write Type XMLEntityCacheMBean Relationship type: Reference. Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
XMLRegistry
The server's XML registry, which is used to configure the behavior of JAXP (Java API for XML Parsing).
For more information, see:
Privileges Read/Write Type XMLRegistryMBean Relationship type: Reference. Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
Attributes
This section describes the following attributes:
AcceptBacklog
The number of backlogged, new TCP connection requests that should be allowed for this server's regular and SSL ports.
Setting the backlog to
0 may prevent this server from accepting any incoming connection on some operating systems.For more information, see:
Privileges Read/Write Type int Default Value 300 Minimum value 0
AdministrationPort
The secure administration port for the server. This port requires that you enable the domain's administration port and that SSL is configured and enabled.
By default, the server uses the administration port that is specified at the domain level. To override the domain-level administration port for the current server instance, set this server's administration port.
For more information, see:
Privileges Read/Write Type int Minimum value 0 Maximum value 65534 Secure value 7002
AdministrationProtocol
Returns the protocol to be used for administrative connections when none is specified.
Privileges Read/Write Type java.lang.String Legal Values
- t3s
- https
- iiops
- t3
- http
- iiop
AdminReconnectIntervalSeconds
The number of seconds between reconnection attempts to the admin server. When the admin server fails the managed server will periodically try to connect back to it.
Privileges Read/Write Type int Default Value 10 Minimum value 0 Maximum value 2147483647
AutoKillIfFailed
Whether the Node Manager should automatically kill this server if its health state is
failed.
Privileges Read/Write Type boolean
AutoMigrationEnabled
Whether Node Manager can automatically restart this server and its services on another machine if the server fails.
Privileges Read/Write Type boolean
AutoRestart
Whether the Node Manager can automatically restart this server if it crashes or otherwise goes down unexpectedly.
Privileges Read/Write Type boolean Default Value true
CachingDisabled
Private property that disables caching in proxies.
Privileges Read only Type boolean Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
ClasspathServletDisabled
The ClasspathServlet will serve any class file in the classpath and is registered by default in every Web application (including management). It does not need to be turned on for many applications though, and represents a security hole if unchecked.
Privileges Read/Write Type boolean Secure value true
ClientCertProxyEnabled
Whether the HttpClusterServlet proxies the client certificate in a special header.
By default (or if you specify
false), theweblogic.xml deployment descriptor for each web application that is deployed on this server determines whether the web application trusts certificates sent from the proxy server plugin. By default (or if the deployment descriptor specifiesfalse), users cannot log in to the web application from a proxy server plugin.A value of
true causes proxy-server plugins to pass identity certifications from clients to all web applications that are deployed on this server instance. A proxy-server plugin encodes each identify certification in theWL-Proxy-Client-Cert header and passes the header to WebLogic Server instances. A WebLogic Server instance takes the certificate information from the header, trusting that it came from a secure source, and uses that information to authenticate the user.If you specify
true, use aweblogic.security.net.ConnectionFilter to ensure that this WebLogic Server instance accepts connections only from the machine on which the proxy-server plugin is running. Specifyingtrue without using a connection filter creates a security vulnerability because theWL-Proxy-Client-Cert header can be spoofed.A cluster can also specify whether the HttpClusterServlet proxies the client certificate in a special header. The cluster-level setting overrides the setting in individual servers that are part of the cluster.
For more information, see:
- ConnectionFilter
- WebAppContainerMBean#isClientCertProxyEnabled()
- ClusterMBean#isClientCertProxyEnabled()
Privileges Read/Write Type boolean
ClusterRuntime
This method is unsupported and always returns null. Use ServerRuntimeMBean.getClusterRuntime instead.
Deprecated.
9.0.0.0
Privileges Read/Write Type
ClusterWeight
The proportion of the load that this server will bear, relative to other servers in a cluster.
If all servers have the default weight or the same weight, each bears an equal proportion of the load. If one server has weight 50 and all other servers have weight 100, the 50-weight server will bear half as much load as any other server.
For more information, see:
Privileges Read/Write Type int Default Value 100 Minimum value 1 Maximum value 100
COMEnabled
Whether COM support is enabled on the regular (non-SSL) port. COM is not supported on the SSL port. (The remaining fields on this page are relevant only if you check this box.)
For more information, see:
Privileges Read/Write Type boolean
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 Type int Default Value -1 Minimum value -1 Maximum value 480
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 Type int Default Value -1 Minimum value -1 Maximum value 480 Secure value 60
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 Type int Default Value -1 Minimum value -1 Maximum value 480 Secure value 60
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.
For more information, see:
Privileges Read/Write Type int Default Value 60 Minimum value 0 Maximum value 480
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 Type int Default Value -1 Minimum value -1 Maximum value 480 Secure value 60
CustomIdentityKeyStoreFileName
The path and file name of the identity keystore.
The path name must either be absolute or relative to where the server was booted. The custom identity key store file name is only used if KeyStores is CUSTOM_IDENTITY_AND_JAVA_STANDARD_TRUST, CUSTOM_IDENTITY_AND_CUSTOM_TRUST or CUSTOM_IDENTITY_AND_COMMAND_LINE_TRUST.
Privileges Read/Write Type java.lang.String
CustomIdentityKeyStorePassPhrase
The encrypted custom identity keystore's passphrase. If empty or null, then the keystore will be opened without a passphrase.
This attribute is only used if KeyStores is CUSTOM_IDENTITY_AND_JAVA_STANDARD_TRUST, CUSTOM_IDENTITY_AND_CUSTOM_TRUST or CUSTOM_IDENTITY_AND_COMMAND_LINE_TRUST.
When you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
CustomIdentityKeyStorePassPhraseEncrypted attribute.Decrypts the value and returns the unencrypted password as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
CustomIdentityKeyStorePassPhraseEncrypted attribute to the encrypted value.Using this attribute (
CustomIdentityKeyStorePassPhrase) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
CustomIdentityKeyStorePassPhraseEncrypted.For more information, see:
Privileges Read/Write Type java.lang.String Encrypted true
CustomIdentityKeyStorePassPhraseEncrypted
Returns encrypted pass phrase defined when creating the keystore.
For more information, see:
Privileges Read/Write Type byte[] Encrypted true
CustomIdentityKeyStoreType
The type of the keystore. Generally, this is
JKS.If empty or null, then the JDK's default keystore type (specified in
java.security) is used. The custom identity key store type is only used if KeyStores is CUSTOM_IDENTITY_AND_JAVA_STANDARD_TRUST, CUSTOM_IDENTITY_AND_CUSTOM_TRUST or CUSTOM_IDENTITY_AND_COMMAND_LINE_TRUST.
Privileges Read/Write Type java.lang.String
CustomTrustKeyStoreFileName
The path and file name of the custom trust keystore.
The path name must either be absolute or relative to where the server was booted. This file name is only used if KeyStores is CUSTOM_IDENTITY_AND_CUSTOM_TRUST.
Privileges Read/Write Type java.lang.String
CustomTrustKeyStorePassPhrase
The custom trust keystore's passphrase. If empty or null, then the keystore will be opened without a passphrase.
This attribute is only used if KeyStores is CUSTOM_IDENTITY_AND_CUSTOM_TRUST.
When you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
CustomTrustKeyStorePassPhraseEncrypted attribute.Decrypts the value and returns the unencrypted password as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
CustomTrustKeyStorePassPhraseEncrypted attribute to the encrypted value.Using this attribute (
CustomTrustKeyStorePassPhrase) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
CustomTrustKeyStorePassPhraseEncrypted.For more information, see:
Privileges Read/Write Type java.lang.String Encrypted true
CustomTrustKeyStorePassPhraseEncrypted
The custom trust keystore's encrypted passphrase. If empty or null, then the keystore will be opened without a passphrase.
This attribute is only used if KeyStores is CUSTOM_IDENTITY_AND_CUSTOM_TRUST.
To set this attribute, use
weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.To compare a password that a user enters with the encrypted value of this attribute, use the same WebLogic Server instance that you used to set and encrypt this attribute and use
weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.For more information, see:
Privileges Read/Write Type byte[] Encrypted true
CustomTrustKeyStoreType
The type of the keystore. Generally, this is
JKS.If empty or null, then the JDK's default keystore type (specified in java.security) is used. This keystore type is only used if KeyStores is CUSTOM_IDENTITY_AND_CUSTOM_TRUST.
Privileges Read/Write Type java.lang.String
DefaultIIOPPassword
The password for the default IIOP user. (Requires you to enable IIOP.)
As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
DefaultIIOPPasswordEncrypted attribute.Decrypts the value and returns the unencrypted password as a String.
Using this attribute (
DefaultIIOPPassword) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
DefaultIIOPPasswordEncrypted.For more information, see:
Privileges Read/Write Type java.lang.String Encrypted true
DefaultIIOPPasswordEncrypted
The encrypted password for the default IIOP user.
To set this attribute, use
weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use
weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.For more information, see:
Privileges Read/Write Type byte[] Encrypted true
DefaultIIOPUser
The user name of the default IIOP user. (Requires you to enable IIOP.)
For more information, see:
Privileges Read/Write Type java.lang.String
DefaultInternalServletsDisabled
Whether all default servlets in the servlet engine are disabled.
This includes: weblogic.servlet.ClasspathServlet weblogic.servlet.utils.iiop.GetIORServlet weblogic.rjvm.http.TunnelSendServlet weblogic.rjvm.http.TunnelRecvServlet weblogic.rjvm.http.TunnelLoginServlet weblogic.rjvm.http.TunnelCloseServlet If set to true, this property overrides the ClasspathServletDisabled property.
Privileges Read/Write Type boolean Secure value true
DefaultProtocol
The protocol to use for connections when none is specified.
Privileges Read/Write Type java.lang.String Default Value t3 Legal Values
- t3
- t3s
- http
- https
- iiop
- iiops
DefaultSecureProtocol
The protocol to use for secure connections when none is specified.
Privileges Read/Write Type java.lang.String Default Value t3s Legal Values
- t3s
- https
- iiops
DefaultTGIOPPassword
The password for the default user associated with the Tuxedo GIOP (TGIOP) protocol. (Requires you to configure WebLogic Tuxedo Connector (WTC) for this server.)
As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
DefaultTGIOPPasswordEncrypted attribute.Decrypts the value and returns the unencrypted password as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
DefaultTGIOPPasswordEncrypted attribute to the encrypted value.Using this attribute (
DefaultTGIOPPassword) is a potential security risk in because the String object (which contains the unencrypted password) remains the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
DefaultTGIOPPasswordEncrypted.For more information, see:
Privileges Read/Write Type java.lang.String Encrypted true
DefaultTGIOPPasswordEncrypted
The encrypted password for the default TGIOP user.
To set this attribute, use
weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use
weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.For more information, see:
Privileges Read/Write Type byte[] Encrypted true
DefaultTGIOPUser
The default user associated with the Tuxedo GIOP (TGIOP) protocol. (Requires you to configure WebLogic Tuxedo Connector (WTC) for this server.)
Privileges Read/Write Type java.lang.String Default Value guest
DGCIdlePeriodsUntilTimeout
The number of idle periods allowed before object is collected.
Privileges Read/Write Type int Default Value 5
EnabledForDomainLog
Determines whether this server sends messages to the domain log (in addition to keeping its own log).
Deprecated.
9.0.0.0 replaced by LogMBean.LogBroadcastSeverity, For backward compatibility the changes to this attribute will be propagated to the LogMBean.
Privileges Read/Write Type boolean Default Value true Secure value true
ExternalDNSName
The external IP address or DNS name for this server.
This address will be sent with HTTP session cookies and with dynamic server lists to HTTP proxies. It will also be used by external application clients to enable the propagation of RMI traffic through network address translating (NAT) firewalls.
You must specify an external DNS name for configurations in which a firewall is performing network address translation, unless clients are accessing WebLogic Server using t3 and the default channel. For example, define the external DNS name for configurations in which a firewall is performing network address translation, and clients are accessing WebLogic Server using HTTP via a proxy plug-in.
For more information, see:
Privileges Read/Write Type java.lang.String
ExtraEjbcOptions
The options passed to the EJB compiler during server-side generation.
Each EJB component can override the compiler options that you specify here. The following options are valid:
- -forcegeneration
Forces generation of wrapper classes. Without this flag the classes may not be regenerated if it is determined to be unnecessary.
- -disableHotCodeGen
Generate ejb stub and skel as part of ejbc. Avoid HotCodeGen to have better performance.
- -keepgenerated
Keep the generated .java files.
- -compiler javac
Java compiler to exec. If not specified, the -compilerclass option will be used.
- -compilerclass com.sun.tools.javac.Main
Specifies the compiler class to invoke.
- -g
Compile debugging info into class file.
- -normi
Passed through to Symantec's sj.
- -classpath path
Classpath to use.
- -source source
Source version.
- -Joption
Flags passed through to java runtime.
For more information, see:
Privileges Read/Write Type java.lang.String
ExtraRmicOptions
The options passed to the RMIC compiler during server-side generation.
Each EJB component can override the compiler options that you specify here.
For more information, see:
Privileges Read/Write Type java.lang.String
GracefulShutdownTimeout
Number of seconds a graceful shutdown operation waits before forcing a shut down. A graceful shutdown gives WebLogic Server subsystems time to complete certain application processing currently in progress. If subsystems are unable to complete processing within the number of seconds that you specify here, then the server will force shutdown automatically.
A value of
0 means that the server will wait indefinitely for graceful shutdown to complete.The graceful shutdown timeout applies only to graceful shutdown operations.
For more information, see:
Privileges Read/Write Type int Default Value 0 Minimum value 0
HealthCheckIntervalSeconds
The number of seconds that defines the frequency of this server's self-health monitoring. The server monitors the health of it's subsystems every HealthCheckIntervalSeconds and changes the Server's overall state if required.
Privileges Read/Write Type int Default Value 180 Minimum value 1 Maximum value 2147483647
HealthCheckStartDelaySeconds
The number of seconds the Node Manager should wait before starting to monitor the server.
Privileges Read/Write Type int Default Value 120 Minimum value 0 Maximum value 2147483647
HealthCheckTimeoutSeconds
The number of seconds the Node Manager should wait before timing out its health query to this server.
If the timeout is reached, Node Managed assumes the Managed Server has failed.
Deprecated.
9.0.0.0 Replaced by Server self-health monitoring that takes action without NodeManager intervention. NodeManager identifies if a running server was shutdown due to a restartable failure and restarts the server.
Privileges Read/Write Type int Default Value 60 Minimum value 1 Maximum value 2147483647
HostsMigratableServices
Gets the hostsMigratableServices attribute of the ServerMBean object
Privileges Read only Type boolean Default Value true Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
HttpdEnabled
Whether or not HTTP support is enabled on the regular port or SSL port.
For more information, see:
Privileges Read/Write Type boolean Default Value true
HttpTraceSupportEnabled
Returns the HttpTraceSupportEnabled value
For more information, see:
Privileges Read/Write Type boolean
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 Type int Default Value 65 Minimum value 0 Secure value 65
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 Type int Default Value -1 Minimum value -1 Secure value 60
IdlePeriodsUntilTimeout
The number of idle periods until peer is considered unreachable
Privileges Read/Write Type int Default Value 4 Minimum value 4 Maximum value 65534
IgnoreSessionsDuringShutdown
Indicates whether a graceful shutdown operation drops all HTTP sessions immediately.
If this is set to
false, a graceful shutdown operation waits for HTTP sessions to complete or timeout.
Privileges Read/Write Type boolean
IIOPEnabled
Whether this server has IIOP support enabled for both the regular (non-SSL) and SSL ports.
For more information, see:
Privileges Read/Write Type boolean Default Value true
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 Type java.lang.String Default Value ots Legal Values
- ots
- jta
InstrumentStackTraceEnabled
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 Type boolean Default Value true
InterfaceAddress
The IP address of the NIC that this server should use for multicast traffic.
For more information, see:
Privileges Read/Write Type java.lang.String
JavaCompiler
The Java compiler to use for all applications hosted on this server that need to compile Java code.
Privileges Read/Write Type java.lang.String Default Value javac Secure value javac
JavaCompilerPostClassPath
The options to append to the Java compiler classpath when compiling Java code.
Privileges Read/Write Type java.lang.String
JavaCompilerPreClassPath
The options to prepend to the Java compiler classpath when compiling Java code.
Privileges Read/Write Type java.lang.String
JavaStandardTrustKeyStorePassPhrase
The password for the Java Standard Trust keystore. This password is defined when the keystore is created.
If empty or null, then the keystore will be opened without a passphrase.
This attribute is only used if KeyStores is CUSTOM_IDENTITY_AND_JAVA_STANDARD_TRUST or DEMO_IDENTITY_AND_DEMO_TRUST.
When you get the value of this attribute, WebLogic Server does the following:
Retrieves the value of the
JavaStandardTrustKeyStorePassPhraseEncrypted attribute.Decrypts the value and returns the unencrypted password as a String.
When you set the value of this attribute, WebLogic Server does the following:
Encrypts the value.
Sets the value of the
JavaStandardTrustKeyStorePassPhraseEncrypted attribute to the encrypted value.Using this attribute (
JavaStandardTrustKeyStorePassPhrase) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.Instead of using this attribute, use
JavaStandardTrustKeyStorePassPhraseEncrypted.For more information, see:
Privileges Read/Write Type java.lang.String Encrypted true
JavaStandardTrustKeyStorePassPhraseEncrypted
The encrypted password for the Java Standard Trust keystore. This password is defined when the keystore is created.
To set this attribute, use
weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use
weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.For more information, see:
Privileges Read/Write Type byte[] Encrypted true
JDBCLLRTableName
The table name for this server's Logging Last Resource (LLR) database table(s). WebLogic Server creates the table(s) and then uses them during transaction processing for the LLR transaction optimization. This setting must be unique for each server. The default table name is
WL_LLR_SERVERNAME.This setting only applies if this server hosts one or more LLR-enabled JDBC data sources.
The format for the tables that WebLogic Server creates is [[[catalog.]schema.]name. Each "." in the table name is significant, and schema generally corresponds to username in many databases.
IMPORTANT: If this value is changed but the LLR table already exists in the database, preserve the existing table's data. Consequently, when changing the table name, the existing database table must be renamed by a database administrator to match the new configured table name. Otherwise, transaction records may be lost, resulting in heuristic failures that aren't logged.
IMPORTANT: Each server's table name must be unique. Multiple LLR-enabled data sources within the same server may share the same table, but multiple servers must not share the same table. If multiple same-named servers share a table, the behavior is undefined and it is likely that transactions will not recover properly after a crash, creating heuristic hazards.
Privileges Read/Write Type java.lang.String
JDBCLogFileName
The name of the JDBC log file. If the pathname is not absolute, it is assumed to be relative to the root directory of the machine on which this server is running. (Requires you to enable JDBC logging.)
If the log has no path element and is atomic (for example,
jdbc.log), the file will be placed relative to the root directory in ./SERVER_NAME/ to avoid name space conflicts. This attribute is deprecated because the JDBC output now goes in the server log.Deprecated.
9.0.0.0 For more information, see:
Privileges Read/Write Type java.lang.String Default Value jdbc.log
JDBCLoggingEnabled
Whether this server maintains a JDBC log file.
Deprecated.
9.0.0.0 Use ServerDebugMBean.getJDBCDriverLogging
Privileges Read/Write Type boolean Secure value true
JDBCLoginTimeoutSeconds
Get the JDBC Login Timeout value. Specified value is passed into java.sql.DriverManager.setLoginTimeout(). Note that this DriverManager setting will impact *all* JDBC drivers loaded into this JVM. Feature is disabled by default.
Available Since Release 9.0.0.0 Privileges Read/Write Type int Default Value 0 Minimum value 0 Maximum value 300
JMSDefaultConnectionFactoriesEnabled
Whether this server uses JMS default connection factories.
WebLogic Server provides the following JMS default connection factories:
weblogic.jms.ConnectionFactoryweblogic.jms.XAConnectionFactoryAn XA factory is required for JMS applications to use JTA user-transactions, but is not required for transacted sessions. All other preconfigured attributes for the default connection factories are set to the same default values as a user-defined connection factory. If the preconfigured settings of the default factories are appropriate for your application, you do not need to configure any additional factories for your application.
Note: When using the default connection factories, you have no control over targeting the WebLogic Server instances where the connection factory may be deployed. However, you can disable the default connection factories on a per-server basis. To deploy a connection factory on independent servers, on specific servers within a cluster, or on an entire cluster, you need to configure a connection factory and specify the appropriate server targets.
Privileges Read/Write Type boolean Default Value true
JNDITransportableObjectFactoryList
List of factories that create transportable objects.
Privileges Read/Write Type class java.lang.String[]
KeyStores
Which configuration rules should be used for finding the server's identity and trust keystores?
Privileges Read/Write Type java.lang.String Default Value DemoIdentityAndDemoTrust Legal Values
- DemoIdentityAndDemoTrust
- CustomIdentityAndJavaStandardTrust
- CustomIdentityAndCustomTrust
- CustomIdentityAndCommandLineTrust
ListenAddress
The IP address or DNS name this server uses to listen for incoming connections.
Servers can be reached through the following URL:
protocol://listen-address:listen-portAny network channel that you configure for this server can override this listen address.
If a server's listen address is undefined, clients can reach the server through an IP address of the computer that hosts the server, a DNS name that resolves to the host, or the localhost string. The localhost string can be used only for requests from clients that running on the same computer as the server.
If you want to limit the valid addresses for a server instance, specify one of the following:
If you provide an IP address, clients can specify either the IP address or a DNS name that maps to the IP address. Clients that specify an IP address and attempt to connect through an SSL port must disable hostname verification.
If you provide a DNS name, clients can specify either the DNS name or the corresponding IP address.
Do not leave the listen address undefined on a Windows computer that uses multiple IP address (a multihomed computer). On such a computer, the server will bind to all available IP addresses.
- Note:
To resolve a DNS name to an IP address, WebLogic Server must be able to contact an appropriate DNS server or obtain the IP address mapping locally. Therefore, if you specify a DNS name for the listen address, either leave a port open long enough for the WebLogic Server instance to connect to a DNS server and cache its mapping or specify the IP address mapping in a local file. If you specify an IP address for ListenAddress and then a client request specifies a DNS name, WebLogic Server will attempt to resolve the DNS name, but if it cannot access DNS name mapping, the request will fail.
For more information, see:
- getExternalDNSName
- getListenPort
- getInterfaceAddress
- SSLMBean#getListenPort
- KernelMBean#getSSL
- NetworkAccessPointMBean#getListenAddress
Privileges Read/Write Type java.lang.String
ListenDelaySecs
Perpetuated for compatibility with 6.1 only.
Deprecated.
Privileges Read/Write Type int Default Value 0
ListenersBindEarly
Determines whether the server should bind server sockets early.
Early binding detects port conflicts quickly and also gives user feedback on the default listen port as to the server state.
Privileges Read/Write Type boolean
ListenPort
The default TCP port that this server uses to listen for regular (non-SSL) incoming connections.
If this port is disabled, the SSL port must be enabled. Additional ports can be configured using network channels. The cluster (multicast) port is configured separately.
For more information, see:
- isListenPortEnabled
- getAdministrationPort
- getListenAddress
- getCluster
- SSLMBean#getListenPort
- ClusterMBean#getMulticastPort
- NetworkAccessPointMBean#getListenPort
Privileges Read/Write Type int Default Value 7001 Minimum value 1 Maximum value 65534
ListenPortEnabled
Whether this server can be reached through the default plain-text (non-SSL) listen port.
If you disable this listen port, enable the default SSL listen port.
You can define additional listen ports for this server by configuring network channels.
For more information, see:
- getListenPort
- isAdministrationPortEnabled
- KernelMBean#getSSL
- SSLMBean#isListenPortEnabled
- NetworkAccessPointMBean#isEnabled
Available Since Release 7.0.0.0 Privileges Read/Write Type boolean Default Value true
ListenThreadStartDelaySecs
Returns the maximum time that the server will wait for server sockets to bind before starting a listen thread.
Properties to consider for removal
Privileges Read/Write Type int Default Value 60
LoginTimeoutMillis
The login timeout for this server's default regular (non-SSL) listen port. This is the maximum amount of time allowed for a new connection to establish.
A value of
0 indicates there is no maximum.For more information, see:
Privileges Read/Write Type int Default Value 5000 Minimum value 0 Maximum value 100000 Secure value 5000
LogRemoteExceptionsEnabled
Whether the server message log includes exceptions that are raised in remote systems.
Privileges Read/Write Type boolean Secure value true
LowMemoryGCThreshold
The threshold level (in percent) that this server uses for logging low memory conditions and changing the server health state to Warning.
For example, if you specify 5, the server logs a low memory warning in the log file and changes the server health state to Warning after the average free memory reaches 5% of the initial free memory measured at the server's boot time.
Privileges Read/Write Type int Default Value 5 Minimum value 0 Maximum value 99 Secure value 5
LowMemoryGranularityLevel
The granularity level (in percent) that this server uses for logging low memory conditions and changing the server health state to Warning.
For example, if you specify 5 and the average free memory drops by 5% or more over two measured intervals, the server logs a low memory warning in the log file and changes the server health state to Warning.
Privileges Read/Write Type int Default Value 5 Minimum value 1 Maximum value 100 Secure value 5
LowMemorySampleSize
The number of times this server samples free memory during the time period specified by LowMemoryTimeInterval.
Increasing the sample size can improve the accuracy of the reading.
Privileges Read/Write Type int Default Value 10 Minimum value 1 Maximum value 2147483647
LowMemoryTimeInterval
The amount of time (in seconds) that defines the interval over which this server determines average free memory values.
By default, the server obtains an average free memory value every 3600 seconds. This interval is not used if the JRockit VM is used, as the memory samples are collected immediately after a VM-scheduled garbage collection. Taking memory samples after a garbage collection gives a more accurate average value of the free memory.
Privileges Read/Write Type int Default Value 3600 Minimum value 300 Maximum value 2147483647
ManagedServerIndependenceEnabled
Whether this Managed Server can be started when the Administration Server is unavailable.
In such a case, the Managed Server retrieves its configuration by reading a configuration file and other files directly.
Privileges Read/Write Type boolean Default Value true Secure value true
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 Type int 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 Type int 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 Type int 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:
A channel-wide maximum in a custom network channel.
A protocol-specific setting in the default network channel.
See
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 Type int Default Value 10000000 Minimum value 4096 Maximum value 2000000000 Secure value 10000000
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 Type int Default Value -1 Minimum value -1 Maximum value 2147483647
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 Type int Default Value -1
MBeanInfo
Returns the MBean info for this MBean.
Deprecated.
Privileges Read only Type javax.management.MBeanInfo Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
MessageIdPrefixEnabled
Indicates whether message IDs in logged messages will include a prefix. Message ids are 6 digit numeric strings that can be optionally presented in a log entry with a prefix. The prefix used by server messages is "BEA-".
Privileges Read/Write Type boolean Default Value true
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 Type int Default Value 5 Minimum value -1 Maximum value 65534
MSIFileReplicationEnabled
Whether the Administration Server replicates its configuration files to this Managed Server.
With file replication enabled, the Administration Server copies its configuration file and
SerializedSystemIni.dat into the Managed Server's root directory every 5 minutes. This option does not replicate a boot identity file.Regardless of the name of the configuration file that you used to start the Administration Server, the replicated file is always named
msi-config.xml. For example, if you specified-Dweblogic.ConfigFile=MyConfig.xml when you started the Administration Server, if you have enabled file replication, the Administration Server copiesMyConfig.xml and names the copymsi-config.xml.Depending on your backup schemes and the frequency with which you update your domain's configuration, this option might not be worth the performance cost of copying potentially large files across a network.
Deprecated.
Privileges Read/Write Type boolean
MuxerClass
The muxer class name.
Privileges Read/Write Type java.lang.String
Name of
An alphanumeric name for this server instance. (Spaces are not valid.)
The name must be unique for all configuration objects in the domain. Within a domain, each server, machine, cluster, JDBC connection pool, virtual host, and any other resource type must be named uniquely and must not use the same name as the domain.
The server name is not used as part of the URL for applications that are deployed on the server. It is for your identification purposes only. The server name displays in the Administration Console, and if you use WebLogic Server command-line utilities or APIs, you use this name to identify the server.
After you have created a server, you cannot change its name. Instead, clone the server and provide a new name for the clone.
Privileges Read/Write Type java.lang.String
NativeIOEnabled
Whether native I/O is enabled for the server.
For more information, see:
Privileges Read/Write Type boolean Default Value true
NMSocketCreateTimeoutInMillis
Returns the timeout value to be used by NodeManagerRuntime when creating a a socket connection to the agent. Default set high as SSH agent may require a high connection establishment time.
Available Since Release 9.2.3.0 Privileges Read/Write Type int Default Value 180000 Minimum value 0
Notes
Optional information that you can include to describe this configuration.
WebLogic Sever saves this note in the domain's configuration file (
config.xml) as XML PCDATA. All left angle brackets (<) are converted to the XML entity<. 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 Type java.lang.String
ObjectName
Returns the ObjectName under which this MBean is registered in the MBean server.
Deprecated.
Privileges Read only Type weblogic.management.WebLogicObjectName Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
OutboundEnabled
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 Type boolean
OutboundPrivateKeyEnabled
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 Type boolean
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 Type int Default Value 60000 Minimum value 0
PreferredSecondaryGroup
Defines secondary clustered instances considered for hosting replicas of the primary HTTP session states created on the server.
Privileges Read/Write Type java.lang.String
Registered
Returns false if the the MBean represented by this object has been unregistered.
Deprecated.
Privileges Read only Type boolean Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
ReplicationGroup
Defines preferred clustered instances considered for hosting replicas of the primary HTTP session states created on the server.
Privileges Read/Write Type java.lang.String
RestartDelaySeconds
The number of seconds the Node Manager should wait before restarting this server.
After killing a server process, the system might need several seconds to release the TCP port(s) the server was using. If Node Manager attempts to restart the Managed Server while its ports are still active, the startup attempt fails.
If AutoMigration is enabled and RestartDelaySeconds is 0, the RestartDelaySeconds is automatically set to the lease time. This prevents the server from failing to restart after migration when the previous lease is still valid.
Privileges Read/Write Type int Default Value 0 Minimum value 0 Maximum value 2147483647
RestartIntervalSeconds
The number of seconds during which this server can be restarted, up to the number of times specified in RestartMax.
For more information, see:
Privileges Read/Write Type int Default Value 3600 Minimum value 300 Maximum value 2147483647
RestartMax
The number of times that the Node Manager can restart this server within the interval specified in RestartIntervalSeconds.
Privileges Read/Write Type int Default Value 2 Minimum value 0 Maximum value 2147483647
ReverseDNSAllowed
Whether the kernel is allowed to perform reverse DNS lookups.
Privileges Read/Write Type boolean
ServerLifeCycleTimeoutVal
Number of seconds a force shutdown operation waits before timing out and killing itself. If the operation does not complete within the configured timeout seconds, the server will shutdown automatically if the state of the server at that time was
SHUTTING_DOWN.A value of
0 means that the server will wait indefinitely for life cycle operation to complete.
Privileges Read/Write Type int Default Value 30 Minimum value 0 Secure value 120
ServerVersion
The release identifier for the server. Since this is a configured attribute it is only as accurate as the configuration. The form of the version is major.minor.servicepack.rollingpatch. Not all parts of the version are required. i.e. "7" is acceptable.
Deprecated.
9.0.0.0
Privileges Read/Write Type java.lang.String Default Value unknown
SocketBufferSizeAsChunkSize
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 Type boolean
SocketReaders
The number of socket reader threads
Privileges Read/Write Type int Default Value -1 Minimum value -1 Maximum value 65534
StagingDirectoryName
The directory path on the Managed Server where all staged (prepared) applications are placed.
If an absolute directory name is not specified, the path is relative to rootdirectory/ Once configured, you cannot change the staging directory name. Remove all applications from the server prior to changing this attribute. The default staging directory is "stage", relative to the server root.
Privileges Read/Write Type java.lang.String
StagingMode
The mode that specifies whether an application's files are copied from a source on the Administration Server to the Managed Server's staging area during application preparation.
During application preparation, the application's files are copied from the source on the Administration Server to the Managed Server's staging area. If you specify
nostage orexternal_stage, the copy will not occur. This is useful when the staging area is a shared directory, already containing the application files, or if this is a single server domain. The administrator must ensure that the Managed Server's staging directory is set appropriately. Deployment errors will result if the application is not available during the preparation or activation of the application. Each application can override the staging mode specified here.For more information, see:
Available Since Release 7.0.0.0 Privileges Read/Write Type java.lang.String Legal Values
- callback-polling
- stage
- nostage
- external_stage
StartupMode
The state in which this server should be started. If you specify STANDBY, also enable the domain-wide administration port.
In the
RUNNING state, a server offers its services to clients and can operate as a full member of a cluster. In theADMIN state, the server is up and running, but available only for administration operations, allowing you to perform server and application-level administration tasks without risk to running applications. In theSTANDBY state, a server instance does not process any request; its regular Listen Port is closed. The Administration Port is open. It only accepts life cycle commands that transition the server instance to either theRUNNING or theSHUTDOWN state. Other Administration requests are not accepted. ASTANDBYserver's only purpose is to resume into theRUNNING state quickly; it saves server startup time.
Privileges Read/Write Type java.lang.String Default Value RUNNING
StartupTimeout
Timeout value for server start and resume operations. If the server fails to start in the timeout period, it will force shutdown.
A value of
0 means that the server will wait indefinitely for the operation to complete.
Privileges Read/Write Type int Default Value 0 Minimum value 0
StdoutDebugEnabled
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 Type boolean
StdoutEnabled
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 Type boolean Default Value true
StdoutFormat
The output format to use when logging to the console.
Deprecated.
Privileges Read/Write Type java.lang.String Default Value standard Legal Values
- standard
- noid
StdoutLogStack
Whether to dump stack traces to the console when included in logged message.
Deprecated.
9.0.0.0
Privileges Read/Write Type boolean Default Value true
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 Type int Default Value 32 Legal Values
- 256
- 128
- 64
- 16
- 8
- 32
- 4
- 2
- 1
- 0
Secure value 32
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 Type int Default Value 600 Minimum value 0 Maximum value 2147483647
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 Type int Default Value 60 Minimum value 0 Maximum value 2147483647
SystemPasswordEncrypted
The password required to access administrative functions on this server.
To set this attribute, use
weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use
weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.For more information, see:
Privileges Read/Write Type byte[] Encrypted true
TGIOPEnabled
Whether this server supports Tuxedo GIOP (TGIOP) requests. (Requires you to configure WebLogic Tuxedo Connector (WTC) for this server.)
Privileges Read/Write Type boolean Default Value true Secure value true
ThreadPoolPercentSocketReaders
The percentage of execute threads from the default queue that can be used as socket readers.
Privileges Read/Write Type int Default Value 33 Minimum value 1 Maximum value 99
TransactionLogFilePrefix
The path prefix for the server's JTA transaction log files. If the pathname is not absolute, the path is assumed to be relative to the server's root directory.
For a clustered server, if you plan to be able to migrate the Transaction Recovery Service from this server if it fails to another server (backup server) in the same cluster, store transaction log files on persistent storage, such as a Storage Area Network (SAN) device or a dual-ported disk, available to both servers.
Do not use an NFS file system to store transaction log files. Because of the caching scheme in NFS, transaction log files on disk may not always be current. Using transaction log files stored on an NFS device for recovery may cause data corruption.
Privileges Read/Write Type java.lang.String Default Value ./
TransactionLogFileWritePolicy
The policy that determines how transaction log file entries are written to disk. This policy can affect transaction performance. (Note: To be transactionally safe, the Direct-Write policy may require additional OS or environment changes on some Windows systems.)
WebLogic Server supports the following policies:
Cache-Flush. Flushes operating system and on-disk caches after each write.
Direct-Write. Tells the operating system to write directly to disk with each write. Direct-Write performs better than Cache-Flush and is available on Windows, HP-UX, and Solaris.
If Direct-Write is not supported on the host platform, the policy becomes Cache-Flush and a log message is printed.
Note: On Windows, unlike Solaris and HP, the "Direct-Write" policy may leave transaction data in the on-disk cache without writing it to disk immediately. This is not transactionally safe because a power failure can cause loss of on-disk cache data. For transactionally safe writes using "Direct-Write" on Windows, either disable all write caching for the disk (enabled by default), or use a disk with a battery-backed cache.
The on-disk cache for a hard-drive on Windows can be disabled through system administration: Control-Panel -> System -> Hardware-tab -> Device-Manager-button -> Disk-Drives -> name-of-drive -> Policies-tab -> "Enable write caching on the disk" check-box. Some file systems do not allow this value to be changed. For example, a RAID system that has a reliable cache.
Privileges Read/Write Type java.lang.String Default Value Direct-Write Legal Values
- Cache-Flush
- Direct-Write
TunnelingClientPingSecs
The interval (in seconds) at which to ping a tunneled client to see if it is still alive.
If you create network channels for this server, each channel can override this setting.
For more information, see:
Privileges Read/Write Type int Default Value 45 Minimum value 1
TunnelingClientTimeoutSecs
The amount of time (in seconds) after which a missing tunneled client is considered dead.
If you create network channels for this server, each channel can override this setting.
For more information, see:
Privileges Read/Write Type int Default Value 40 Minimum value 1
TunnelingEnabled
Whether tunneling for the T3, T3S, HTTP, HTTPS, IIOP, and IIOPS protocols should be enabled for this server.
If you create network channels for this server, each channel can override this setting.
For more information, see:
Privileges Read/Write Type boolean
Type
Returns the type of the MBean.
Privileges Read only Type java.lang.String Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.
UploadDirectoryName
The directory path on the Administration Server where all uploaded applications are placed.
If an absolute directory name is not specified, the path is relative to rootdirectory/ The default staging directory is "stage", relative to the server root.. On the Managed Server this returns null, and is not configurable.
Privileges Read/Write Type java.lang.String Secure value An absolute directory that is outside the root directory of any WebLogic Server instance or application, and that resides on a physical disk that is separate from the WebLogic Server host's system disk.
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 Type boolean
VerboseEJBDeploymentEnabled
Whether or not verbose deployment of EJBs is enabled.
Privileges Read/Write Type java.lang.String Default Value false
WeblogicPluginEnabled
Whether this server uses the proprietary WL-Proxy-Client-IP header, which is recommended if the server instance will receive requests from a proxy plug-in.
If the server instance is a member of a cluster that will receive proxied requests, enable the WebLogic plugin at the cluster level. For servers that are members of a cluster, the setting at the cluster level overrides the server's setting.
When the WebLogic plugin is enabled, a call to
getRemoteAddr will return the address of the browser client from the proprietaryWL-Proxy-Client-IP header instead of the web server.For more information, see:
Privileges Read/Write Type boolean
Operations
This section describes the following operations:
addNetworkAccessPoint
Deprecated.
9.0.0.0 For more information, see:
Operation Name "addNetworkAccessPoint"Parameters Object [] { networkAccessPoint }where:
networkAccessPoint is an object of typeweblogic.management.configuration.NetworkAccessPointMBean that specifies:
The feature to be added to the NetworkAccessPoint attribute
Signature String [] { "weblogic.management.configuration.NetworkAccessPointMBean" }Returns booleanExceptions
javax.management.InvalidAttributeValueException
weblogic.management.configuration.ConfigurationException
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"Parameters Object [] { attributeName }where:
attributeName is an object of typejava.lang.String that specifies:
attributeName
Signature String [] { "java.lang.String" }Returns voidExceptions
javax.management.AttributeNotFoundException
javax.management.MBeanException
isSet
Returns true if the specified attribute has been set explicitly in this MBean instance.
Operation Name "isSet"Parameters Object [] { propertyName }where:
propertyName is an object of typejava.lang.String that specifies:
property to check
Signature String [] { "java.lang.String" }Returns boolean
removeNetworkAccessPoint
Deprecated.
9.0.0.0 For more information, see:
Operation Name "removeNetworkAccessPoint"Parameters Object [] { networkAccessPoint }where:
networkAccessPoint is an object of typeweblogic.management.configuration.NetworkAccessPointMBean that specifies:
networkAccessPoint
Signature String [] { "weblogic.management.configuration.NetworkAccessPointMBean" }Returns booleanExceptions
javax.management.InvalidAttributeValueException
weblogic.management.configuration.ConfigurationException
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"Parameters Object [] { attributeName }where:
attributeName is an object of typejava.lang.String that specifies:
attributeName
Signature String [] { "java.lang.String" }Returns voidExceptions
javax.management.AttributeNotFoundException
synchronousKill
Kill this server. This is a blocking call. Returns String containing NodeManger log for killing the server.
Deprecated.
9.0.0.0 Use ServerRuntimeMBean#forceShutdown() instead
Operation Name "synchronousKill"Parameters nullSignature nullReturns String
synchronousStart
Start this server. This is a blocking call. Returns String containing NodeManger log for starting the server.
Deprecated.
9.0.0.0 Use ServerLifeCycleRuntimeMBean#start() instead.
Operation Name "synchronousStart"Parameters nullSignature nullReturns String
unSet
Restore the given property to its default value.
Operation Name "unSet"Parameters Object [] { propertyName }where:
propertyName is an object of typejava.lang.String that specifies:
property to restore
Signature String [] { "java.lang.String" }Returns void