In this section:
Configuring the Settings
dotTEST can be configured with settings (see Configuration Settings) that should be specified in a .properties file. The basic settings are listed in the dottestcli.properties file shipped in [INSTALL_DIR]. By default, most settings are disabled. Uncomment the settings you want to enable and specify the parameters. Modifying the .properties file may require administrator privilages.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 dottestcliwith the -settings switch. You can use the -settings switch multiple times to specify several .properties files. Entries with the same key will be overwritten.
dottestcli.exe -solution "C:\Devel\FooSolution\FooSolution.sln" -settings "C:\Devel\Settings\dtp_server.properties" -settings "C:\Devel\Settings\email_server.properties"
File path convention on Windows
Use double backslashes to specify file paths in the .properties file on Windows. For example:
configuration.dir.user=C:\\parasoft\\2018\\configs\\user
Configuring passwords
We highly recommend that you use encoded passwords to ensure successful authentication and increase the level of security; see Creating an Encoded Password.
Settings Hierarchy
General settings are applied in the following order:
[INSTALL_DIR]/etc/dottestcli.properties: the base configuration file that should not be modified.[INSTALL_DIR]/dottestcli.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.[USER_HOME_DIR]/dottestcli.properties: for your convenience, you can store the configuration file in your home directory (%USERPROFILE% directory) to overwrite settings from the [INSTALL_DIR] (for example, to ensure your settings are not affected by re-installations or updates).[WORKING_DIR]/dottestcli.properties: for your convenience, you can store the configuration file in your working directory.- Custom settings passed with the command line switch
-settings path/to/settings.properties(e.g.,-settings "../settings.properties"). - Custom settings passed with the command line switch
-property [key=value](e.g.-property "report.mail.enabled=true").
-report, -config, etc.If you have dotTest 9.5 or later, settings can be prepared in Visual Studio and exported to a *.properties file.Viewing Current Settings
Use the -showsettings option to print the current settings and customizations, including the origin file for each configuration.
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
- Log into DTP with administrator credentials
- Switch to Report Center and choose Report Center Settings from the menu.
- Go to Additional Settings> Report Center Administration.
- Choose Settings> Parasoft Test Global Settings and enter the settings from the
.propertiesfile.
- Click Save.
Specifying Settings Per Project
- Log into DTP with administrator credentials
- Switch to Report Center and choose Report Center Settings from the menu.
- Choose Projects> Search and click Search.
- Click on your project name in the results and click the Parasoft Test Settings tab
- Enter the settings from the
.propertiesand click Save.
