Search the VMware Knowledge Base (KB)
View by Article ID

Entering and exiting maintenance mode for an ESXi host that has Horizon instant clones (2144808)

  • 4 Ratings
Language Editions

Details

Instant clone creation requires that parent VMs are created on all hosts in the selected cluster. The parent VMs are tied to the host they are on and cannot be migrated or powered off through the vSphere client. This prevents the host from entering maintenance mode if initiated from the vSphere client.

Note that with Horizon 7.1 and later this issue does not occur. When you put the host in maintenance mode, vSphere will remove the instant clone VMs. However, the exception is VMware Update Manager is used to update hosts, in which case, the manual steps described in this KB still applies.

Solution

You can use either of the following methods to put a host in and out of maintenance mode.

Method 1. From vSphere Client
  1. Select the host that you want to put in maintenance mode. If you are using the vSphere web client, make sure that the plug-in to edit Annotations is installed.
  2. Look up Annotations in the host's Summary tab and set InstantClone.Maintenance to 1.
  3. Wait up to 3 minutes and the parent VMs on this host will be deleted. Also, the value for InstantClone.Maintenance will change to 2.
  4. Put the host in maintenance mode. This host will no longer be used for provisioning.
  5. Perform maintenance.
  6. Take the host out of maintenance mode.
  7. Clear the InstantClone.Maintenance annotation value.
  8. As new provisioning happens, parent VMs and then instant clones will be created on this host.
Method 2. From Connection Server
  1. From the Connection Server, run IcMaint.cmd to delete the parent VMs and put the host in maintenance mode. See http://pubs.vmware.com/horizon-7-view/index.jsp#com.vmware.horizon-view.desktops.doc/GUID-6025D684-2E05-4857-9C24-18F16DDC38FD.html. The syntax is: IcMaint.cmd -vc <VC host name or IP> -uid <user ID> -password <user password> -hostName <ESXi host name> -maintenance ON
    Note: This command deletes the parent VMs from the host. The host is not automatically put into maintenance mode. To perform maintenance on the host, the vCenter server administrator must manually put the host into maintenance mode. 
  2. Wait up to 3 minutes and the parent VMs on this host will be deleted.
  3. Perform maintenance.
  4. Run IcMaint.cmd again to take the host out of maintenance mode. The syntax is: IcMaint.cmd -vc <VC host name or IP> -uid <user ID> -password <user password> -hostName <ESXi host name> -maintenance OFF
  5. As new provisioning happens, parent VMs and then instant clones will be created on this host.

Additional Information

For translated versions of this article, see:

Language Editions

ja,2145513

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 4 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)




Please enter the Captcha code before clicking Submit.
  • 4 Ratings
Actions
KB: