System Configuration

The Tools -> Options dialog box lets you specify a number of important properties to control Java Profiler 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.

AppPerfect

General

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 views should be refreshed while profiling. Application queries for latest profiling data from target application after every refresh interval and updates the profiler views.

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 Java Profiler.

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

Here you can configure browser which application should use 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.

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.

Java Profiler

View Settings

Show fully qualified names in Method Signatures: Select this option if you want to see fully qualified names in method views. Otherwise, by default, Java Profiler will show abbreviated method signatures.

Record URLs for memory leak scenarios: Select this option in case you are profiling Server application and need to record urls as you navigate though them in browser during memory leak scenarios. Application uses Proxy Recording to record these url requests.

Profiler Agent Settings

These settings are required by the AppPerfect Java Profiler to fine tune your application's profiling.

Connection Timeout: This value specifies the time you want AppPerfect Java Profiler to wait for receiving some data or establishing connection to your application before timing out. If you never want Java Profiler to time out while profiling, you can choose 'Indefinite'.

Allocations Trace Depth: The value entered here will define the depth to which allocations will be traced. The minimum value you can enter here is 1. The maximum value is 20. Please note that the allocations depth will depend first on the actual allocations tree. If the value specified here exceeds allocations depth, then it will be ignored.

Method Call Stack Depth: This is same as 'Allocation Trace Depth' except that it is used for Method calls and not Allocations. The minimum value allowed is 1 and maximum is 20.

Agent Port: This port is used by Java Profiler to connect to the profiling agent. Please change the default value 8677 if its already in use by some other application on the system.

Filter Settings

You can filter the profiling data in Java Profiler based on components like Servlets, JSPs, EJBs, JDBC, JMS, JNDI etc. All the interfaces and classes defined here are used to identify components. You can configure new component setting here by providing the base class for that component. Application will take care of filtering the profiling data for that component by looking at all the implementing classes for this component.

Licenses

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.

Proxy Settings

General Settings

Select this option in case you are profiling Server application and need to record urls as you navigate though them in browser during memory leak scenarios. Application uses Proxy Recording to record these url requests.

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 Java Profiler product also installs a product service which listens to requests from other Java Profiler product installations on remote machines while performing remote execution. This service by default runs on port 8834 and can be accessed as http://HOST_NAME:8834/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