This topic provides upgrade scenarios for Tanzu Kubernetes Grid Integrated Edition (TKGI) environments that are upgraded from v1.12 to v1.13 on vSphere.
Overview
When you upgrade TKGI on vSphere, you might also upgrade vSphere and, if you are using it, NSX‑T.
TKGI, NSX‑T, and vSphere upgrades depend on each other. Some combinations also require upgrading Ops Manager or TKGI-provisioned Kubernetes clusters.
For any combination of upgrades that you perform, you must follow the upgrade order described in this topic.
- If your environment is on vSphere with NSX‑T networking, see TKGI on vSphere with NSX‑T Networking below.
- If your environment is on vSphere with Antrea or Flannel networking, see TKGI on vSphere (Antrea and Flannel Networking) below.
TKGI on vSphere with NSX‑T Networking
When upgrading a TKGI environment on vSphere with NSX‑T networking, you can choose to upgrade any of the following:
- TKGI only, optionally including Kubernetes clusters
- TKGI, Kubernetes clusters, and NSX‑T
- TKGI, Kubernetes clusters, NSX‑T, and vSphere
Note: When upgrading TKGI to mitigate the Apache Log4j vulnerability you must also upgrade all TKGI clusters.
For more information, see below:
| To upgrade these components… | Use this order… | For more information, see… |
|---|---|---|
| TKGI |
|
Upgrading to TKGI v1.13 |
| TKGI and NSX‑T |
|
Upgrading to TKGI v1.13 and NSX‑T v3.1 |
| TKGI, NSX‑T, and vSphere |
|
Upgrading to TKGI v1.13, NSX‑T v3.1, and vSphere v7.0 |
Warning: Refer to the Release Notes for current version support, known issues, and other important information.
For a list of NSX‑T and vSphere versions compatible with Tanzu Kubernetes Grid Integrated Edition v1.13, see:
- Product Snapshot in Release Notes
- VMware Product Interoperability Matrices
Scenario 1: Upgrading to TKGI v1.13
In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13 and do not upgrade your NSX‑T or vSphere infrastructure.
The upgrade scenario includes the following steps:
- Upgrade Ops Manager to v2.10.21 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.13.0. To verify Ops Manager compatibility with other v1.13 versions, see VMware Tanzu Network.
- Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13.
- (Recommended) Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.13. This upgrades the NCP version of your clusters.
See the table below for version information and instructions for this upgrade scenario:
| Component | Pre-upgrade version | Post-upgrade version | Instructions |
|---|---|---|---|
| TKGI | v1.12 | v1.13 | See Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX‑T Networking). |
| Ops Manager | v2.10.16 | v2.10.21 | n/a |
Scenario 2: Upgrading to TKGI v1.13 and NSX‑T v3.1
Warning: Refer to the Release Notes for current version support, known issues, and other important information.
In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13 and NSX‑T from v3.0.0 or later, to v3.1.0 or later.
The upgrade scenario includes the following steps:
- 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.
- Upgrade NSX‑T from v3.0.0 or later to v3.1.0 or later.
- If you set DRS mode to Manual above, restore DRS to its original setting.
- Upgrade Ops Manager to v2.10.21 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.13.0. To verify Ops Manager compatibility with other v1.13 versions, see VMware Tanzu Network.
- Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13.
- Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.13. This upgrades the NCP version of your clusters.
See the table below for version information and instructions for this upgrade scenario:
| Component | Pre-upgrade version | Post-upgrade version | Instructions |
|---|---|---|---|
| TKGI | v1.12 | v1.13 | See Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX‑T Networking). |
| Ops Manager | v2.10.16 | v2.10.21 | n/a |
| NSX‑T | v3.0.0 or later | v3.1.0 or later | See Upgrade NSX‑T Data Center to v3.0 or v3.1 in Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX‑T Networking). |
| NCP | v3.1.2.1 | v3.2.0.0 | n/a |
Scenario 3: Upgrading to TKGI v1.13, NSX‑T v3.1, and vSphere v7.0
Warning: Refer to the Release Notes for current version support, known issues, and other important information.
In this upgrade scenario, you upgrade:
- Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13
- NSX‑T from v3.0.0 or later to v3.1.0 or later.
- vSphere from v6.5 or v6.7 to v7.0
The upgrade scenario includes the following steps:
- 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.
- Upgrade NSX‑T from v3.0.0 or later, to v3.1.0 or later.
- If you set DRS mode to Manual above, restore DRS to its original setting.
- Upgrade Ops Manager to v2.10.21 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.13.0. To verify Ops Manager compatibility with other v1.13 versions, see VMware Tanzu Network.
- Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13.
- Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.13. This upgrades the NCP version of your clusters.
- Upgrade vSphere from v6.5 or v6.7 to v7.0.
See the table below for version information and instructions for this upgrade scenario:
| Component | Pre-upgrade version | Post-upgrade version | Instructions |
|---|---|---|---|
| TKGI | v1.12 | v1.13 | See Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX‑T Networking). |
| Ops Manager | v2.10.16 | v2.10.21 | n/a |
| NSX‑T | v3.1.0 or later, v3.0.2 or later, or v3.0.1 or later | v3.1.0 or later | See Upgrade NSX‑T Data Center to v3.1 in Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX‑T Networking). |
| NCP | v3.1.2.1 | v3.2.0.0 | n/a |
| vSphere | v6.7 or v6.5 | v7.0 | See the vSphere documentation: |
TKGI on vSphere (Antrea and Flannel Networking)
When upgrading a Tanzu Kubernetes Grid Integrated Edition environment on vSphere with Antrea or Flannel networking, you can choose to upgrade any of the following:
- TKGI only, optionally including Kubernetes clusters
- TKGI, Kubernetes clusters, and vSphere
Note: When upgrading TKGI to mitigate the Apache Log4j vulnerability you must also upgrade all TKGI clusters.
For more information, see below:
| To upgrade these components… | Use this order… | For more information, see… |
|---|---|---|
| TKGI |
|
Upgrading to TKGI v1.13 |
| TKGI and vSphere |
|
Upgrading to TKGI v1.13 and vSphere v7.0 |
For a list of vSphere versions compatible with Tanzu Kubernetes Grid Integrated Edition v1.13, see VMware Product Interoperability Matrices.
Scenario 1: Upgrading to TKGI v1.13
In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13 and do not upgrade your vSphere infrastructure.
The upgrade scenario includes the following steps:
- Upgrade Ops Manager to v2.10.21 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.13.0. To verify Ops Manager compatibility with other v1.13 versions, see VMware Tanzu Network.
- Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13.
- (Recommended) Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.13. This upgrades the NCP version of your clusters.
See the table below for version information and instructions for this upgrade scenario:
| Component | Pre-upgrade version | Post-upgrade version | Instructions |
|---|---|---|---|
| TKGI | v1.12 | v1.13 | See Upgrading Tanzu Kubernetes Grid Integrated Edition (Antrea and Flannel Networking). |
| Ops Manager | v2.10.16 | v2.10.21 | n/a |
| vSphere | v7.0, v6.7 or v6.5 | v7.0, v6.7 or v6.5 | n/a |
Scenario 2: Upgrading to TKGI v1.13 and vSphere v7.0
In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13 and vSphere from v6.5 or v6.7 to v7.0.
The upgrade scenario includes the following steps:
- Upgrade Ops Manager to v2.10.21 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.13.0. To verify Ops Manager compatibility with other v1.13 versions, see VMware Tanzu Network.
- Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.12 to v1.13.
- Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.13. This upgrades the NCP version of your clusters.
- Upgrade vSphere from v6.5 or v6.7 to v7.0.
See the table below for version information and instructions for this upgrade scenario:
| Component | Pre-upgrade version | Post-upgrade version | Instructions |
|---|---|---|---|
| TKGI | v1.12 | v1.13 | See Upgrading Tanzu Kubernetes Grid Integrated Edition (Antrea and Flannel Networking). |
| Ops Manager | v2.10.16 | v2.10.21 | n/a |
| vSphere | v6.7 or v6.5 | v7.0 | See the vSphere documentation: |
