---

File	Date	Author	Commit
Tutorial	2006-08-23	alvaro_nieto	[r6] Primera versión
cx_Oracle	2006-10-06	alvaro_nieto	[r7] Adaptado a cx_Oracle 4.2.1
tuxmodule	2006-08-20	alvaro_nieto	[r1] Primera versión
LEEME	2006-10-06	alvaro_nieto	[r8] Adaptado a la versión 4.2.1 de cx_Oracle
LICENSE	2006-08-20	alvaro_nieto	[r1] Primera versión
README	2006-10-06	alvaro_nieto	[r8] Adaptado a la versión 4.2.1 de cx_Oracle
TODO	2006-08-20	alvaro_nieto	[r1] Primera versión
setup.py	2006-08-20	alvaro_nieto	[r1] Primera versión

Read Me

tux_oracle - http://tux-oracle.sourceforge.net
===========================================================

Actual version 1.0.1
------------------
Version 1.0.1 Based on tuxmodule 1.8 and cx_Oracle 4.2.1 October 2006
Version 1.0. Based on tuxmodule 1.8 and cx_Oracle 4.2. September 2006

Author
------
Alvaro Nieto Gil. 
Contact: alvaro.nieto@gmail.com

License
=======

This software is distributed as-it, without any author's warranty and
responsability.

Modules tuxmodule and cx_Oracle have their owns licenses. See tuxmodule
and cx_Oracle documentation.

What's tux_oracle ?
===================

tux_oracle is a Python module that allow you to create Tuxedo clients and 
servers that works with Oracle databases.

It's based on tuxmodule and cx_Oracle modules. Respectively authors grant me
permission to use and modify it; Ralf Henschkowski for tuxmodule and Anthony 
Tuininga for cx_Oracle.

Main diferences with original modules are support XA standard for
distributed transaction processing (DTP).

Adicionaly, it's have been added samples how can you use de module. This samples
could been used as starting sources.

Instalation and tests
=====================

0. Tuxedo and Oracle must be installed

1. Modify Oracle and Tuxedo variables editing file entorno.sh. Execute it;

   ./entorno.sh

2. Create the modules:

   python setup.py build

3. Install the modules:

   python setup.py install

4. Change Tutorial directory

5. Configure database executing sql script crear_tabla.sql

6. Configure Tuxedo domain editing ubbconfig file

7. Regenerate Tuxedo binary file:
   
   tmloadcf -y ubbconfig

8. Create log transaction file with crear_tlog (previously edit it
   changing the TLOG absolute path):

   ./crear_tlog.sh

9. Create resource manager (RM) with crear_tms.sh (edit RM based in
   Oracle version used):

   ./crear_tms.sh

10. Boot Tuxedo domain and execute client

Compatibility
=============

tux_oracle is tested in next systems;

* Linux (Mandrake 10)
* IBM Aix 5.2
* Sun Solaris 8

but certainly it may work in other *nix platforms and linux distributions. 

Windows platform is not supported due tuxmodule incompatibility.