In certain situations, such as for site-wide power maintenance, you might need to shut down a Horizon Cloud Node completely, perform the maintenance or other operation, and power the node on again.

About this task

Shutting down a Horizon Cloud Node is rarely necessary. For example, you can perform maintenance on a Horizon Cloud Node by putting the hosts into maintenance mode one at a time. However, if necessary, you can achieve a complete shutdown by shutting down all the requisite virtual machines (VMs).

Note:

Because a vSAN cluster is part of the Horizon Cloud Node environment, information about shutting down a vSAN cluster is applicable to shutting down Horizon Cloud Nodes. See https://kb.vmware.com/kb/2142676 in preparation for the instructions that follow.

To completely shutdown the environment, perform the following steps on each Horizon Cloud Node in your deployed environment.

Prerequisites

  • Enable access to the ESXi hosts used in your Horizon Cloud Node.

    ESXi access is required to shut down a Horizon Cloud Node. See VMware KB article 2004746 for more information about enabling ESXi access. Confirm that one of the following access methods is available.

    Type of Access

    Description

    Direct Access

    Enable the SSH service.

    Remote Access

    Use a remote-access technology, such as iLO or DRAC, to access the ESXi console.

  • If your environment has active users, inform them of the shutdown and tell them to save and log out of their desktops to avoid data loss.

  • Clear off the internal parent VMs from of all of the hosts by following the steps in Clear Internal Parent VMs off of a Horizon Cloud Node's ESXi Host. Clearing off the internal parent VMs before shutting down the system ensures that no unexpected results occur when the Horizon Cloud Node's management virtual appliance is powered off prior to putting the hosts into maintenance mode.

Procedure

  1. Check for active user sessions to desktops or applications and if sessions exist, wait for them to end.

    For example, click Assign to open the Assignments page to see the set of assignments. In turn, click each assignment to display its page, click Desktops, and check for active or disconnected sessions.

    Caution:

    Performing the shutdown while active or disconnected sessions are running causes unsaved user data to be lost.

  2. Wait for active tasks running in the Horizon Cloud Node to end.

    You can verify active tasks by connecting to the Horizon Cloud Node's vCenter Server Appliance using the vSphere Web Client. Do not proceed if vCenter Server tasks or vSAN resync processes are running.

    1. Wait for vCenter Server tasks, such as creating new desktop assignments or resizing existing assignments, to end.
    2. Wait for vSAN resync processes to end.

      In the vSphere Web Client, you can view active resync processes by selecting the cluster and then navigating to Monitor > Virtual SAN > Resyncing Components.

  3. Log into your vCenter Server Appliance using the vSphere Web Client.
  4. Use the VMs and Templates view to access the folder that contains the desktops, such as the one labeled 1001.
  5. Select all the desktop virtual machines in the folder and perform a shutdown.
  6. Verify that you have completed the prerequisite step of clearing off the internal parent VMs from every host.

    If you have not cleared off the internal parent VMs from all of the hosts, do it now.

  7. Shut down the Horizon Air Link virtual machine and the Horizon Cloud Node management appliance in the following order.
    • Horizon Air Link

    • smartnode-sm1

  8. Take note of the ESXi host on which the vCenter Server Appliance virtual machine is running and shut down any remaining virtual machines in the cluster as illustrated in the following list.
    Note:

    Your environment might not include all of the VMs listed below. For example, when a Horizon Cloud Node is built on a vSAN Ready Node, the environment does not have a VxRail Manager virtual machine.

    • vRealize Log Insight

    • VxRail Manager

    • vCenter Server Appliance

  9. Use an ESXCLI command to put each ESXi host in the cluster into maintenance mode, starting with the first host and continuing with the subsequent hosts.

    You can access the hosts using the SSH client or by using a remote access technology, such as iLO or DRAC, to access the ESXi console.

    esxcli system maintenanceMode set -e true -m noAction

  10. Shut down each host in the cluster.

    You can shut down the hosts using ESXCLI or PowerCLI commands or by connecting remotely using iLO or DRAC.

    The following is an example of an ESXCLI command that shuts down a host, where ReasonForShutdown is a placeholder you can replace with the reason for the shutdown.

    esxcli system shutdown poweroff -r "ReasonForShutdown"

What to do next

Perform the maintenance to the system or environment as required. After you perform the maintenance, power the Horizon Cloud Node on again. See Power on the Horizon Cloud Nodes.