"Source vCenter Server has instance(s) of Distributed Virtual Switch at unsupported version" error while upgrading vCenter Server 6.7 ,7.0 or 8.0

Products

• VMware vCenter Server

Issue/Introduction

This article provides information on the removal of support for:

• DVS versions 5.5 and below in vSphere 6.7 
• DVS version 6.0 and below in vSphere 7.0
• DVS version 6.5 and below in vSphere 8.0

While upgrading vCenter Server to version 6.7 or 7.0 or 8.0, you see the below:

The upgrade fails with below error:

• Source vCenter Server has instance(s) of Distributed Virtual Switch at unsupported version.

• In Installation log you see entries similar to:
  • Distributed Virtual Switches with versions lower than 6.6.0 are not supported with vCenter Server 8.0. Upgrade these Distributed Switches to version 6.6.0 or later to be able proceed with the upgrade of vCenter Server. 

OR

• • Distributed Virtual Switches with versions lower than 6.5.0 are not supported with vCenter Server 7.0. Upgrade these Distributed Switches to version 6.5.0 or later to be able proceed with the upgrade of vCenter Server. 

OR

• • Distributed Virtual Switches with versions lower than 6.0.0 are not supported with vCenter Server 6.7. Upgrade these Distributed Switches to version 6.0.0 or later to be able proceed with the upgrade of vCenter Server. 

Environment

 

• VMware vCenter Server 7.0.x
• VMware vCenter Server Appliance 6.5.x
• VMware vCenter Server 6.5.x
• VMware vCenter Server 6.7.x
• VMware vCenter Server Appliance 6.7.x
• VMware vCenter Server 8.0.x

Cause

The upgrade of vCenter Server to version 6.7, 7.0, or 8.0 fails due to the presence of Distributed Virtual Switches (DVS) running on unsupported versions. VMware has deprecated support for older DVS versions in newer vCenter releases to ensure compatibility, stability, and access to enhanced networking features.

Specifically:

• vCenter 6.7 requires all DVS to be version 6.0 or higher

• vCenter 7.0 requires all DVS to be version 6.5 or higher

• vCenter 8.0 requires all DVS to be version 6.6 or higher

Resolution

To proceed with the upgrade:

• vCenter Server 6.7, all DVS(es) at version 5.5 or below have to be upgraded to version 6.0 or above
• vCenter Server 7.0, all DVS(es) at version 6.0 or below have to be upgraded to version 6.5 or above
• vCenter Server 8.0, all DVS(es) at version 6.5 or below have to be upgraded to version 6.6 or above

The list of DVS names that need to be upgraded are saved in a file vcdb_req.err, located at:

• vCenter Server Appliance: /var/log/vmware/upgrade/
• Windows vCenter Server: C:\Users\install_user\AppData\Local\Temp\vcsMigration

The contents of the file look like the example below:

ERROR: invalid-dvs-version
{DVSwitch: DSwitch, Version: 5.5.0}
{DVSwitch: DSwitch2, Version: 5.1.0}

• Where DSwitch, DSwitch2 indicate names of the DVS’es that need to be upgraded and their current versions.
• The DVS Upgrade can be done from the vCenter User Interface or through the vCenter API.
  • Upgrade a vSphere Distributed Switch to a Later Version, click on the below link for more details:
    • 8.0
    • 7.0
    • 6.7
    • 6.5