config.xml Elements and Attributes

 

This document contains the following sections:

• config.xml Element Hierarchy Diagram

• Element Attribute Descriptions

  Domain
  JTA
  Security
  PasswordPolicy
  Log
  Server
  SSL
  WebServer
  Cluster
  Machine
  UnixMachine
  Application
  EJBComponent
  WebAppComponent
  FileRealm
  NTRealm
  UnixRealm
  JMSServer
  JMSSessionPool
  JMSConnectionConsumer
  JMSTopic
  JMSDestinationKey
  JMSQueue
  JMSConnectionFactory
  JMSFileStore
  JMSTemplate
  JMSJDBCStore
  JDBCTxDataSource
  XMLRegistry
  XMLRegistryEntry
  StartupClass
  ShutdownClass
  DomainLogFilter
  VirtualHost
  CachingRealm
  CustomRealm
  LDAPRealm
  RDBMSRealm
  WLECConnectionPool
  JoltConnectionPool
  JDBCConnectionPool
  JDBCDataSource
  JDBCMultiPool
  FileT3
  MailSession

config.xml Element Hierarchy Diagram

The config.xml file consists of a series of XML elements. The Domain element is the top-level element, and all elements in the Domain are children of the Domain element. Child elements may have children themselves. For example, the Security element contains the PasswordPolicy child element, and the Server element contains the Log, SSL, and WebServer child elements, as shown in the following diagram.

The characters following the element names in the diagram indicate the possible occurrence of the children elements in the Domain element: + (one or more), * (zero or more), or ? (zero or one time).

Element Attribute Descriptions

The following sections describe the attributes that you can configure for each element shown in the preceding diagram.

Domain

JTA

Security

PasswordPolicy

Attribute	Description	weblogic.properties Property Name
LockoutCacheSize	Range of values: Default value:
LockoutDuration	Number of minutes that a user's account will be locked after Lockout threshold number of invalid login attempts have taken place within the LockoutRestDuration time period. Range of values: Default value:
LockoutEnabled	Range of values: Default value:
LockoutGCThreshold	Range of values: Default value:
LockoutResetDuration	Number of minutes within which the invalid login attempts must happen in order for the user's account to be locked. Range of values: Default value:
LockoutThreshold	Range of values: Default value:
MinimumPasswordLength	The minimum length of any password, domain-wide. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null

Log

Attribute	Description	weblogic.properties Property Name
FileCount	Range of values: Default value:
FileMinSize	Range of values: Default value:	weblogic.system.maxLogFileSize
FileName	The log file name. If the file path is not absolute, the path is assumed to be relative to the root directory of the machine on which the server is running. Range of values: String Default value:	weblogic.system.logFile
FileTimeSpan	Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
NumberOfFilesLimited	Range of values: Boolean Enabled=selected; Not enabled=not selected. Default value: Not selected
RotationType	The rotation type for this log file. Range of values: Integer Default value: 7

Server

Attribute	Description	weblogic.properties Property Name
AdministrationPort	Range of values: Valid administration port. Default value:	weblogic.system.AdministrationPort
Cluster	The cluster to which this server belongs. Range of values: Default value:
ClusterRuntime	Returns an Mbean containing runtime information about the cluster that was started from this configuration Mbean. Returns null if no such cluster exists. Range of values: Default value:
ClusterWeight	The cluster weight (percent) for this server. Range of values: Integer Default value: 100
DefaultIIOPPassword	The password for the default IIOP user. Range of values: Default value:	weblogic.iiop.password
DefaultIIOPUser	The default IIOP user. Range of values: Default value:	weblogic.iiop.user
DefaultProtocol	The protocol to be used for connections when none is specified. Range of values: Default value:	weblogic.system.defaultProtocol
DefaultSecureProtocol	The protocol to be used for secure connections when none is specified. Range of values: Default value:	weblogic.system.defaultSecureProtocol
DomainLogFilter	Range of values: Default value:
EnabledForDomainLog	Range of values: Default value:
ExpectedToRun	Is this server expected to run if the domain is started? Range of values: Default value:
ExtraRmicOptions	The extra options passed to RMIC during server-side generation. Range of values: Default value:
HelpPageURL	Range of values: Default value:	weblogic.system.helpPageURL
HttpdEnabled	Range of values: Default value:	weblogic.httpd.enable
IIOPEnabled	Sets whether or not IIOP support is enabled. Range of values: Default value:	weblogic.system.enableIIOP
InstrumentStackTraceEnabled	Range of values: Default value:
JDBCLogFileName	Range of values: Default value:	weblogic.jdbc.logFileName
JDBCLoggingEnabled	Sets whether or not logging of JDBC log stream is enabled. Range of values: Default value:	weblogic.jdbc.enableLogFile
JMSDefaultConnectionFactoriesEnabled	Range of values: Default value:
JNDITransportableObjectFactoryList	Range of values: Default value:	weblogic.jndi.transportableObjectFactories
JavaCompiler	Range of values: Default value:
JavaCompilerPostClassPath	Range of values: Default value:
JavaCompilerPreClassPath	Range of values: Default value:
ListenAddress	Range of values: Default value:	weblogic.system.bindAddr
ListenPort	The server's listen port. Range of values: Default value:
LogRemoteExceptionsEnabled	Sets whether remote exceptions are to be reported to the log. Range of values: Default value:
LoginTimeout	The login timeout for the server. Range of values: Default value:
LoginTimeoutMillis	The interval to wait for a read to fail on login; 0 to disable. Range of values: Default value:	weblogic.system.readTimeoutMillis
Machine	The machine on which this server is meant to run. If the server is already running, this will migrate the server to a different machine. If the machine is the same as the machine is the server is already running on, this is a no-op. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
NativeIOEnabled	Sets whether or not native I/O should be enabled. See also "Using WebLogic Server Performance Packs".	weblogic.system.nativeIO.enable
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
PreferredSecondaryGroup	The preferred replication group for the server's secondaries. Range of values: Default value:
ReplicationGroup	The server's replication group. Range of values: Default value:
ReverseDNSAllowed	Returns whether or not the kernel is allowed to perform reverse DNS lookups. Range of values: Default value:	weblogic.system.enableReverseDNSLookups
RootDirectory	The root directory for the weblogic installation for this server. Range of values: Default value:	weblogic.system.home
StdoutDebugEnabled	Allows verbose display of server activity. If StdoutDebugEnabled="true", StdoutEnabled="true", and StdoutSeverityLevel="64" (INFO), all messages that would normally go to weblogic.log go to the screen where you started up WebLogic Server. Range of values: true or false Default: false
StdoutEnabled	Determines if log messages should be logged to the standard out stream. Overrides StdoutSeverityLevel and StdoutDebugEnabled. Range of values: true or false Default: true	weblogic.system.enableConsole
StdoutSeverityLevel	The minimum severity of a message that should be logged to the stand output device stream. All messages with given severity and higher, qualify. 64 (INFO) 32 (WARNING) 16 (ERROR) 8 (NOTICE) 4 (CRITICAL) 2 (ALERT) 1 (EMERGENCY) Note: The lower the number, the higher the severity. See also StdoutDebugEnabled and StdoutEnabled. Range of values: 64, 32, 16, 8, 4, 2, 1 Default: 16
ThreadPoolPercentSocketReaders	The percentage (1-99) of execute threads that may be used as socket readers. Represents a negative int. Range of values: Default value:	weblogic.system.percentSocketReaders
ThreadPoolSize	The size of the execute thread pool size. Represents a negative int. Range of values: Default value:	weblogic.system.executeThreadCount
TransactionLogFilePrefix	Range of values: Default value:
TunnelingClientPingSecs	Interval (in seconds) at which to ping an http-tunneled client to see if it is still alive. Range of values: Default value:	weblogic.httpd.tunneling.clientPingSecs
TunnelingClientTimeoutSecs	Duration (in seconds) after which a missing http-tunneled client is considered dead. Range of values: Default value:	weblogic.httpd.tunneling.clientTimeoutSecs
TunnelingEnabled	Enables tunneling via http. Range of values: Default value:	weblogic.httpd.tunnelingenabled
ValidProtocols	The collections of protocols supported by this kernel. The result is a map that maps strings to strings. The key is the protocol name and the value is the protocol description. This collection includes both secure and insecure protocols. Range of values: Default value:
WorkspaceShowUserKeysOnly	Controls whether user-inserted items are shown in the WebLogic console. Range of values: Default value:	weblogic.workspace.showUserKeysOnly
XMLRegistry	Return the XML Registry for the server. Range of values: Default value:
ZACEnabled	Sets whether or not the Zero Admin Client (ZAC) feature is enabled. Range of values: Default value:	weblogic.zac.enable
ZACPublishRoot	The root (storage) directory on WebLogic for ZAC packages. Range of values: Default value:	weblogic.zac.publishRootProp

SSL

Attribute	Description	weblogic.properties Property Name
CertAuthenticator	Range of values: Default value:	weblogic.security.realm.certAuthenticator
CertificateCacheSize	The number of certificates held that have not been redeemed by tokens. Range of values: Default value:	weblogic.security.certificateCacheSize
Ciphersuites	String. List of possible values: SSL_NULL_WITH_NULL_NULL SSL_RSA_WITH_NULL_SHA SSL_RSA_EXPORT_WITH_RC4_40_MD5 SSL_RSA_WITH_RC4_128_MD5 SSL_RSA_WITH_RC4_128_SHA SSL_RSA_EXPORT_WITH_DES_40_CBC_SHA SSL_RSA_WITH_DES_CBC_SHA SSL_RSA_WITH_3DES_EDE_CBC_SHA SSL_DH_anon_EXPORT_WITH_RC4_40_MD5 SSL_DH_anon_WITH_RC4_128_MD5 SSL_DH_anon_EXPORT_WITH_DES_40_CBC_SHA SSL_DH_anon_WITH_DES_CBC_SHA SSL_DH_anon_WITH_3DES_EDE_CBC_SHA If not specified, the default is SSL_RSA_EXPORT_WITH_RC4_40_MD5 Range of values: Default value:
ClientCertificateEnforced	Range of values: Default value:	weblogic.security.enforceClientCert
Enabled	Sets whether or not SSL usage is enabled for the server. Range of values: Default value:	weblogic.security.ssl.enable
ExportKeyLifespan	Range of values: Default value:	weblogic.security.key.export.lifespan
HandlerEnabled	Sets whether or not to enable server-to-server SSL connections. Range of values: Default value:	weblogic.security.SSLHandler.enable
KeyEncrypted	If true, the key is PKCS8 encrypted and requires a pass phrase to be supplied to use the key. If false, the key is an unencrypted private key and may be used without providing a pass phrase. Range of values: Default value:
ListenPort	The TCP port at which the WebLogic Server listens for SSL connection requests. Range of values: Default value:	weblogic.system.SSLListenPort
LoginTimeoutMillis	Duration allowed for a login sequence. If the duration is exceeded, the login is timed out. 0 to disable. Range of values: Default value:	weblogic.login.readTimeoutMillisSSL
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
PeerValidationEnforced	Range of values: Default value:
ServerCertificateChainFileName	Range of values: String Default value:	weblogic.httpd.logFileFlushSecs
ServerCertificateFileName	Range of values: String Default value:	weblogic.security.certificate.server
ServerKeyFileName	File containing SSL server encryption key. Range of values: String Default value:	weblogic.security.key.server
TrustedCAFileName	The name of the file containing the SSL certificate authority for clients. Range of values: String Default value:	weblogic.security.clientRootCA
UseJava	Range of values: Default value:	weblogic.system.SSL.useJava

WebServer

Cluster

Attribute	Description	weblogic.properties Property Name
ClusterAddress	The address to be used by clients to connect to this cluster. This address may be either a DNS host name that maps to multiple IP addresses or a comma separated list of single address host names or IP addresses. Range of values: This address may be either a DNS host name that maps to multiple IP addresses or a comma separated list of single address host names or IP addresses. Default value: Null
DefaultLoadAlgorithm	The algorithm by which the load is distributed. When the last server has been assigned a transaction, the load comes back to the starting server. Range of values: Round Robin, Weight-based Round Robin, Random, and Parameter-based Routing Default value: Round Robin	weblogic.cluster.defaultLoadAlgorithm
MulticastAddress	The multicast address used by cluster members to communicate with each other. Well-formed IP address. Range of values: Default value:	weblogic.cluster.multicastAddress
MulticastSendDelay	The number of milliseconds to delay sending message fragments over multicast. Range of values: Integer Default value: 12
MulticastTTL	The number of network hops that a cluster multicast message is allowed to travel. Range of values: Integer. Minimum value is 1 and the maximum value is 255, inclusive. 1 restricts the cluster to one subnet. Default value: 1	weblogic.cluster.multicastTTL
Name	The name of the MBean. Range of values: String The cluster name can be up to 256 alphanumeric characters, but may not contain commas or spaces. Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
Servers	The servers that have declared membership in this cluster. Range of values: List Default value: Null

Machine

Attribute	Description	weblogic.properties Property Name
Addresses	The addresses by which the machine is known. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
StartdPort	The port number that the startd is configured to run on this machine. Range of values: Default value:

UnixMachine

This element represents a machine that is running the UNIX operating system. It extends MachineMBean with properties specific to the UNIX platform.

For more information about how to use the Administration Console to set the attributes for configuring and managing machines, see the UnixMachine Console help.

Attribute	Description	weblogic.properties Property Name
Addresses	The addresses by which the machine is known. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
PostBindGID	The UNIX GID a server running on this machine will run under after it has carried out all privileged startup actions. Range of values: Unix GID or null Default value: null	weblogic.system.nonPrivGroup
PostBindGIDEnabled	This attribute allows the user to enable or disable the post-bind GID. Range of values: Boolean True = Selected False = Not Selected Default value: Not Selected	weblogic.system.enableSetGID
PostBindUID	The UNIX UID a server running on this machine will run under after it has carried out all privileged startup actions. Range of values: Unix UID or null Default value: null	weblogic.system.nonPrivUser
PostBindUIDEnabled	This attribute allows the user to enable or disable the post-bind UID. Range of values: Boolean True = Selected False = Not Selected Default value: Not Selected	weblogic.system.enableSetUID
StartdPort	The port number that the startd is configured to run on this machine. Range of values: Default value:

Application

Attribute	Description	weblogic.properties Property Name
Deployed	Deploy or undeploy the entire application. All of the application's components will be deployed or undeployed on their respective roles. Setting deployed to be true on an application that is already deployed is a no-op. Likewise, setting deployed to be false on an application that is not deployed is a no-op. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
Path	The path pointing to the application's EAR file, relative to the Administration Server's file system. Range of values: Default value:

EJBComponent

Attribute	Description	weblogic.properties Property Name
Application	The name of the application this component is a part of. This is guaranteed to never be null. Range of values: Default value:
ExtraRmicOptions	The extra options passed to rmic during server-side generation. The default value for this attribute must be null. If no ExtraRmicOptions are specified on the EJB Component, the default will be pulled from Server.ExtraRmicOptions. Range of values: Default value:
JavaCompiler	The path to the Java compiler (such as "sj" or "javac") to use to compile EJBs. If no Java Compiler is specified on the EJBComponent, the default will be pulled from Server.JavaCompiler. Range of values: Default value: Null
JavaCompilerPostClassPath	Range of values: Default value:
JavaCompilerPreClassPath	The options to prepend to the Java compiler classpath when compiling Java code. Range of values: Default value:
KeepGenerated	Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
Targets	The targets on which this deployment is deployed. Range of values: Default value:
TmpPath	The temporary directory where generated files are stored by ejbc. Range of values: Default value:

WebAppComponent

Attribute	Description	weblogic.properties Property Name
Application	The application this component is a part of. This is guaranteed to never be null. Range of values: Default value:
AuthRealmName	Range of values: Default value:	weblogic.httpd.authRealmName
IndexDirectoryEnabled	Return whether or not to automatically generate an HTML directory listing if no suitable index file is found. Range of values: Default value:	weblogic.httpd.indexDirectories
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
ServletExtensionCaseSensitive	Range of values: Default value:	weblogic.httpd.servlet.extensionCaseSensitive
ServletReloadCheckSecs	Range of values: Default value:	weblogic.httpd.servlet.reloadCheckSecs
SessionMonitoringEnabled	If true, runtime Mbeans will be created for sessions, otherwise, they will not. Range of values: Default value:
SingleThreadedServletPoolSize	Range of values: Default value:	weblogic.httpd.servlet.SingleThreadedModelPoolSize */
Targets	The targets on which this deployment is deployed. Range of values: Default value:

FileRealm

Attribute	Description	weblogic.properties Property Name
MaxACLs	The maximum number of (positive) ACLs that the file-based provider supports. Range of values: Default value:
MaxGroups	The maximum number of groups that the file-based provider supports. Range of values: Default value:
MaxUsers	The maximum number of users that the file-based provider supports. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null

NTRealm

Attribute	Description	weblogic.properties Property Name
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
PrimaryDomain	The Windows NT Primary Domain Controller where users and groups are defined for the domain. You can set the property to "." if the local computer (where the WebLogic Server executes) is the Primary Domain Controller. Range of values: Default value:	weblogic.security.ntrealm.domain
RealmClassName	The realm's java class name.Typically, this class name is hard-coded in a custom Mbean implementation of a specific realm's Mbean interface that extends this interface. Range of values: Default value:

UnixRealm

Attribute	Description	weblogic.properties Property Name
AuthProgram	The Authentication program path. The authentication program must run setuid root. If the program name is wlauth and is in the path of weblogic server, leave this property blank. If the program name is different than wlauth, or if it is not in the path, specify this property. Range of values: Default value: Null	weblogic.security.unixrealm.authProgram
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
RealmClassName	The realm's java class name.Typically, this class name is hard-coded in a custom Mbean implementation of a specific realm's Mbean interface which extends this interface. Range of values: Default value:

JMSServer

Attribute	Description	weblogic.properties Property Name
BytesMaximum	The maximum number of bytes that can be stored in the JMS Server at any one time. A value of zero means there is no limit. Range of values: Default value:
BytesThresholdHigh	Range of values: Default value:
BytesThresholdLow	If there is a threshold condition and the number of bytes stored in the JMS Server drops below this value, then the condition is cleared and an event is generated. Range of values: Default value:
MessagesMaximum	Range of values: Default value:
MessagesThresholdHigh	The value of MessagesThresholdHigh. If there is no threshold condition and the number of messages stored in the JMS Server exceeds this value, then the condition is set and an event is generated. Range of values: Default value:
MessagesThresholdLow	The value of MessagesThresholdLow. If there is a threshold condition and the number of messages stored in the JMS Server drops below this value, then the condition is cleared and an event is generated. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
Store	The backing store for the JMS server. A backing store may only be used by one JMS server. Range of values: Default value:
Targets	Returns targets on which this deployment is deployed. Range of values: Default value:
TemporaryTemplate	The temporary template that is used to create all temporary destinations on this JMS Server. The attributes for the temporary destinations are derived from the template. If no temporary template is defined for the JMS server, then temporary destinations receive the default values for destinations. Range of values: Default value:

JMSSessionPool

JMSConnectionConsumer

JMSTopic

Attribute	Description	weblogic.properties Property Name
BytesMaximum	Range of values: Default value:
BytesThresholdHigh	The value of bytesThresholdHigh. If there is no threshold condition and the number of bytes stored in the destination exceeds this value, then the condition is set and an event is generated. Range of values: Default value:
BytesThresholdLow	The value of BytesThresholdLow. If there is a threshold condition and the number of bytes stored in the destination drops below this value, then the condition is cleared and an event is generated. Range of values: Default value:
DeliveryModeOverride	Range of values: Default value:
Destinations	A read-only array of the Destinations for the template. Range of values: Default value:
JNDIName	The JNDI name of a destination. Range of values: Default value:
MessagesMaximum	The value of MessagesMaximum. This is the maximum number of messages that can be stored in the destination at any one time. A value of zero means there is no limit. Range of values: Default value:
MessagesThresholdHigh	Range of values: Default value:
MessagesThresholdLow	The value of messagesThresholdLow. If there is a threshold condition and the number of messages stored in the destination drops below this value, then the condition is cleared and an event is generated. Range of values: Default value:
MulticastAddress	The multicast address used by the destination well-formed IP address. Range of values: The valid range of multicast addresses is from 224.0.0.1 to 239.255.255.255 Default value:
MulticastPort	The multicast port for the destination. Range of values: Default value:
MulticastTTL	The number of network hops that a multicast message is allowed to travel. Range of values: The minimum value is 1 and the maximum value is 255, inclusive. 1 restricts the message to one subnet. Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
PriorityOverride	Range of values: Default value:
StoreEnabled	Range of values: Default value:
Template	The template for this destination. Range of values: Default value:
TimeToLiveOverride	Range of values: Default value:

JMSDestinationKey

JMSQueue

JMSConnectionFactory

JMSFileStore

JMSTemplate

JMSJDBCStore

JDBCTxDataSource

XMLRegistry

XMLRegistryEntry

StartupClass

ShutdownClass

DomainLogFilter

VirtualHost

CachingRealm

CustomRealm

LDAPRealm

RDBMSRealm

WLECConnectionPool

JoltConnectionPool

JDBCConnectionPool

JDBCDataSource

JDBCMultiPool

Attribute	Description	weblogic.properties Property Name
ACLName	The ACL list for this meta pool. Range of values: Default value:
HighAvail	Whether high availability is used in this meta pool. Range of values: Default value:
LoadBalance	Sets load balancing for this meta pool. Range of values: Default value:
Name	The name of the MBean. Range of values: String Default value: N/A
Notes	Optional user-supplied information about this configuration MBean. Range of values: alphanumeric string Default value: Null
PoolList	Defines the connection pools in the meta pool. Range of values: Default value:
Targets	The targets on which this deployment is deployed. Range of values: Default value:

FileT3

MailSession