This topic explains how to upgrade Tanzu Kubernetes Grid Integrated Edition (TKGI) from v1.12 to v1.13 on vSphere with NSX-T networking.
For instructions on upgrading TKGI with Flannel networking, see Upgrading Tanzu Kubernetes Grid Integrated Edition (Antrea and Flannel Networking).
Warning: Do not manually upgrade your Kubernetes version. TKGI includes the compatible Kubernetes version.
Before you upgrade, follow the procedures in Prepare to Upgrade below to plan and prepare your upgrade.
After you complete the preparation steps, continue to the procedures in Perform the Upgrade below. These steps guide you through the process of upgrading Ops Manager and the TKGI tile, importing a new stemcell, and applying the changes to your deployment.
After you complete the upgrade, follow the procedures in After the Upgrade below to verify that your upgraded TKGI deployment is running properly and to optionally upgrade NSX-T and vSphere.
To see a list of NSX-T v3.1 versions compatible with TKGI v1.13, consult Product Snapshot in Release Notes for TKGI v1.13.
To prepare for upgrading Tanzu Kubernetes Grid Integrated Edition from TKGI v1.12 to TKGI v1.13:
This section describes the steps required to upgrade to TKGI v1.13:
Tanzu Kubernetes Grid Integrated Edition v1.13 supports running on NSX-T v3.1. If you are using NSX-T v3.0 or later, you must upgrade to NSX-T v3.1.
To upgrade NSX-T to NSX-T v3.1:
Warning: Refer to the Release Notes for current version support, known issues, and other important information.
Note the current DRS mode setting, then change DRS mode to Manual. For more information, see Pods Stop After Upgrading From NSX-T v3.0.2 to v3.1.0 in the Tanzu Kubernetes Grid Integrated Edition Release Notes.
Confirm that your vSphere v6.5, v6.7, or v7.0 installation is on the supported version and patch for NSX-T v3.1.
Upload the NSX-T upgrade bundle using the NSX-T Manager and proceed with the upgrade process by following the instructions in the UI.
For more information, refer to the Upgrading NSX-T Data Center documentation.
If you set DRS mode to Manual above, restore DRS to its original setting.
Each version of TKGI is compatible with multiple versions of Ops Manager. See VMware Tanzu Network to determine if your Ops Manager version is compatible with TKGI v1.13.
Warning: If you use an automated pipeline to upgrade TKGI, see Configure Automated Ops Manager and Xenial Stemcell Downloading in Configuring the Upgrade Pipeline.
To upgrade Ops Manager:
Log in to Ops Manager.
Click your username in the top right corner and navigate to Settings > Export Installation Settings.
Click Export Installation Settings.
Log in to vCenter Server using the vSphere Client.
Shut down the Ops Manager VM.
Deploy the upgraded Ops Manager VM by following the first two steps of Deploying Ops Manager with NSX-T for TKGI:
Using a browser, navigate to the newly-deployed Ops Manager web interface.
On the welcome page, select Import Existing Installation.
Browse to and select the installation configuration archive you exported.
Log in to Ops Manager
Click Apply Changes.
Verify that the BOSH Director for vSphere tile shows the upgrade version.
When you upgrade TKGI, your configuration settings typically migrate to the new version automatically. To download and import a TKGI version:
Download the target version of the product from VMware Tanzu Network.
Import the target version of the TKGI tile to the Ops Manager Installation Dashboard.
Click Review Pending Changes.
Expand the Errands dropdown and activate or deactivate Upgrade all clusters errand
Warning: Deactivating the Upgrade all clusters errand causes the TKGI version tagged in your Kubernetes clusters to fall behind the TKGI tile version. If you deactivate the Upgrade all clusters errand when upgrading the TKGI tile, you must upgrade all your Kubernetes clusters before the next TKGI upgrade.
Set the Run smoke tests errand to On. The errand uses the TKGI CLI to create a Kubernetes cluster and then delete it. If the creation or deletion fails, the errand fails and the installation of the TKGI tile is aborted.
TKGI requires a Xenial stemcell. A stemcell for Windows 2019 is also required if you intend to create Windows worker-based clusters. For information about Windows stemcells, see Configuring Windows Worker-Based Clusters.
Warning: If you use an automated pipeline to upgrade TKGI, see Configure Automated Ops Manager and Xenial Stemcell Downloading in Configuring the Upgrade Pipeline.
If Ops Manager does not have the Xenial stemcell required for TKGI v1.13, the TKGI tile displays the message Missing stemcell. To download and import a new Xenial stemcell, follow the steps below:
On the TKGI tile, click the Missing stemcell link.
In the Stemcell Library, locate the TKGI tile and note the required stemcell version.
Navigate to the Stemcells (Ubuntu Xenial) page on VMware Tanzu Network and download the required stemcell version for your IaaS.
Return to the Installation Dashboard in Ops Manager and click Stemcell Library.
On the Stemcell Library page, click Import Stemcell and select the stemcell file you downloaded from VMware Tanzu Network.
Select the TKGI tile and click Apply Stemcell to Products.
Verify that Ops Manager successfully applied the stemcell. The stemcell version you imported and applied appears in the Staged column for TKGI.
Return to the Installation Dashboard.
To complete the upgrade of the TKGI tile:
Return to the Installation Dashboard in Ops Manager.
Click Review Pending Changes. For more information about this Ops Manager page, see Reviewing Pending Product Changes.
Click Apply Changes.
(Optional) If you activated the Upgrade all clusters errand, you can use the BOSH CLI to monitor its progress:
bosh -e MY-ENVIRONMENT log-in
from a VM that can access your TKGI deployment. For more information, see Using BOSH Diagnostic Commands in Tanzu Kubernetes Grid Integrated Edition.bosh -e MY-ENVIRONMENT tasks
.bosh task TASK-NUMBER
, replacing TASK-NUMBER
with the task number you located in the previous step.Verify that the TKGI tile shows the target version.
After you complete the upgrade to TKGI v1.13, complete the following verifications and upgrades:
Upgrade the TKGI and Kubernetes CLIs on any local machine where you run commands that interact with your upgraded version of TKGI.
To upgrade the CLIs, download and re-install the TKGI and Kubernetes CLI distributions that are provided with TKGI on VMware Tanzu Network.
For more information about installing the CLIs, see the following topics:
If you upgraded TKGI with the Upgrade all clusters errand deactivated, the next step is to upgrade the Kubernetes clusters individually using the TKGI CLI.
Log in to the TKGI environment using the TKGI CLI.
Run the command tkgi clusters
to list all Kubernetes clusters with their current versions and status:
TKGI Version Name k8s Version Plan Name UUID Status Action
1.12.0 tkgi-cluster-1-small 1.21.3 small 0bea03c8-af47-48e8-b249-814c0bc407b9 succeeded CREATE
1.12.0 tkgi-cluster-2-medium 1.21.3 medium 5d9f4501-70cb-460b-9d78-0afbc074cb8c succeeded CREATE
1.12.0 tkgi-cluster-3-large 1.21.3 large b448117a-bb6f-49de-bc9b-452588bd44ef succeeded CREATE
Upgrade each cluster one-by-one using the command tkgi upgrade-cluster CLUSTER-NAME
.
When the cluster upgrades are complete, run the command tkgi clusters
and verify that they list the target version:
TKGI Version Name k8s Version Plan Name UUID Status Action
1.13.0 tkgi-cluster-1-small 1.22.2 small 0bea03c8-af47-48e8-b249-814c0bc407b9 succeeded UPGRADE
1.13.0 tkgi-cluster-2-medium 1.22.2 medium 5d9f4501-70cb-460b-9d78-0afbc074cb8c succeeded UPGRADE
1.13.0 tkgi-cluster-3-large 1.22.2 large b448117a-bb6f-49de-bc9b-452588bd44ef succeeded UPGRADE
To verify successful upgrade, create a test cluster:
tkgi create-cluster tkgi-cluster-4-test --external-hostname tkgi-cluster-test --plan medium --num-nodes 3
Note: Use only lowercase characters when naming your cluster if you manage your clusters with Tanzu Mission Control (TMC). Clusters with names that include an uppercase character cannot be attached to TMC.
Run tkgi clusters
to verify that the new cluster is created with the appropriate version of TKGI and Kubernetes:
$ tkgi clusters
TKGI Version Name k8s Version Plan Name UUID Status Action
1.13.0 tkgi-cluster-4-test 1.22.2 medium 5d9f4501-70cb-460b-9d78-0afbc074cb8c succeeded CREATE
1.13.0 tkgi-cluster-1-small 1.22.2 small 0bea03c8-af47-48e8-b249-814c0bc407b9 succeeded UPGRADE
1.13.0 tkgi-cluster-2-medium 1.22.2 medium 5d9f4501-70cb-460b-9d78-0afbc074cb8c succeeded UPGRADE
1.13.0 tkgi-cluster-3-large 1.22.2 large b448117a-bb6f-49de-bc9b-452588bd44ef succeeded UPGRADE
After upgrading TKGI and its Kubernetes clusters to v1.13, you can upgrade vSphere to v7. This upgrade includes upgrading the vCenter Server Appliance and each ESXi host, in that order.
See Verifying Deployment Health for how to verify the health of your TKGI environment and gather information for troubleshooting cluster upgrades.