bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search

WebLogic Server Configuration Reference

 Previous Next Contents Index View as PDF  

JDBCMultiPool

Description

Relevant only in single-server configurations, JDBC Multipools provide backup pools and load balancing to enhance database connectivity. A MultiPool is a "pool of pools" that allows a configurable algorithm for choosing among its list of pools, the pool that will be selected to provide the connection. MultiPools do not apply to multiple-server configurations.

Syntax

<!ELEMENT JDBCMultiPool EMPTY >
<!ATTLIST JDBCMultiPool
   ACLName                    CDATA                    #IMPLIED
   AlgorithmType              (High-Availability |
                               Load-Balancing)         "High-Availability"
   DeploymentOrder            CDATA                    "1000"
   Name                       CDATA                    #REQUIRED
   Notes                      CDATA                    #IMPLIED
   PoolList                   CDATA                    #IMPLIED
   Targets                    CDATA                    #IMPLIED
>

Parent Elements

The JDBCMultiPool element is a child of the Domain element.

Attributes

Table 24-1 JDBCMultiPoolMBean Element Attributes

Attribute

Description

Range of Values and Default

Console Label

ACLName

The access control list (ACL) used to control access to this MultiPool.


ACLName

Algorithm-Type

The algorithm type for this Multipool.

If set to "High availability", the connection pools are set up as an ordered list. That is, every time an application asks the Multipool for a connection, it tries to get a connection from the first pool in its list. If unable to get a valid connection, it tries the next pool in its list. The process is repeated until a valid connection is obtained, or until the end of the list is reached, in which case an exception will be thrown.

Note that the Multipool will only move to the next pool in the list when there is a real problem with the pool, for example the database is down or the pool disabled. For the cases where all connections are busy, the Multipool behaves as a single pool and an exception is thrown.

If the algorithm is set to "Load balancing," the Multipool will distribute the connection requests evenly to its member pools. This algorithm also performs the same failover behavior as the high availability algorithm.

Default value for this attribute is "High availability".

Default: High-Availability

Valid values:

  • High-Availability

  • Load-Balancing

Algorithm Type

Deployment-Order

A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type. For example, the server prioritizes and deploys all startup classes before it prioritizes and deploys EJBs.

Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters.

Default: 1000

Minimum: 0

Maximum: 2147483647

Deployment Order

Name

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.


Name

Notes

Optional information that you can include to describe this configuration.


Notes

Pool-List

The list of connection pools in the MultiPool.


Pool List

Targets

The targets in the current domain on which this item can be deployed.


Targets


 

 

Back to Top Previous Next