Product Documentation

Connections and resources

Mar 19, 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. Type a name for the Connection.
  5. Specify the type of host, its address, and the credentials to use when connecting. Ensure that the credentials enable you to carry out 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.
    If you manage user desktops hosted on dedicated blade PCs in the data center, set Host type to None.
  6. Select whether you will use Machine Creation Services (MCS) or other tools to create VMs.
  7. When using MCS, select the network and storage resources for the new virtual machines.

    If you use shared storage, you can enable the use of IntelliCache to reduce load on the storage device. Local storage is on the Host. For more information about using IntelliCache, see Use IntelliCache with XenDesktop.

  8. Type 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, and then click Next.
  4. When using MCS, select the network and storage resources for the new virtual machines
  5. Type 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, type the new details, and then click OK. Do not edit a Connection to create a new one.
      Note: To rename the Connection, select it and then click Rename.
    • 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% 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.

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. Ensure you read this document 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 are given the opportunity to delete the catalog at this point. Before you delete a catalog, ensure that 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. Type 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 the unfold button and then select from the lists of properties and operators.

To manage machines

  1. Display the machines as described above.
  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 that 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 that the group is based on. You can remove a machine only while no user is connected to it. To temporarily stop users from connecting to a machine while you are removing it, put the machine into maintenance mode first. 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 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, put the machine into maintenance mode first.

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.