Upgrading Tanzu Application Platform

This document describes how to upgrade Tanzu Application Platform.

You can perform fresh install of Tanzu Application Platform by following the instructions in Installing Tanzu Application Platform.

Prerequisites

Before you upgrade Tanzu Application Platform:

Verify that you meet all the prerequisites of the target Tanzu Application Platform version. If the target Tanzu Application Platform version does not support your existing Kubernetes version, VMware recommends upgrading to a supported version before proceeding with the upgrade.
For information about installing your Tanzu Application Platform, see Install your Tanzu Application Platform profile
For information about installing or updating the Tanzu CLI and plug-ins, see Install or update the Tanzu CLI and plug-ins
For information on Tanzu Application Platform GUI considerations, see Tanzu Application Platform GUI Considerations
Verify all packages are reconciled by running tanzu package installed list -A

Add new package repository

Follow these steps to update to the new package repository:

Relocate the latest version of TAP images which you want to update with the Carvel tool imgpkg by following the steps provided in document from Step 1 - Step 4.
```
tanzu package repository update tanzu-tap-repository \
    --url registry.tanzu.vmware.com/tanzu-application-platform/tap-packages:VERSION  \
    --namespace tap-install
```
Where VERSION is the target revision of Tanzu Application Platform you are migrating to. Note: Make sure to Update the export TAP_VERSION=VERSION-NUMBER which you want to update to
Add the target version of the Tanzu Application Platform package repository by running:
- If Cluster Essentials 1.2 and above installed:
```
tanzu package repository add tanzu-tap-repository \
--url ${INSTALL_REGISTRY_HOSTNAME}/TARGET-REPOSITORY/tap-packages:$TAP_VERSION \
--namespace tap-install
```
  Where VERSION is the target revision of Tanzu Application Platform you are migrating to.
- If Cluster Essentials 1.1 and 1.0 installed:
```
tanzu package repository update tanzu-tap-repository \
--url ${INSTALL_REGISTRY_HOSTNAME}/TARGET-REPOSITORY/tap-packages:$TAP_VERSION \
--namespace tap-install
```
  Where $TAP_VERSION is the target revision of Tanzu Application Platform you are updating to.For example, 1.3.0
  
  Note: If you are using Cluster Essentials 1.0 or 1.1, expect to see the installed Tanzu Application Platform packages in a temporary “Reconcile Failed” state, following a “Package not found” warning. These warnings will disappear after you upgrade the installed Tanzu Application Platform packages to version 1.2.0.

Verify you have added the new package repository by running:

tanzu package repository get tanzu-tap-repository --namespace tap-install

Perform upgrade of Tanzu Application Platform

Upgrade instructions for Profile-based installation

Important: Before performing the upgrade, ensure descriptor_name is either unset or set to full, or lite in the tap-values.yaml.

For Tanzu Application Platform that is installed by profile, you can perform the upgrade by running:

Note: Ensure you run the following command in the directory where the tap-values.yaml file resides.

tanzu package installed update tap -p tap.tanzu.vmware.com -v VERSION  --values-file tap-values.yaml -n tap-install

Where VERSION is the target revision of Tanzu Application Platform you are migrating to.

Upgrade instructions for component-specific installation

For information about upgrading Tanzu Application Platform GUI, see upgrading Tanzu Application Platform GUI.

Verify the upgrade

Verify the versions of packages after the upgrade by running:

tanzu package installed list --namespace tap-install

Your output is similar, but probably not identical, to the following example output:

- Retrieving installed packages...
  NAME                      PACKAGE-NAME                                        PACKAGE-VERSION  STATUS
  accelerator               accelerator.apps.tanzu.vmware.com                   1.0.2            Reconcile succeeded
  api-portal                api-portal.tanzu.vmware.com                         1.0.9            Reconcile succeeded
  appliveview               run.appliveview.tanzu.vmware.com                    1.0.2            Reconcile succeeded
  appliveview-conventions   build.appliveview.tanzu.vmware.com                  1.0.2            Reconcile succeeded
  buildservice              buildservice.tanzu.vmware.com                       1.4.3            Reconcile succeeded
  cartographer              cartographer.tanzu.vmware.com                       0.2.2            Reconcile succeeded
  cert-manager              cert-manager.tanzu.vmware.com                       1.5.3+tap.1      Reconcile succeeded
  cnrs                      cnrs.tanzu.vmware.com                               1.1.1            Reconcile succeeded
  contour                   contour.tanzu.vmware.com                            1.18.2+tap.1     Reconcile succeeded
  conventions-controller    controller.conventions.apps.tanzu.vmware.com        0.5.1            Reconcile succeeded
  developer-conventions     developer-conventions.tanzu.vmware.com              0.5.0            Reconcile succeeded
  fluxcd-source-controller  fluxcd.source.controller.tanzu.vmware.com           0.16.3           Reconcile succeeded
  grype                     grype.scanning.apps.tanzu.vmware.com                1.0.1            Reconcile succeeded
  image-policy-webhook      image-policy-webhook.signing.apps.tanzu.vmware.com  1.0.2            Reconcile succeeded
  learningcenter            learningcenter.tanzu.vmware.com                     0.1.1            Reconcile succeeded
  learningcenter-workshops  workshops.learningcenter.tanzu.vmware.com           0.1.1            Reconcile succeeded
  metadata-store            metadata-store.apps.tanzu.vmware.com                1.0.2            Reconcile succeeded
  ootb-delivery-basic       ootb-delivery-basic.tanzu.vmware.com                0.6.1            Reconcile succeeded
  ootb-supply-chain-basic   ootb-supply-chain-basic.tanzu.vmware.com            0.6.1            Reconcile succeeded
  ootb-templates            ootb-templates.tanzu.vmware.com                     0.6.1            Reconcile succeeded
  scanning                  scanning.apps.tanzu.vmware.com                      1.0.1            Reconcile succeeded
  service-bindings          service-bindings.labs.vmware.com                    0.6.1            Reconcile succeeded
  services-toolkit          services-toolkit.tanzu.vmware.com                   0.5.1            Reconcile succeeded
  source-controller         controller.source.apps.tanzu.vmware.com             0.2.1            Reconcile succeeded
  spring-boot-conventions   spring-boot-conventions.tanzu.vmware.com            0.3.0            Reconcile succeeded
  tap                       tap.tanzu.vmware.com                                1.0.2            Reconcile succeeded
  tap-gui                   tap-gui.tanzu.vmware.com                            1.0.2            Reconcile succeeded
  tap-telemetry             tap-telemetry.tanzu.vmware.com                      0.1.4            Reconcile succeeded
  tekton-pipelines          tekton.tanzu.vmware.com                             0.30.1           Reconcile succeeded