Create Citrix Provisioning catalogs in DaaS (Preview)
Currently, Citrix provides two provisioning solutions for creating VMs, Citrix Provisioning and Machine Creation Services (MCS).
To create a Citrix Provisioning catalog, you had to use the Citrix Virtual Apps and Desktops Setup Wizard. With this feature, you can now create a Citrix Provisioning catalog by using theFull Configurationuser interface and PowerShell.
Note:
Technical previews are available for customers to test in their non-production or limited production environments, and to give them an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might act on feedback based on its severity, criticality, and importance.
This implementation provides you the following advantages:
- A single unified console to manage both MCS and Citrix Provisioning catalogs.
- Have new features for Citrix Provisioning catalogs, such as, identity management solution, on-demand provisioning and so on.
目前,这个功能只有蓝色e workloads.
Note:
In this preview, many features aren’t supported. More hypervisors and features are to be supported later.
This article explains how to create an Azure Citrix Provisioning catalog in DaaS using theFull Configurationinterface and PowerShell commands.
Considerations
- Classic AD machine identity type is supported in this preview. Other identity types are to be supported later.
- Write-back cache is formatted after the first start of VMs.
- Image management is done using the existing Citrix Provisioning console.
- Only Boot Device Manager (BDM) is supported.
- While provisioning Citrix Provisioning target VMs, select the site for the target VMs. Ensure that the site is registered.
Limitations
- In this preview, the customer-managed Delivery Controller is not supported.
- Gen 2 VMs are only supported.
- You can create a catalog using a machine profile. Do not enable hibernation in the machine profile input.
You cannot set the following custom properties while creating the catalog:
- StorageType
- OsType
- MachinesPerStorageAccount
- StorageAccountsPerResourceGroup
- UseSharedImageGallery
- SharedImageGalleryReplicaRatio
- SharedImageGalleryReplicaMaximum
- UseEphemeralOsDisk
- UseManagedDisks
- StorageTypeAtShutdown
Requirements
- Upgrade to Citrix Provisioning version 2305 or later.
- Update the vDisks to run the required version of the VDA (2305 or later). SeeUpdating vDisks.
- On theFull Configuration interface > Preview features, enableCreating Citrix Provisioning catalogs in DaaSusing the toggle button. This action enables the Citrix DaaS
McsPVSProvScheme
feature flag to provision Citrix Provisioning VMs on Azure. Enable the following Citrix Provisioning feature flag on every Citrix Provisioning server and console system before running the Configuration Wizard. This action enables the MCS Provisioning feature in the registry:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ProvisioningServices\Features] "CCMessaging"=dword:00000001
Key steps
Set up Citrix Provisioning on Azure.
Note:
Citrix Provisioning version must be 2305 or later.
- Register Citrix Provisioning servers to Citrix Cloud.
Create or update vDisk.
Note:
The VDA version must be 2305 or later.
- Add a connection to Azure and specify its network resources.
- Create a Citrix Provisioning catalog in DaaS.
- Check the collections in the Citrix Provisioning Console underSites.
Set up Citrix Provisioning on Azure
To set up Azure provisioning, begin by configuring your provisioning server and other infrastructure on Azure. For more information, seeSet up Citrix Provisioning on Azure.
Register Citrix Provisioning server to Citrix Cloud
Run the Configuration Wizard to register the Citrix Provisioning servers in a farm to Citrix Cloud.
When joining an existing farm, identify the site where this provisioning server is a member.
For more information on registering Citrix Provisioning server to Citrix Cloud, seeConfiguration wizard settings.
Ensure to select a resource location for the target site when using MCS to provision Citrix Provisioning targets. You can selectNo resource locationfrom the options if:
- you do not use MCS to provision Citrix Provisioning targets.
- you use MCS to provision Citrix Provisioning targets, however, not for the specified target site.
For more information on selecting a resource location, seeSet up resource locations.
Create or update vDisk
As part of creating a catalog, you must be able to create a vDisk or update vDisks to run the required version of the VDA (2305 or later). SeeCreating vDisksorUpdating vDisks.
Add a connection to Azure and specify its network resources
Configuring a connection includes selecting the connection type from among the supported hypervisors and cloud services and the storage and network that you select from the resources for that connection. For more information, seeConnection to Microsoft Azure.
Create a Citrix Provisioning catalog using the Full Configuration interface
The workflow for creating the catalog is similar to the MCS workflow. However, now Studio creates and uploads a BDM boot disk to the storage. It then uses this disk as the OS disk, replicating it to machines as they are created.
To create a Citrix Provisioning catalog using theFull configurationinterface:
- Sign in to Citrix Cloud. In the upper left menu, selectMy Services > DaaS.
- FromManage > Full Configuration, selectMachine Catalogsin the left pane.
- SelectCreate Machine Catalog. The catalog creation wizard opens.
- On theMachine Typepage, select a machine type for this catalog, such asMulti-session OSorSingle-session OS.
On theMachine Managementpage, select the settings as follows:
- SelectMachines that are power managed (for example, virtual machines or blade PCs).
- SelectCitrix provisioning technology. Then, selectCitrix Provisioning Services (PVS).
- In theResourcesfield, select an Azure network resource for this catalog.
- (Viewable only to single-session-OS catalogs) On theDesktop Experiencepage, select the random or static desktop experience as needed.
On theTarget Devicepage, select the following:
Select the farm and site for the machines to be provisioned.
Note:
The site field shows only sites registered with the Citrix Cloud.
- Select the vDisk to use with the provisioned machines.
- Select a machine profile for the provisioned machines.
- On theStorage and License Typespage, select the storage to use for this catalog and select the Windows volume licenses to provision VMs in Azure.
- On theVirtual Machinespage, select the count of VMs, VM size, and availability zone.
- On theNICspage, add the NICs you want the VMs to use.
- On the磁盘设置page, select the storage type and size of the write-back cache disk.
- On theResource Grouppage, select the resource group to provision VMs.
- On theMachine Identitiespage, selectCreate new Active Directory accounts. Specify an account naming scheme.
- On theDomain Credentialspage, clickEnter credentials. Enter your domain credentials to perform account operations in the target Active Directory domain.
- On theSummarypage, enter a name for the machine catalog, and clickFinish.
A Citrix Provisioning machine catalog is now created.
Check the collections in the Citrix Provisioning Console under Sites
After the Citrix Provisioning catalog is created, in the Citrix Provisioning console, you can see two types of collections underSitein the Citrix Provisioning console:
- PVS Provisioned Collections: Collection of all PVS-provisioned devices in the site
- MCS Provisioned Collections: Collection of all MCS-provisioned devices in the site
In the MCS Provisioned Collections, you can see Citrix Provisioning catalogs.
Citrix Provisioning PowerShell SDK to get site and vDisk information
To get the list of Citrix Provisioning sites where each site lists the Citrix Provisioning servers that are in that site, run the PowerShell command
Get-HypPvsSite
. For example:Get-HypPvsSite -SiteId 00000000-0000-0000-0000-000000000000 -SiteName "exampleSite" -FarmId 00000000-0000-0000-0000-000000000000 -FarmName "exampleFarm" -ResourceLocation 00000000-0000-0000-0000-000000000000
Note:
All the parameters are optional in
Get-HypPvsSite
command. If you don’t enter any parameters, you get the list of all the registered sites.To get a list of vDisks where each vDisk lists the site that it can be used with that vDisk, run the PowerShell command
Get-HypPvsDiskInfo
. For example, you can run one of the following:Get-HypPvsDiskInfo -FarmId 00000000-0000-0000-0000-000000000000
Get-HypPvsDiskInfo -SiteId 00000000-0000-0000-0000-000000000000 -StoreId 00000000-0000-0000-0000-000000000000
Get-HypPvsDiskInfo -SiteId 00000000-0000-0000-0000-000000000000 -DiskLocatorId 00000000-0000-0000-0000-000000000000
Note:
The command queries
FarmId
from registered sites usingSiteId
when noFarmId
is given.
Create a Citrix Provisioning catalog using PowerShell commands
- If you are not on the Citrix Provisioning server or on a system that has the Citrix Provisioning console installed, then download and install the latest Remote PowerShell SDK. For more information, seeInstall and use the Remote PowerShell SDK.
- Open thePowerShellwindow.
- Run the PowerShell commands to create a broker catalog and identity pool.
Run the
New-ProvScheme
command to create the catalog. For example:New-ProvScheme -AdminAddress cl“localhost: 190 xx”eanOnBoot ` -ProvisioningSchemeType PVS ` -CustomProperties "
- Run the other required PowerShell commands to create a catalog. For information on creating a catalog using PowerShell commands, seehttps://developer-docs.citrix.com/projects/citrix-daas-sdk/en/latest/.
In this article
- Considerations
- Limitations
- Requirements
- Key steps
- Set up Citrix Provisioning on Azure
- Register Citrix Provisioning server to Citrix Cloud
- Create or update vDisk
- Add a connection to Azure and specify its network resources
- Create a Citrix Provisioning catalog using the Full Configuration interface
- Check the collections in the Citrix Provisioning Console under Sites
- Citrix Provisioning PowerShell SDK to get site and vDisk information
- Create a Citrix Provisioning catalog using PowerShell commands