How to run vSphere HA agent remove script in ESXi
search cancel

How to run vSphere HA agent remove script in ESXi


Article ID: 323611


Updated On:


VMware vSphere ESXi


vSphere HA agent should normally install in vSphere through unconfiguring then reconfiguring vSphere High Availability (vSphere HA) in vCenter Server at the cluster level or at the ESXi host level.

Problems with this not working can often be solved by manually uninstalling, then reinstalling, the vSphere HA agent directly on an affected ESXi host. The script may assist with cleanly removing the vSphere HA agent VIB and related configuration files.


VMware vSphere ESXi 7.0.x
VMware ESXi 6.0.x
VMware ESXi 6.5.x
VMware ESXi 6.7.x


  1. Place the ESXi host in Maintenance Mode.
  2. Disable Lockdown Mode on all hosts in the cluster.
  3. Connect to the ESXi host with SSH session per Connecting to an ESX host using an SSH client.
  4. Run this command to confirm the HA agent is installed : 
  5. esxcli software vib list | grep fdm
  6. Run these commands to run a script that will properly remove FDM agent and configuration files from the ESXi host:
    1. cp /opt/vmware/uninstallers/ /tmp
    2. cd /tmp
    3. chmod +rx
    4. ./
  7. If the script fails, the command to attempt to remove the vSphere HA VIB manually is 
  8. esxcli software vib remove -n vmware-fdm
  9. Exit maintenance mode.
  10. Check the status of HA using the webclient to confirm that HA is not working. If there are error messages at this stage, note these and refer to VMware documentation or contact VMware support for further troubleshooting.

Additional Information

FDM stands for Fault Domain Manager. This was the original name for the vSphere HA feature.

Error: "vSphere HA agent cannot be correctly installed or configured"