Rachel - Repairing deadlocking service choreographies

Understand Rachel

Much work has been conducted to analyze services and service choreographies to assert manyfold correctness criteria. While errors can be detected automatically, the correction of defective services is usually done manually.

Rachel is a tool to correct deadlocking choreographies by giving information how to modify a service of the choreography to acheive deadlock freedom.

Rachel does not give arbitrary modification information, but tries to find the most similar correct service from the set of all correctly fitting services.

Rachel takes a service automaton and an operating guideline as input and calculates a list of correction actions needed to fix the service automaton to match with the operating guideline.

Case Studies

  • At the Business Process Management conference 2008, a paper was presented containing a case study.

This is the complete list of all case-studies available on service-technology.org that were conducted with Rachel:

You can run all case studies by executing

make experiments

in the root directory of a Rachel distribution after compilation.


We suggest the following paper to get an overview on the problem that is addressed by Rachel and Rachel's problem solving algorithms.

This is the complete list of all publications related to Rachel:

Get Rachel

Rachel is released as free software under the terms of the GNU General Public License. You can download the source code and compile it using a C++ compiler.


You can download the latest source code release here.

Setup & Install

Rachel can be compiled on most operating systems1) with

tar xfz rachel-1.xx.tar.gz

cd rachel-1.xx



To check the built binary, you can (optionally) execute

make check

which runs a bunch of self-tests.

After compilation, you can install the generated binary, the manpage, and the documentation with

make install

For more details, see the distribution's INSTALL file.


The (most recent, possibly buggy) source code is also available from an anonymous Subversion repository typing2)

After checking out, the following commands have to be executed to prepare Rachel to compile

cd rachel

autoreconf -iv

Now, Rachel can be configured and compiled with



Note that in order to compile the source code from the repository, you need to following tools:

Change Log

A detailed change log is available here.

Use Rachel

Rachel is a prototypic implementation and currently lacks a graphical user interface. Instead, Rachel is controlled with a few simple command line parameters.


A manual is available in PDF format.


Rachel is controlled with command line parameters:


Currently, we are not aware of any bugs.

Bugs can be reported at Rachel's project page or via e-mail to rachelservice-technologyorg.

1) We tried Microsoft Windows (with Cygwin), Sun Solaris, GNU/Linux, and Mac OS X.

2) For more information, see https://gna.org/svn/?group=service-tech.