System Configuration

The Tools -> Options dialog box lets you specify a number of important properties to control Web Test behavior. Properties configured here are applied to all the projects in the test. Following is a description of the various tabs and properties found in them.



Number of Recent Project Files: Specify the number of project files to show in the most recently used menu list. The default is 5.

Number of Recent Result Files: Specify the number of result files to show in the most Recently used menu list. The default is 5.

Screen Refresh Interval(sec): Here you can specify the time interval after which the Status views should be refreshed during load test execution. Application updates the status charts after every refresh interval provided here.

Highlight Row/node on mouse over:This setting is for highlighting the current row you are browsing or the current node you are visiting in AppPerfect product.

Save Result: Define your results-save strategy here. You can configure to save result for each project run automatically or to save just last run of the project. Default value is to not save result automatically.

User Name: Shows the name of the user configured in AppPerfect Test Manager. Multiple users can be configured with AppPerfect Test Manager and each client AppPerfect product can use unique user name to submit results/ projects to Test Manager. This user name is used as identifier and is helpful in generating user based reports in Test Manager. In case connection to Test Manager is not configured Or if there is only single user configured in Test Manager then this field is un-editable.

Garbage Collector Settings

To control the memory usage of application during execution you can configure Garbage collector settings here. AppPerfect takes care of forcing the garbage collection once the specified limit is reached. You can also configure how often AppPerfect should check for memory consumption.

Font Settings

You can set your own font for AppPerfect Load Test.

Update Schedule

Application can be configured to check for new updates/release of the AppPerfect product. On finding one application notifies the user about the availability of same. Keeping this feature enabled ensures that you are using latest version of the product.

Browsers, JDKs & DBs

Browser Settings

AppPerfect supports recording of test on multiple browsers including Internet Explorer, Firefox and Safari Here you can configure browser which application should use to perform recording. The one selected as default is used for recording of the test. AppPerfect also uses the browser configured here to open Help files and exported results/reports. You should have proper browser configured for application to work correctly.

JDK Settings

Specify your JDK's name and path here. AppPerfect will use the default JDK specified at the time of installation. You may want to use other JDKs for your applications and those can be defined and used from here.

DB Connections

You can configure Database related properties like Database name, Connection URL, JDBC driver, User Name, password etc. here. This is useful in case you need to fetch values from database to parameterize your test. Database configuration is also required in case you need to add Database validation in test or in case you need to Load Test Database.

Custom Certificates

In case your application uses a custom SSL certificate (i.e. certificate not provided by Verisign or Thawte), then either you need to make that custom certificate trusted by the JVM running AppPerfect product or you may select the option to "Accept Self-signed or untrusted custom SSL certificates."

To make the custom certificate trusted by the JVM running AppPerfect product, you need to add the SSL certificate here. AppPerfect uses this certificate when running your test. Certificates provided by Verisign or Thawte are automatically trusted by the "trust file" within the JVM. All other certificates are considered custom SSL certificates. If you are using a Custom certificate, you will need to import that certificate into AppPerfect. In case you don't have the certificate file, open your HTTPS link in a browser and then click on the "lock" icon. This will pop up a dialog box with "Certificate" title & General tab selected. Go to Details tab and select "Copy to File..." option. Proceed with the wizard. On Export file format select "Base-64 encoded..." radio button. Save it to some temporary location and import this certificate file. Please note that you will be required to restart AppPerfect product after registering custom certificate.

Custom Script Settings

AppPerfect uses javascript as its scripting language. You can add your own custom code to the recorded test script.To use any custom classes in the script files you should configure the classpath of those custom classes here. You can provide the path for either the zip/jar file or can provide the path for the folder containing the custom classes.

Load Test

General Details

Use Cookies: You can choose to disable cookies for your Load Tester tests by de-selecting the checkbox.

Decode Post Parameters: Select this option in case you want application to decode the post parameters before sending request to the server during execution.

Decode Request Headers: Select this option in case you want application to decode the request headers before sending request to the server during execution.

Decode Get/Post Parameters while recording: Select this option in case you want application to decode the get/post parameters during recording.

Compare response code with recorded response code to identify whether the task is successful or failed: Select this option in case you want application to compare recorded response code with replayed response code while finding task's execution status.

Data Consolidation count: To show charts in the results, By default application consolidates data after recording every 32 values while collecting statistics. You can configure the consolidation count here after which the data consolidation should be performed.

Remote Server port : Here you can provide the port which should be used for collecting execution results from remote machine during Remote execution of projects. By default the port used is 8669, in case this port is not free and is in use by some other application, you should change the port here to use some free port.

Save failed response data on disk: Select this option in case you want application to save failed responses on disk.

Save header, parameter details for failed tasks: Select this option in case you want application to save headers and parameters details for failed tasks.

Save sub tasks details for failed tasks: Select this option in case you want application to save sub tasks details for failed tasks.

Save failed response data on disk: Select this option in case you want application to save failed responses on disk.

Filter Settings: If while recording, you want to filter out certain patterns, then you can add them here. Separate the patterns using commas. If the list of patterns to include is smaller than the list of patterns to exclude, then you can provide the 'include' pattern and vice versa. For instance, if you want to record only '.html' files and no other like '.gif' or '.jpeg' etc.. then just provide '.html' in the 'Patterns to Include' field.

Response Codes

What you see here by default is the list of the standard HTTP Response Codes and their description which the user will see. You can decide the behavior of these response codes here using the checkbox 'Treat as Success'.

SubTask Extensions

While recording subtasks in the test, application check for the extension of the task. You can configure the task extensions here which should be marked as subtasks during recording.

PassThrough Resolution - Extensions

In case a parameter is a passthough parameter then application parses the response of previous tasks to find the value of that passthrough parameter. Here you can configure the extensions of the tasks which should be considered for parsing for resolving the values of passthrough type parameters.

You can also add your own response codes for specific testing.


License related settings are done here. You can configure license for either single client machine or can configure the product to pick the license from Floating license server in case you have purchased Floating license. Floating licenses are managed using License Manager in AppPerfect Test Manager.

Log Settings

AppPerfect maintains logs of fatal exceptions for all the products. You can change this setting here to log all messages. This option is very useful for debugging purposes. It is recommended that you use this feature in case you are facing any issues with the product and send us the log files. By default log files are saved at: <AppPerfect_Home>/logs. You can configure to change the log path and save logs at different location. Application can also log the values from the test script. For each log statement in test script you will find output getting logged in script_log.txt. The script log can be used to check the values getting used during parameterized test.

Select the checkbox 'Log Requests Fired' if you want to log each request fired in AppPerfect Load Test. This is useful for checking various details about the requests like the User Agent, IP Address etc. All the requests will be saved to requests.txt file under <AppPerfect_Home>/logs folder.

Proxy Settings

General Settings

To record Load Test with browser application uses Proxy Recording.

AppPerfect Proxy Server Settings

AppPerfect starts its local proxy server and sets same in target browser. By default Application uses localhost and port 8690 to start the local proxy server. In case default port is in use by some other application you can change it to some other value here.

AppPerfect can automatically launch and configure proxy settings in your web browser wherever possible. If you want to do that yourself, deselect the checkbox 'Automatically launch and configure browser for recording.'

Target Proxy Server Settings

These settings are required if you do not have a direct connection to the Internet and you normally use a proxy server to access your application. The browser's current proxy settings have to be specified here. By default AppPerfect assumes a direct connection to the Internet.

Filter Settings

These settings are required in case of Proxy Recording. All the patterns which are marked as excluded here are not recorded while recording. Application by default adds common update services installed on machine which are not part of your application and these requests should be dropped while recording tests. You can extend this list to add more patterns which you would like to exclude during recording.

Server Connection

Test Manager Settings

AppPerfect Test Manager settings are done here. AppPerfect Test Manager provides functionality of requirement, project, results and issues management. It allows to schedule various project executions, view results, export them to various formats, add/manage test requirements and add/manage issues in the product. AppPerfect Test Manager by default runs on port 8744 and can be accessed as http://HOST_NAME:8744/AppTestManager.

Product's Service Settings

Product related service settings are configured here. Each Load Test product also installs a product service which listens to requests from other Load Test product installations on remote machines while performing remote execution. This service by default runs on port 8874 and can be accessed as http://HOST_NAME:8874/AppService

Repository Settings

AppPerfect Repository Settings is required to share AppPerfect projects across the team. AppPerfect provides support for Subversion(SVN) server for sharing projects across team. AppPerfect Repository server by default runs on port 8747 and can be accessed as svn://HOST_NAME:8747/AppRepository in case repository is created with "AppRepository" as the root folder. For complete details on configuration of Team or Repository Server refer to Team Server Configuration