Single Tenant Upgrade

When a new version is released, it is made available to clients in AWS Service Catalog. This topic explains how to perform an upgrade, and in what order the upgrade should be performed.

The TDP consists of two layers: Data and Service. You'll need to install the Data Layer first, and the Service Layer second. Keep in mind that every version must be installed incrementally and minor versions must not be skipped.

Understanding the Order Upgrades Should Be Applied

The example table below shows the order of updates to be installed. An explanation follows the table.

StepData LayerService Layer
02.22.0 (current version)2.22.0 (current version)
1Upgrade to 2.23.0 2.22.0
22.23.0Upgrade to 2.23.0
3Upgrade to 2.24.0 2.23.0
4Upgrade to 2.24.1 2.23.0
52.24.1Upgrade to 2.24.0
  • Step 0: To begin, both the data layer and service layer are both version 2.22.0.
  • Step 1: Since the Data Layer must be upgraded first, the Data Layer is upgraded to 2.23.0 using the Upgrade Steps instructions.
  • Step 2: Then, once the Data Layer has been upgraded to 2.23.0, the Service Layer can be upgraded, again using the Upgrade Steps instructions.
  • Step 3: Once the Service Layer is upgraded, the Data Layer is upgraded again, this time to 2.24.0.
  • Step 4: Note that because there is a patch, the Data Layer is upgraded again to 2.24.1.
  • Step 5: Only after the patch has been applied, is the Service Layer upgraded. Note that in this example, there was no Service Layer upgrade to 2.24.1, so the Service layer was upgraded to 2.24.0 instead.

Upgrade Steps

To upgrade, complete the following steps, starting with the data layer.

  1. In the AWS console, go to Service Catalog → Provisioned products.
  2. Click on the {product}-data-layer. Take note of 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 Service Catalog. There is no need to change the other parameters.
  6. Click Update.
  7. Wait for Status to become Available.

Once the data layer is updated to the next minor version, repeat the above steps on the service layer to install the same version.