Product Documentation

To configure a VM hosted apps site

Oct 09, 2015

Use Desktop Studio to configure your VM hosted apps.

Configuring your VM hosted apps site requires:
  • Licensing the site.
  • Specifying the edition of XenApp or XenDesktop for which you have licenses.
    Note: Use the XenDesktop SDK instead of Desktop Studio to configure the license edition for your VM hosted apps site if you are using VM hosted apps as a feature of XenDesktop, you want to deliver desktops and VM-hosted applications from the site, and your XenApp edition is different from your XenDesktop edition. Using the SDK, you can specify both a XenApp edition and a XenDesktop edition.
  • Setting up the site database.
    Important: If you plan to use an external database created manually, not created using Desktop Studio, ensure your database administrator uses the following collation setting when creating the database: Latin1_General_CI_AS_KS (where Latin1_General varies depending on the country; for example Japanese_CI_AS_KS). If this collation setting is not specified during database creation, subsequent creation of the XenDesktop service schemas within the database will fail, and an error similar to "<service>: schema requires a case-insensitive database" appears (where <service> is the name of the service whose schema is being created).
  • Providing information about your virtual infrastructure.

    If you are using XenServer, Citrix recommends using HTTPS to secure communication between XenDesktop and XenServer. To use HTTPS you must replace the default SSL certificate installed with XenServer with one from a trusted certificate authority.

To perform the initial configuration of your VM hosted apps site:

  1. Start Desktop Studio if it has not started automatically after installation.
  2. Select Application deployment.
  3. Follow the prompts to complete the configuration:
    Wizard page What to do


    Enter a name for your VM hosted apps site.

    Specify license server information:

    • To configure a license server not installed on the XenDesktop Controller, specify the address as name:port, where name can be a DNS, NetBIOS, or IP address.
    • To configure a license server installed on the XenDesktop Controller, specify the license file location.

    If you configured a license server not installed on the XenDesktop Controller, specify the XenApp or XenDesktop edition for which you have licenses.

    Choose whether you want to use the default database or an existing database:

    • To use the locally installed copy of SQL Express to automatically create the site database on the controller on which you are working, select Use default database.
    • To use an existing database, select Use specified database. The server location must be a DNS, NetBIOS, or IP address, without a port number.


    Specify the type of virtual infrastructure host (Citrix XenServer, Microsoft, or VMWare) your VM hosted apps site will connect to, if any.

    If you specified a virtual infrastructure host type, specify the address, user name, and password of the host.

    If you specified XenServer as your host type, and High Availability is enabled on XenServer, you can select servers for High Availability configuration. Citrix recommends that you select all servers in the pool to allow communication between XenDesktop and XenServer if the pool master fails.

    Specify whether you want to create virtual machines manually or use XenDesktop infrastructure to create virtual machines.

    Enter a name for the connection between the VM hosted apps site and the virtual infrastructure host.


    This page appears if you are configuring the site to use XenDesktop infrastructure to create virtual machines.

    Add storage to use when creating virtual machines.

    If both local and shared storage are available on the hosting unit you must select a single type; you cannot mix them.

    For each host :

    • Enter a name
    • Specify shared or local
    • Select the storage location
    • Specify the network the virtual machines reside on
  4. To use Access Gateway, pass-through authentication, or smart card authentication with your VM hosted apps site, configure XenDesktop to trust XML services by running this Powershell SDK command:
    Set-BrokerSite -TrustRequestsSentToTheXmlServicePort $true
After you configure the site, you can add more XenDesktop Controllers. See "To add a controller" in the XenDesktop 5 product documentation in the Citrix eDocs Archive.

After the initial configuration, you can change licensing and host configuration settings by starting Desktop Studio and expanding the Desktop Studio > Configuration node.