![]() ![]() ![]() ![]() |
Domains: Configuration: General
Configuration Options Advanced Configuration Options Related Tasks Related Topics
A domain is a collection of WebLogic Server instances that is managed by a single Administration Server. Use this page to configure administrative options that apply to all servers in the current domain.
Each WebLogic Server domain must have an Administration Server, which runs the Administration Console and distributes configuration changes to other servers in the domain. In a typical production environment, you add one or more Managed Servers to the domain to host business applications and use the Administration Server only to configure and monitor the Managed Servers.
Configuration Options
Name Description Name The name of this WebLogic Server domain.
MBean Attribute:
DomainMBean.Name
Changes take effect after you redeploy the module or restart the server.
Enable Administration Port Specifies whether the domain-wide administration port should be enabled for this WebLogic Server domain. Because the administration port uses SSL, enabling the administration port requires that SSL must be configured for all servers in the domain.
The domain-wide administration port enables you to start a WebLogic Server instance in
STANDBY
state. It also allows you to separate administration traffic from application traffic in your domain. Because all servers in the domain must enable or disable the administration port at once, you configure the default administration port settings at the domain level.If you enable the administration port:
The administration port accepts only connections that specify administrator credentials.
Connections that specify administrator credentials can use only the administration port.
The command that starts managed servers must specify a secure protocol and the administration port:
-Dweblogic.management.server=https://admin_server:administration_port
MBean Attribute:
DomainMBean.AdministrationPortEnabled
Secure value:
true
Administration Port The common secure administration port for this WebLogic Server domain. (Requires you to enable the administration port.)
MBean Attribute:
DomainMBean.AdministrationPort
Minimum value:
1
Maximum value:
65535
Production Mode Specifies whether all servers in this domain run in production mode.
MBean Attribute:
DomainMBean.ProductionModeEnabled
Changes take effect after you redeploy the module or restart the server.
Enable Exalogic Optimizations Specifies whether optimizations for Oracle Exalogic should be enabled. Optimizations include improved thread management and request processing, and reduced lock contention. This attribute should be enabled only when configuring a WebLogic domain for Oracle Exalogic.
MBean Attribute:
DomainMBean.ExalogicOptimizationsEnabled
Changes take effect after you redeploy the module or restart the server.
Enable Cluster Constraints Specifies that deployments targeted to a cluster succeed only if all servers in the cluster are running.
By default, cluster constraints are disabled and deployment is attempted only on the servers that are reachable at the time of deployment from the Administration Server. Any servers that have been shut down or are temporarily partitioned from the Administration Server will retrieve the deployment during server startup or shortly after the network partition is resolved.
MBean Attribute:
DomainMBean.ClusterConstraintsEnabled
Changes take effect after you redeploy the module or restart the server.
Enable on-demand deployment of internal applications Specifies whether internal applications such as the console, uddi, wlstestclient, and uddiexplorer are deployed on demand (first access) instead of during server startup.
MBean Attribute:
DomainMBean.InternalAppsDeployOnDemandEnabled
Changes take effect after you redeploy the module or restart the server.
Server Log Format Compatibility Enabled Configures whether log messages will be logged in legacy format without supplemental attributes.
MBean Attribute:
DomainMBean.LogFormatCompatibilityEnabled
Changes take effect after you redeploy the module or restart the server.
Advanced Configuration Options
Name Description Console Enabled Specifies whether the Administration Server automatically deploys the Administration Console in the current domain.
If the Administration Console is not deployed, you can still use the WebLogic Scripting Tool or the management APIs to configure and monitor the domain.
MBean Attribute:
DomainMBean.ConsoleEnabled
Changes take effect after you redeploy the module or restart the server.
Console Context Path The context path that you want to use in URLs that specify the Administration Console. (Requires you to enable the Administration Console for the current domain.)
To access the Administration Console, you use the following URL: http://listen-addess:listen-port/context-path. For example, if you set the context path to
myconsole
, then you use the following URL to access the Administration Console:http://localhost:7001/myconsole
.To specify the listen address and listen port that you use to access the Administration Console, configure the listen address and listen port of the Administration Server.
MBean Attribute:
DomainMBean.ConsoleContextPath
Changes take effect after you redeploy the module or restart the server.
Console Cookie Name Returns the Cookie Name used by the Administration Console.
MBean Attribute:
AdminConsoleMBean.CookieName
Changes take effect after you redeploy the module or restart the server.
Protect Console Cookie Set to true if the Administration Console's session cookie is protected so that it is only visible to the Console. This may prevent use of this shared cookie in other applications.
MBean Attribute:
AdminConsoleMBean.ProtectedCookieEnabled
Changes take effect after you redeploy the module or restart the server.
Minimum Threads dedicated to Console interactions Specify the minimum number of threads that should be dedicated to the Administration Console. These threads are used to interact with managed servers in parallel for improved responsiveness in large domains. 5 is the smallest accepted number.
MBean Attribute:
AdminConsoleMBean.MinThreads
Minimum value:
5
Console Session Timeout Returns Session Timeout value (in seconds) for Administration Console.
MBean Attribute:
AdminConsoleMBean.SessionTimeout
Changes take effect after you redeploy the module or restart the server.
Console SSO Logout URL Returns the log out URL for the Administration Console in a single sign-on (SSO) environment. Only needed when you use the Console with an SSO provider that requires a log out URL so that it can clean up its SSO session state. See the SSO provider documentation for details on the URL value
MBean Attribute:
AdminConsoleMBean.SSOLogoutURL
Console Extension Directory Returns the directory path that console extensions are loaded from.
MBean Attribute:
DomainMBean.ConsoleExtensionDirectory
Changes take effect after you redeploy the module or restart the server.
Enable Web Service Test Page Specifies whether the WebLogic Server automatically deploys Web Service Test Page in the current domain.
MBean Attribute:
WebserviceTestpageMBean.Enabled
Changes take effect after you redeploy the module or restart the server.
Configuration Archive Enabled If true, then backups of the configuration will be made during server boot.
MBean Attribute:
DomainMBean.ConfigBackupEnabled
Changes take effect after you redeploy the module or restart the server.
Archive Configuration Count The number of archival versions of
config.xml
saved by the Administration Server each time the domain configuration is modified.MBean Attribute:
DomainMBean.ArchiveConfigurationCount
Minimum value:
0
Maximum value:
2147483647
Changes take effect after you redeploy the module or restart the server.
Administration Protocol The default protocol for communicating through the administration port or administration channels. (Requires you to enable the administration port or to create an administration channel.)
If requests through the administration port or an administration channel do not specify a protocol, WebLogic Server uses the protocol specified here.
Valid admin protocols are:
t3s
https
iiops
MBean Attribute:
DomainMBean.AdministrationProtocol
Changes take effect after you redeploy the module or restart the server.
Configuration Audit Type Returns the criteria used for auditing configuration events (configuration changes and other operations):
CONFIG_CHANGE_NONE
Configuration events will neither be written to the server log or directed to the Security Audit Framework.
CONFIG_CHANGE_LOG
Configuration events will be written to the server log.
CONFIG_CHANGE_AUDIT
Configuration events will be directed to the Security Audit Framework.
CONFIG_CHANGE_LOG_AND_AUDIT
Configuration events will be written to the server log and directed to the Security Audit Framework.
MBean Attribute:
DomainMBean.ConfigurationAuditType
Secure value:
audit
Compatibility MBean Server Enabled Enables JMX clients to use the deprecated
MBeanHome
interface.Prior to 9.0, WebLogic Server supported a typed API layer over its JMX layer. Your JMX application classes could import type-safe interfaces for WebLogic Server MBeans, retrieve a reference to the MBeans through the
weblogic.management.MBeanHome
interface, and invoke the MBean methods directly.MBean Attribute:
JMXMBean.CompatibilityMBeanServerEnabled
Management EJB Enabled Enables access to the Management EJB (MEJB), which is part of the Java EE Management APIs (JSR-77).
The Management API specification provides a standardized management data model for common resources on Java EE Web application servers.
The MEJB provides access to Java EE Managed Objects (JMOs), which describe the common Java EE resources. If you set this attribute to
false
, WebLogic Server does not register the MEJB in the JNDI tree, and effectively disables the Java EE Management APIs for the domain.MBean Attribute:
JMXMBean.ManagementEJBEnabled
Platform MBean Server Enabled Specifies whether each server instance initializes the JDK's platform MBean server. Enabling it, along with
isPlatformMBeanServerUsed
, causes WebLogic Server to use the platform MBean server as its Runtime MBean Server.As of JDK 1.5, JVMs provide a platform MBean server that local processes can instantiate. There can be only one instance of the platform MBean server for each JVM. When a process instantiates this MBean server, the JVM creates several platform MXBeans that provide monitoring data for the JVM itself.
If you set this attribute to
true
, each WebLogic Server instance invokes the methodjava.lang.management.ManagementFactory.getPlatformMBeanServer()
and thus causes the initialization of the JVM's MXBeans.MBean Attribute:
JMXMBean.PlatformMBeanServerEnabled
Changes take effect after you redeploy the module or restart the server.
Platform MBean Server Used Specifies whether WebLogic Server will use the platform MBean server for its Runtime MBean Server. Previously, WebLogic Server used the platform MBean server by default if it was enabled. This attribute provides a separation between enabling the platform MBean server and using it for WebLogic Server MBeans.
The default value for this attribute is based on the
DomainVersion
attribute of the DomainMBean. If the domain version is prior to 10.3.3.0, then the default value of this attribute isfalse
and the platform MBean server is not used. If the domain version is 10.3.3.0 or higher, then the default value of this attribute istrue
and the platform MBean server is used.In this case, the server's Runtime MBean Server uses the
MBeanServer
returned byjava.lang.management.ManagementFactory.getPlatformMBeanServer()
method as its MBean Server. This makes it possible to access the WebLogic Server MBeans and the JVM platform MXBeans from a single MBean server. In addition, if you enable the Runtime MBean Server to be the Platform MBean Server, local processes in the JVM can directly access this MBean server through theMBeanServer
interface thatjava.lang.management.ManagementFactory.getPlatformMBeanServer()
returns.MBean Attribute:
JMXMBean.PlatformMBeanServerUsed
Changes take effect after you redeploy the module or restart the server.
Enable Remote Deployer EJB Specifies whether the Remote Deployer EJB is automatically deployed in the current domain. The Remote Deployer EJB is only used by the weblogic.Deployer tool in the WLS 9.0 and 9.1 releases when the -remote option is specified.
If the Remote Deployer EJB is not deployed, you will not be able to use the -remote option in weblogic.Deployer running in a 9.0 or 9.1 installation. You can still use the -remote option from weblogic.Deployer in 9.2 or later releases.
MBean Attribute:
DeploymentConfigurationMBean.RemoteDeployerEJBEnabled
Changes take effect after you redeploy the module or restart the server.
Enable RESTful Management Services Enables the monitoring of this WebLogic Server domain through the RESTful Management Services Web application.
MBean Attribute:
RestfulManagementServicesMBean.Enabled
Changes take effect after you redeploy the module or restart the server.
Lifecycle Management Services Availability The deployment model for LifecycleManager services in this domain.
MBean Attribute:
LifecycleManagerConfigMBean.DeploymentType
Changes take effect after you redeploy the module or restart the server.
Lifecycle Management Notifications Enabled Determine if LifecycleManager should listen for configuration changes on this server.
MBean Attribute:
LifecycleManagerConfigMBean.OutOfBandEnabled
Lifecycle Management Remote Domain 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
MBean Attribute:
LifecycleManagerEndPointMBean.Name
Changes take effect after you redeploy the module or restart the server.
Lifecycle Management Remote URL Returns the URL for the root REST resource for the LifecycleManager instance. For example, http://localhost:7001/lifecycle/12.2.1.0/
MBean Attribute:
LifecycleManagerEndPointMBean.URL
Lifecycle Management Remote Username The user name that will be passed when opening a connection to a LifecycleManager instance (specified by the URL value for this endpoint). If not set, then no user name will be specified when establishing an connection.
MBean Attribute:
LifecycleManagerEndPointMBean.Username
Lifecycle Management Remote Password Get the password in clear text. (disallowed by default - use getPasswordEncrypted)
MBean Attribute:
LifecycleManagerEndPointMBean.Password
Changes take effect after you redeploy the module or restart the server.
Invocation Timeout Seconds The number of seconds that internal WebLogic Server processes wait to connect to an MBean server, invoke an MBean server method, and return the results of the invocation. If the MBean server method does not complete (return) within the timeout period, WebLogic Server abandons its invocation attempt.
Some internal management processes within WebLogic Server require a server instance to connect to MBean servers in other WebLogic Server instances and invoke an MBean server method. The timeout period prevents the internal process from locking up if an MBean server cannot successfully return a method invocation.
A value of
0
(zero) prevents the method invocation from timing out. With such a value, the internal process will wait indefinitely until the MBean server's method returns.MBean Attribute:
JMXMBean.InvocationTimeoutSeconds
Minimum value:
0
Maximum value:
2147483647
Changes take effect after you redeploy the module or restart the server.
Diagnostic Context Compatibility Mode Specifies whether WLDF sends a pre-12.2.1-style diagnostic context along with the current-style diagnostic context.
If outbound communication to pre-12.2.1 servers is possible, this setting should always be enabled to ensure that those servers receive a diagnostic context that they can process. Disabling this setting in those scenarios can result in correlation information being lost across tiers, and in information reported by WLDF and DMS to become of sync in some situations.
If there is no outbound communication to pre-12.2.1 servers possible, it is suggested to disable this mode as only the current-style diagnostic context is needed to be propagated outbound (propagating the old style will not cause a failure, but is unnecessary overhead in that situation).
This setting affects outbound only, inbound pre-12.2.1 style diagnostic contexts are always understood and handled.
MBean Attribute:
DomainMBean.DiagnosticContextCompatibilityModeEnabled
Enable EE Compliant Class loading for Embedded Adapters Specifies the class loading behavior for embedded adapters. If you enable this option, embedded adapters deployed to all partitions in the domain will use Java EE compliant class loading. The embedded adapter's classes will be accessible from other modules in the same application.
MBean Attribute:
DomainMBean.EnableEECompliantClassloadingForEmbeddedAdapters
Enable Implicit Bean Discovery Enable or disable implicit bean discovery for all applications deployed to the domain. This is used for CDI 1.0 application compatibility.
MBean Attribute:
CdiContainerMBean.ImplicitBeanDiscoveryEnabled
Changes take effect after you redeploy the module or restart the server.
Site Name The name of the site this domain is associated with.
MBean Attribute:
DomainMBean.SiteName
Partition URI Prefix The URI prefix used for partition administrative virtual targets.
MBean Attribute:
DomainMBean.PartitionUriSpace
Changes take effect after you redeploy the module or restart the server.
![]() |