L     I X   X   A
L     I  X X   A A    LIXA
L     I   X   A   A   LIbre XA
L     I  X X  AAAAA   a free and open source XA Transaction Manager
LLLLL I X   X A   A

LIXA (LIbre XA) is an open source and free software Transaction Manager
that implements the distributed transaction processing "XA specification" and
"TX (transaction demarcation) specification" according to the
X/Open CAE Specification.
LIXA is a Transaction Manager but it's not a Transaction Monitor: this is the
distinguishing feature of the project: it enables every application container,
like a web server or a shell, to become an XA compliant application server.
The client/server architecture of LIXA allows many application container to
point a single LIXA server: this is ideal where horizontal scalability is a
must and many identical application containers must refer to a single
transactional environment. 

********
LICENSE:

 * LIXA is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as published
 * by the Free Software Foundation.
 *
 * LIXA is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.

******************
LICENSE EXCEPTION:

A piece of LIXA (liblixab, liblixac) is distributed with a special exception:

 * In addition, as a special exception, the copyright holders of LIXA gives
 * Globetom Holdings (Pty) Ltd / 92 Regency Drive / Route 21 Corporate Park /
 * Nellmapius Drive / Centurion / South Africa
 * the permission to redistribute this file and/or modify it under the terms
 * of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 * The above special grant is perpetual and restricted to
 * Globetom Holdings (Pty) Ltd: IN NO WAY it can be automatically transferred
 * to a different company or to different people. "In no way" contemplates:
 * merge, acquisition and any other possible form of corportate change.
 * IN NO WAY, the above special grant can be assimilated to a patent or
 * any other form of asset.
 *
 * August 1st, 2016: Christian Ferrari thanks Globetom Holdings (Pty) Ltd 
 * for its donation to Emergency NGO, an international charity that promotes 
 * a culture of peace, solidarity and respect for human rights providing free, 
 * high quality medical and surgical treatment to the victims of war, landmines 
 * and poverty.



Documentation is available in these places:
- local directory doc/manuals/index.html after tarball extraction
- http://lixa.sourceforge.net/lixa-doc/html/
- http://lixa.sourceforge.net/lixa-doc/ext/html/

Some important things you should check in the documentation before going on:
1. check LIXA dependency looking at "Installation/System requirements"
2. understand LIXA installation procedure describe at "Installation/Configure,
   build and install"
3. if you are interested in the test procedure (after build), take a look to
   "Installation/Checking"
4. how to understand what's happening inside LIXA code is explained in
   "In Depth/Tracing"
5. examples are described in chapter "Development"

Doxygen source code documentation: how to extract from LIXA source code the
documentation of files, structs and functions (you must install Doxygen
http://www.stack.nl/~dimitri/doxygen/ before you can use it).
Please update doxygen.conf.in and change /var/www/lixa to a suitable 
destination in your system.
Use "configure" (see above) to produce "doxygen.conf" file.
If you installed Graphviz (http://www.graphviz.org/), configure should detect
it and would produce data and headers dependencies too.

Dependencies report:
O.S.            Feature         Packages
Ubuntu          Basic           make gcc libglib2.0-dev libxml2-dev uuid-dev pkg-config automake
Ubuntu		MySQL		mysql-server libmysqlclient-dev
Ubuntu		PostgreSQL	postgresql libpq-dev
Ubuntu          GnuCOBOL	open-cobol
CentOS          Basic           gcc glib2-devel libxml2-devel libuuid-devel autoconf net-tools
CentOS		MySQL		mysql-server/mariadb-server mysql-devel/mariadb-devel
CentOS		PostgreSQL	postgresql postgresql-server postgresql-devel
RHEL 7.3	Basic		gcc glib2-devel libxml2-devel libuuid-devel
				autoconf net-tools libtool


Enjoy LIXA!
Ch.F.