Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Each setting should be entered on a single line.
  • We highly recommend that you use encoded passwords to ensure successful authentication and increase the level of security; see Creating an Encoded Password.
  • If you are importing preferences from localsettings specified on DTP and you want to override these settings from the GUI, you can clear the Use DTP settings option on the appropriate page, then manually configure the settings.
  • If any localsettings problems are detected during a test run, details will be reported in the command line output.
  • If you are running cli mode from a developer/tester desktop (as opposed to from a Server machine), use the tasks.clear=false option to ensure that your results from previous runs are preserved.

...

SettingPurpose
dtp.enabled=true|false

Determines whether the current C/C++test installation is connected to DTP.

dtp.server=[server]Specifies the host name of the DTP server.
dtp.port=[port]Specifies the port number of the DTP server.
dtp.user=[username]Specifies the username for DTP server authentication.
dtp.password=[password]Specifies the password for DTP server authentication. We highly recommend that you use an encoded password to ensure successful authentication and increase the level of security; see Creating an Encoded Password.
dtp.context.path=[path]Specifies the path to DTP. The context path is a relative path from the host name specified with the dtp.server setting. This setting should only be configured if DTP is deployed to a location other than the root of the host server, which may be the case if your organization uses a reverse proxy.
report.dtp.publish=true|falseEnables or disables reporting results to DTP server.
dtp.project=[project_name]Specifies the name of the DTP project that you want these results linked to.
dtp.additional.settings=[KEY1\=VALUE1\nKEY2\=VALUE2...]Specifies advanced settings for reporting results to DTP.
dtp.autoconfig=true|falseEnables autoconfiguration with C/C++test settings stored on the DTP server

...

SettingPurpose
parasoft.eula.accepted=true|false

Allows you to accept the terms of Parasoft End User License Agreement (EULA).

Default: false

cpptest.license.use_network=true|false

Enables or disables retrieving a network license.

Example: cpptest.license.use_network=true

Default: true

(info) By default, C/C++test will try to retrieve a license form License Server on the DTP configured as your primary DTP server; see Parasoft DTP Settings. If you want to configure another License Server, enable the license.network.use.specified.server option.

cpptest.license.local.password=[password]Specifies the local password that you want C/C++test to use. 
cpptest.license.local.expiration=[expiration]

Specifies the expiration date of the local license.

Default: 0

cpptest.license.network.edition=[edition_name]

Specifies the type of license that you want C/C++test to retrieve from License Server. 

[edition_name] can be automation_edition. To use a custom edition, do not set anything after the "="; simply leaving the value empty.

Example:

cpptest.license.network.edition=desktop_edition

cpptest.license.network.edition=automation_edition

Default: custom_edition

cpptest.license.custom_edition_features=[feature name]Specifies the features you want to enable in the custom edition of the C/C++test license.
cpptest.license.wait.for.tokens.time=[time in minutes]

Specifies the time that C/C++test will wait for a license if a license is not currently available. 

For example to make C++test  wait 3 minutes for license tokens, use cpptest.license.wait.for.tokens.time=3.

Default: 0

cpptest.license.autoconf.timeout=[seconds]

Specifies the maximum number of seconds C/C++test will  wait for the license to be automatically configured from License Server.

Default: 20

license.network.use.specified.server=true|false

Enables or disables retrieving the license from a custom License Server specified with the license.network.host and license.network.port options.

Example: license.network.use.specified.server=true

Default: false

license.network.host=[host]

Specifies the host name of the standalone License Server,  secondary DTP, or legacy License Server that you use to obtain the license. It requires the license.network.use.specified.server option set to true.

Example: license.network.host=jade.mycompany.com

(info) If you retrieve the license from a standalone License Server that uses the HTTPS protocol, precede the hostname with https://.

license.network.port=[port]

Specifies the port number that is assigned to License Server specified with the license.network.host option.

  • For a standalone License Server:  Depends on your Tomcat settings; typically, a  HTTP port, for example, 8080.
  • For License Server on secondary DTP: Typically, a HTTPS port, for example 443 or 8443.
  • For legacy License Server: Typically, 2002.

Example: license.network.port=2222

license.network.context.path=[path]

Specifies the path to the DTP License Server. The context path is a relative path from the host name specified with the license.network.host setting. This setting should only be configured if DTP is deployed to a location other than the root of the host server, which may be the case if your organization uses a reverse proxy.

Configuring the context path is not supported for standalone License Server.

Refer to the DTP documentation for additional information about reverse proxy server configuration and context path configuration.

Example: license.network.context.path=/foo/bar

license.network.connection.type=[http|tcp]

Specifies the connection type if you obtain your license from a custom License Server.

http: Allows you to obtain the license from a standalone License Server or License Server on secondary DTP.

tcp: Allows you to obtain the license from Legacy License Server.

It requires the license.network.use.specified.server, license.network.host, and license.network.port to be enabled.

Example: license.network.connection.type=http

license.network.auth.enabled=true|false

Enables or disables authentication on the secondary DTP server specified with the license.network.host and license.network.port options.

It requires the license.network.use.specified.serveroption to be set to true.

license.network.user=[username]

Specifies the username for authentication on the secondary DTP server specified with the license.network.host and license.network.port options. It requires the license.network.use.specified.server and license.network.auth.enabled options set to true.

Example: license.network.user=JohnSnow

license.network.password=[password]

Specifies the password for authentication on the secondary DTP server specified with the license.network.host and license.network.port options. It requires the license.network.use.specified.server and license.network.auth.enabled options set to true, and the the license.network.user to be configured. We highly recommend that you use an encoded password to ensure successful authentication and increase the level of security; see Creating an Encoded Password.

Example: license.network.password=Wic2019!

...

SettingPurpose
oidc.enabled=true|false

Enables or disables user authentication via OpenID Connect.

The default is false.

oidc.issuer.uri=[uri]Specifies the URI of the OpenID Connect server where your DTP is registered.
oidc.client.id=[id]Specifies the ID registered on your OpenID Connect server.
oidc.client.secret=[password]Specifies the password provided by your OpenID Connect server.
oidc.keystore=[path]

Specifies the path to the keystore file that stores the certificate to authenticate the user on the OpenID Connect server.

oidc.keystore.password=[password]Specifies the password to the the keystore file that stores the self-signed client certificate. We highly recommend that you use an encoded password to ensure successful authentication and increase the level of security; see Creating an Encoded Password.
oidc.keystore.alias=[alias]

Specifies the alias you want to use to authenticate on the OpenID Connect server. You may need to configure this setting if your keystore file contains multiple entries.

Example: oidc.keystore.alias=grs

oidc.callback.host=localhost | 127.0.0.1

This setting specifies the local callback host configured in the IDE to communicate with the OpenID Connect server.

(info) This is an IDE-related setting and is not intended for command line use.

The default is localhost.

oidc.callback.port=0 | [port number]

This setting specifies the callback port number configured in the IDE to communicate with the OpenID Connect server.

(info) This is an IDE-related setting and is not intended for command line use.

0: The port will be automatically configured.

The default is 0.

oidc.callback.timeout=[seconds]

This setting specifies the maximum time allowed for providing user credentials on the authentication page to authenticate on DTP via OpenID Connect when working with C/C++test in the IDE.

(info) This is an IDE-related setting and is not intended for command line use.

The default is 60.

...