First-Gen Tenants - IMS and Horizon 8 Pods - Import an Image from vCenter into the Image Catalog

Use the following procedure to import an image from vCenter into the IMS image catalog and prepare it for publication to your first-generation Horizon Cloud tenant's Horizon pods.

Note: In all of these first-generation documentation pages, the term Horizon 8 pod includes pods running a software version that is compatible with the first-generation Horizon Cloud control plane.

When you import an image for the first time, the image is added to the catalog as version 1.0 of a new image.

When the image is imported into the catalog, the image is now considered managed by IMS. The image is a managed image.

Prerequisites

• Set up the participating vCenter Server instances. See First-Gen Horizon Cloud, IMS, and Horizon 8 Pods - Configuring the vCenter Server Instances.

• Verify that VMware Tools is installed on the image's operating system. The import operation fails if VMware Tools is not installed on the operating system.

• For best results, verify that the latest Windows update patches are installed on the image's operating system. These updates facilitate any silent installations of Horizon Agent on the image in the future.

• Follow the standard and traditional Horizon guidance for preparing the image's guest Windows operating system for use in desktop pools. For example, to use a Windows Server operating system type as a single-session virtual desktop, the Horizon documentation states you must perform certain steps before the Horizon Agent is installed in the VM. For the standard Horizon guidance, refer to the information within the Desktops and Applications guide that corresponds to your Horizon 8 deployment version. That guide is located within the Horizon 8 documentation page.

• Decide on at least one marker name to add to the Marker field.

Attention: For the imported image to be usable later when you create a pool, VDI desktop assignment, or farm, it must have at least one named marker on it. Currently the console only supports adding the marker in this import UI and not later on.

Procedure

1. In the left pane of the first-gen Horizon Universal Console, select Inventory > Images - Multi-Pod.

2. On the Multi-Pod Images page, take one of the following actions.

   The action labels you see in the console will vary depending on the deployment types in your first-gen tenant's pod fleet — solely Horizon deployments that run Connection Server, solely first-gen Horizon Cloud on Microsoft Azure deployments, or both types in the fleet. Follow the on-screen guidance and prompts.

   • Click New > Import from vCenter.
   • Click New.

   The Import Images wizard appears.

3. On the Definition page of the wizard, specify the filtering parameters for the type of image that you want to import into the catalog. To import a VM template or VM snapshot that is in use by a desktop assignment, enable the In Use By Pool toggle. Then specify search filters as described in the section Filtering Parameters for VM Templates and VM Snapshots.

   The Images list displays all the available images that match the filtering parameters you specified.

4. Select an image and click Next.

   Note: If you select an image that has the Horizon Agent already installed, then later in the Publish an Image Version workflow, its wizard includes an option to skip the agent installation. See Horizon 8 Pods - Publish an Image Version.

5. On the Details page of the wizard, enter configuration options for the image.

   Option	Description
   Name	Enter a name for the image. Horizon Image Management Service uses this name when displaying the image in the image catalog.
   Username	Enter the correct user name of the built-in Windows super-administrator account for this image. If you enter the incorrect user name, the publishing operation fails. Note: Horizon Image Management Service requires the privileges of the full, built-in Windows administrator to create a directory and install Horizon Agent on the VMs cloned from this image.
   Password	Enter the correct password of the built-in Windows super-administrator account for this image. If you enter the incorrect password, the publishing operation fails.
   Description	(Optional) Enter a description for the image.
   Marker(s)	Define one or more reference markers that you want to associate with the image. The markers are associated with version 1.0 of the image. Attention: For this imported image to be usable later when you create a pool, VDI desktop assignment, or farm, it must have at least one named marker on it. Currently the console only supports adding the marker in this import UI and not at a later point. Due to a console quirk, when using this field, after typing your desired marker name, you must ensure you press Enter on your keyboard and explicitly get the name entered into the field. If you do not see your typed name appear in the Marker(s)field, it is inadequately entered and will fail to be configured on the image.

6. Click Next.

7. On the Summary page of the wizard, review the information for the image and then click Finish.

   Horizon Image Management Service starts to import the image into the catalog and creates a new image in the list.

   On the Multi-Pod Images page, while the activity is going on, the Status column indicates the activity using an in-progress () icon.

8. To monitor the import progress, you can click the name of the displayed image.

   When you click the image's name, its details page appears. A Status column on this page also indicates the current activity status.

Results

During the import process, Horizon Image Management Service creates a copy of the image in the content library of the source pod. It also registers the image with the service by storing the image's metadata in the image catalog. When the import is complete, the status of image version 1.0 changes to indicate the activity is complete.

What to do next

Publish the first image version based on the imported image. Publishing the image version replicates the image to selected pods. See Horizon 8 Pods - Publish an Image Version.

First-Gen Horizon Universal Console - Filtering Parameters for VM Templates and VM Snapshots

This topic describes the filtering parameters that you can use in the first-gen Horizon Universal Console to find and select VM templates and VM snapshots when importing images into the image catalog. Such templates and snapshots are the ones located in vCenter infrastructure for use with your first-gen Horizon Cloud tenant's Horizon 8 pods.