Benchmark Factory for Database 7.6.1 - User Guide

Agent Connection

If the agent is having a problem connecting to the Benchmark Factory console, please check the following:

• Verify that the console is running.
• Verify that the agent is pointed to the console machine.  In the Agent dialog, go to Options | Settings and check the Machine Name/IP and the Console Port fields .  See Configure Agent Machine for more information.
• Verify TCP connectivity between the Agent and Console. If there is a firewall in place, allow for communication on port 4568 (or the specified console port). See Configure Firewall for Remote Agent Install/Start-Up for more information.

Licensing

The Benchmark Factory Licensing dialog allows you to enter a new license key, modify a license, or modify the virtual user pack.

The active license or licenses in Benchmark Factory determine the available features, including the ability to connect to certain types of databases. Benchmark Factory supports multiple licenses. This can enable multiple license-dependent features.

Note: If you delete an active Trial key from the Licensing dialog, any features enabled by the Trial key and not included in one of the remaining active licenses will be disabled.

To access the licensing dialog

1. Click Help | Licensing.

From this dialog you can:

• Enter a New License Key
• Modify the Benchmark Factory License
• Modify the  Benchmark Factory Virtual User Pack
• Upgrade Earlier-Version License Key

Enter a New License Key

To enter a new license key

1. In the Licensing dialog, click the blank tab.
2. Enter your Authorization key and the site message you received with your key.

Modify the Benchmark Factory License

If required, you can modify your Benchmark Factory license key.

To modify the license key

1. Click the tab for the product license key you want to modify.
2. Click Modify.
3. Update the Authorization Key and Site Message.

Modify the  Benchmark Factory Virtual User Pack

Benchmark Factory comes with 100 virtual users. Benchmark Factory Freeware comes with 20 virtual users.  To add up to an unlimited number of virtual users, enter a virtual user key.

To modify the Virtual User Pack

1. Click the Virtual User Pack tab.
   1. To send an email to Quest Software to extend a trial, click Extend Trial.
   2. To visit the Quest Software Web site and purchase a license, click Purchase License.
   3. To modify the current license, click Modify.
   4. Enter the authorization key and site message.

Upgrade Earlier-Version License Key

License keys compatible with Benchmark Factory 5.8.1 (or earlier) are no longer supported.

To upgrade your license key

1. Go to Help | Licensing to find your license number in your current version of Benchmark Factory. If not explicitly listed, it may be included as part of the Site Message associated with your key.

   Example: ACCOUNTNAME-nnn-nnn-nnn

2. Then go to the License Key Upgrade page: http://license.quest.com/upgrade.
3. Enter your e-mail address and your existing license number, and then follow the prompts.

If you need help finding your license number or an upgrade key, please contact the License Administration team: https://support.quest.com/licensing-assistance.

Licensing and Keys

The Benchmark Factory Licensing dialog allows you to enter a new license key, modify a license, or modify the virtual user pack.

The active license or licenses in Benchmark Factory determine the available features, including the ability to connect to certain types of databases. Benchmark Factory supports multiple licenses. This can enable multiple license-dependent features.

Note: If you delete an active Trial key from the Licensing dialog, any features enabled by the Trial key and not included in one of the remaining active licenses will be disabled.

To access the licensing dialog

1. Click Help | Licensing.

From this dialog you can:

• Enter a New License Key
• Modify the Benchmark Factory License
• Modify the  Benchmark Factory Virtual User Pack
• Upgrade Earlier-Version License Key

Enter a New License Key

To enter a new license key

1. In the Licensing dialog, click the blank tab.
2. Enter your Authorization key and the site message you received with your key.

Modify the Benchmark Factory License

If required, you can modify your Benchmark Factory license key.

To modify the license key

1. Click the tab for the product license key you want to modify.
2. Click Modify.
3. Update the Authorization Key and Site Message.

Modify the  Benchmark Factory Virtual User Pack

Benchmark Factory comes with 100 virtual users. Benchmark Factory Freeware comes with 20 virtual users.  To add up to an unlimited number of virtual users, enter a virtual user key.

To modify the Virtual User Pack

1. Click the Virtual User Pack tab.
   1. To send an email to Quest Software to extend a trial, click Extend Trial.
   2. To visit the Quest Software Web site and purchase a license, click Purchase License.
   3. To modify the current license, click Modify.
   4. Enter the authorization key and site message.

Upgrade Earlier-Version License Key

License keys compatible with Benchmark Factory 5.8.1 (or earlier) are no longer supported.

To upgrade your license key

1. Go to Help | Licensing to find your license number in your current version of Benchmark Factory. If not explicitly listed, it may be included as part of the Site Message associated with your key.

   Example: ACCOUNTNAME-nnn-nnn-nnn

2. Then go to the License Key Upgrade page: http://license.quest.com/upgrade.
3. Enter your e-mail address and your existing license number, and then follow the prompts.

If you need help finding your license number or an upgrade key, please contact the License Administration team: https://support.quest.com/licensing-assistance.

Adding Virtual Users

Benchmark Factory comes with 100 virtual users by default.  Benchmark Factory Freeware comes with 20 virtual users. Virtual users simulate the load against the system-under-test. 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 that includes transaction times and the number of times a transaction executes.

Benchmark Factory can scale up to an unlimited number of concurrent load users. Additional virtual users allow you to:

• Accurately determine system throughput and capacity for database systems
• Simulate thousands of concurrent users with a minimal amount of hardware
• Find applications that do not scale well with an increase in the number of users
• Find breaking points, weak links, or bottlenecks of a system
• Quantify application or server performance with realistic workloads

To request additional concurrent load users, please contact your Quest Software representative, or visit the Benchmark Factory Web site.