Page tree
Skip to end of metadata
Go to start of metadata

Agentless collection, or proxy data collection, enables a computer to act as a proxy host and collect data from other computers without having to install BMC TrueSight Capacity Optimization on those computers. You can collect data using a Windows proxy host, a VMware ESX proxy host, or vCenter Server proxy host. You can also use a proxy host to collect data for specific components, such as Investigate, Manager, Collect Data, and the Best1Collect command. The advantages of proxy data collection include:

  • Fewer computers to deploy.
  • Fewer computers to manage.
  • Minimal footprints on the agentless computers.

For more information about collecting BMC TrueSight Capacity Optimization data using proxy hosts, see: 

For information about the recommended resources required for proxy data collection, see Sizing guidelines for BMC TrueSight Capacity Optimization proxy collection agents.

Proxy data collection terms

The following table defines a few of the terms related to proxy data collection:

Proxy terminology



Proxy host

The computer configured as the proxy to manage the agentless computers.

Agentless computer

Computer that does not have Perform Agent installed and is therefore being managed by the proxy host.

Proxy domain

The domain that contains the agentless computers. This is defined for the Microsoft Windows proxy host.

Logical domain

The domain that contains the agentless ESX servers. This is defined for the VMware ESX proxy host.

Outline of the proxy data collection process

These steps provide a basic outline of what you need to do to configure and implement proxy data collection in your environment.

  1. Determine the domains and computers you want to manage.
  2. Gather information about all the computers in the domain, such as computer name, username, and password.
  3. Identify which computers you want to manage.
  4. Identify the computers to use as proxy hosts. They must have Perform Agent installed.
  5. Determine the domain accounts and privileges necessary for proxy hosts. See Knowing Domain accounts and privileges for specific requirements.
  6. Create a list of agentless computers for each proxy host.
  7. Identify which proxy host will manage which agentless computers.
  8. Prepare the configuration file (agentlessComputers.cfg) with the list of agentless computers that are candidates for proxy data collection. See Populating the proxy data collection configuration file.
  9. Enable proxy data collection. See Enabling proxy collection, history, and selecting the VMware proxy type for the full procedure.
  10. Configure each proxy host computer using PATROL - Perform Agent, accessible from Start > Settings > Control Panelon the proxy host computer. Depending on your proxy host type, see one of the following for more information:
  11. Perform a sample data collection to verify that all agentless computers can be discovered and that data is collected from them.


    If you are using a VMware ESX or vCenter Server proxy host, you might require additional preparation. For details see, [Deprecated] Setting up VMware ESX and vCenter Server proxy data collection.

Preparing for proxy data collection

This section covers step 8 and step 9 of Outline of the proxy data collection process. It assumes you have completed all necessary research and design decisions (steps 1 through 7) and are ready to begin implementation. After you complete these tasks, you can continue with steps 10 and 11, configuring the proxy host and performing a sample data collection. 

The tasks described in this section are:

Populating the proxy data collection configuration file

The configuration of proxy hosts for proxy data collection is a post-install activity. A configuration file, agentlessComputers.cfg, lets you control the scale of service provided by a given proxy host. This file limits the set of agentless computers from which a proxy host can collect data. By default the file is located in C:\Program Files\BMC Software\Patrol3\BEST1versionNumber\local\setup.


For optimal performance and reliability of the proxy data collection process, consider the recommendations outlined in Collecting data using Proxy Agents, prior to populating the configuration file.

The configuration file is initially empty. After you decide how to deploy proxy data collection for your system, populate the configuration file with a list of agentless computers that are enabled for proxy collection. Specify the name, domain, and (optional) enable history collection for each agentless computer.



agentless computer

Name of the agentless computer from which you want to collect data.


Name of the domain or vCenter Server to which the agentless computer belongs.

history enabled

Boolean value that indicates whether the History feature is disabled (0) or enabled (1).

The format of the file, with example entries, follows. Commented lines are preceded by a pound (#) sign:

# comment line
# format : one agent less computer per line
# contents: agentless computer,domain,history enabled(0 or 1)
# example:
# calbro1,development,1
# calbro2,development,0


The contents of the agentlessComputers.cfg file is read at agent startup and stored in memory. Changes to the list requires an agent restart in order for the modifications to take effect. The content of this file is case-sensitive.

After the configuration file is populated with the list of agentless computers, use PATROL - Perform Agent to enable proxy collection and then configure the proxy host.

Enabling proxy collection, history, and selecting the VMware proxy type

Perform the following procedure on each computer that you use as a proxy host.

  1. From Start > Settings > Control Panel, select PATROL - Perform Agent.
  2. Click the Agent tab.
  3. (Optional) In the History section, select to enable or disable history collection for the proxy host, and specify where to save the history files. This option is enabled by default, and the default location of the history file is: C:\Program Files\BMC Software\Patrol3\BEST1versionNumber\History.
  4. Select Enable Proxy Collection Service.
  5. Perform one of the following actions:
    • If you want the proxy host to collect data directly from ESX servers, from the Collect VMware proxy data via list, select VMware ESX server.
    • If you want the proxy host to collect data from a vCenter, from the Collect VMware proxy data via list, select vCenter.


      Use vCenter Server to discover and collect data from ESX servers.

  6. Click OK.
    Your changes are saved, and PATROL - Perform Agent Setup closes.

Restarting Perform Agent

Whenever a change is made to the configuration of a proxy host, including during the initial setup, the Perform Agent application must be restarted.

This occurs automatically after you click OK. A message box appears to inform you that the agent is restarting and a second message appears to let you know if the restart was successful.

If you are notified that the restart failed, you must restart Perform Agent manually (from Start > Settings > Control Panel > PATROL - Perform Agent.) in order for your changes to take effect.

1 Comment