diff --git a/docs/source/advancedDevelopment/advancedDevelopment.rst b/docs/source/advancedDevelopment/advancedDevelopment.rst index 0b4b9542..f6673244 100644 --- a/docs/source/advancedDevelopment/advancedDevelopment.rst +++ b/docs/source/advancedDevelopment/advancedDevelopment.rst @@ -12,6 +12,5 @@ Chapter :ref:`gettingStarted` provides the basics of Frank development. This cha database/database dockerDevel/dockerDevel integrationPatterns/integrationPatterns - narayana/narayana deployment/maven muchData/muchData diff --git a/docs/source/advancedDevelopment/integrationPatterns/errorStoreAndXaTransactions.rst b/docs/source/advancedDevelopment/integrationPatterns/errorStoreAndXaTransactions.rst index cb73fd14..38c3468d 100644 --- a/docs/source/advancedDevelopment/integrationPatterns/errorStoreAndXaTransactions.rst +++ b/docs/source/advancedDevelopment/integrationPatterns/errorStoreAndXaTransactions.rst @@ -7,7 +7,7 @@ Error Store and XA Transactions This section shows how to implement the Fire and Forget integration pattern using an error storage and a queue. As a starting point, the application created in section :ref:`advancedDevelopmentIntegrationPatternsTransactions` is taken. It is :download:`available for download <../../downloads/advancedDevelopmentDockerDevelPreJms.zip>`. -Section :ref:`advancedDevelopmentDockerDevelJms` explains how the development environment, files ``docker-compose.yml`` and ``resources.yml``, should be updated to have a queue that can be referenced by Frank configurations. These updates also show that another database driver is needed for PostgreSQL databases that have to support XA transactions. As said, XA transactions are transactions that span multiple data-processing systems, in our case a queue and a database. XA transactions are implemented by the *two phase commit protocol*, see https://en.wikipedia.org/wiki/Two-phase_commit_protocol. This protocol requires a coordinator that drives the data-processing systems. The Frank!Framework uses the Narayana transaction manager for this, which is enabled by setting system property ``transactionmanager.type.default`` to the value ``NARAYANA``. +Section :ref:`advancedDevelopmentDockerDevelJms` explains how the development environment, files ``docker-compose.yml`` and ``resources.yml``, should be updated to have a queue that can be referenced by Frank configurations. These updates also show that another database driver is needed for PostgreSQL databases that have to support XA transactions. As said, XA transactions are transactions that span multiple data-processing systems, in our case a queue and a database. XA transactions are implemented by the *two phase commit protocol*, see https://en.wikipedia.org/wiki/Two-phase_commit_protocol. This protocol requires a coordinator that drives the data-processing systems. The Frank!Framework uses the Narayana transaction manager for this, which is enabled by setting system property ``transactionmanager.type.default`` to the value ``NARAYANA``. The behavior of the Narayana transaction manager can be fine-tuned by setting properties, see section :ref:`advancedDevelopmentIntegrationPatternsNarayana`. With the development environment in place, it can be shown how our example configuration can be updated to have the Fire and Forget integration pattern. The changes are shown below: diff --git a/docs/source/advancedDevelopment/integrationPatterns/integrationPatterns.rst b/docs/source/advancedDevelopment/integrationPatterns/integrationPatterns.rst index 354235ad..92a49b5e 100644 --- a/docs/source/advancedDevelopment/integrationPatterns/integrationPatterns.rst +++ b/docs/source/advancedDevelopment/integrationPatterns/integrationPatterns.rst @@ -21,4 +21,5 @@ This section introduces concepts and features of the Frank!Framework to implemen onlyOnce transactions fireAndForget - errorStoreAndXaTransactions \ No newline at end of file + errorStoreAndXaTransactions + narayana \ No newline at end of file diff --git a/docs/source/advancedDevelopment/narayana/narayana.rst b/docs/source/advancedDevelopment/integrationPatterns/narayana.rst similarity index 98% rename from docs/source/advancedDevelopment/narayana/narayana.rst rename to docs/source/advancedDevelopment/integrationPatterns/narayana.rst index 53eeac9f..73e0966c 100644 --- a/docs/source/advancedDevelopment/narayana/narayana.rst +++ b/docs/source/advancedDevelopment/integrationPatterns/narayana.rst @@ -1,7 +1,7 @@ -.. _advancedDevelopmentNarayana: - LIVING DOCUMENT +.. _advancedDevelopmentIntegrationPatternsNarayana: + Narayana TransactionManager ===========================