Proper use of esxcli/localcli vsan maintenancemode cancel

Products

• VMware vSAN

Issue/Introduction

This KB documents the proper use of esxcli/localcli vsan maintenancemode cancel

The above command should only be used when canceling an in-progress vSAN EMM operation. When using this command it doesn't update esx.conf making this not persistent, so the next time ESXi reads from the config, the decommission state will be overwritten from the last known state in esx.conf.

Environment

VMware vSAN 7.x

VMware vSAN 8.x

Resolution

NOTICE: Before putting the host into maintenance mode, make sure to verify the data health and cluster health. This may have impact on the VMs and data availability.

To properly clear the maintenance mode mismatch between ESXi and vSAN put the host into maintenance mode with noAction either via vCenter or via CLI by running esxcli system maintenanceMode set --enable true -m noAction.

Then take the host out of maintenance mode by either vCenter or via CLI by running esxcli system maintenanceMode set --enable false.

This ensures the esx.conf file gets updated accordingly.

If further guidance or assistance needed from Broadcom, please contact Broadcom Support.