Manage catalogs in Quick Deploy

This article describes the catalog management tasks you can use to manage catalogs that were created in Quick Deploy.

Remember: If you used Quick Deploy to create a catalog, and then use the Full Configuration interface to perform any management tasks on that catalog, you can no longer use the Quick Deploy interface for that catalog.

(For information about managing catalogs in the Full Configuration management interface, seeManage machine catalogs.)

Add machines to a catalog

While machines are being added to a Quick Deploy catalog, you cannot make any other changes to that catalog.

1. FromManage > Quick Deploy, click anywhere in the catalog’s entry.

2. On theMachinestab, selectAdd Machines to Catalog.

   

3. 进入机器的数量你想添加the catalog.

   

4. (Valid only if the catalog is domain-joined.) Type the user name and password for Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) account.
5. SelectAdd Machines to Catalog.

You cannot reduce the machine count for a catalog. However, you can use power management schedule settings to control how many machines are powered on, or delete individual machines from theMachinestab. SeeManage machines in a catalogfor information on deleting machines from theMachinestab.

Change the number of sessions per machine

Changing the number of sessions per multi-session machine can affect users’ experience. Increasing this value can reduce the compute resources allocated to concurrent sessions.

Recommendation: Observe your usage data to determine the appropriate balance between user experience and cost.

1. FromManage > Quick Deploy, select a catalog containing multi-session machines.
2. On theDetailstab, selectEditnext toSessions per Machine.
3. Enter a new number of sessions per machine.
4. SelectUpdate Number of Sessions.
5. Confirm your request.

This change does not affect current sessions. When you change the maximum number of sessions to a value that is lower than a machine’s currently active sessions, the new value is implemented through the normal attrition of active sessions.

If a failure occurs before the update process begins, the catalog’sDetailsdisplay retains the correct number of sessions. If a failure occurs during the update process, the display indicates the number of sessions you wanted.

Manage machines in a catalog

Note:

Many of the actions that are available fromManage > Quick Deployare also available from theMonitortab in Quick Deploy.

To select actions fromManage > Quick Deploy:

1. FromManage > Quick Deploy, click anywhere in a catalog’s entry.

2. On theMachinestab, find the machine you want to manage. In the ellipsis menu for that machine, select the desired action:

   • Restart:Restarts the selected machine.
   • Start:Starts the selected machine. This action is available only if the machine is powered off.
   • Shutdown:Shut down the selected machine. This action is available only if the machine is powered on.

   • Turn maintenance mode on/off:Turns maintenance mode on (if it is off) or off (if it is on) for the selected machine. By default, maintenance mode is turned off for a machine.

     Turning on maintenance mode prevents new connections from being made to that machine. Users can connect to existing sessions on that machine, but they cannot start new sessions on that machine.

     You might place a machine in maintenance mode before applying patches, or for troubleshooting.

   • Delete:Deletes the selected machine. This action is available only when the machine’s session count is zero. Confirm the deletion.

     When a machine is deleted, all data on the machine is removed.

   • Force restart:Forces a restart of the selected machine. Select this action only if aRestartaction for the machine fails.

Add apps to a catalog

1. FromManage > Quick Deploy, click anywhere in the catalog’s entry.

2. On theDesktop and Appstab, selectManage Apps.

   

3. Select how you are adding apps: from theStartmenu of machines in the catalog, or from a different path on the machines.

4. To add apps from theStartmenu:

   

   • Select available apps in the left column. (UseSearchto tailor the apps list.) Select the right arrow between the columns. The selected apps move to the right column.
   • Similarly, to remove apps, select them in the right column. Select the left arrow between columns.
   • If theStartmenu has more than one version of the same app, with the same name, you can add only one. To add another version of that app, edit that version to change its name. Then you can add that version of the app.

5. To add apps by path:

   

   • Enter the name for the app. This is the name users see in Citrix Workspace.
   • The icon shown is the icon users see in Citrix Workspace. To select another icon, selectChange iconand navigate to the icon you want to display.
   • (Optional) Enter a description of the application.
   • Enter the path to the app. This field is required. Optionally, add command line parameters and the working directory. For details about command line parameters, seePass parameters to published applications.
6. When you’re finished, selectClose.

On Windows Server 2019 VDAs, some application icons might not appear correctly during configuration and in the users’ workspace. As a workaround, after the app is published,edit the appand use theChange iconfeature to assign a different icon that displays correctly.

Edit an app in a catalog

1. FromManage > Quick Deploy, click anywhere in the catalog’s entry.
2. On theDesktop and Appstab, click anywhere on the row containing the app you want to edit.

3. Select the pencil icon.

   

4. Type changes in any of the following fields:

   • Name:The name users see in Citrix Workspace.
   • Description
   • 路径:The path to the executable.
   • Command line parameters:For details, seePass parameters to published applications.
   • Working directory
5. To change the icon users see in their Citrix Workspace, selectChange iconand navigate to the icon you want to display.
6. When you’re done, selectSave.

Pass parameters to published applications

When you associate a published application with file types, the percent and star symbols (enclosed in double quotation marks) are appended to the end of the command line. These symbols act as a placeholder for parameters passed to user devices.

• If a published application does not launch when expected, verify that its command line contains the correct symbols. By default, parameters supplied by user devices are validated when the symbols are appended.

  For published applications that use customized parameters supplied by the user device, the symbols are appended to the command line to bypass command-line validation. If you do not see these symbols in a command line for the application, add them manually.

• If the path to the executable file includes directory names with spaces (such as“C:\Program Files”), enclose the command line for the application in double quotation marks to indicate that the space belongs in the command line. Add double quotation marks around the path, and another set of double quotation marks around the percent and star symbols. Add a space between the closing quotation mark for the path and the opening quotation mark for the percent and star symbols.

  For example, the command line for the published application Windows Media Player is:“C:\Program Files\Windows Media Player\mplayer1.exe” “%*”

Remove apps from a catalog

Removing an app from a catalog does not remove it from the machines. It just prevents it from appearing in Citrix Workspace.

1. FromManage > Quick Deploy, click anywhere in the catalog’s entry.
2. On theDesktop and Appstab, select the trash icon next to the apps you want to remove.

Delete a catalog

When you delete a catalog, all the machines in the catalog are permanently destroyed. Deleting a catalog cannot be reversed.

1. FromManage > Quick Deploy, click anywhere in the catalog’s entry.
2. On theDetailstab, selectDelete Catalog.
3. Confirm the deletion.

来帮助识别残余Active Directory的机器accounts that you must delete, you can download a list of machine and Cloud Connector names.

Manage power management schedules

power management schedule affects all machines in a catalog. A schedule provides:

• Optimal user experience: Machines are available for users when they’re needed.
• Security: Desktop sessions that remain idle for a specified interval are disconnected, requiring users to launch a new session in their workspace.
• Cost management and power savings: Machines with desktops that remain idle are powered-off. Machines are powered on to meet scheduled and actual demand.

您可以配置权力安排当您创建a custom catalog or do it later. If no schedule is selected or configured, a machine powers off when a session ends.

You cannot select or configure a power schedule when creating a catalog with quick create. By default, quick create catalogs use the Cost Saver preset schedule. You can select or configure a different schedule later for that catalog.

Schedule management includes:

• Knowing what information a schedule contains
• Creating a schedule

Information in a schedule

The following diagram shows the schedule settings for a catalog containing multi-session machines. Settings for a catalog containing single-session (random or static) machines differ slightly.

power management schedule contains the following information.

Preset schedules

Citrix DaaSoffers several preset schedules. You can also configure and save custom schedules. Although you can delete custom presets, you cannot delete Citrix-provided presets.

Time zone

Used with the power-on machines setting to establish work hours and after hours, based on the selected time zone.

This setting is valid for all machine types.

Power on machines: Work hours and after hours

The days of the week and start-stop hours of the day that form your work hours. This generally indicates the intervals when you want machines powered on. Any time outside of those intervals is considered after-hours. Several schedule settings allow you to enter separate values for work hours and after-hours. Other settings apply all the time.

This setting is valid for all machine types.

Disconnect desktop sessions when idle

How long a desktop can remain idle (not used) before the session is disconnected. After a session is disconnected, the user must go to Workspace and start a desktop again. This is a security setting.

This setting is valid for all machine types. One setting applies all the time.

Power off idle desktops

How long a machine can remain disconnected before it is powered off. After a machine is powered off, the user must go to Workspace and start a desktop again. This is a power-saving setting.

For example, let’s say you want desktops to disconnect after they have been idle for 10 minutes. Then, power off the machines if they remain disconnected for another 15 minutes.

If Tom stops using his desktop and walks away for a one-hour meeting, the desktop will be disconnected after 10 minutes. After another 15 minutes, the machine will be powered off (25 minutes total).

从用户的角度来看,两个闲置设置(说connect and power-off) have the same effect. If Tom stays away from his desktop for 12 minutes or an hour, he must start a desktop again from Workspace. The difference in the two timers affects the state of the virtual machine providing the desktop.

This setting is valid for single-session (static or random) machines. You can enter values for work hours and after-hours.

Log off disconnected sessions

How long a machine can remain disconnected before the session is closed.

This setting is valid for multi-session machines. One setting applies all the time.

Power-off delay

The minimum amount of time a machine must be powered-on before it is eligible for power-off (along with other criteria). This setting keeps machines from “flip-flopping” on and off during volatile session demands.

This setting is valid for multi-session machines, and applies all the time.

Minimum running machines

How many machines must remain powered-on, regardless of how long they are idle or disconnected.

This setting is valid for random and multi-session machines. You can enter values for work hours and after-hours.

Capacity buffer

A capacity buffer helps accommodate sudden spikes in demand, by keeping a buffer of machines powered-on. The buffer is specified, as a percentage of current session demand. For example, if there are 100 active sessions and the capacity buffer is 10%, Citrix DaaS provides capacity for 110 sessions. A spike in demand might occur during work hours or adding new machines to the catalog.

A lower value decreases the cost. A higher value helps ensure an optimized user experience. When launching sessions, users do not have to wait for extra machines to power on.

When there are more than enough machines to support the number of powered-on machines needed in the catalog (including the capacity buffer), extra machines are powered off. Power-off might occur because of off-peak time, session logoffs, or fewer machines in the catalog. The decision to power off a machine must meet the following criteria:

• The machine is powered on and not in maintenance mode.
• The machine is registered as available or waiting to register after power-on.
• The machine has no active sessions. Any remaining sessions have ended. (The machine was idle for the idle timeout period.)

• The machine has been powered on for at least “X” minutes, where “X” is the power-off delay specified for the catalog.

  In a static catalog, after all machines in the catalog are assigned, the capacity buffer does not play a role in powering machines on or off.

This setting is valid for all machine types. You can enter values for work hours and after-hours.

Create a power management schedule

1. FromManage > Quick Deploy, click anywhere in the catalog’s entry.
2. On thePower Managementtab, determine whether any of the preset schedules (in the menu at the top) meet your needs. Select a preset to see the values it uses. If you want to use a preset, leave it selected.
3. If you change the values in any fields (such as days, times, or intervals), the preset selection changes toCustomautomatically. An asterisk indicates that custom settings have not been saved.
4. Set the values you want for the custom schedule.
5. SelectCustomat the top, and then save the current settings as a new preset. Enter a name for the new preset and select the check mark.
6. When you’re done, selectSave Changes.

Later, you can edit or delete a custom preset by using the pencil or trash icons in thePresetsmenu. You cannot edit or delete common presets.

Related information

• Update a catalog with a new image
• Add and remove users in a catalog