To update the agent-related software that is installed on the images that are used by floating VDI desktop assignments, you first use the Update Agent action on the image. Then you edit the floating VDI desktop assignments to use those updated images.
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 automatically 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 prior to 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.
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 screenshot below 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.
- 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 hover over a blue dot, a popup 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.
Hover your cursor over that blue dot to see what updates are available.
- Select the check box next to the image you want to update.
- Click Update Agent.
The Agent Update wizard appears.
- In the Software step, select the update version you want to use from the drop-down list and click Next.
- (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.
- 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.
What to do next
- Update the floating 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.
- If you have any dedicated VDI desktop assignments that are using the original image and you want to move them to the same agent level, update the agent on those assignments following the steps in Update Agent Software for Dedicated VDI Desktop Assignments.
Important: Even though you can edit a dedicated VDI desktop assignment to use the new duplicate image, only unassigned desktop VMs will be updated in that method. If you want to update agents on all desktop VMs in a dedicated VDI desktop assignment, use the steps in Update Agent Software for Dedicated VDI Desktop Assignments.
- 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. Deleting the original image is a best practice, to prevent other administrators in your organization from using an image that has down-level agents.