In this section:

Configuring the Settings

Jtest can be configured with settings (see Configuration Settings) that should be specified in a .properties file. The basic settings are listed in the jtestcli.properties  file shipped in <INSTALL_DIR>.  By default, most settings are disabled. Uncomment the settings you want to enable and specify the parameters.Alternatively, you can store the settings in a .properties file in your home directory <USER_HOME_DIR> to ensure that the settings you configured are not affected by re-installation or updates. If a setting is configured in both the installation directory and the user's home directory, the value configured in <USER_HOME_DIR> overwrites the value in <INSTALL_DIR>.

 You can also create a custom .properties file and pass it to the jtestcliwith the -settings switch. Use absolute paths to specify the custom .properties file. You can use the -settings switch multiple times to specify several .properties files. Entries with the same key will be overwritten.

jtestcli -settings path/to/settings.properties  -settings path/to/another/settings.properties

Settings Hierarchy

General settings are applied in the following order: 

1. <INSTALL_DIR>/etc/jtestcli.properties: the base configuration file that should not be modified.
2. <INSTALL_DIR>/jtestcli.properties: the main configuration file you can use to specify your settings; it contains a list of basic configuration settings (license, reporting, etc.) you need to uncomment before configuring the setting's value.
3. <USER_HOME_DIR>/jtestcli.properties: for your convenience, you can store the configuration file in your home directory to overwrite settings from the <INSTALL_DIR> (for example, to ensure your settings are not affected by re installations or updates).
4. <WORKING_DIR>/jtestcli.properties: for your convenience, you can store the configuration file in your working directory.
5. Custom settings passed with the command line switch -settings path/to/settings.properties (e.g., -settings ../settings.properties).
6. Custom settings passed with the command line switch -property [key=value] (e.g. -property "report.mail.enabled=true").
   

Ant and Maven Pattern

You can provide the path to the settings file with Ant or Maven using the following pattern:

<settings>path/to/settings.properties</settings>

Settings Hierarchy for Maven

If you use Maven, you can configure jtestcli settings with:

• -Djtest.[Maven property name] (e.g., -Djtest.settings="my.general.properties").
• the pom.xml file
• -Dproperty.[property name] (e.g., -Dproperty.dtp.url=https://server1.mycompany.com:8443)

Both -Djtest and pom.xml override settings that are passed with -Dproperty.jtest.

-Djtest overrides settings in pom.xml if they are provided as Maven properties. However, if a setting value is specified directly in pom.xml, it has the highest priority and cannot be overridden by command line settings. For example, the test configuration specified in pom.xml as a user property <config>${jtest.config}</config> can be overridden with -Djtest.config. If it is hardcoded as <config>builtin://Demo Configuration</config>, it cannot be overridden.

See Jtest Goals Reference for Maven for the complete list of parameters.

It is recommended that you keep all user-level customizations, including custom settings, license, rules, test configurations, compiler configurations, outside of the Jtest installation directory so they are not affected by reinstallations or updates.

Viewing Current Settings 

Use the -showsettings option to print the current settings and customizations, including the origin file for each configuration. 

Ant and Maven Pattern

If you use Ant or Maven, you can use the following pattern to view the current settings:

<showsettings>true</showsettings>

Auto-configuring Settings from DTP Server

You can specify settings in DTP and configure your Parasoft tool to use the settings when it connects to DTP Server. This enables you to use the same settings across multiple machines and configurations to ensure consistency. Edit the following setting in the .properties file to enable auto-configuration:  

dtp.autoconfig=true

Settings can be auto-configured for the entire organization or per project. 

Specifying Organization-wide Settings

1. Log into DTP with administrator credentials. 
2. Choose Report Center Settings from the settings menu.
   
3. Choose Global Tool Settings from the sidebar menu and enter the configuration settings from the.properties file in the space provided. Enter each setting on a new line. Use the # character to add comments.
   
4. Click Save.

Specifying Settings Per Project

1. Log into DTP with administrator credentials.
2. Choose Report Center Settings from the settings menu.
   
3. Click Projects in the Administration tab and click on a project. 
4. Enter the configuration settings from the .properties file in the Parasoft Tool Settings section. Enter each setting on a new line. Use the # character to add comments.
    
5. Click Save.

JVM, Framework, and Application Setup

The following table describes additional configuration files for setting up Jtest.