5.1.1 Upgrade to the Latest Free Release

MicroTx Free 24.2 provides additional features.

To upgrade to MicroTx Free 24.2 from a previous release of MicroTx Free:

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 at installation_directory/otmm-<version>/otmm/image/tmm-<version>.tgz. 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.
   • If you have installed MicroTx in a Kubernetes cluster, see Push Images to a Remote Docker Repository.
   • If you have installed MicroTx in Docker Swarm, see Push Image to a Docker Registry.
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.
   • If you have installed MicroTx in a Kubernetes cluster, see Configure the values.yaml File.
   • If you have installed MicroTx in Docker Swarm, see Configure the tcs-docker-swarm.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 application named tmm-app in the otmm namespace.

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

   Where,

   • tmm-app is the name of the MicroTx application.
   • otmm is the namespace in Kubernetes cluster, where you have installed MicroTx.
   • installation_directory/otmm-<version>/otmm/helmcharts/tmm is the folder that contains the chart.yaml file for MicroTx.
   • installation_directory/otmm-<version>/otmm/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.