Product Documentation

Publish to Citrix MCS for XenServer

Jan 11, 2018

A Layered Image is a virtual machine that App Layering has 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 XenServer environment and add it to a catalog for provisioning systems. In the Connector Configuration wizard, be sure to configure a Virtual Machine Template, so that the Layered Image you publish will be in 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 modifications.

Prerequisites

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

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:

  • App Layering powers on the virtual machine - This enables the guest operating system to run and then run any layer scripts through the kmssetup.cmd functionality.  This can be used to perform important layer specific steps such as activating Microsoft Office. The steps might need to be done before the virtual machine is used to create a view desktop pool/RDS farm or recompose them. The mechanism used to run the scripts can vary, including:
    • The kmssetup.cm functionality
    • Run-once support
    • Running the script manually
    • When all of the scripts are run or other manual steps are taken and the virtual machine is in the desired state, the following takes place:
      Operating system shutdown initiated by the scripts or by the user.
      If you use the kmssetup.com functionality, there is a documented process for initiating a shutdown after all layer script and other kmssetup is complete.
  • The VM shuts down - When the virtual machine is in the desired state, the virtual machine 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 the Layered Image is published.

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