Product Documentation

Connections and resources

May 09, 2015

You must be a full administrator to complete these tasks. Read Only Administrators can view connection, resource, and machine details.

For information about deploying this product with supported host systems, see the Integrate documentation.

Hosts must be present when creating a connection.

To create a Connection and resources

  1. In Studio, select Configuration > Hosting.
  2. Click Add Connections and Resources.
  3. Select Create a new Connection.
  4. Enter a Connection name.
  5. Specify the type of host, its address, and the credentials to use when connecting. Ensure that the credentials let you perform all the necessary tasks. If you use XenServer:
    • Citrix recommends using HTTPS to secure communication with XenServer. To use HTTPS, you must replace the default SSL certificate installed with XenServer with one from a trusted certificate authority; see CTX128656.
    • You can later select the hypervisors to be used for high availability if it is enabled on XenServer. To select hypervisors, finish creating the Connection, select it, and click Change details. Citrix recommends that you select all servers in the pool to allow communication with XenServer if the pool master fails.
    • For Citrix CloudPlatform you need the following information from your cloud service administrator:
      • Connection URL
      • API key
      • Secret key
    • For Amazon Web Services (AWS), you need the following information from your cloud service administrator:
      • Connection URL
      • API key
      • Secret key
      Note: The credentials file for the root AWS account, retrieved from the AWS console is not in the same format for credentials files downloaded for standard AWS users. Because of this, Studio cannot use the file to populate the API key and Secret key fields when creating a connection. Ensure that you are using IAM credentials files when administering Studio.
    • For Microsoft Configuration Manager Wake on LAN, you need the following information:
      • Connection address
      • User name and password
      • Connection name
    If you manage user desktops hosted on dedicated blade PCs in the data center, set Host type to None.
  6. Select Studio Tools (Machine Creation Services) or Other tools to create VMs. To select hypervisors that provide GPU resources, you must choose Machine Creation Services (MCS).
  7. On the Storage page, select storage types and devices.
    • When using MCS, select the network and storage resources for the new virtual machines in the Storage.
    • If you use shared storage, you can enable IntelliCache to reduce load on the storage device. Local storage is on the Connection. For more information about using IntelliCache, see Use IntelliCache.
  8. If your Connection has GPU capabilities:
    1. Select Yes for Do you want to use graphics virtualization?
    2. Select a GPU type and group from the list.
  9. Enter a name for the resources, and then click Finish.

To create a Connection and resources from an existing Connection

  1. In Studio, select Configuration > Hosting.
  2. Click Add Connections and Resources.
  3. Select Use an existing Connection, select the relevant Connection from the list.
  4. Select Machine Creation Services (MCS) or Other tools, and then click Next. To select hypervisors that provide GPU resources, you must choose Machine Creation Services (MCS). If your connection has GPU capabilities:
    1. Select Yes for Do you want to use graphics virtualization?
    2. Select a GPU type and group from the list.
  5. Enter a name for the resources, and then click Finish.

To add storage to a Connection

  1. In Studio, select Configuration > Hosting.
  2. Select the resource to which you want to add storage, then click Add storage.
  3. Select the storage to add, and then click OK.

To edit a Connection

  1. In Studio, select Configuration > Hosting.
  2. Select the Connection you want to edit, and then click Change details.
  3. Edit the Connection:
    • To update the Connection address and credentials, click Edit settings, enter the new details, and then click OK.
    • Do not edit a Connection to create a new one. Follow the steps in To create a Connection and resources.
      Note: To rename the Connection, select it, and then click Rename.
    • For a Microsoft System Center Configuration Manager (ConfMgr) Wake on LAN connection, you can edit the power management connection by clicking Advanced. Configure the use of the ConfMgr Wake Proxy and magic packets, as well as change the packet transmission method.
    • To specify the high-availability servers (enabled on XenServer), click Edit HA servers. Citrix recommends that you select all servers in the pool to allow communication with XenServer if the pool master fails.
    • To configure hypervisor throttling, click Advanced. If your power management settings allow too many or too few machines to start at the same time, you can adjust the throttling limit as follows:
      • To prevent more than a certain number of operations or actions running at any one time, select a number for Max active actions.
      • To limit the number of new actions that can be started per minute, select a number for Max new actions per minute.
      • To limit the number of concurrent actions to a percentage of the total number of VMs configured for this Connection, select a number for Max power actions as a percentage of desktops.
      • To limit the number of Personal vDisk power actions as a percentage, select a number for Max Personal vDisk power actions as a percentage.

      The actual limit applied is the lower number of the configured settings. For example, if the maximum active number of actions is 10, the maximum number of actions as a percentage of desktops is 10, and the number of machines is 34, the limit is 3 (that is, 10 percent of 34 rounded to the nearest whole number).

      Note: Use Connection options only under the guidance of a Citrix Support representative.
    • To change the scopes for the Connection, click Scopes.
    • You cannot change the GPU settings for an existing connection, because machine catalogs accessing this resource must use an appropriate GPU-specific master image. You must create a new Connection as described in To create a Connection and resources.

To place a Connection into maintenance mode

Placing a Connection into maintenance mode prevents any new power action from affecting any machine stored on the Connection. No user can connect to a machine in this state. If a user is already connected, maintenance mode takes effect as soon as they log off. You can then perform administrative tasks on the associated image, such as applying patches and upgrades using your image management tools.

  1. In Studio, select Configuration > Hosting.
  2. Select the Connection to put into maintenance mode and then click Turn on maintenance mode. To take a Connection out of maintenance mode, click Turn off Maintenance Mode.

To delete a Connection

Before you delete a Connection, ensure that:
  • All users have logged off from the machines stored on the Connection.
  • No disconnected user sessions are still running.
  • For pooled and dedicated machines, all machines are in maintenance mode.
  • For existing Machine Catalogs, all machines are powered off.
Caution: Deleting a Connection can result in the deletion of large numbers of machines and in loss of data. Make sure you read this topic carefully and that any user data on affected machines is backed up or no longer required.
  1. In Studio, select Configuration > Hosting.
  2. Select the Connection you want to delete, and then click Delete Connection.
  3. If this Connection still has machines stored on it, you are prompted to specify whether or not the machines should be deleted and, if they are to be deleted, what should be done with the Active Directory computer accounts associated with them. A catalog becomes unusable when you delete a Connection that is referenced by that catalog. If this Connection is referenced by a catalog, you have the option to delete the catalog. Before you delete a catalog, make sure it is not supported by other Connections.

To rename a Connection

  1. In Studio, select Configuration > Hosting.
  2. Select the Connection you want to rename, and then click Rename Connection.
  3. Enter the new name and then click OK.

To view machine details

  1. In Studio, select Configuration > Hosting.
  2. Select the relevant Connection.
  3. Select View Machines. The machines accessed through this Connection are listed in the upper panel of the window. To display the details of a machine, select it, and the details appear in the lower panel. Session details are also provided if there is a session open.

    To find machines quickly, use the search features. Either select a saved search from the list at the top of the window, or create a new search. You can either search by typing all or part of the machine name, or you can build an expression to use for an advanced search. To build an expression, click Unfold, and then select from the lists of properties and operators.

To manage machines

  1. Display the machines by selecting Configuration > Hosting.
  2. Select the relevant machines.
  3. Select one of the following actions:
    • Start. Starts the machine if it is powered off or suspended. If the Host type does not support the power-on function, the Start action is not available.
    • Suspend. Pauses the desktop without shutting it down and refreshes the list of desktops.
    • Shut down. Requests the desktop’s operating system to shut down.
      Note: If the desktop does not shut down within 10 minutes, it is powered off. If Windows attempts to install updates during shutdown, there is a risk that the desktop will be powered off before the updates are complete.
    • Force shut down. Forcibly powers off the desktop and refreshes the list of desktops.
    • Restart. Requests the desktop operating system to shut down and then start the desktop again. If the operating system is unable to do this, the desktop remains in its current state.
    • Enable maintenance mode. To temporarily stop connections to a machine so maintenance tasks can be carried out, put it into maintenance mode. Users cannot connect to a machine in this state. If a user is already connected, maintenance mode takes effect as soon as they log off.
      Note: To put all the machines accessed through a Connection into maintenance mode, select the Connection, and click Turn on Maintenance Mode, as described in "To place a Connection into maintenance mode" above.
    • Remove from Delivery Group. Removing a machine from a Delivery Group does not delete it from the catalog on which the group is based. You can remove a machine only while no user is connected to it. To temporarily prevent users from connecting to a machine while you are removing it, first put the machine into maintenance mode. Users cannot connect to a machine that is removed from a Delivery Group.
    • Delete. When you delete a machine, users no longer have access to it, and the machine is deleted from the catalog. Before deleting a machine, ensure that all user data is backed up or no longer required. You can delete a machine only while no user is connected to it. To temporarily stop users from connecting to a machine while you are deleting it, first put the machine into maintenance mode.

To delete a resource

  1. In Studio, select Configuration > Hosting.
  2. Select the resource you want to delete, and then click Delete Resources.

To rename a resource

  1. In Studio, select Configuration > Hosting.
  2. Select the resource you want to rename, and then click Rename Resources.

Use IntelliCache

Using IntelliCache, hosted VDI deployments are more cost-effective because IntelliCache enables you to use a combination of shared storage and local storage. Performance is enhanced and network traffic is reduced. The local storage caches the master image from the shared storage, which reduces the amount of reads on the shared storage. For shared desktops, writes to the differencing disks are written to local storage on the host and not to shared storage.

Your shared storage must be NFS when using IntelliCache.

Citrix recommends that you use a high performance local storage device to ensure the fastest possible data transfer.

To use IntelliCache you must enable it in both this product and XenServer.

To enable IntelliCache in XenServer

When installing XenServer, select Enable thin provisioning (Optimized storage for XenDesktop). Citrix does not support mixed pools of servers that have IntelliCache enabled and servers that do not.

For more information on using IntelliCache, see the XenServer and IntelliCache chapter in the XenServer Installation Guide available from the XenServer node.

To enable IntelliCache in this product

IntelliCache is disabled by default. You can update the setting only when you create a connection; you cannot disable IntelliCache later. When you add a XenServer connection from Studio:

  1. Select Shared as the storage type.
  2. Select Use IntelliCache to reduce load on the shared storage.