6.2. Configuring the Transaction Manager

download PDF


You can configure some basic parameters of the Aries transaction manager by editing the properties in the Aries transaction manager configuration file. In particular you must always specify the location of the HOWL log file directory and it is necessary to set the aries.transaction.recoverable property explicitly to true, if you want to enable the transaction recovery mechanism.

Configuration file

To configure the Aries transaction manager, you can edit the properties in the following configuration file:

Transaction manager properties

The properties that you can set in the org.apache.aries.transaction.cfg file include the following:
A boolean variable that specifies whether or not the transaction manager is recoverable. If not set, it defaults to false.
Specifies the transaction timeout in seconds. Default is 600 (that is, 10 minutes).
Specifies the transaction manager identification string that gets appended to all transaction XIDs. This identification string allows transactions from different transaction managers to be disambiguated during transaction recovery, and should be different for each JBoss Fuse container that performs global transactions on a particular set of transactional resources. The string can be up to 64 characters in length. If not specified, a default identification string would be used, but this default value is the same for all JBoss Fuse containers.
Specifies the HOWL log buffer size in units of KB, where the value must be an integer in the range [1,32]. Default is 32.
(Required) Specifies the log directory location, which must be an absolute path. No default value.
Specifies the name of the HOWL log file. Default is transaction.
Specifies the file extention for the HOWL log file. Default is log.
Specifies the maximum number of log files. Default is 2.
Specifies the maximum size of a transaction log file in blocks (the block size can vary, but in Linux systems a typical block size is 4kB). After the maximum size is reached, the log rolls over to a new log file.

Sample settings

The following example shows the default settings from the org.apache.aries.transaction.cfg configuration file:
Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.