Upgrade to vCenter 8 fails with error "This vCenter Server has extensions registered that are unsupported by the new vCenter Server. Extensions: NSX Manager (by VMware) on https://xxx/sdk/vim"

Products

• VMware vCenter Server

Issue/Introduction

This article provides the steps to remove or disable the unsupported NSX-V plugin from the vCenter in order to be able to upgrade to version 8.x

Symptoms:

• Upgrading vCenter to version 8.x fails on prechecks with the error:

  "This vCenter Server has extensions registered that are unsupported by the new vCenter Server.
  
  Extensions: NSX Manager (by VMware) on https://xxx/sdk/vim
  
  Please ensure extensions unsupported by the new vCenter Server are un-registered with existing vCenter Server before upgrade."

 

• Example:
• requirements-upgrade-runner.log contains errors similar to the excerpt below:

  requirementMismatchSpecs': [{'text': {'id': 'upgrade.vpxd.external.extension.unsupported.msg', 'translatable': 
  'This vCenter Server has extensions registered that are unsupported by the new vCenter Server.
  
  Extensions:
  %(0)s', 'args': ['NSX Manager (by VMware) on https://xxx/sdk/vimService, 
  '], 'localized': 'This vCenter Server has extensions registered that are unsupported by the new vCenter Server.
  
  Extensions:
  NSX Manager (by VMware) on https://xxx/sdk/vimService, 
  '}, 'description': {'id': 'upgrade.vpxd.external.extension.title', 'translatable': 'vCenter External Extensions', 'localized': 'vCenter External Extensions'}, 'resolution': {'id': 'upgrade.vpxd.external.extension.unsupported.resolution.msg', 'translatable': 'Please ensure extensions unsupported by the new vCenter Server are un-registered with existing vCenter Server before upgrade.
  Please refer to the vSphere documentation on extensions, and the upgrade and interoperability guides.', 'localized': 'Please ensure extensions unsupported by the new vCenter Server are un-registered with existing vCenter Server before upgrade.
  Please refer to the vSphere documentation on extensions, and the upgrade and interoperability guides.'

 

• The Extension Manager in the vCenter Managed Object Browser (MOB) lists the com.vmware.vShieldManager extension:

Environment

VMware vCenter Server 8.0

Cause

An unsupported NSX-V extension is present in the source vCenter preventing upgrade to version 8.0

Resolution

Caution: Before applying the steps below, please take a backup or an offline-snapshot (in powered-off state) of the vCenter Server Appliance . If the vCenter is part of a Linked Mode replication setup, please backup/snapshot all replicating nodes as well.


To resolve this issue, remove the unsupported com.vmware.vShieldManager extension from the available plug-in list.

Note: If you have vCenter Server in linked mode, perform this procedure on the vCenter Server that is used to install the plug-in initially, then restart the vCenter Server services on the linked vCenter Server.
 

1. Access the MOB extension manager by opening the following URL in a webbrowser (replace <VC_FQDN_OR_IP> with the correct IP address or fully-qualified domain name of the vCenter Server):

   https://<VC_FQDN_OR_IP>/mob/?moid=ExtensionManager

2. Select UnregisterExtension. A new window appears

3.  Paste the key "com.vmware.vShieldManager" of the plug-in and click on Invoke Method. This removes the plug-in and results in void:

4. Close the window
5. Refresh the Extension Manager window to verify that the plug-in is removed successfully.
6. Restart the vSphere Client service:

   # service-control --restart vsphere-ui

Additional Information

For more information, see:

Safely Remove a NSX-V Installation
SDK Managed Object Browser (568529).
Cannot remove or disable unwanted plug-ins from vCenter Server and vCenter Server Appliance (1025360)

Impact/Risks:
Caution: Before applying any changes confirm that the environment does not use NSX-V