Chapter 10. XA Tutorial

download PDF


This tutorial describes how to define and build a transactional route involving two XA resources (a JMS resource and a JDBC resource), based on the Apache Aries transaction manager in the OSGi container. For the purposes of illustration, the tutorial uses the Apache Derby database, which provides the JDBC XA resource.

10.1. Install Apache Derby


For this tutorial, you need an installation of the Apache Derby database, which is an open source database that supports XA transactions. In particular, you will need to use the ij command-line utility later in the tutorial to create a database schema.


Download the latest binary distribution of Apache Derby,, from the Apache Derby download page:
The same binary distribution is used both for Windows and *NIX operating systems.


To install Apache Derby, use an archive utility to extract the binary distribution into a convenient directory (for example, C:\Program Files on Windows, or /usr/local on *NIX).

Environment variables

To gain access to the Derby command-line utilities, add the Derby bin directory to your PATH variable.
On Windows, you could use a batch script like the following:
REM Set Apache Derby environment on Windows
SET DERBY_HOME=DerbyInstallDir

On *NIX, you could use a bash script like the following:
# Set Apache Derby environment on *NIX

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.