When a new Tetra Data Platform (TDP) version is released, it is made available to customers in the AWS Service Catalog. This page describes how to perform an upgrade, and in what order you should perform it.

The TDP has two layers:

• Data
• Service

You must install the Data layer first, and then the Service layer.

🚧

Software Versions

You must install every version incrementally and you should not skip minor versions of the software.

How to Order and Install Upgrades

This table shows an example of how to order and install updates.

Upgrade Procedure

To upgrade the data layer:

1. In the AWS console, navigate Service Catalog -> Provisioned products.
2. Click on the {product}-data-layer and note the current version.
3. Click Action -> Update.
4. Select the next minor version available from the Product versions list.
5. (Important) Change the CFTemplateVersion parameter to reflect the same version as the one in the Service Catalog. You can leave the other parameters set to their defaults.
6. Click Update.
7. Wait for Status to change to Available.

After you have updated the data layer to the next minor version, repeat Upgrade Procedure for the service layer to install the same version.

Rollback an Upgrade

The built-in capabilities of AWS CloudFormation automatically cancels and rolls back the upgrade if there are any issues detected. However, it is theoretically possible that, after successfully upgrading to a new version, the platform does not behave as expected. If this happens and you want to go back to a previous version, do the following:

1. Contact TetraScience Customer Success and ask them to validate the rollback plan.
2. For the ServiceLayer, use the same upgrade steps, but choose the previous version, so it is actually a downgrade.
3. Wait for the Service Layer downgrade to finish.
4. Repeat the step for the Data Layer.