A catalog is a group of identical virtual machines. When you deploy desktops, the machines in the catalog are shared with selected users. When you publish applications, multi-session machines host applications that are shared with selected users.
For information about creating Remote PC Access catalogs, see Remote PC Access.
A catalog can contain one of the following types of machines:
- Static: The catalog contains single-session static machines (also known as personal, dedicated, or persistent desktops). Static means that when a user starts a desktop, that desktop “belongs” to that user. Any changes that that user makes to the desktop are retained at logoff. Later, when that user returns to Citrix Workspace and starts a desktop, it is the same desktop.
- Random: The catalog contains single-session random machines (also known as non-persistent desktops). Random means that when a user starts a desktop, any changes that that user makes to that desktop are discarded after logoff. Later, when that user returns to Citrix Workspace and starts a desktop, it might or might not be the same desktop.
Multi-session: The catalog contains machines with apps and desktops. More than one user can access each of those machines simultaneously. Users can launch a desktop or apps from their workspace. App sessions can be shared. Session sharing is not permitted between an app and a desktop.
- When you create a multi-session catalog, you select the work load: light (such as data entry), medium (such as office apps), heavy (such as engineering), or custom. Each option represents a specific number of machines and sessions per machine, which yields the total number of sessions that the catalog supports.
- If you select the custom work load, you then select from available combinations of CPUs, RAM, and storage. Type the number of machines and sessions per machine, which yields the total number of sessions that the catalog supports.
The static and random types are sometimes called “desktop types.”
To learn about catalog information that’s displayed from the Manage dashboard, see Catalog tabs on the Manage dashboard.
Ways to create a catalog
There are several ways to create and configure a catalog:
- Quick create is the fastest way to get started. You provide minimal information, and the service takes care of the rest. A quick create catalog is great for a test environment or proof of concept.
- Custom create allows more configuration choices than quick create. It’s more suited to a production environment than a quick create catalog.
- Remote PC Access catalogs contain existing machines (usually physical) that users access remotely. For details and instructions about these catalogs, see Remote PC Access.
Here’s a comparison of quick create and custom create:
|Quick create||Custom create|
|Less information to provide.||More information to provide.|
|Fewer choices for some features.||More choices for some features.|
|Citrix-managed Azure Active Directory user authentication.||Choice of: Citrix-managed Azure Active Directory, or your Active Directory/Azure Active Directory.|
|No connection to your on-premises network.||Choice of: No connection to your on-premises network or Azure VNet peering.|
|Uses a Citrix-managed Windows 10 master image. That image contains a current desktop VDA.||Choice of: Citrix-provided images, a version of a Citrix image that you’ve customized, or an image you imported from Azure.|
|Each desktop has Azure standard disk (HDD) storage.||Several storage options are available.|
|Static desktops only.||Static, random, or multi-session desktops.|
|A power management schedule cannot be configured during creation. The machine hosting the desktop powers off when the session ends. (You can change this setting later.)||A power management schedule can be configured during creation.|
|Must use the Citrix-managed subscription.||Can use the Citrix-managed or your own Azure subscription.|
For details, see:
Create a catalog using quick create
This catalog creation method always uses the Citrix-managed subscription.
- Sign in to Citrix Cloud.
- In the upper left menu, select My Services > Managed Desktops.
If a catalog has not yet been created, you’re taken to the Welcome page. Choose one of:
Configure the catalog on this page. Continue with steps 6 through 10.
Click Get Started. You’re taken to the Manage dashboard. Click Create Catalog.
If a catalog has already been created (and you’re creating another one), you’re taken to the Manage dashboard. Click Create Catalog.
Click Quick Create at the top of the page, if it is not already selected.
- Machine performance: Select the machine type. Each choice has a unique combination of CPUs, RAM, and storage. Higher-performance machines have higher monthly costs.
- Region: Select a region where you want the machines created. You might select a region that’s close to your users.
- Name: Type a name for the catalog. This field is required, and there is no default value.
- Number of machines: Type the number of machines you want.
- When you’re done, click Create Catalog. (If you’re creating the first catalog from the Welcome page, click Quick Create Desktops.)
You’re taken automatically to the Manage dashboard. While the catalog is being created, the catalog’s name is added to the list of catalogs, indicating its progress through creation.
Citrix Managed Desktops also automatically creates a resource location and adds two Cloud Connectors.
What to do next:
- If you’re using Managed Azure AD for user authentication, you can add users to the directory while the catalog is being created.
- Regardless of which user authentication method you use, after the catalog is created, add users to the catalog.
Create a catalog using custom create
If you plan to use a connection to your on-premises network resources, create that network connection before creating the catalog. To allow your users access to your on-premises or other network resources, you also need Active Directory information for that location.
- Sign in to Citrix Cloud.
- In the upper left menu, select My Services > Managed Desktops.
If a catalog has not yet been created, you’re taken to the Welcome page. Click Get Started. At the end of the introduction page, you’re taken to the Manage dashboard. Click Create Catalog.
If a catalog has already been created, you’re taken to the Manage dashboard. Click Create Catalog.
Select Custom Create at the top of the page, if it’s not already selected.
Complete the following fields. (Some fields are valid only for certain machine types. The field order might differ.)
- Machine type. For details, see Machine types.
- Subscription. For details, see Azure subscriptions.
Network connection: Select the connection to use for accessing resources in your network. For details, see Network connections.
For the Citrix-managed subscription, the choices are:
- No Connectivity: Users cannot access locations and resources on your on-premises corporate network.
- Connections: Select a connection, such as a VNet peering or SD-WAN connection.
For the customer-managed Azure subscription, select the appropriate resource group, virtual network, and subnet.
- Region: (Available only for No Connectivity network connection. If you selected a network connection, the catalog uses that network’s region.) Select a region where you want the desktops created. You might select a region that’s close to your users.
- Storage type. HDD or SSD.
Machine performance (for Static or Random machine type), or Workload (for multi-session machine type).
If you select the custom work load, type the number of machines and sessions per machine in the Machine Performance field.
- Machine. How many machines you want in this catalog.
Machine naming. To specify a machine naming scheme, select Specify machine naming scheme. Use from 1-4 wildcards (hash marks) to indicate where sequential numbers or letters appear in the name. Rules:
- The naming scheme must contain at least one wildcard, but not more than four wildcards. All the wildcards must be together.
- The entire name, including wildcards, must be between 2 and 15 characters.
- A name cannot include blanks (spaces), slashes, backslashes, colons, asterisks, angle brackets, pipes, commas, tildes, exclamation points, at signs, dollar signs, percent signs, carets, parentheses, braces, or underscores.
- A name cannot begin with a period.
- A name cannot contain only numbers.
- Do not use the following letters at the end of a name:
Indicate whether the sequential values are numbers (0-9) or letters (A-Z).
For example, a naming scheme of
PC-Sales-##(with 0-9 selected) results in computer accounts named
PC-Sales-03, and so on.
Leave enough room for growth.
- For example, a naming scheme with 2 wildcards and 13 other characters (for example,
MachineSales-##) uses the maximum number of characters (15).
- Once the catalog contains 99 machines, the next machine creation fails. Citrix Managed Desktops tries to create a machine with three digits (100), but that would create a name with 16 characters. The maximum is 15.
- So, in this example, a shorter name (for example,
PC-Sales-##) allows scaling beyond 99 machines.
If you do not specify a machine naming scheme, Citrix Managed Desktops uses the default naming scheme
%%%%%= five random alphanumeric characters matching the resource location prefix
**= two random alphanumeric characters for the catalog
###= three digits.
- Master image: Select an operating system image. For details, see Master images.
- Name: Type a name for the catalog. This name appears on the Manage dashboard.
- Power schedule: By default, the I’ll configure this later check box is selected. For details, see Power management schedules.
Join the local Active Directory domain: (Available only for a VNet peering network connection.) Select Yes or No. If you select Yes, enter the:
- FQDN of the domain (for example, Contoso.com).
- Organization Unit: To use the default OU (Computers), leave this field empty.
- Service account name: Must be a domain or enterprise administrator in the format name@domain or name\domain.
- Password for the service account name.
- When you’re done, click Create Catalog.
For information about Advanced settings, see Resource location settings when creating a catalog.
The Manage dashboard indicates when your catalog is created. Citrix Managed Desktops also automatically creates a resource location and adds two Cloud Connectors.
What to do next:
- Configure the authentication method for your users to authenticate to Citrix Workspace.
- After the catalog is created, add users to the catalog.
- If you created a multi-session catalog, add applications (before or after adding users).
Resource location settings when creating a catalog
When creating a catalog, Citrix manages the resource location for the catalog. You can optionally configure advanced settings for the resource location.
When you click Advanced settings, Citrix Managed Desktops retrieves resource location information.
If you already have a resource location for the domain and network connection specified for the catalog, you can save it for use by the catalog you’re creating.
If that resource location has only one Cloud Connector, another one is installed automatically. You can optionally specify advanced settings for the Cloud Connector you’re adding.
If you don’t have a resource location set up for the domain and network connection specified for the catalog, you’re prompted to configure one.
Configure advanced settings:
- (Required only when the resource location is already set up.) A name for the resource location.
- The OU for the resource location. By default, the OU specified for the catalog is used.
- (Available only when using a customer-managed Azure subscription) Machine performance. This selection is used for the Cloud Connectors in the resource location.
- (Available only when using a customer-managed Azure subscription) Azure resource group. This selection is used for the Cloud Connectors in the resource location. The default is the resource group last used by the resource location (if applicable).
- Organizational Unit (OU). The default is the OU last used by the resource location (if applicable).
- Whether your network requires a proxy server for internet connectivity. If it does, enter the proxy server’s FQDN or IP address, and the port number.
- External connectivity type: through the Citrix Gateway service, or from within your corporate network.
When you’re done with the advanced settings, click Save to return to the catalog creation flow.