4.2.4.2 MicroTx Distributed Transactions Coordinator Properties

Under tmmConfiguration, provide information to configure MicroTx Distributed Transactions coordinator.

Property Description
tmmAppName Enter the name of the MicroTx Distributed Transactions application that you want to create. When you install MicroTx Distributed Transactions, Helm creates the MicroTx Distributed Transactions service with the name that you specify. Note down this name as you will need to provide it later. For example, tmm-app.
tmmId Enter a value to uniquely identify each instance of MicroTx Distributed Transactions coordinator that you install. The unique identifier must have 5-characters and can contain only alphanumeric characters (a-z, A-Z, and 0-9). For example, TMM01.

Use this ID to identify MicroTx Distributed Transactions coordinator when there are multiple installations. You cannot use this ID to differentiate between replicas of a single instance of MicroTx Distributed Transactions coordinator installation as all the replicas have the same ID. You can't change this value after installing MicroTx Distributed Transactions coordinator.

port Enter the port over which you want to internally access MicroTx Distributed Transactions coordinator within the Kubernetes cluster where you will install this service. Create the required networking rules to permit inbound and outbound traffic on this port. Note down this number as you will need to provide it later. For example, 9000.
xaCoordinator, lraCoordinator, or tccCoordinator Set enabled: "true" for the transaction protocols that your microservices use. MicroTx Distributed Transactions coordinator supports three distribution transaction protocols: XA, Saga, and TCC. If you want to nest an XA transaction within an Saga transaction, set enabled: "true" for both xaCoordinator and lraCoordinator.
narayanaLraCompatibilityMode Only for the Saga transaction protocol. Set enabled to true only when you want to use Saga participant applications that were implemented to work with the Narayana LRA Coordinator and now would participate in Saga transactions using MicroTx Distributed Transactions. Enable this mode to ensure that the Saga APIs return the same response data that Narayana LRA Coordinator APIs return.
sessionAffinity Set this to true to enable session affinity for transaction participant services and the transaction initiator service. When you enable caching, you must also enable session affinity for the coordinator.
metrics.enabled Set this to true so that Prometheus can scrape the metrics logs of the MicroTx Distributed Transactions coordinator. By default, this is set this to true.
logging.level Enter one of the following types to specify the log level for MicroTx Distributed Transactions:
  • info: Logs events that occur during the normal operation of the MicroTx Distributed Transactions. This setting logs the least amount of information. This is the default setting.
  • warning: Logs events that may cause potentially harmful situations.
  • error: Logs events to indicate that there is an issue that requires troubleshooting.
  • debug: Logs all the events. Use this setting when you want to debug an issue.
logging.httpTraceEnabled Set this to true to log all the HTTP request and responses in MicroTx Distributed Transactions when you want to debug. When you set this value as true, you must also set the level as debug.