After you install the broker agent, you use the Broker Agent Configuration wizard to configure the broker agent on the Horizon Connection Server host where the broker agent is installed. 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 Horizon adapter instance. Pairing the broker agent with a Horizon adapter instance is a necessary authentication step that enables the broker agent and desktop agents to communicate with the Horizon adapter. The broker agent and desktop agents cannot communicate with the Horizon adapter until the pairing process is complete.

If you are monitoring multiple Horizon pods, you can pair the broker agent installed in each pod with the same Horizon adapter instance as long as the total number of desktops that the Horizon adapter instance handles does not exceed 10,000.

If your Horizon environment includes an events database, you must configure the broker agent to connect to the database. You can optionally configure the broker agent to monitor application pools and specific desktop pools.

Prerequisites

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

  • Verify that you have the server key for the Horizon adapter. You specified the server key when you created a credential for the adapter instance.

  • Verify that you have the IP address of the machine where you installed the Horizon adapter.

  • If your Horizon environment includes an events database, verify that the database format is supported. See Support for Oracle Databases that Provide Horizon Events.

  • To monitor specific desktop pools in Horizon, obtain the IDs for the pools. You can find pool IDs in Horizon Administrator. For more information, see the administration document for your Horizon version.

  • Verify that you are logged in to the Horizon Connection Server host with a domain user account. Local accounts do not have the necessary privileges to configure all settings.

Procedure

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

    By default, the broker agent uses port 3091 to communicate with the Horizon adapter. You can modify the default port number, depending on your network configuration.

  4. After entering the pairing key, click Pair to pair the broker agent with the Horizon adapter.

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

  5. After the pairing process succeeds, click Next.
  6. For Horizon 6.1 with Horizon or later, type and validate the user name, domain, and password of a Horizon Administrator account by clicking Test.

    A Horizon Administrator account is typically part of the local administrators group on the Windows server computer on which Horizon Connection Server is installed.

  7. If your Horizon environment includes an events database, type the credentials for that database.
  8. In the Horizon Pool Filter section, perform these steps to monitor specific desktop pools in vRealize Operations Manager, or click Next to proceed to the next dialog box.

    If you do not specify specific desktop pools, vRealize Operations Manager monitors all desktop pools.

    1. Select the Specify desktop pools check box and type the IDs of the desktop pools to monitor in the text box.

      Use a comma to separate each desktop pool ID.

    2. Select whether to include or exclude the listed desktop pools.
    3. Click Test to verify the list of desktop pools.
    4. To monitor application pools in Horizon 6.0 with Horizon or later, select the Monitor application pools and hosted applications check box.

      You cannot select specific application pools to monitor.

  9. Click Next. In the next dialog, if the default Intervals and Timeouts needs to be changed, select the Edit the Intervals and Timeouts checkbox and make the change.
  10. Click Next in the Configure the Logging parameters window and change the default logging parameters if required.
  11. Click Next.
  12. In the "Configure The Broker Agent Service" wizard, the Broker Agent service can be started here or it will be started in the last wizard.
  13. Select the broker agent settings that you configured appear in the Review Changes Wizard. Review the changes and click Finish. The configuration utility closes and the broker agent service is started.