Performing maintenance on a Horizon Cloud Node usually involves putting one of its underlying ESXi hosts into maintenance mode using one of the vSphere clients, such as the vSphere Web Client or vSphere Client.

About this task

Important:

Perform maintenance on one ESXi host at a time. Avoid putting a host into maintenance mode if another host has not fully exited maintenance mode. If you need to do maintenance on more than one host in your on-premises environment, do one host at a time and complete the maintenance on one host and fully bring the host back out of maintenance mode before you initiate entering maintenance mode on the next host. If a host starts entering maintenance mode while another host has not fully exited maintenance mode, unexpected results might occur.

During ongoing system operations, the hosts have a number of running VMs, including:

  • The Horizon Air Link.

  • The management virtual appliance, which has a name in the pattern like smartnode-sm1. The specific name is unique to your system.

  • VMs related to the desktop images and assigned desktops, including internal parent VMs that are created automatically by the VMware Instant Clone technology.

The hosts are in a vSAN cluster. When you initiate the task to put a host into maintenance mode, the VMware vSphere® vMotion™ capability starts migrating the host's running VMs to another host in the cluster. The management appliance detects that host is going into maintenance mode and automatically deletes the internal parent VMs from that host. When all of the VMs are evacuated from the host, it is in maintenance mode and you can perform your required maintenance tasks on it.

After you finish your maintenance tasks on the host, you take it out of maintenance mode. As new desktop provisioning occurs, the VMware Instant Clone technology creates parent VMs and instant clone VMs on the host as usual.

This procedure's steps are performed using the vSphere Web Client.

Note:

If you prefer to clear off all of the VMware Instant Clone technology's parent VMs on the host yourself before putting the host into maintenance mode, you can optionally perform the steps described in Clear Internal Parent VMs off of a Horizon Cloud Node's ESXi Host. If that is what you choose to do, you must perform those steps prior to initiating the enter-maintenance-mode process.

Prerequisites

Ensure the Horizon Cloud Node's management appliance is running before putting one of the hosts into maintenance mode. The management appliance handles the automatic deletion of parent VMs when one of the hosts enters maintenance mode. If the management appliance is not running when you select to put a host into maintenance mode, the enter maintenance mode task will fail.

Procedure

  1. Use the vSphere Web Client to connect to your on-premises Horizon Cloud Node's vCenter Server environment.
  2. Use the VMs and Templates view to verify the management appliance is powered on and running.

    The management appliance has a name in the pattern like smartnode-sm1.

    Important:

    The management appliance must be running to ensure the parent VMs are automatically deleted successfully during this procedure.

  3. Navigate to the ESXi host that you want to put into maintenance mode.
  4. Put the host into maintenance mode by right-clicking the host and clicking Maintenance Mode > Enter Maintenance Mode.
    • The management appliance detects the host is going into maintenance mode and automatically starts deleting the internal parent VMs.

    • During the process of going into maintenance mode, the VMs residing on that host are automatically migrated from the host to other hosts in the cluster. End-user access to the desktops provided by those virtual machines remains unaffected.

  5. Perform your maintenance tasks on the host as required.
  6. Take the host out of maintenance mode by right-clicking the host and clicking Maintenance Mode > Exit Maintenance Mode.

Results

As new provisioning occurs, the system creates parent VMs and instant clone VMs on the host as usual.

What to do next

If you cleared off the parent VMs yourself using the steps in Clear Internal Parent VMs off of a Horizon Cloud Node's ESXi Host, you should examine the InstantClone.Maintenance annotation value and make sure it is cleared out. If the value is 1 or 2, clear it out.