The quickstarts for the narayana project
Clone or download
Latest commit f28d1e4 Oct 11, 2018
Permalink
Failed to load latest commit information.
ArjunaCore ArjunaCore/txoj: txoj to update to run during integration testing Oct 16, 2018
ArjunaJTA [JBTM-3060] fixing quickstart README while adding top-level readme up… Oct 16, 2018
ArjunaJTS Reducing size of git clone of foreign repositories Oct 16, 2018
STM Updated to 5.9.1.Final-SNAPSHOT Jul 5, 2018
XTS [JBTM-3069] Fix for XTS ssl failure Oct 18, 2018
agroal Adding quickstart showing integration with Agroal Oct 19, 2018
atsintegration atsintegration: get it run with maven Oct 16, 2018
blacktie [JBTM-3069] Fix for XTS ssl failure Oct 18, 2018
compensating-transactions Updated to 5.9.1.Final-SNAPSHOT Jul 5, 2018
dbcp2-and-tomcat [JBTM-3060] fixing quickstart README while adding top-level readme up… Oct 16, 2018
jca-and-hibernate unification of h2 version used in quickstarts Oct 19, 2018
jca-and-tomcat unification of h2 version used in quickstarts Oct 19, 2018
jta-1_2-in-wildfly Updated to 5.9.1.Final-SNAPSHOT Jul 5, 2018
jta-1_2-standalone [JBTM-3060] fixing quickstart README while adding top-level readme up… Oct 16, 2018
jta-and-hibernate-standalone Updated to 5.9.1.Final-SNAPSHOT Jul 5, 2018
jts-atomic-app [JBTM-2298] JTS and Jacorb atomic app Mar 29, 2016
jts-docker [JBTM-3060] fixing quickstart README while adding top-level readme up… Oct 16, 2018
karaf/osgi-jta Updated to 5.9.1.Final-SNAPSHOT Jul 5, 2018
rts JBTM-3063 LRA examples Oct 23, 2018
scripts/hudson [JBTM-3069] Fix for XTS ssl failure Oct 18, 2018
spring unification of h2 version used in quickstarts Oct 19, 2018
tools Revert "JBTM-2805 Upgrade maven to 3.3.9" Dec 16, 2016
transactionaldriver unification of h2 version used in quickstarts Oct 19, 2018
wiki-example JBTM-2779 Update to add the license file Nov 1, 2016
wildfly unification of h2 version used in quickstarts Oct 19, 2018
.gitignore [JBTM-3060] fixing quickstart README while adding top-level readme up… Oct 16, 2018
LICENSE.md JBTM-3063 LRA examples Oct 23, 2018
PULL_REQUEST_TEMPLATE.md Create PULL_REQUEST_TEMPLATE.md Oct 12, 2018
README.md Adding quickstart showing integration with Agroal Oct 19, 2018
build.bat Revert "JBTM-2816 rename mvn.bat to mvn" Dec 16, 2016
build.sh JBTM-2874 GlassFish interop Apr 13, 2017
pom.xml [JBTM-3060] fixing quickstart README while adding top-level readme up… Oct 16, 2018

README.md

Quickstarts

Introduction

The repository contains a set of quickstart projects which provide working example for specific Narayana transaction manager capabilities. The quickstarts can be used as a reference for your own project.

The list of all available quickstart can be found down at this page. Each quickstart is categorized with tags that depict areas the quickstart is connected with.

TODO: link here quickstarts from WildFly!!!

List of quickstarts

Project name Description Maven coordinates Tags
ArjunaCore/txoj Showing how to use the Transactional Object for Java (TXOJ) which is the core implementation concept of the Narayana state machine o.j.n.quickstart.arjunacore :txoj arjuna.core, standalone
ArjunaJTA/maven Minimalistic maven project showing how to configure maven to use the Narayana JTA implementation o.j.n.quickstart.jta :maven jta, standalone
ArjunaJTA/javax_transaction basics on using JTA API in your application, you can check how to obtain the UserTransaction and TransactionManager with use of the Narayana API o.j.n.quickstart.jta :javax_transaction jta, standalone_
ArjunaJTA/jee_transactional_app WildFly application which shows use of the transaction management in EJB when invoked from CDI bean o.j.n.quickstart.jta: jee_transactional_app jta, wildfly
ArjunaJTA/object_store How to configure Narayana to run different types of object stores in standalone mode org.jboss.narayana.quickstart.jta: object_store jta, narayana.configuration, standalone
ArjunaJTA/recovery Example of running periodic recovery in Narayana standalone. The setup shows multiple implementation of the recovery storage for could be configured by user. o.j.n.quickstart.jta: recovery jta, narayana.configuration, standalone
ArjunaJTS/interop Transactional EJB calls between GlassFish and WildFly o.j.n.quickstart.jts :jts-interop-quickstart jts,wildfly,glassfish
ArjunaJTS/jts Demonstration of setting up JTS transactions in WildFly and how to use EJB2 beans to pass the transactional context over the remote IIOP call o.j.n.quickstart.jts :jboss-as-jts-parent jts,wildfly
ArjunaJTS/recovery Setting up the Narayana recovery manager for JTS in standalone mode o.j.n.quickstart.jts :jts-recovery jts, narayana.configuration, standalone
ArjunaJTS/standalone Example of using Narayana JTS and in second part the example of using ORB API to manage remote JTS transaction manager with IIOP calls o.j.n.quickstart.jts :jts-standalone jts, iiop, standalone
atsintegration How to integrate Narayana with and arbitrary Java EE application server o.j.n.quickstart.jta :application-server-integration narayana.configuration
agroal How to integrate Narayana with Agroal jdbc pooling library o.j.n.quickstart.jta :agroal jta, standalone, jdbc

Quickstart categorization

Category List of quickstarts
arjuna.core ArjunaCore/txoj
narayana.configuration ArjunaJTA/object_store, ArjunaJTA/recovery, ArjunaJTS/recovery, atsintegration
jta ArjunaJTA/maven, ArjunaJTA/javax_transaction, ArjunaJTA/jee_transactional_app, ArjunaJTA/object_store, ArjunaJTA/recovery, agroal
jts ArjunaJTS/interop, ArjunaJTS/jts, ArjunaJTS/recovery, ArjunaJTS/standalone
standalone ArjunaCore/txoj, ArjunaJTA/maven, ArjunaJTA/javax_transaction, ArjunaJTA/object_store, ArjunaJTA/recovery, ArjunaJTS/recovery, ArjunaJTS/standalone, agroal
wildfly ArjunaJTA/jee_transactional_app,ArjunaJTS/interop, ArjunaJTS/jts
glassfish ArjunaJTS/interop
iiop ArjunaJTS/standalone
jdbc agroal

Tags definition

Contacting us

We are always happy to talk transactions and how-to use Narayana in exotic and not so exotic environments. If you have ideas for what we can add to the quickstarts to make them more useful please do reach out to us at: http://narayana.io/community

Quickstarts in CI environment

If you want to see how we run the quickstarts in our continuous integration environment, take a look at scripts/hudson/quickstart.sh.

Running a single quickstart

Change directory into the required quickstart and follow the instructions in the README.md file.

Running all quickstarts in a single command

To run the quickstarts:

  1. set WORKSPACE (to the root of the quickstart checkout)
  2. set JBOSSAS_IP_ADDR (default is localhost)
  3. set JBOSS_HOME (to the path of WildFly server, you can download the server at http://wildfly.org/downloads)
  4. mvn clean install

NOTE: One of the BlackTie quickstarts requires the Oracle driver to be downloaded and configured, see blacktie/test/initializeBlackTie.xml for more details.

It is disabled by default but running ./blacktie/run_all_quickstarts.[sh|bat] tx will execute it.

NOTE: As the scope of Narayana quickstart is broad - it shows integration with many platform – you need to expect a big amount of data to be downloaded from Maven repository.

NOTE: If you want to prepare the quickstarts by installing them without running any test then run the mvn clean install -DskipTests

NOTE: If you want to run the quickstart with specific Narayana version you can use command line option -Dversion.narayana=...