Citrix Provisioning

Export Devices Wizard

This release of Citrix Provisioning includes a new wizard in the provisioning console. The Devices Export Wizard exports existing provisioned devices to the Citrix Virtual Apps and Desktops Delivery Controller.

Note:

Instead of importing devices from Citrix Studio, devices are exported to the Delivery Controller using the remote PowerShell SDK. The remote PowerShell SDK can now communicate with both Customer Managed Delivery Controller and Delivery Controller managed by Citrix Cloud. The Devices Export Wizard is the preferred method for adding existing devices in your Citrix Provisioning farm to a Citrix Virtual Apps and Desktops Delivery Controller. Ability to import Citrix Provisioning target devices to create catalogs in Citrix Studio is deprecated and removed.

Requirements

The following elements are required for the Export Devices Wizard on Citrix Cloud deployments:

  • Citrix Virtual Apps and Desktops Delivery Controller in Citrix Cloud. The Delivery Controller has its own database where Citrix Provisioning devices are added to the catalog.
  • Citrix Cloud Connector located on-premises. Used for setting up Citrix Cloud, this connector acts as the relay between Citrix Cloud and the on-premises resource location.
  • Citrix Provisioning console. The console uses the Citrix Virtual Apps and Desktops remote PowerShell SDK to add existing Citrix Provisioning devices to the Citrix Virtual Apps and Desktops Delivery Controller.
  • Citrix Provisioning server version 1912 or later. This server communicates with the on-premises hypervisors and database and makes SOAP calls to MAPI.

The following elements are required for the Export Devices Wizard on-premises deployments:

  • Citrix Provisioning console. The console installer removes any existing installed PowerShell snap-ins and installs the remote PowerShell SDK.
  • Citrix Provisioning server version 1912 or later. This server communicates with the on-premises hypervisors and database and makes SOAP calls to MAPI.
  • Citrix Virtual Apps and Desktops Delivery Controller for on-premises setup.

Important considerations

Consider the following when using the Export Devices Wizard:

  • The Devices Export Wizard Summary page displays the number of devices that are exported to the Citrix Virtual Apps and Desktops Delivery Controller. This page displays this information even if devices fail to export. The Summary page displays how many device records were created and how many failed. the names of the failed devices can be found in the CDF trace. To export devices that failed earlier, rerun the Devices Export Wizard. Select the same collections. Add them to the existing Citrix Virtual Apps and Desktops catalog, or create a catalog to add them.

Devices Export Wizard Summary

  • Devices can only be exported to a single Citrix Cloud customer during a single execution of the wizard. If the Citrix Cloud user has multiple cloud customers to manage, and changes occur during the execution of the wizard process, close the wizard and start it again. Use this process to change the Citrix Cloud customer.

  • When creating a machine catalog for a physical device using the Export Devices Wizard, the following exception may appear: Object reference not set to an instance of an object. To resolve this issue, use the Machine Creation Wizard in Studio to import the physical devices to the Citrix Virtual Apps and Desktops machine catalog. When you are using Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) in Citrix Cloud, the machine catalog appears in the Initial Zone. Manually correct the zone of the machine catalog in Studio. This configuration avoids the error Cannot connect to the PVS server when adding more devices. To manually move the machine catalog to correct zone:

  1. Log into Studio.

  2. In the zones node, manually drag the machine catalog to the desired zone.

Nutanix limitations

Existing provisioned Nutanix devices cannot be exported to Citrix Cloud because a Nutanix VM MAC address cannot be obtained. This limitation is similar to the behavior of the machine creation wizard in the Citrix Studio. To add a Nutanix device to the Citrix Cloud Delivery Controller, create a device using the Citrix Virtual Apps and Desktop Setup Wizard on Citrix Provisioning console.

Architecture

The following image illustrates elements comprising the Citrix Cloud architecture as part of the Devices Export Wizard functionality.

Note:

The on-premises configuration remains unchanged. The Devices Export Wizard functions with the on-premises Citrix Virtual Apps and Desktops Delivery Controller.

Devices Export Wizard Citrix Cloud Architecture

The wizard:

  • runs on the Citrix Provisioning console and adds existing provisioned devices to the Citrix Cloud Delivery Controller.
  • uses SOAP and MAPI calls to interact with the Citrix Provisioning server to retrieve information on existing provisioned devices.
  • interacts with the Citrix Virtual Apps and Desktops remote PowerShell SDK to communicate with the Customer Managed Delivery Controller and the Citrix Cloud Delivery Controller to add provisioned devices to the machine catalog.

Using the devices export wizard

Use the information in this section to install elements required for Devices Export Wizard functionality.

Important:

For on-premises deployments, the Citrix Virtual Apps and Desktops Delivery Controller is unmodified. No further installation or configuration changes are required. The Citrix Provisioning console installer, version 1912 or later, provides all the necessary components required to use the Export Devices Wizard.

For Citrix Cloud deployments:

  1. Install the Citrix Cloud Connector.
  2. Upgrade Citrix Provisioning to version 1912 or later.

For information about provisioning in Citrix Cloud, see Citrix Provisioning managed by Citrix Cloud. For more information about installations related to Citrix Cloud deployments, see Using PVS with the Citrix Cloud Apps and Desktop Service.

To launch the Devices Export Wizard:

  1. In the Citrix Provisioning console, click the Sites node.
  2. Right-click the Site you want to configure, and right-click to expose a contextual menu.
  3. In the context menu, click Export Devices Wizard.

    Launch the Export Devices Wizard

    The Export Devices Wizard screen appears.

  4. Click Next to start the wizard.

    Start the Devices Export Wizard

  5. On the Citrix Virtual Desktops Controller screen, select the type of Delivery Controller.
    1. If you select Citrix Cloud:

      Citrix Cloud DDC Export Wizard

      1. Enter your Citrix Cloud credentials. Click Sign In.

        Sign in to Citrix Cloud

      2. After signing in to Citrix Cloud, select the appropriate cloud customer if requested.

        Select the Citrix Cloud customer

    2. If you select Customer-Managed Control Plane, enter the controller hostname or address. This will authenticate using your current logged in user.

      Customer Managed Control Plane DDC Export Wizard

  6. Click the Device Type to export. Select Next. Selecting Virtual Devices creates power managed Citrix Virtual Apps and Desktops catalog. Physical devices in the Citrix Virtual Apps and Desktops catalog are unmanaged. When selecting Virtual Devices, the wizard displays the Host Resource screen which allows you to click the host or hypervisor. For physical devices, the wizard skips to the Active Directory and Collection selection screen.

    Select the Device Type

  7. Click the host resource. Select Next.

    Select the host resource

  8. When selecting the host resource, you must associate a user name and password. Select OK.

    Enter the Citrix Cloud user name and password

  9. Click the Active Directory domain and collections that you want to export. Select Next.

    Note:

    The Domain field lists all domains (trusted and untrusted) for selection.

    Select the AD domain and collections

  10. Use the list to select the VDA version. Devices are required to register with the Delivery Controller referencing the machine catalog. Select Next.

    Tip:

    All displayed devices are exported to a single Citrix Virtual Apps and Desktop catalog. You cannot select a device in this list.

    Select the VDA version

  11. Click machine catalog preferences. If you are creating a catalog, specify the name and optionally include a description. Select Next.

    Set machine catalog preferences

  12. Click the operating system. Select Next.

    Select the operating system

  13. Set the user experience for the virtual desktop. Select Next.

    Select the user experience

  14. Select Finish in the Summary screen to complete the wizard process.

    Summary screen

    Once the wizard finishes, use the Machine Catalog Screen to view the Citrix Virtual Apps and Desktops catalog. Ensure that the catalog was created with the associated machines.

    Select the user experience

Export Devices Wizard