The Benchmark Factory Agent is a component used in Benchmark Factory to create virtual users which simulate real-world user activity by placing transactions against the database-under-test. The Benchmark Factory Agent is installed when the Benchmark Factory Console is installed. In addition, you can install additional agents on other remote machines. Each Benchmark Factory agent can spawn multiple virtual-user sessions and Benchmark Factory can control hundreds of Agent machines.
After installing additional agents, use your Benchmark Factory Console to define a connection to each agent machine. When you create a new benchmark test through the Console, you can select which of the defined agents to use to generate the user load.
Each virtual user is a separate thread, acting independently of the other virtual users, with its own connection to the system-under-test. Each virtual user tracks its own statistics, including transaction times and the number of times a transaction executes.
The Benchmark Factory Console allows you to view information about all currently running agents, provides a way to connect to and manage remote agents, and allows you to specify some global agent settings. In addition, the primary Agent, Agent.exe, includes a GUI which displays transaction and virtual user statistics during test execution.
Benchmark Factory provides several types of agent components:
BMFAgent.exe—(Windows or Linux) The non-GUI agent. You can use BMFAgent.exe to integrate Benchmark Factory into your continuous integration or continuous testing process. See BMFAgent.exe for more information.
Review the following topics to learn how to use the Benchmark Factory Agent.
You must define a connection to each agent machine before you can use that agent in a Benchmark Factory test. The local Benchmark Factory Agent is defined by default. After installing a remote agent however, use this procedure to define a connection to the remote agent machine from the console.
To setup a new user agent
In the Setup Windows/Linux Agent dialog, enter the name or IP address of the computer where the agent is installed.
Tip: If you are using this dialog to install an agent on a Windows or Linux platform, enter the name or IP address of the computer on which you want to install an agent. Then see Install Remote Agent on Windows or Install Remote Agent on Linux for more instructions.
Use this page of the Settings dialog to do the following:
To specify Agent settings
Select Agent. Review the following for additional information:
|Setup New User Agent||
Click to setup a new agent or to install a remote agent on Windows or Linux.
List of agents
Displays the list of agents that have been set up in the console.
Use this area to specify the default agent machines to use by selecting the check box for each default agent. Also, specify the number of agents. These default settings are used when you create a new job.
If you do not select a default agent, the local agent is automatically selected when you create a new job in the New Job wizard.
Note: When you run a job using one or more local agents, if Agent utilization of resources on the local machine is too high, errors could occur.
|Remove||Click to remove the selected agent.|
|Verify Selected Agent||Verifies that the selected agent starts and communicates with console.|
Stop job when agent cannot be started/connected—Cancels job if agent does not start or connection is lost.
Do not select this option if you want to run a job using multiple agents AND you want the job to run even if one or more agents do not start.
|Agent communication timeout||Specify timeout duration in seconds.|
|Agent refresh interval||Specify how often each agent should refresh its status.|
You can install agents on remote computers from your Benchmark Factory console. You must be able to connect to the remote machine.
This procedure is designed for installing the agent on a Windows platform. To install the Benchmark Factory agent in a Linux environment, see Install Remote Agent on Linux.
To install a remote agent from the console
Enter the connection information for the remote machine. Review the following for additional information:
|IP Address / Name||Enter the IP address or name of the remote machine.|
Enter the user name to use to connect.
Note: Only accounts in the Administrators group on the remote machine can install or launch remote Agents. If in a domain, connect using a domain account in the Administrators group.
Enter the password to use to connect.
|Use Windows session credentials||
Select to use Windows credentials.
|# of Agents||Specify the number of agents to deploy on this machine.|
In the Installer field, browse to and select the Benchmark Factory installer.
Note: The Installer can be located on your local machine or on the remote machine.
Click OK. The installer installs the agent component on the remote machine.
Note: If the agent fails to install, you may need to configure the firewall or attempt one of the troubleshooting techniques. See Configure Firewall for Remote Agent Install/Start-Up.
In order to install remote agents and allow communication with remote agents after installation, you may need to configure the firewall on the console machine and on each agent machine. See Configure Firewall for Remote Agent Install/Start-Up to learn more.
If you configure the firewall and then encounter an error when attempting to install a remote agent, find some troubleshooting techniques here: Troubleshooting.