5.1 Upgrade to the Latest Free Release

Upgrade to the latest release of Transaction Manager for Microservices (MicroTx) Free.

To upgrade to the latest release of MicroTx Free from a previous release:

1. Download the files to install the latest release of MicroTx. See Download the Installation Bundle.

   Ensure that you do not overwrite the files that you had downloaded for earlier versions of MicroTx.

   The latest image of the transaction coordinator is available in the installation_directory/MicroTx-<version>/coordinator/container-images folder. In the next steps, you will use this file to update the existing transaction coordinator image.

2. Load the transaction coordinator image to the local repository, tag the image, and then push the image. See Push Images to a Remote Docker Repository.
3. Update the YAML file for the transaction coordinator with the name of the latest image in the repository. If you want to use the latest features, complete the required tasks to use these features, and then update the YAML file with the property values. See Configure the values.yaml File.
4. If you have installed MicroTx in a Kubernetes cluster, run the following command to complete the upgrade.

   Syntax

   helm upgrade <release name> --namespace <namespace> <chart directory> --values <path_to_updated_values.yaml>

   The following sample command upgrades the MicroTx Distributed Transactions application named tmm-app in the MicroTx namespace.

   helm upgrade tmm-app --namespace MicroTx tmm --values tmm/values1.yaml

   Where,

   • tmm-app is the name of the MicroTx Distributed Transactions coordinator.
   • MicroTx is the namespace in Kubernetes cluster, where you have installed MicroTx Distributed Transactions coordinator.
   • installation_directory/MicroTx-<version>/MicroTx/helmcharts/tmm is the folder that contains the chart.yaml file for MicroTx Distributed Transactions.
   • installation_directory/MicroTx-<version>/MicroTx/helmcharts/tmm/values1.yaml is the location of the application's updated manifest file in your local machine. This file contains the updated deployment configuration details for MicroTx Distributed Transactions.