Configuration differences between the full profile and Liberty profile: connectionManager element

There are some differences in configuration between connectionManager in the Liberty profile and connection pools in the full profile.

• Properties with different names

  • maxConnectionsPerThread, which is maxNumberofMCsAllowableInThread in the full profile.

  • maxIdleTime, which is unusedTimeout in the full profile.

  • maxPoolSize, which is maxConnections in the full profile.

  • minPoolSize, which is minConnections in the full profile.

• Time duration properties

  We can optionally specify the time duration properties with units in the Liberty profile. For example,

  <connectionManager id="pool1" connectionTimeout="30s" reapTime="3m" maxIdleTime="30m"/>

  See Configuration elements in server.xml for accepted time units and formats for the connectionManager element. If we do not specify time units in the Liberty profile, the same default units are used as in the full profile.

• Differences between immediate timeout values and never (disable) timeout

  There are differences in the values that represent immediate timeout and never (disabled) timeout.

  • The Liberty profile uses a value of 0 to represent immediate, whereas the full profile often uses -1 for immediate.

  • The Liberty profile uses a value of -1 to represent never (disabled), whereas the full profile often uses 0 for never (disabled).

  Specifically this applies to the following attributes:

  • agedTimeout
  • connectionTimeout
  • maxIdleTime, which is unusedTimeout in the full profile
  • reapTime

• Purge policy changes

  In the Liberty profile , there are three purge policy values: EntirePool, FailingConnectionOnly, and ValidateAllConnections.

  In the full profile, there are two purge policy values: EntirePool and FailingConnectionOnly, with a second property, defaultPretestOptimizationOverride, determining the behavior of FailingConnectionOnly.

  Purge policies in the Liberty profile, and their full profile equivalents, :

  • purgePolicy="EntirePool", which is the same for both.

  • purgePolicy="FailingConnectionOnly", which is equivalent to purgePolicy="FailingConnectionOnly" with defaultPretestOptimizationOverride="false" in the full profile.

  • purgePolicy="ValidateAllConnections", which is equivalent to purgePolicy="FailingConnectionOnly" with defaultPretestOptimizationOverride="true" in the full profile.

Parent topic: Migrate data access applications to the Liberty profile