Visit Azul.com Support

Flush-Connection-Pool

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

Reintializes all connections established in the specified connection pool.

Synopsis

 
asadmin [asadmin-options] flush-connection-pool [--help] [--appname application [--modulename module] pool_name

Description

The flush-connection-pool subcommand resets a JDBC connection pool or a connector connection pool to its initial state. Any existing live connections are destroyed, which means that the transactions associated with these connections are lost. The subcommand then recreates the initial connections for the pool, and restores the pool to its steady pool size.

This subcommand is supported in remote mode only.

Application Scoped Resources

The flush-connection-pool subcommand can target resources that are scoped to a specific application or module, as defined in the glassfish-resources.xml or payara-resources.xml for the Payara Server domain.

Important
glassfish-resources.xml is deprecated and support will be removed in a future release. It is recommended to use payara-resources.xml instead.
  • To reference the jndi-name for an application scoped resource, perform the lookup using the java:app prefix.

  • To reference the jndi-name for a module scoped resource, perform the lookup using the java:module prefix.

The jndi-name for application-scoped-resources or module-scoped-resources are specified using the format java:app/`jdbc/myDataSource or java:module/`jdbc/myModuleLevelDataSource. This naming scope is defined in the Jakarta EE Specification (https://jakarta.ee/specifications/).

Options

asadmin-options: Options for the asadmin utility. For information about these options, see the asadmin help page. --help: -?: Displays the help text for the subcommand. --appname: Name of the application in which the application scoped resource is defined. --modulename: Name of the module in which the module scoped resource is defined.

Operands

pool_name: Name of the connection pool to be reinitialized.

Flushing a Connection Pool

This example reinitializes the JDBC connection pool named __TimerPool.

 
asadmin> flush-connection-pool __TimerPool Command flush-connection-pool executed successfully.

Exit Status

0: subcommand executed successfully 1: error in executing the subcommand

See Also