6.2. Configuring the Transaction Manager
Overview
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:
EsbInstallDir/etc/org.apache.aries.transaction.cfg
Transaction manager properties
The properties that you can set in the
org.apache.aries.transaction.cfg file include the following:
- aries.transaction.timeout
- Specifies the transaction timeout in seconds. Default is 600 (that is, 10 minutes).
- aries.transaction.recoverable
- A boolean variable that specifies whether or not the transaction manager is recoverable. Default is
false. - aries.transaction.howl.bufferSize
- Specifies the HOWL log buffer size in units of KB, where the value must be an integer in the range
[1,32]. Default is32. - aries.transaction.howl.logFileDir
- (Required) Specifies the log directory location, which must be an absolute path. No default value.
- aries.transaction.howl.logFileName
- Specifies the name of the HOWL log file. Default is
transaction. - aries.transaction.howl.logFileExt
- Specifies the file extention for the HOWL log file. Default is
log. - aries.transaction.howl.maxLogFiles
- Specifies the maximum number of log files. Default is 2.
Sample settings
The following example shows the default settings from the
org.apache.aries.transaction.cfg configuration file:
aries.transaction.timeout=600
aries.transaction.howl.logFileDir=${karaf.data}/txlog/