Error deploying plug-in VMware vSAN Plugin (com.vmware.vsan.client 8.0.203.10000)

Products

• VMware vCenter Server

Issue/Introduction

• After upgrading vCenter to 8.0U3e you may see the following error "Error deploying plugin"
  
  
• In the UI there will be failed Deploy plug-in Task.
  
  
• In the vsphere_client_virgo.log log located at /var/log/vmware/vsphere-ui/logs you see the following entries:

[2025-04-27T13:04:47.215Z] [INFO ] sdk-plugin-deployer-89 com.vmware.vise.plugin.extension.PluginStatusTaskManager User: VSPHERE.LOCAL\vsphere-webclient-********-****-*********-************ initiated plugin DEPLOYMENT task for plugin com.vmware.vsan.client:8.0.203.10000.

[2025-04-27T13:04:47.215Z] [ERROR] sdk-plugin-deployer-89 com.vmware.vise.plugin.status.RemotePluginStatusServiceImpl DEPLOYMENT_FAILED: Error deploying plugin package com.vmware.vsan.client:8.0.203.10000. Reason: The validation of the plugin manifest file has failed. com.vmware.vise.plugin.schema.exceptions.PluginManifestSchemaValidationException: Plugin manifest failed schema validation: file:/etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/com.vmware.vsan.client-8.0.203.10000/plugin.json Errors:

"$: unknown found, object expected"
[2025-04-27T13:04:47.215Z] [INFO ] sdk-plugin-deployer-89 com.vmware.vise.plugin.extension.VcExtensionManager Plugin package 'com.vmware.vsan.client:8.0.203.10000' is incompatible with vCenter:

Environment

VMware vCenter Server 8.0 U3e

Cause

Corruption can occur in installer package located at /etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/

Resolution

Snapshot the vCenter before attempting, if linked mode vCenter then offline snapshots off all ELM nodes.

1. Stop vsphere ui:
   service-control --stop vsphere-ui
2. Clear the user cache:
   cd /storage/vsphere-ui/SerenityDB/serenity/
   This directory is to be completely emptied. (You can use "rm -rf *" when in the directory - WARNING: This is destructive and if run from the wrong directory can destroy the vCenter Server. Be SURE you are in the correct location prior to executing.)
3. Clean tomcat cache:
   cd /usr/lib/vmware-vsphere-ui/server/work/
   This directory is to be completely emptied also.
4. Remove with rm the old plugin package:
   cd /etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/
   bundle to remove:
   rm com.vmware.vsan.client-8.0.203.10000
5. start vSphere-ui
   service-control --start vsphere-ui