Skip navigation.

eDocs Home > BEA WebLogic Server 8.1 Documentation > WebLogic Server Configuration Reference > WLECConnectionPool

WebLogic Server Configuration Reference

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents Index View as PDF   Get Adobe Reader

WLECConnectionPool

 

Description

This bean defines a WLEC connection pool.

 

Syntax

<WLECConnectionPool
  ApplicationPassword="String"
  ApplicationPasswordEncrypted="[B"
  CertificateAuthenticationEnabled=( "true" | "false" )
  DeploymentOrder="number"
  FailoverAddresses="list of Strings"
  MaximumEncryptionLevel="number"
  MaximumPoolSize="number"
  MinimumEncryptionLevel="number"
  MinimumPoolSize="number"
  Name="String"
  Notes="String"
  PrimaryAddresses="list of Strings"
  SecurityContextEnabled=( "true" | "false" )
  Targets="list of Target names"
  UserName="String"
  UserPasswordEncrypted="[B"
  UserRole="String"
  WLEDomain="String"
/>

 

Parent Elements

 

Attributes

Table 75-1 WLECConnectionPool attributes

Attribute

Description

Range of Values and Default

ApplicationPassword

The password for the application. This field is required when the security level in the Tuxedo domain is APP_PW, USER_AUTH, ACL, or MANDATORY_ACL.

As of 8.1 sp4, the getApplicationPassword() method does the following:

    1. Retrieves the value of the ApplicationPasswordEncrypted attribute.

    2. Decrypts the value and returns the unencrypted password as a String.

Using getApplicationPassword() 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. 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 method, use getApplicationPasswordEncrypted() to retrieve the encrypted password. On the same WebLogic Server that encrypted the value of the ApplicationPasswordEncrypted attribute, use weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.

Admin Console field label: Application Password

Required: no

Encrypted: yes

ApplicationPasswordEncrypted

The encrypted password for the application. This field is required when the security level in the Tuxedo domain is APP_PW, USER_AUTH, ACL, or MANDATORY_ACL.

Required: no

Encrypted: yes

CertificateAuthenticationEnabled

Defines the state of certificate authentication.


  • When you use certificate authentication, WLEC uses the values for the User Name and Application Password fields to create a certificate for WLEC.

  • If you do not use certificate authentication, WLEC uses password authentication or no authentication, depending on the security level of the Tuxedo domain.

  • If password authentication is required, WLEC uses the values for the User Name and User Password fields to authenticate.

Admin Console field label: Enable Certificate Authentication

Default: false

Secure value: true

DeploymentOrder

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 EJBs before it prioritizes and deploys startup classes.

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: 231-1

FailoverAddresses

Defines the list of addresses for IIOP Listener/Handlers used if connections defined in the primary addresses cannot be established or fail. Multiple addresses are separated by semicolons.

Admin Console field label: Failover Addresses

Required: no

MaximumEncryptionLevel

Defines the maximum SSL encryption level used between the Tuxedo domain and WebLogic Server.


  • Zero (0) indicates that the data is signed but not sealed.

  • 40, 56, and 128 specify the length, in bits, of the encryption key.

  • The default is the maximum level allowed by the Encryption Package kit license.

  • If this minimum level of encryption is not met, the SSL connection between Tuxedo and WebLogic Server fails.

Admin Console field label: Maximum Encryption Level

Default: 128

MaximumPoolSize

Defines the maximum number of IIOP connections that can be made from the WLEC connection pool.

Admin Console field label: Maximum Pool Size

Default: 1

MinimumEncryptionLevel

Defines the minimum SSL encryption level used between the Tuxedo domain and WebLogic Server.


  • Zero (0) indicates that the data is signed but not sealed.

  • 40, 56, and 128 specify the length, in bits, of the encryption key.

  • Default value is 40.

  • If this minimum level of encryption is not met, the SSL connection between Tuxedo and WebLogic Server fails.

Admin Console field label: Minimum Encryption Level

Default: 40

MinimumPoolSize

Defines the number of IIOP connections to be added to the WLEC connection pool when WebLogic Server starts.

Admin Console field label: Minimum Pool Size

Default: 1

Name

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

Admin Console field label: Name

Required: no

Notes

Optional information that you can include to describe this configuration.

Admin Console field label: Notes

Required: no

PrimaryAddresses

Defines the list of addresses for IIOP Listener/Handlers used to establish a connection between the WLEC connection pool and the Tuxedo domain.


  • The format of each address is //hostname:port.

  • The addresses must match the ISL addresses defined in the UBBCONFIG file. Multiple addresses are seperated by semicolons. Example: //main1.com:1024;//main2.com:1044.

  • To configure the WLEC connection pool to use the SSL protocol, use the corbalocs prefix with the address of the IIOP Listener/Handler. Example: corbalocs://hostname:port.

Admin Console field label: Primary Addresses

Required: no

SecurityContextEnabled

Defines the state of the security context the WebLogic Server User passed to the Tuxedo domain. If selected, security context is enabled.

Admin Console field label: Enable Security Context

Default: false

Secure value: true

Targets

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

Admin Console field label: Targets

Required: no

UserName

Defines the name of a qualified user. This field is required only when the security level in the Tuxedo domain is USER_AUTH, ACL or MANDATORY_ACL.

Admin Console field label: User Name

Required: no

UserPasswordEncrypted

The encrypted password of the qualified user specified in the User Name field. This field is required only when you define the User Name field.

Required: no

Encrypted: yes

UserRole

Defines the user role for this connection pool. This field is required when the security level in the Tuxedo domain is APP_PW, USER_AUTH, ACL, or MANDATORY_ACL.

Admin Console field label: User Role

Required: no

WLEDomain

Defines the name of the WLEC domain to which the pool is connected.


  • You can have only one WLEC connection pool per Tuxedo domain.

  • The domain name must match the domainid parameter in the RESOURCES section of the UBBCONFIG file for the Tuxedo domain.

Admin Console field label: Domain

Required: no

 

Skip navigation bar  Back to Top Previous Next