Add CVAD Integration
    • Dark
      Light
    • PDF

    Add CVAD Integration

    • Dark
      Light
    • PDF

    Article Summary

    The following article explians how to configure a CVAD connection and monitor your CVAD components with ControlUp.

    Data Collector

    We strongly recommend that you use a dedicated data collector for all EUC environment connections. A data collector can be any machine that has the ControlUp Agent installed. To learn more, visit ControlUp Data Collector.

    To learn how to get started with CVAD integration, watch our video.

    Prerequisites

    Component Requirements

    • Citrix Virtual Desktops (XenDesktop) 7.5 or higher
    • Citrix Virtual Desktops (XenDesktop) PowerShell SDK installed on Monitor machines, Data Collector machines, and all machines running the Real-Time Console. You can download the necessary Snap-ins 7.9 here. Alternatively, install Citrix Studio to automatically install the Citrix Virtual Desktops (XenDesktop) PowerShell SDK. We require the following PowerShell SDK Snap-ins:
      • AD Identity
      • Broker
      • Configuration
      • Configuration Logging
      • Delegated Admin
      • Host
      • Machine Creation Services
      • Monitor

    Network Requirements

    If you keep the SDK default TCP port 80 (HTTP) in the CVAD configuration, you only need to enable API port 80 from all Real-Time Console machines, Monitor machines, and Data Collector machines to the Citrix Virtual Desktops (XenDesktop) Broker.

    If you change the SDK default TCP port from 80 to 443 (HTTPS) in the CVAD configuration, you must enable both API ports 80 and 443 from all Real-Time Console machines, Monitor machines, and Data Collector machines to the Citrix Virtual Desktops (XenDesktop) Broker. 

    For details on how to change your CVAD API ports from 80 to 443 in ControlUp, see Change Citrix API Connection Port to 443.

    Service Account Requirements

    Custom Permissions
    ControlUp doesn't currently support custom permissions in Citrix Cloud environments.

    The Read Only Administrator right to all managed farms is sufficient for all monitoring purposes. If you want to perform built-in CVAD management actions, then the service account needs the following permissions:

    • Edit Application Group Policies
    • Edit Application Properties (Application Group)
    • Edit Delivery Group Properties
    • Edit Machine Catalog Properties

    Add your credentials to your shared credentials before you add the CVAD integration.

    Data Collector Requirements

    The data collector machine must have the CVAD PowerShell SDK installed. See Component Requirements above for details.

    9.0 and later only
    From version 9.0, we recommend you add cuagent.exe.log4net to the data collector.

    Add a CVAD Connection to ControlUp

    To add a CVAD connection in your ControlUp environment, perform the following steps:

    1. In the Real-Time Console, go to Home > Add EUC Environment to open the Add EUC Environment Connection window.AddEUCEnvironment
    2.  Set the Solution / Platform to Citrix Virtual Apps and Desktops.
       
    3. Enter the Broker Name / IP (FQDN, hostname, or IP address) of your CVAD Broker site.
    4. Optionally, change the Port used to communicate to the Broker. The default port is 80.
    5. Select Credentials for your CVAD environment from your shared credentials. The required permissions for the credentials are described above. You should have added these credentials as shared credentials in your Monitor Settings.
    6. Expand the Data Collectors tab to configure a data collector for the CVAD connection.
      ExpandDataCollectorsEUC
      1. Select the default data collector and click Remove.RemoveDefaultDataCollectorEUC
      2. Click Add and select the machine that you want to use as a data collector.
      3. Optionally, add another machine to use as a backup data collector in case the primary data collector is down. Note that the first machine in the list is the primary data collector.
    7. Click OK to save the CVAD connection.

    After ControlUp connects to your CVAD site, the Site Name field automatically populates, and the Brokers Failover List tab contains the names of all the Broker servers assigned to the CVAD site.

    CVAD Monitoring

    After you add a CVAD connection, ControlUp discovers Virtual Desktop Agents (VDAs), delivery groups, and brokers associated with your CVAD environment. In the Real-Time Console, you can see:

    • VDAs and brokers in the Machines view.
    • Open sessions on the VDAs or broker in the Sessions view.
    • Running processes of open sessions in the Processes view.
    • Information about published applications in the Applications view.

    Resources monitored with ControlUp will be enriched with CVAD-related metrics and metadata. For example, the Machines view has the column CVAD Machine Availability to show if VDAs are accessible by users, and the Sessions view has the column CVAD Launched Via HostName to show the name of the StoreFront server used to launch each session.

    The CVAD site appears in the organization tree under EUC Environments. You can see the delivery groups and brokers under the CVAD site. Select one of these folders to show information relevant to only that folder.

    Note
    The subfolder of a CVAD site (delivery groups and brokers) are not stored in ControlUp's configuration and can't be used to configure stress settings, triggers, or column presets. To use these features, you need to install the ControlUp Agent on these machines.

    For a reference of the CVAD information you can monitor, visit CVAD Integration: Columns & Grids Overview.

    To monitor performance metrics of your VDAs and broker machines, you can install the ControlUp Agent on these machines.

    Licensing
    Each session discovered by the CVAD connection uses 1 ControlUp license.

    Monitor Broker Health

    You can monitor the health of each broker in the CVAD site.

    The CVAD Broker Health column is based on a list of services, databases, and hypervisors. If all of these are running and available, the broker's health is 100%. The health percentage decreases if some parameters are not healthy.

    Each of the parameters that the calculation is based on can be excluded from the registry (by default the % hypervisors available is excluded).

    The CVAD site itself shows an aggregated calculation of how many % of brokers are 100% healthy.


    Was this article helpful?