Citrix Virtual Apps and Desktops

Migrate legacy MMC Group Policy templates to Web Studio

Note:

Starting with version 2511, Citrix Web Studio™ (web-based) is the only management console for Citrix Virtual Apps and Desktops™. Citrix Studio (MMC-based) has been removed from the installer. This article applies only to Web Studio. For information about Citrix Studio, see the equivalent article in Citrix Virtual Apps and Desktops 7 2212 or earlier.

Legacy MMC Studio Group Policy templates are stored in the administrator’s user profile on the local computer where MMC Studio runs. Web Studio templates are stored in the site database and are accessible to all administrators from any computer. Because no direct export or import path exists between the two formats, migrate a legacy template by using a policy as an intermediary.

Before you begin

  • Make sure you have access to the MMC Studio installation where the legacy templates are stored.
  • Make sure Web Studio has access to the same Citrix Virtual Apps and Desktops™ site.
  • Note the settings in the legacy template so that you can verify them after migration.

Migrate a template

  1. In MMC Studio, navigate to the template you want to migrate.
  2. In the Actions pane, select Create Policy from Template.
  3. Follow the wizard to create a policy. For convenience, use the same name as the template.
  4. Wait up to 5 minutes for the policy to appear in Web Studio. This time is required for the site service to convert the policy data from the MMC format to the Web Studio format.
  5. Open Web Studio and select Policies in the left pane.
  6. Confirm that the policy is visible in the policies list.
  7. Select the policy, then select … More in the ribbon and click Save as Template.
  8. Follow the wizard to create the Web Studio template.

After migration, the template is stored in the site database and is accessible to all administrators who use Web Studio from any computer.

Verify the migration

  1. In Web Studio, select the Templates tab in the Policies node.
  2. Confirm that the migrated template is visible.
  3. Compare the settings with the original MMC template to confirm they match.

After you verify the migration, you can retire the original MMC template. The MMC template remains local to the computer where it was created.

Example

The following example shows how to migrate a template named Watermark Settings that contains watermark configurations shared across multiple sites.

  1. In MMC Studio, locate the Watermark Settings template. In the Actions pane, click Create Policy from Template.

    MMC template

  2. Follow the wizard to create a policy. For convenience, name the policy Watermark Settings to match the template.

    Create a policy from the template

  3. Wait up to 5 minutes, then open Web Studio. Verify that the policy Watermark Settings appears in the policies list.

    View policy in Web Studio

    Note:

    At this point, the template does not yet appear on the Templates tab. The policy is the intermediary — you use it to create the Web Studio template in the next step.

  4. Select the Watermark Settings policy, then select … More in the ribbon and click Save as Template.

    Save as template

  5. Follow the wizard to create the Web Studio template.

  6. Select the Templates tab. The Watermark Settings template is now visible and accessible to all administrators from any computer that has access to the site.

    Template appears

For more information about managing templates in Web Studio, see Manage policy templates.

Migrate legacy MMC Group Policy templates to Web Studio