Using the Streamed VM Setup Wizard

The Citrix Provisioning Streamed VM Setup Wizard helps with deploying a streamed vDisk to several cloned virtual machines (VMs).

Use the wizard to:

  • Create VMs on a supported hosted hypervisor from an existing template:
    • XenServer
    • Hyper-V via SCVMM
    • ESX via V-Center
  • Create Citrix Provisioning target devices within a Collection
  • Assign a vDisk image that is in Standard Image mode to the VMs

Before running the wizard, be sure that the following prerequisites are met:

  • One or more hypervisor hosts exist with a configured template.

  • A Device Collection exists in the Citrix Provisioning Site.

  • A vDisk in Standard Image mode exists, to be associated with the selected VM template.

  • Template VM Requirements:

    • Boot order: Network/PXE first in list (as with physical machines).

    • Hard disks: If using local write cache, an NTFS formatted disk large enough for the cache must exist. Otherwise, no hard disks are required.

    • Network: Static MAC addresses. If using XenServer, address cannot be 00-00-00-00-00-00

  • The Citrix Provisioning Console user account was added to a Provisioning Site Admin group or above.

  • When creating accounts in the Console, you need permissions to create the Active Directory account. To use existing one, consider that the Active Directory account must exist in a known OU for selection.

  • If you are importing an Active Directory .CSV file, use the following format: <name>,<type>,<description>. The .CSV file must contain the column header. For example:

    Name,Type,Description,

    PVSPC01,Computer,,

    The trailing comma must be present to signify three values, even if there is no description. This method is the same formatting used by Active Directory Users and Computers MMC when exporting the contents of an organizational unit.

  • If you are running a vCenter server on alternate ports, the following registry modifications must be made to connect to it from Provisioning Services:

    • Create a new key HKLM\Software\Citrix\CitrixProvisioning\PlatformEsx

    • Create a string in the PlatformEsx key named ‘ServerConnectionString’ and set it to http://{0}:PORT\#/sdk

      Note:

      If you are using port 300, ServerConnectionString= http://{0}:300/sdk

This wizard creates VMs, associates Citrix Provisioning target devices to those VMs, and assigns a shared vDisk to them.

The wizard is run directly from a Citrix Provisioning Console.

  1. Right-click on the Site icon in the Console tree panel, then select the Streamed VM Setup Wizard…menu option. The Welcome to the Streamed VM Setup Wizard appears.

  2. Click Next to begin the setup.

  3. Select the type of hypervisor to connect to, then enter the required connection credentials.

  4. Click Next to verify the connection.

    Note:

    For convenient reuse, the most recently used hypervisor and username is cached in the registry of the local machine running this instance of the Console.

    XenServer 5.5 Update 2 hypervisors are not supported in the 5.6.1 Streamed VM Setup Wizard. System Center Virtual Machine Management (SCVMM) servers require PowerShell 2.0 to be installed.

  5. Optional. On the Hypervisor cluster screen, select the hypervisor host or cluster to host the VMs, then click Next.

  6. Select one VM template from the specified host, then click Next.

  7. On the Collection and vDisk page, select the collection in which to add VMs.

  8. Select a single shared vDisk within to assign to VMs within that collection, then click Next.

  9. Set the number of VMs to create, the number of vCPUs, and the amount of Memory used by each new virtual machine.

  10. Enable the radio button next to one of the following methods used for adding Active Directory computer accounts, then click Next:

    • Create accounts
    • Import existing accounts

    Note:

    The Active Directory administrator must delegate rights to the Citrix Provisioning Console user to allow Active Directory account creation.

    The domain and OU default to those rights of the current user.

    New computer names that are created are first validated that they do not exist as computers in Active Directory, VMs, or target devices.

  11. If the Create new accounts method is selected:

    • Click Next. The Active Directory accounts and location screen appears.
    • Select the appropriate domain from the Domain drop-down box, then select from the OUs listed for that Domain.
    • In the Account naming scheme drop-down box, select a valid naming scheme consisting of at least one hash symbol (#) that is 15 characters or less. Additionally, select a number/character fill option that dynamically replace the hash symbols in the specified naming scheme, incrementing by one for each VM as they are created.

    If Import existing accounts is selected:

    • Click Next. The Active Directory accounts and location page appears.
    • Click Browse to browse for an Active Directory Organizational Unit to import Active Directory account names, or click Import to import account names from a CSV file.

    Note:

    The Required count displays the number of virtual machines previously specified to be created. The Added count displays the number of validated entries added to appear in the list.

  12. Review all configuration settings, and then click Next to confirm and finish configurations.

    Note:

    Clicking Cancel cancels the configuration of any additional machines, and the quantity of successfully configured machines displays under the Progress bar. If the wizard fails or is canceled in the middle of an operation, any progress made is retained. If cleanup of existing progress is required, it must be done manually, which includes removing the following:

    • Citrix Provisioning target devices created in the selected Collection.
    • VMs created in any of the selected hosts hypervisors.
    • Active Directory computer accounts that were created.

Important:

When using the setup wizard to specify names associated with storage devices, do not use a comma. Names associated with storage devices are retained by Citrix Virtual Apps and Desktops and separated by commas. For example, Storage 1, Storage 2, Storage 3. If a storage name includes a comma (for instance, ‘Storage1,East’) Citrix Provisioning erroneously recognizes it as two separate storage devices.

Tip:

There is a risk that moving target devices from site to site could cause them to be deleted in the future. This risk increases if the target device was created using the Streamed VM Setup Wizard. Citrix recommends that you avoid moving target devices from site to site.

Using the Streamed VM Setup Wizard

In this article