Upgrade Order for Tanzu Kubernetes Grid Integrated Edition Environments on vSphere

Note: As of v1.8, Enterprise PKS has been renamed to VMware Tanzu Kubernetes Grid Integrated Edition. Some screenshots in this documentation do not yet reflect the change.

Page last updated:

This topic provides upgrade scenarios for Tanzu Kubernetes Grid Integrated Edition (TKGI) environments that are upgraded from v1.7 to v1.8 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.

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

For more information, see below:

To upgrade these components… Use this order… For more information, see…
TKGI
  1. Upgrade Ops Manager if necessary.
  2. Upgrade TKGI.
  3. (Recommended) Upgrade Kubernetes clusters.
Upgrading to TKGI v1.8
TKGI and NSX-T
  1. Upgrade Ops Manager if necessary.
  2. Upgrade TKGI.
  3. Upgrade Kubernetes clusters.
  4. Upgrade NSX-T.
Upgrading to TKGI v1.8 and NSX-T v3.0
TKGI, NSX-T, and vSphere
  1. Upgrade Ops Manager if necessary.
  2. Upgrade TKGI.
  3. Upgrade Kubernetes clusters.
  4. Upgrade NSX-T.
  5. Upgrade vSphere.
Upgrading to TKGI v1.8, NSX-T v3.0, and vSphere v7.0

Warning: TKGI supports NSX-T v3.0.1.1 (v3.0.1 EP1) and later patch versions of NSX-T v3.0. It does not support NSX-T v3.0.0, or v3.0.1 without Express Patch EP1.

For a list of NSX-T and vSphere versions compatible with Tanzu Kubernetes Grid Integrated Edition v1.8, see:

Scenario 1: Upgrading to TKGI v1.8

In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8 and do not upgrade your NSX-T or vSphere infrastructure.

The upgrade scenario includes the following steps:

  1. Upgrade Ops Manager to v2.9.3 or later, v2.8.2 or later, or v2.7.15 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.8.0. To verify Ops Manager compatibility with other v1.8 versions, see VMware Tanzu Network.
  2. Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8.
  3. (Recommended) Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.8. This upgrades the NCP version of your clusters to 3.0.1.

See the table below for version information and instructions for this upgrade scenario:

Component Pre-upgrade version Post-upgrade version Instructions
TKGI 1.7 1.8 See Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX-T Networking).
Ops Manager 2.7, 2.8, or 2.9 2.7, 2.8, or 2.9 n/a
NSX-T* 2.5.0 or 2.5.1 2.5.0 or 2.5.1 n/a
NCP 2.5.1 3.0.1 n/a
vSphere 6.5 or 6.7 6.5 or 6.7 n/a

* This scenario assumes that your Enterprise PKS v1.7 environment is running with NSX-T v2.5. Tanzu Kubernetes Grid Integrated Edition v1.8 does not support NSX-T v2.4. See Upgrade NSX-T Data Center v2.4.3 to v2.5 in the Enterprise PKS v1.7 documentation.

Scenario 2: Upgrading to TKGI v1.8 and NSX-T v3.0

Warning: TKGI supports NSX-T v3.0.1.1 (v3.0.1 EP1) and later patch versions of NSX-T v3.0. It does not support NSX-T v3.0.0, or v3.0.1 without Express Patch EP1.

In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8 and NSX-T from v2.5.0 or v2.5.1 to v3.0.

The upgrade scenario includes the following steps:

  1. Upgrade Ops Manager to v2.9.3 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.8.0. To verify Ops Manager compatibility with other v1.8 versions, see VMware Tanzu Network.
  2. Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8.
  3. Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.8. This upgrades the NCP version of your clusters to 3.0.1.
  4. Upgrade NSX-T from v2.5.0 or v2.5.1 to v3.0.

See the table below for version information and instructions for this upgrade scenario:

Component Pre-upgrade version Post-upgrade version Instructions
TKGI 1.7 1.8 See Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX-T Networking).
Ops Manager 2.7, 2.8, or 2.9 2.9 n/a
NSX-T* 2.5.0 or 2.5.1 3.0 See Upgrade NSX-T Data Center v2.5 to v3.0 in Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX-T Networking).
NCP 2.5.1 3.0.1 n/a
vSphere 6.5 or 6.7 6.5 or 6.7 n/a

* This scenario assumes that your Enterprise PKS v1.7 environment is running with NSX-T v2.5. Tanzu Kubernetes Grid Integrated Edition v1.8 does not support NSX-T v2.4. See Upgrade NSX-T Data Center v2.4.3 to v2.5 in the Enterprise PKS v1.7 documentation.

Scenario 3: Upgrading to TKGI v1.8, NSX-T v3.0, and vSphere v7.0

Warning: TKGI supports NSX-T v3.0.1.1 (v3.0.1 EP1) and later patch versions of NSX-T v3.0. It does not support NSX-T v3.0.0, or v3.0.1 without Express Patch EP1.

In this upgrade scenario, you upgrade:

  • Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8
  • NSX-T from v2.5.0 or v2.5.1 to v3.0
  • vSphere from v6.5 or v6.7 to v7.0

The upgrade scenario includes the following steps:

  1. Upgrade Ops Manager to v2.9.3 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.8.0. To verify Ops Manager compatibility with other v1.8 versions, see VMware Tanzu Network.
  2. Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8.
  3. Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.8. This upgrades the NCP version of your clusters to 3.0.1.
  4. Upgrade NSX-T from v2.5.0 or v2.5.1 to v3.0.
  5. 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 1.7 1.8 See Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX-T Networking).
Ops Manager 2.7, 2.8, or 2.9 2.9 n/a
NSX-T* 2.5.0 or 2.5.1 3.0 See Upgrade NSX-T Data Center v2.5 to v3.0 in Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX-T Networking).
NCP 2.5.1 3.0.1 n/a
vSphere 6.5 or 6.7 7.0

See the vSphere documentation:

  1. Upgrading the vCenter Server Appliance
  2. Upgrading ESXi Hosts
Also, see Overview of the vSphere Upgrade Process.

* This scenario assumes that your Enterprise PKS v1.7 environment is running with NSX-T v2.5. Tanzu Kubernetes Grid Integrated Edition v1.8 does not support NSX-T v2.4. See Upgrade NSX-T Data Center v2.4.3 to v2.5 in the Enterprise PKS v1.7 documentation.

TKGI on vSphere with Flannel Networking

When upgrading a Tanzu Kubernetes Grid Integrated Edition environment on vSphere with Flannel networking, you can choose to upgrade any of the following:

  • TKGI only, optionally including Kubernetes clusters
  • TKGI, Kubernetes clusters, and vSphere

For more information, see below:

To upgrade these components… Use this order… For more information, see…
TKGI
  1. Upgrade Ops Manager if necessary.
  2. Upgrade TKGI.
  3. (Recommended) Upgrade Kubernetes clusters.
Upgrading to TKGI v1.8
TKGI and vSphere
  1. Upgrade Ops Manager if necessary.
  2. Upgrade TKGI.
  3. Upgrade Kubernetes clusters.
  4. Upgrade vSphere.
Upgrading to TKGI v1.8 and vSphere v7.0

For a list of vSphere versions compatible with Tanzu Kubernetes Grid Integrated Edition v1.8, see VMware Product Interoperability Matrices.

Scenario 1: Upgrading to TKGI v1.8

In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8 and do not upgrade your vSphere infrastructure.

The upgrade scenario includes the following steps:

  1. Upgrade Ops Manager to v2.9.3 or later, v2.8.2 or later, or v2.7.15 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.8.0. To verify Ops Manager compatibility with other v1.8 versions, see VMware Tanzu Network.
  2. Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8.
  3. (Recommended) Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.8.

See the table below for version information and instructions for this upgrade scenario:

Component Pre-upgrade version Post-upgrade version Instructions
TKGI 1.7 1.8 See Upgrading Tanzu Kubernetes Grid Integrated Edition (Flannel Networking).
Ops Manager 2.7, 2.8, or 2.9 2.7, 2.8, or 2.9 n/a
vSphere 6.5 or 6.7 6.5 or 6.7 n/a

Scenario 2: Upgrading to TKGI v1.8 and vSphere v7.0

In this upgrade scenario, you upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8 and vSphere from v6.5 or v6.7 to v7.0.

The upgrade scenario includes the following steps:

  1. Upgrade Ops Manager to v2.9.3 or later. These are the recommended Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition v1.8.0. To verify Ops Manager compatibility with other v1.8 versions, see VMware Tanzu Network.
  2. Upgrade Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8.
  3. Upgrade all Kubernetes clusters to Tanzu Kubernetes Grid Integrated Edition v1.8.
  4. 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 1.7 1.8 See Upgrading Tanzu Kubernetes Grid Integrated Edition (Flannel Networking).
Ops Manager 2.7, 2.8, or 2.9 2.9 n/a
vSphere 6.5 or 6.7 7.0

See the vSphere documentation:

  1. Upgrading the vCenter Server Appliance
  2. Upgrading ESXi Hosts
Also, see Overview of the vSphere Upgrade Process.

Please send any feedback you have to pks-feedback@pivotal.io.