WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud
  • Tanzu
    • Application Modernization
    • Tanzu services
    • Tanzu Community Edition
    • Tanzu Kubernetes Grid
    • vSphere with Tanzu
  • Home Lab
  • Nested Virtualization
  • Apple
You are here: Home / Automation / How to unregister Hybrid Cloud Extension (HCX) from your onPrem vCenter Server?

How to unregister Hybrid Cloud Extension (HCX) from your onPrem vCenter Server?

09.17.2018 by William Lam // 1 Comment

I recently had to redeploy my Hybrid Cloud Extension (HCX) setup on my onPrem vCenter Server as a newer version had been released since the last time I had looked at this which was some time last year. I had already deleted my HCX Manager and cleaned up the other HCX VMs but one thing that is not handled for you currently are the extension plugins that HCX uses to register with vCenter Server, which is no different than any other solution that integrates with vCenter Server.

Today, the only easy way to unregister an extension is to use the vSphere MOB, which I have blogged about in the past here. As you can see from the screenshot below, HCX has a number of plugins and because this is done by hand, its entirely possible that you may accidentally unregister the wrong extension which could severely impact your vCenter Server.


To help reduce that risk, an alternative and recommended method is to simply use the vSphere API (which is exactly what the vSphere MOB is talking to) and specifying the specific extensions to unregister. Below is a quick PowerCLI snippet which talks to the vSphere API and unregisters the 8 extensions related to HCX. After this, if you are still logged into the vSphere Client, you simply need to logout and log back in for the UI components to go away. If you are still seeing the UI plugins, you may need to restart the vSphere Client service.

$extensionManager = Get-View $global:DefaultVIServer.ExtensionData.Content.ExtensionManager

$hcxExtensions = @(
"com.vmware.hybridity"
"com.vmware.hybridity.dr"
"com.vmware.hybridity.hcsp-dashboard"
"com.vmware.hybridity.publisher"
"com.vmware.hybridity.troubleshooting"
"com.vmware.hybridity.hybrid-interconnect-ui"
"com.vmware.hybridity.auditlog-ui"
"com.vmware.vca.marketing.ngc.ui"
"com.vmware.hybridity.mobility-app"
"com.vmware.hcsp.alarm"
)

foreach ($hcxExtension in $hcxExtensions) {
    $extensionManager.UnregisterExtension($hcxExtension)
}

Once the HCX extensions have been removed, you can now download the new HCX Manager appliance from the VMC portal and redeploy.

If you are still seeing the HCX Plugin in the vSphere UI after unregistering the extension, I have found that you also needed to clear the H5 Plugins on the vCenter Server itself. Here is what I needed to do to fully clean it up. Login to the VCSA and then run the following commands:

cd /etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/
rm -rf com.vmware.hybridity*
rm com.vmware.vca.marketing.*
cd /usr/lib/vmware-vsphere-ui/server/pickup/
rm -rf com.vmware.hybridity*
rm com.vmware.vca.marketing.*

More from my site

  • Automating HCX Multi-Site Service Mesh configuration using the new HCX PowerCLI cmdlets
  • Automating HCX Add On for VMware Cloud on AWS
  • Automating complete HCX deployment and configuration to first cloud migration using PowerCLI
  • Automating Hybrid Cloud Extension (HCX) Manager initial configuration for VMC
  • Quick Tip - How to clear all Hybrid Cloud Extension (HCX) Migrations in the vSphere UI

Categories // Automation, HCX, VMware Cloud on AWS Tags // HCX, Hybrid Cloud Extension, VMware Cloud on AWS

Comments

  1. VirtualVaibhav says

    09/17/2018 at 1:35 pm

    Great article !! I ran into same issue and at the end of clean up I had to restart web client service. Not always but sometimes you might need to

    Reply

Thanks for the comment! Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Search

Author

William Lam is a Senior Staff Solution Architect working in the VMware Cloud team within the Cloud Infrastructure Business Group (CIBG) at VMware. He focuses on Cloud Native technologies, Automation, Integration and Operation for the VMware Cloud based Software Defined Datacenters (SDDC)

Connect

  • Email
  • GitHub
  • LinkedIn
  • RSS
  • Twitter
  • Vimeo

Recent

  • vSphere with Tanzu using Intel Arc GPU 01/26/2023
  • Quick Tip - Automating allowed and not allowed Datastores for use with vSphere Cluster Services (vCLS) 01/25/2023
  • ESXi with Intel Arc 750 / 770 GPU 01/24/2023
  • How to bootstrap vSAN Express Storage Architecture (ESA) on unsupported hardware? 01/19/2023
  • Automating Virtual Machine screenshots in vSphere 01/18/2023

Advertisment

Privacy & Cookies: This site uses cookies. By continuing to use this website, you agree to their use.
To find out more, including how to control cookies, see here: Cookie Policy

Copyright WilliamLam.com © 2023

 

Loading Comments...