After you install the broker agent, you use the Broker Agent Configuration wizard to configure the broker agent on the Citrix XenDesktop Delivery Controller where you installed the broker agent. You can also use the Broker Agent Configuration wizard to make changes to your broker agent configuration.

About this task

A check box in the Broker Agent Setup wizard controls whether the Broker Agent Configuration wizard opens immediately after you install the broker agent. This check box is selected by default.

During broker agent configuration, you pair the broker agent with a vRealize Operations for Published Applications adapter instance. Pairing the broker agent with a vRealize Operations for Published Applications adapter instance is a necessary authentication step that enables the broker agent and desktop agents to communicate with the vRealize Operations for Published Applications adapter. The broker agent and desktop agents cannot communicate with the vRealize Operations for Published Applications adapter until the pairing process is complete.

If you are monitoring multiple XenDesktop Sites, you can pair the broker agent installed in each Site with the same vRealize Operations for Published Applications adapter instance as long as the total number of desktops that the vRealize Operations for Published Applications adapter instance handles does not exceed 10,000.

Each time you restart the broker agent service, a new log file is created.

If a log file was created for the day and the broker agent is restarted on that day, a new log file is created. The name of the new log file is v4pa_brokeragent_svc_<date>_00.log, and the log rotation follows this series.

Prerequisites

  • Install the vRealize Operations for Published Applications broker agent. See Install the vRealize Operations for Published Applications Broker Agent.

  • Verify that you have the server key for the vRealize Operations for Published Applications adapter. You specified the server key when you created a credential for the adapter instance.

  • Verify that you have the IP address or FQDN of the machine where you installed the vRealize Operations for Published Applications adapter.

Procedure

  1. If the Broker Agent Configuration wizard is not already open, start it by selecting Start > VMware > vRealize Operations for Published Apps Broker Agent Settings.
  2. In the Adapter IP/FQDN Address text box, type the IP address of the vRealize Operations Manager node or remote collector where the vRealize Operations for Published Applications adapter instance is running.
  3. In the Port text box, type the port used to connect to the vRealize Operations for Published Applications adapter.

    By default, the broker agent uses port 3095 to communicate with the vRealize Operations for Published Applications adapter. You can modify the default port number, depending on your network configuration.

  4. Type and confirm the pairing key for the vRealize Operations for Published Applications adapter.
  5. Click Pair to pair the broker agent with the vRealize Operations for Published Applications adapter, and click Test to test the connection.

    The status of the pairing process appears in the Text area.

  6. After the pairing process succeeds, click Next.
  7. On the Copy Information page, click Copy to copy the certificate string to the clipboard and click Next.

    Save this text to copy to the GPO Template.

  8. Provide the requested information on the Citrix Delivery Controller Information window.
    1. Type the XenDesktop environment domain name, domain administrator, and credentials.
    2. Click Test to validate the connection to the XenDesktop Controller server.
    3. Click Next.
  9. (Optional) : Edit the interval values on the Intervals and Timeouts page, and click Next.
  10. (Optional) : Configure the logging level and log rotation on the Configure the logging parameters page, and click Next.
  11. When the Service Configuration window appears, select Start/Restart, and then click Next.
  12. Review the configurations and click Finish to apply the configurations.

Results

The vRealize Operations for Published Applications broker agent is configured and available.

Note:

To configure the Broker-Agent to use a Read-Only/Custom Administrator account for XenDesktop Delivery Controller, go to Configure Broker Agent to use Non-Admin User for Citrix Desktop Delivery Controller.

What to do next

Verify the status of the vRealize Operations for Published Applications broker agent in the Windows Services Management Console.

Review the logs by browsing to the C:\ProgramData\VMware\VMware vRealize Operations for Published Apps\Broker Agent\logs directory.