Title and Copyright Information
What's New in MicroTx
- New Features in 24.4
- Changes in the Previous Release
1 About MicroTx
- 1.1 How MicroTx Works
- 1.2 Components of MicroTx
- 1.3 About the Distributed Transaction Protocols
- 1.4 Workflow to Install and Use MicroTx
2 Plan
- 2.1 Supported Container Platforms
- 2.2 Supported Authorized Cloud Environments
- 2.3 Supported Languages and Frameworks
- 2.4 Supported Data Stores for Transaction Logs
- 2.5 Supported Identity Providers
- 2.6 Limits
- 2.7 About Choosing a Transaction Protocol
- 2.8 About Authentication and Authorization
3 Prepare
- 3.1 Download the Installation Bundle
- 3.2 Download the MicroTx image from Oracle Container Registry
- 3.3 Set Up Oracle Identity Providers
- 3.4 Prepare a Kubernetes Cluster
- 3.5 Set Up Access to MicroTx Web Console
- 3.6 Set Up etcd as Data Store
  - 3.6.1 Generate RSA Certificates for etcd
  - 3.6.2 Create a Kubernetes Secret for etcd
- 3.7 Set Up Oracle Database as Data Store
4 Install on a Kubernetes Cluster
- 4.1 Push Images to a Remote Docker Repository
- 4.2 Configure the values.yaml File
- 4.3 Install MicroTx
- 4.4 Access MicroTx
- 4.5 Check the Coordinator Health
5 Post-Installation Tasks
- 5.1 Find IP Address of Istio Ingress Gateway
- 5.2 What's Next
6 Upgrade to 24.4
- 6.1 Upgrade to the Latest Free Release
- 6.2 Back Up Cached Maintenance Data
- 6.3 Upgrade to the Latest Enterprise Edition in Kubernetes Cluster
- 6.4 Upgrade to the Latest Enterprise Edition in Docker
- 6.5 Upgrade to the Latest Enterprise Edition in Docker Swarm
- 6.6 Upgrade to the Latest Enterprise Edition Using SQL Scripts
7 Develop Applications with XA
- 7.1 About MicroTx Library for XA
- 7.2 Workflow to Develop Applications with XA
- 7.3 Plan Your Resource Manager
- 7.4 Provide the Resource Manager Connection Details
- 7.5 Configure PostgreSQL as Resource Manager
- 7.6 Manage XA Transactions
- 7.7 Required User Privileges
- 7.8 Configure Library Properties for JAX-RS and Node.js Apps
- 7.9 About @Transactional
- 7.10 Develop Spring Boot Apps with XA
- 7.11 Develop JAX-RS Apps with XA
- 7.12 Configure Java Apps to Leverage Transactional Event Queues
- 7.13 Develop Node.js Apps with XA
  - 7.13.1 Configure Node.js App as Transaction Initiator
  - 7.13.2 Configure Node.js App as Transaction Participant
    - 7.13.2.1 Configure Node.js Apps with an XA-Compliant Resource Manager
    - 7.13.2.2 Configure Node.js Apps with a Non-XA Resource
- 7.14 Develop ORDS App with XA
- 7.15 Include Oracle Blockchain Platform in XA Transactions
8 Develop Applications with Saga
- 8.1 Workflow to Develop Applications with Saga
- 8.2 Propagate Oracle-Tmm-Tx-Token for multiple REST API calls
- 8.3 Develop Java Apps with Saga
- 8.4 Develop Node.js Apps with Saga
  - 8.4.1 Configure Library Properties for Node.js Apps
  - 8.4.2 Configure Node.js Apps as Transaction Initiator or Participant
9 Develop Applications with TCC
- 9.1 Guidelines
- 9.2 Workflow to Develop Applications with TCC
- 9.3 Configure Library Properties
- 9.4 About Transaction Timeout
- 9.5 Develop Spring Boot Apps with TCC
  - 9.5.1 Configure Spring REST App as Transaction Initiator
  - 9.5.2 Configure Spring Boot App as Transaction Participant
- 9.6 Develop JAX-RS Apps with TCC
  - 9.6.1 Configure JAX-RS App as Transaction Initiator
  - 9.6.2 Configure JAX-RS App as Transaction Participant
- 9.7 Develop Node.js Apps with TCC
  - 9.7.1 Configure Node.js App as Transaction Initiator
  - 9.7.2 Configure Node.js App as Transaction Participant
- 9.8 Develop Python Apps with TCC
  - 9.8.1 Configure Python App as Transaction Initiator
  - 9.8.2 Configure Python App as Transaction Participant
10 Develop Tuxedo Apps with XA
- 10.1 Run Tuxedo App on Linux Host
- 10.2 Run Tuxedo App in Kubernetes Cluster
  - 10.2.1 Start Tuxedo Sample App in a Docker Container
  - 10.2.2 Update the YAML Files for Tuxedo App
11 Manage the Transaction Coordinator
- 11.1 About Session Affinity
  - 11.1.1 Enable Session Affinity
- 11.2 Enable Caching
- 11.3 About Transaction Recovery
- 11.4 General Syntax of Commands
- 11.5 Scale up or down
- 11.6 Update
- 11.7 Uninstall
12 Manage Transactions Using the Web Console
- 12.1 Access the Web Console
- 12.2 View Details of a Transaction
- 12.3 View the Total Number of Transactions
- 12.4 View the Number of Recent Transactions
- 12.5 View Coordinator Health
- 12.6 View Console Health
- 12.7 View Configuration Properties
- 12.8 Manage XA Transactions
- 12.9 Manage TCC Transactions
  - 12.9.1 Confirm a TCC Transaction
  - 12.9.2 Cancel a TCC Transaction
- 12.10 Manage Saga Transactions
  - 12.10.1 Complete a Saga Transaction
  - 12.10.2 Compensate a Saga Transaction
13 Deploy Sample Applications
- 13.1 About XA Sample Application
  - 13.1.1 Scenario: Withdraw and Deposit an Amount
- 13.2 About the Sample Saga Application
- 13.3 About the Sample TCC Application
14 Monitor and Trace Transactions
- 14.1 Trace
- 14.2 Monitor Performance
  - 14.2.1 Set Up Prometheus and Grafana
  - 14.2.2 View Metrics with Prometheus and Grafana
- 14.3 Install and Configure Alertmanager
- 14.4 Logs
15 Troubleshooting
- 15.1 Cannot retrieve transaction details from the MicroTx coordinator
- 15.2 Unable to retrieve details about the MicroTx coordinator and console health
- 15.3 No data is displayed in the Console
A Deploy Your Application
- A.1 Build the Docker Image
- A.2 Push App Image to a Remote Repo
- A.3 Create Helm Files
- A.4 Install Your Application
B Install on Docker Swarm
- B.1 Set Up Docker Swarm
- B.2 Create a Registry
- B.3 Push Image to a Docker Registry
- B.4 Create Encryption Key and Key Pair
- B.5 Create a Docker Secret for Oracle Database Credentials
- B.6 Update YAML files with etcd Details
- B.7 Configure the tcs-docker-swarm.yaml File
- B.8 Configure Secure Connection for Your Apps
- B.9 Access MicroTx in Docker Swarm
C Run MicroTx in a Docker Container in Local Environment
- C.1 Run MicroTx in a Docker Container on Linux
- C.2 Run MicroTx in a Docker Container on Windows
- C.3 Run MicroTx in a Docker Container on macOS (Intel x86)
- C.4 Run MicroTx in a Docker Container on macOS (Arm)
D Configure Coordinator Using Environment Variables
- D.1 Provide Configuration Details
- D.2 Environment Variables for Transaction Coordinator