VMware ESXi and vSphere Cluster Management

VMware ESXi Maintenance Mode Explained

Learn what VMware ESXi maintenance mode does, how to evacuate virtual machines, use it in clusters, compare it with standby mode, and complete a safe maintenance workflow.

What Is ESXi Maintenance Mode?

Maintenance mode is an ESXi host state that removes a host from normal virtual machine workload placement so administrators can safely perform host maintenance. An ESXi host is a physical server running the VMware ESXi hypervisor, while a virtual machine (VM) is a software-defined computer running on that host.

Administrators commonly use maintenance mode before certain software installations, patches, updates, upgrades, hardware work, repairs, and reboots. The host remains managed and available for administrative tasks, but it is no longer intended to run normal production workloads.

What Must Happen to Virtual Machines First?

Before an ESXi host can successfully enter maintenance mode, its running VMs must be evacuated. Evacuation means moving the VMs to another compatible host or powering them off according to an approved maintenance plan.

In a cluster, vMotion can migrate a running VM between compatible hosts with minimal interruption. Distributed Resource Scheduler (DRS) can recommend or automate placement and migration when the cluster is configured to do so. The exact result depends on the DRS automation level, VM rules, available capacity, and migration compatibility.

VM Evacuation Options

OptionRequirementsDowntime impactBest suited for
Live migration with vMotionCompatible source and destination hosts, working vMotion networking, accessible storage and networks, and no blocking VM restrictionsUsually minimal interruptionProduction VMs that must remain available
Power off the VMAn approved outage window and a recovery planService interruption until the VM is restartedEnvironments without vMotion or VMs that cannot be migrated
DRS-assisted evacuationA configured cluster with suitable DRS automation and enough destination capacityUsually minimal interruption when vMotion succeedsClusters where placement should be automated

Evacuation can fail when destination hosts lack CPU or memory capacity, vMotion is unavailable, storage is inaccessible, networks do not match, CPU compatibility prevents migration, attached devices restrict migration, or host affinity rules prevent placement. An anti-affinity rule can also influence where a VM may be placed, even when it does not directly require a particular host.

Host Behavior During Maintenance Mode

While an ESXi host is in maintenance mode:

  • New virtual machines cannot be deployed to the host.
  • Virtual machines cannot be powered on at that host.
  • Workload placement tools should not return normal production VMs to the host.
  • Administrators can still manage the host and perform maintenance tasks through vSphere and other approved administrative methods.

These restrictions separate administrative access from workload service. The host may be visible, connected, and manageable, but it is intentionally excluded from normal production VM use until maintenance is complete.

Entering Maintenance Mode in the vSphere Client

  1. Open the vSphere inventory and select the target ESXi host.
  2. Open the host context menu or host actions menu.
  3. Choose Enter Maintenance Mode.
  4. When prompted, select the appropriate VM evacuation option, such as migrating VMs or powering them off according to the available workflow.
  5. Monitor the evacuation tasks and related events.
  6. Confirm that all required VMs have left the host and that the task reports successful completion before starting disruptive work.

The interface may display migration recommendations, warnings, or blockers. Do not assume that selecting the action alone completes the operation. Check task progress, VM power states, host membership, and recent events.

What to Check Before Starting

CheckWhy it mattersHow to validateRisk if not addressed
Backups and rollback planProvides recovery if an update or hardware operation failsConfirm recent usable backups, configuration records, and rollback stepsLonger outage or possible data loss
Active workloadsRunning VMs must be migrated or powered offReview the host's VM list and power statesMaintenance mode cannot complete
Cluster capacityRemaining hosts must support evacuated CPU, memory, and reservationsReview utilization, reservations, admission control expectations, and unavailable hostsMigration failure or reduced redundancy
vMotion connectivityLive migration depends on working compatible network pathsReview vMotion configuration, host compatibility, and relevant network statusVMs may require shutdown
Storage availabilityDestination hosts need access to required VM storage unless another supported migration method is plannedVerify datastores and paths on destination hostsMigration cannot complete or VM access may be interrupted
Maintenance scopeDefines expected duration, reboot requirements, and affected servicesReview the change plan, vendor guidance, and rollback criteriaUnexpected service impact
Placement rulesAffinity and anti-affinity rules may restrict evacuationReview VM-host rules and DRS recommendationsSpecific VMs remain blocked

Maintenance Mode in a vSphere Cluster

A cluster is a group of ESXi hosts managed together for resource sharing, workload placement, and availability features. Putting one host into maintenance mode normally affects that host, not the entire cluster. Other hosts can continue running workloads if they have enough resources and remain healthy.

Capacity planning is essential. The remaining hosts must accommodate evacuated VMs while preserving the required redundancy and high-availability margin. A cluster that can run normally may not have enough spare capacity to evacuate a host during a period of high utilization or when another host is unavailable.

DRS may select destinations and perform migrations based on its automation level. VM-host affinity rules can require or prefer a VM to run on certain hosts. Anti-affinity rules can keep selected VMs apart. These policies may reduce the number of valid destinations, so review them before maintenance.

Maintenance scheduling should also account for vSphere High Availability expectations, admission control, failure domains, and any requirement to keep multiple copies or tiers of service running. Avoid beginning parallel host maintenance unless the cluster has been designed and approved to tolerate it.

Exiting Maintenance Mode

After maintenance, return the host to workload service by selecting the host and choosing Exit Maintenance Mode from the host actions or context menu.

  1. Confirm the planned update, repair, or upgrade completed successfully.
  2. Validate host health, including hardware status, alarms, boot state, and management connectivity.
  3. Check networking, including management, VM, storage, and vMotion connectivity as applicable.
  4. Confirm required datastores and storage paths are accessible.
  5. Review update status and confirm that any required reboot or remediation step is complete.
  6. Exit maintenance mode.
  7. Verify that workload placement can resume and that DRS or other placement mechanisms behave as expected.
  8. Monitor newly placed or returned workloads and confirm application health.

Exiting maintenance mode makes the host available for workload placement again; it does not by itself guarantee that every VM will immediately return. Placement depends on DRS settings, resource demand, rules, and the chosen operational plan.

Maintenance Mode Versus Standby Mode

Standby mode is a distinct host power state in which an ESXi host is powered down or placed into a low-power condition. Distributed Power Management (DPM) can use standby mode when cluster capacity is temporarily greater than demand and power policies allow a host to be removed from active service.

StatePrimary purposeHost power conditionVM placement behaviorTypical use caseRelevant vSphere feature
Normal operationRun and manage workloadsPowered on and activeCan host and receive VMsRoutine production serviceDRS and other cluster services
Maintenance modeSafely perform host servicingNormally powered on and administratively availableNew placement and power-on are blocked; VMs are evacuatedPatching, upgrades, repair, or hardware workvSphere host maintenance workflow
Standby modeReduce power consumption when capacity is unnecessaryPowered down or in a low-power stateVMs must be relocated before the host enters standbyTemporary capacity reductionDPM

Maintenance mode is for safely performing host work. Standby mode is for power optimization. Standby mode is not a substitute for planning VM evacuation before maintenance. If a host must be patched, repaired, or upgraded, use the maintenance workflow and follow the applicable product procedure.

Practical Example: Patching One Host in a DRS-Enabled Cluster

  1. Confirm that the other cluster hosts have enough CPU and memory capacity for the selected host's workloads.
  2. Review DRS automation, vMotion network availability, storage access, VM-host rules, and high-availability requirements.
  3. Select the ESXi host in the vSphere inventory and choose Enter Maintenance Mode.
  4. Allow DRS or vMotion to relocate running VMs.
  5. Monitor tasks and verify that no active workload VMs remain on the host.
  6. Apply the patch and reboot if required.
  7. Validate host health, networking, storage, and update status.
  8. Choose Exit Maintenance Mode and monitor workload placement.

The learning point is that maintenance mode removes the host from workload use while leaving it available for controlled servicing.

Practical Example: No Live Migration Capability

  1. Identify every VM running on the host.
  2. Schedule downtime and gracefully shut down those VMs.
  3. Confirm that the VMs are powered off and no unresolved workload remains.
  4. Enter maintenance mode.
  5. Perform the required maintenance.
  6. Validate the host and exit maintenance mode.
  7. Restart workloads according to the recovery plan and verify application health.

Maintenance mode cannot replace evacuation planning. When vMotion is unavailable, powered-off VMs and an approved outage window may be required.

Operational Workflow

  1. Plan: Define the maintenance scope, duration, risks, rollback method, and service impact.
  2. Protect: Confirm backups or other recovery options and record the current configuration.
  3. Assess: Review active VMs, cluster capacity, storage, networks, DRS, affinity rules, and high-availability requirements.
  4. Evacuate: Migrate compatible VMs or power them off in a controlled manner.
  5. Confirm: Verify that no VMs remain running on the target host.
  6. Service: Perform the patch, installation, upgrade, repair, or reboot.
  7. Validate: Check host health, management connectivity, networking, storage, update status, and relevant alarms.
  8. Return: Exit maintenance mode and monitor workload placement and application health.

Troubleshooting Maintenance Mode Problems

The Host Does Not Enter Maintenance Mode

The usual reason is that one or more VMs remain powered on and cannot be evacuated. Identify the blocking VMs, then check for a valid destination, sufficient CPU and memory capacity, vMotion configuration, storage and network access, CPU compatibility, attached devices, and placement rules. Resolve the migration issue or use a controlled shutdown during an approved window, then retry.

A VM Cannot Migrate

Review vMotion networking and migration compatibility. Confirm that the destination host can access the VM's required storage and networks. Check CPU compatibility, attached devices, VM configuration restrictions, and host-affinity rules. Correct the underlying issue where possible; otherwise, power off the VM only when the maintenance plan permits it.

There Is Not Enough Capacity

Remaining hosts may already be heavily utilized, resource reservations or cluster policies may limit placement, or multiple hosts may be unavailable. Free or add capacity, postpone parallel maintenance, migrate selected workloads elsewhere, or schedule approved VM shutdowns.

Standby Mode Is Being Confused with Maintenance Mode

Standby mode is a power-management state, often associated with DPM. Maintenance mode is a servicing state. Use maintenance mode for patching, repair, upgrades, and hardware work; use standby only when power-management policies determine that host capacity is temporarily unnecessary.

Exam-Relevant Notes

  • Maintenance mode removes an ESXi host from normal VM workload placement.
  • Running VMs must be migrated or powered off before evacuation can complete.
  • vMotion requires compatible hosts and working migration prerequisites.
  • DRS can assist with placement and migration in a configured cluster.
  • A host in maintenance mode remains administratively manageable but cannot receive normal VM deployments or power-ons.
  • Maintenance mode and standby mode have different purposes: servicing versus power optimization.
  • Cluster capacity, affinity rules, storage access, and high-availability requirements affect whether evacuation succeeds.

For related study, see Maintenance Mode Explained.