To update agent-related software for a dedicated VDI desktop assignment, the first task is to update the software installed on the image used by the assignment and edit the dedicated VDI desktop assignment to use that updated image. This procedure updates the unassigned desktops in the assignment.

At a high level, the system's agent update capability works as follows:

  • The system makes regular contact with the VMware CDS (Component Download Service) software distribution network to see if a new version of the Horizon Agents Installer is available. If so, the system downloads that version to your Horizon Cloud pods.
  • After a new version is downloaded, the administrative console reflects that an update is available for the images which are eligible for the update. A visual indicator is displayed for those images that have the agent-related software at a level earlier than the new version.
  • During the agent update process:
    • The system powers on the selected image, clones a duplicate virtual machine (VM) from the powered-on image, and then runs the convert-to-image process on the selected image to return it to its original published state. During this part of the process, the image's status displayed in the console changes from Published to In Transition.
    • When the duplicate VM exists, the system powers it on, installs the agent-related software using the newer update version that was selected in the wizard, and then runs the convert-to-image process on that duplicate to publish it.
  • At the end of the agent update process, both the original image and its duplicate are listed, where the duplicate image has the updated agent software installed in it.
Important: At the end of the agent update process, the image you selected when you clicked Update Agent ends up in the same state it was in when the process started, with its original agent version level. The new duplicate image gets the agent software at the selected update level.

The agent update process results in a new assignable image that is a duplicate of the original, with the agent-related software updated to the version you specify in the wizard. The agent update workflow automatically clones the original image to make a new VM, installs the agent-related software of the specified level into that VM, and then converts that VM to make it an assignable (published) image. The system bases the name of the new image on the original image's name appended with a dash and a number. For example, if the original image's name is SalesGold, the agent update process results in an image such as SalesGold-2. At the end of the process, both images are listed together in the console.

The following screenshot illustrates the two images listed after running the agent update process on one image and selecting the most recently available update version. Because the original image is unchanged at the end of the process, the blue dot remains displayed next to it. The other image contains the agent software are the update level, and because there are no newer update versions in the system yet, that image has no blue dot next to it.

Screenshot showing both images listed at the end of the process


  1. Click Inventory and navigate to the image-related page where the image used by the assignment is listed.
    On the selected page, a blue dot appears next to the name of any image for which an update applies. If you place your pointer on a blue dot, a pop-up window displays indicating the new version of the Horizon Agents Installer available for that image.

    The screenshot below illustrates that an agent update is available for the image named la24win10N.

    Listed image with a green arrow pointing to the blue dot indicating an image has agent updates available.

    Place your pointer on that blue dot to see what updates are available.

    Screenshot of the list that appears when the pointer is on the blue dot indicator.

  2. Select the check box next to the image you want to update.
  3. Click Update Agent.
    The Agent Update wizard appears.
  4. In the Software step, select the update version you want to use from the drop-down menu and click Next.

    Step 1 of the Agent Update wizard showing the available versions of the Horizon Agents Installer

  5. (Optional) In the Command Line step, add any command-line options that might be relevant for this update on the image.
    The wizard displays a message that indicates whether command-line options are available for the specified update.
  6. Click Submit.
    • A message displays at the top of the page indicating that the update has started.
    • The system creates a clone virtual machine (VM) of the original image and then updates the agent-related components on that clone image. After the clone image is updated, the system runs the convert-to-desktop process to turn it into a published image.

    You can view the progress of the update task by selecting Monitor > Activity. If the task is not completed successfully within 24 hours, it is shown in failure status.

  7. Perform any desired tests on the updated image.
  8. Update the dedicated VDI desktop assignments that are using the original image by editing the assignments to use the new duplicate image, the image which now has the updated agent software on it. Use the Edit action on the assignment, then in the window that opens, locate the Image field, select the new duplicate image, and save.
    For more information about editing assignments, see Edit an Assignment in Your Horizon Cloud Environment.
  9. Confirm that all unassigned desktops are now linked to the updated image.
  10. When you have updated the assignments that were using the original image and can determine the original image is no longer needed by your organization, you can delete the original image from the page where it is listed. Deleting the original image is a best practice, to prevent other administrators in your organization from using an image that has down-level agents.

What to do next

Complete the agent software update for the assignment using the Update Agent action on the Assignments page. See Update Agent Software on the Assignments Page for Dedicated VDI Desktop Assignments.
Important: You must perform the agent software update on the Assignments page to complete the update for the dedicated VDI desktop assignment.