Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space FUNCTDEV and version SVC2022.1

...

  • Use DTP settings: Enable this option to use the connections settings specified in DTP. See Connecting to DTP
  • Server Name: Specifies a name for the server you are connecting to CTP. This is the name that will be used to identify this server within CTP.
  • CTP URL: Specifies the location of the CTP to which you are connecting (e.g., http://emdemo:8080).
  • Notify CTP of virtual asset deployment: Determines whether the  server notifies Parasoft CTP when virtual assets are first deployed.

  • Username: Specifies the username for logging into CTP.
  • Password: Specifies the password for logging into CTP.

    Note

    If OpenID Connect authentication is enabled, the Username and Password fields do not appear. Instead, you will see a notice that OIDC authentication is in use with a button to test that connection.

Global Data Source Settings

...

  • Default timeout (milliseconds): Allows you to enter the length of delay (in milliseconds) after which SOAtest should consider your FTP, telnet, or HTTP requests to be “timed out.” The default is 30000 milliseconds.
  • Report each duplicate error that occurs on the same line: Tells SOAtest to show only the first instance of duplicate errors that occur for the same line of code.
  • Reset Cookies: Allows you to clear the current global cookies so that next HTTP invocations start a new session.
  • Enable the Automatically backup project files option and specify a file size threshold for .tst and/or .pva files in the Warn on file size large than (MB) field to be notified when the size of the file exceeds the threshold. You can then reduce the size (and prevent performance problems) by dividing it into smaller files.

Anchor
OIDC
OIDC
OpenID Connect

The OpenID Connect panels allows you to configure the application to authenticate users via your OpenID Connect server.

...

Info

Azure Active Directory users: Enter the redirect URL configured above under "Mobile and desktop applications" in Azure AD. For example, if Callback host is set to "localhost" and Callback port is set to "Automatically select an open port" (the default values), you would enter "http://localhost/oauth2_callback" for the callback URL in Azure AD.

Proxy Settings

The Proxy panel controls how SOAtest and/or Virtualize works with proxy servers. It does not control the separate intermediary proxy used for web scenarios (for details on this other proxy, seeProxy Configuration Details). 

...

Configure global HTTP authentication properties that can be used when configuring HTTP protocols within an applicable tool.

  1. Enables Enable the Perform Authentication option and enter the Username and Password to authenticate the request
  2. Choose the authentication type from the drop-down menu. Supported types are Basic, NTLM, Kerberos, or Digest.
  3. If you are using Kerberos authentication, enter the Service Principal to authenticate the request. If the correct username and password, or the correct service principal, are not used, the request will not be authenticated.
    1. Kerberos realm: Specify the Kerberos realm associated with your network. By convention, this is typically your domain name in all caps (e.g. PARASOFT.COM).
    2. KDC server: Specify the hostname of your Key Distribution Center (e.g. kdc.parasoft.com).
    3. Check Ticket: This will execute a simple test to locate a cached Kerberos TGT (Ticket Granting Ticket) to grant access to the service. SOAtest and/or Virtualize will not be able to communicate with the service if it cannot first locate a valid TGT. For more information about Kerberos, see Configuring Kerberos Authentication.

...

Info
iconfalse
titleAvoiding Common Kerberos Errors

For tips on common Kerberos errors and how to solve them, see http://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/Troubleshooting.html.

Anchor
#ConfiguringKerberosAuthentication
#ConfiguringKerberosAuthentication
Configuring Kerberos Authentication for Tools

  1. Select the tool for which you intend to use Kerberos authentication.
  2. Select the Transport tab and select Security from the left pane of the Transport tab. 
  3. Configure the following options from the security panel of the Transport tab:
    1. Perform Authentication: Select this option to activate authentication.
    2. Use Global Preferences: Select this option if you have authentication properties setup in Security Preferences.
    3. Type: Select Kerberos to perform Kerberos Authentication.
    4. Service Principal: Specify the name of the service/server as defined in the Kerberos database (e.g. HTTP/soatest.parasoft.com).

...

There are two ways to define settings files:

  • Enter them manually in a simple text file simple text file. There are no name or location requirements. Each setting should be entered in a single line.
  • Export your GUI preferences, then adjust or extend them as needed. To export, choose Parasoft> Preferences, select Parasoft (the root element in the left tree), click the Share link, specify which settings you want to export.

Settings files can specify the following settings.

Licensing Settings

Info

Some of the settings described in this section have been deprecated.

SettingPurpose
virtualize.license.use_network=true|falseDetermines whether the current installation retrieves its license from LicenseServerLicense Server.
virtualize.license.network.host=[host]

Specifies the machine name or IP address of the machine running LicenseServer License Server Configuration Manager. If your server uses the HTTPS protocol, prepend https:// to the hostname.Example:

This setting is deprecated

virtualize.license.network.host=10.9.1.63

virtualize.license.network.host=https://10.9.1.63

virtualize.license.network.port=[port]

Specifies the LicenseServer License Server port number.

Example:

virtualize.license.network.port=2222This setting is deprecated

virtualize.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.url option.

This options requires the license.network.use.specified.server and license.network.auth.enabled options to be set to true.

Example: license.network.user=JohnDoe

virtualize.license.network.password=[password] 

Specifies the password for authentication on the secondary DTP server specified with the license.network.hostand license.network.port optionsurl option.

This option requires the license.network.use.specified.server and license.network.auth.enabled options to be set to true and the the license.network.user to be configured.

We strongly recommend encoding your password to ensure successful authentication and a secure connection. You can encode your password by running virtualizecli  with the -encodepass flag. 

Example:

virtualizecli -encodepass mypassword 

The command line tool will generate an encoded string that you can use in the configuration file. 

license.network.url=[url]

Specifies the License Server URL. Include the protocol and host name or IP address and, if appropriate, the port number and context path.

Example: https://10.9.1.63:8443

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. 

This setting is deprecated.

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 optionsurl option.

This option requires the license.network.use.specified.server option to be set to true.

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

This option enables Virtualize to connect to either DTP and License Server, or two instances of DTP simultaneously.

Set to false if you want to retrieve a license from the DTP server specified with Parasoft DTP Settings

Set to true and specify a license network connection type with the license.network.connection.type setting. If set to true, Virtualize will retrieve a license from the server specified with the license.network.host and license.network.port settingsurl option

virtualize.license.network.edition=[edition_name]

Specifies the type of license that you want this installation to retrieve from LicenseServer.

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

Example:

virtualize.license.network.edition=desktop_edition

virtualize.license.network.edition=server_edition

virtualize.license.autoconf.timeout=[seconds]Specifies the maximum number of seconds this installation will wait for the license to be automatically configured from LicenseServer. Default is 10.
virtualize.license.
local.expiration=[expiration]
Specifies the local license that you want this installation to use.
virtualize.license.local.password=[password]Specifies the local password that you want this installation to use.
virtualize.license.wait.for.tokens.time=[time in minutes]

Specifies the time that this installation will wait for a license if a license is not currently available. 

For example, use virtualize.license.wait.for.tokens.time=3 to configure Virtualize to wait three minutes for a license token to become available. 

...

SettingPurpose
env.manager.server

Specifies the location of the CTP server. Required

Example: env.manager.server=http://em_hostname:8080/

env.manager.server.name

Specifies the name that will be used to label this server on CTP. You can use whatever value will help you identify this server. Optional

Example: env.manager.server.name=MyVirtServerLabel

env.manager.notify

Determines whether the Virtualize server notifies Parasoft CTP when virtual assets are deployed. Optional

Example: env.manager.notify=true

env.manager.username

Specifies the username for logging into CTP. Optional

Example: env.manager.username=me

env.manager.password

Specifies the password for logging into CTP. Optional

Example: env.manager.password=12345

Miscellaneous Settings

Info

Some of the settings described in this section have been deprecated.

SettingPurpose
dtp.autoconfig=true|false

Enables autoconfiguration with Parasoft Test settings stored on the DTP server.

Default: false

dtp.enabled=true|false

Determines whether the current Parasoft Test product is connected to DTP.

Default: false

Determines whether the current Parasoft Test product is connected to DTP.

Default: false

dtp.url=[url]Specifies the URL of the DTP server. Include protocol and host name or IP address and, as appropriate, port and context path.
dtp.server=[host]Specifies the host name of the DTP server. This setting is deprecated.
dtp.port=[port]Specifies the DTP server port. This setting is deprecated.
console.verbosity.level=low|normal|high

Specifies the verbosity level for the Console view. Available settings are:

low: Configures the Console view to show errors and basic information about the current step’s name and status (done, failed, up-to-date).

normal: Also shows command lines and issues reported during test and analysis.

high: Also shows warnings.

parallel.mode=Manual|Auto|Disabled

Determines which of the following modes is active:

  • Auto: Allows the product to control parallel processing settings.
  • Manual: Allows you to manually configure parallel processing settings to suit your specific needs.
  • Disabled: Configures the product to use only one of the available CPUs.
parallel.max_threads=<number>

Specifies the maximum number of  parallel threads that can be executed simultaneously. The actual number of parallel threads is determined based on the number of CPUs, available memory, and license settings.

parallel.free_memory_limit=<percentage>Specifies the amount of memory that should be kept free in low memory conditions (expressed as a percentage of the total memory available for the application). This is used to ensure that free memory is available for other processes.
parallel.no_memory_limit=true|falseIndicates that you do not want to place any restrictions (beyond existing system limitations) on the memory available to the product.
tasks.clear=true|falseClears existing tasks upon startup in cli mode. This prevents excessive time being spent "loading existing results." The default is true.
security.trust.all.certificates=true|falseTells Virtualize that you want it to accept any certificate. This is useful if you want to load pages whose certificates are not "trusted."
security.use.default.java.cacerts=true|falseTells Virtualize that you want it to accept only certificates from the standard list of Java trusted certificate vendors.

...

  1. If you will be using a custom edition license, define the appropriate license features in the settings as follows:
    [product].license.custom_edition_features= All enabled features
    Note that license feature settings apply only to custom edition licenses.
  2. Define the main license settings in the settings as follows:

    Code Block
    virtualize.license.network.edition= [Type of license edition] 
    virtualize.license.use_network= [Value (true or false)] 
    license.network.host= Host name
    license.network.port= Port numberurl=[URL]

    If your server uses the HTTPS protocol, prepend https:// to the hostname.

...

Code Block
virtualize.license.network.edition=desktop_edition 
virtualize.license.use_network=true
license.network.hosturl=http://main1.parasoft.com.pl 
license.network.port=:2222

Virtualize network license -custom edition with various features

Code Block
virtualize.license.custom_edition_features=Virtualize, Server, Message Packs, Unlimited Million Hits / Day
virtualize.license.network.edition=custom_edition
virtualize.license.use_network=true
license.network.hosturl=http://main1.parasoft.com.pl
license.network.port=:2222

Virtualize network license -custom edition with various features

...