Product Documentation

Publish to Citrix MCS for vSphere

Jan 11, 2018

A Layered Image is a virtual machine that the App Layering software composited from the Layers and settings specified in an Image Template. You can publish one or more Layered Images to Citrix Machine Creation Services in your vSphere environment and add it to a catalog for provisioning systems. In the Connector Configuration wizard, ensure that you configure a Virtual Machine Template, so that the Layered Image you publish is a ready-to-use virtual machine, the image shut down and a snapshot taken. You can use the virtual machine in your Horizon environment without further modification.

Prerequisites

To publish a Layered Image to Machine Creation Services, you need one or more Image Templates.

To publish a Layered Image

In the Images module, select one or more Image Templates that you want to publish.

On the Action menu, select Publish Layered Image.

On the Confirm and Complete page, select Publish Layered Images. For each Image Template, this starts a task called Publishing Layered Image. When each task completes, the task description provides the information you need to navigate to the image in your environment.

At the end of the image creation process:

  • The App Layering software powers on the virtual machine - Enables the guest OS to run and any layer scripts to run through our kmssetup.cmd functionality.
    You can use scripts to perform important Layer-specific steps. For example, you can activate Microsoft Office, which may need to be done before the virtual machine is used to create or a view desktop pool/RDS farm or recompose them..
    The mechanism used to run these scripts can vary, including our own kmssetup.cmd functionality, run-once support, or even running the scripts manually. After all of the scripts run or other manual steps are taken and the virtual machine is in the desired state, a guest OS shutdown is initiated either by the scripts or the user. If you use the kmssetup.cmd functionality, there is a documented process for initiating a shutdown after all layer scripts and other kmssetup functionality is complete.
  • The virtual machine shuts down - When the virtual machine is in the desired state, it shuts down and the status changes to Done.

When the task completes, the task description provides the information you need to navigate to the image in your environment.

Use the information in the expanded Packaging Disk Task to navigate to the location in your environment where you published the Layered Image.

Next you can move the image to a collection or other location for provisioning servers.