Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

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.

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.

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

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

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 method java.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 is false 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 is true and the platform MBean server is used.

In this case, the server's Runtime MBean Server uses the MBeanServer returned by java.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 the MBeanServer interface that java.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.

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.

Related Tasks

Related Topics


Back to Top