...

You can also set this property after the server has been started using the REST API. Note that settings related to CTP in the .properties file are named "env.manager", which refers to the legacy name Environment Manager. The CTP object in the API, however, is labeled "ctp". These settings refer to the same component.

Click Try it out and enter the Continuous Testing Platform (CTP) server settings as a JSON object into the input field.
Image Removed

You can copy the following example JSON, paste it into your input field, and change the values to your installation:

fileName="${sys:catalina.home}/logs/soavirt_access.log"

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
 
  <Appenders>
    <Console name="CONSOLE" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{dd-MMM-yyyy HH:mm:ss,SSS} [%p] %m at %l%n" />
    </Console>
 
    <!-- Uncomment this appender when using access logs
    <RollingFile name="ACCESS" fileName="${sys:catalina.home}/logs/soavirt_access.log" filePattern="${sys:catalina.home}/logs/$${date:yyyy-MM}/access-%d{MM-dd-yyyy}-%i.log.gz">
        <PatternLayout pattern="%d{dd-MMM-yyyy HH:mm:ss,SSS} [%p] %m%n" />
        <Policies>
            <TimeBasedTriggeringPolicy />
            <SizeBasedTriggeringPolicy size="50 MB"/>
        </Policies>
    </RollingFile>
     -->
 
  </Appenders>
 
  <Loggers>
    <Logger name="com.parasoft" level="INFO">
      <AppenderRef ref="CONSOLE" />
    </Logger>
    <!-- Set level to "trace" to enable access logs -->
    <Logger name="com.parasoft.webtool.rest.api.web.providers.access.logs" additivity="false" level="off">
      <!-- Uncomment to direct to access log file
      <AppenderRef ref="ACCESS" />
        -->
    </Logger>
    <Logger name="com.parasoft.ptest.lic.client.internal" level="off" />
    <Logger name="com.parasoft.ptest.lic.client.validator" level="off" />
    <Root level="off" />
  </Loggers>
 
</Configuration>

{
  "ctp": {
    "server": "<your-ctp-server>:<port>",
    "name": "<your-ctp-server-name>",
    "username": "<your-username>",
    "password": "<your-password>",
    "notify": false,
  }
}

{
  "ctp": {
    "server": "<your-ctp-server>:<port>",
    "name": "<your-ctp-server-name>",
    "username": "<your-username>",
    "password": "<your-password>",
    "notify": false,
  }
}

env.manager.server. name

This option specifies the name that will be used to label this server on CTP. You can use any value that helps you identify this server. 

Example Usage

env.manager.server.name=MyVirtServerLabel

Setting the Property with the REST API

You can also set this property after the server has been started using the REST API. See env.manager.server for details.

env.manager.username

This option specifies the username for logging into CTP.

Example Usage

env.manager.username=me 

Setting the Property with the REST API

You can also set this property after the server has been started using the REST API. See env.manager.server for details.

env.manager.

This option specifies the (plain text or encoded) password for logging into CTP. 

We strongly recommend encoding passwords to ensure successful authentication and a secure connection. The WAR distribution contains a script that can encode passwords. To use it, run:

<SOAVIRT_HOME>/scripts/encodepass.sh <YOUR_PASSWORD>

or

<SOAVIRT_HOME>/scripts/encodepass.bat <YOUR_PASSWORD>

as appropriate for your OS.

You can also run a command line instance of SOAtest or Virtualize with the -encodepass flag. Examples:

soatestcli.exe -encodepass <YOUR_PASSWORD> 

virtualizecli.exe -encodepass <YOUR_PASSWORD> 

Either method will generate an encoded string that you can use in place of the password property in the SOAtest and Virtualize Server configuration file. See CLI Options for additional information about command line options.  

Example Usage

env.manager.password=12345

Setting the Property with the REST API

You can also set this property after the server has been started using the REST API. See env.manager.server for details.

env.manager.notify

This option enables/disables notifications to Parasoft CTP when virtual assets are deployed.

Example Usage

The following example enables notifications:

env.manager.notify=true

Setting the Property with the REST API

You can also set this property after the server has been started using the REST API. See env.manager.server for details.

env.manager.registry.id

This is a read-only setting used by CTP. 

soatest.license.enabled

This option enables/disables the license related to SOAtest functionality. The default is true. If this option is not present in the .properties configuration file, the default is used. If this option is set to false, other license-related settings will be ignored.

Example Usage

soatest.license.enabled=true

virtualize.license.enabled

This option enables/disables the license related to Virtualize functionality. The default is true. If this option is not present in the .properties configuration file, the default is used. If this option is set to false, other license-related settings will be ignored.

Example Usage

virtualize.license.enabled=true

notify

This option enables/disables notifications to Parasoft CTP when virtual assets are deployed.

Example Usage

The following example enables notifications:

env.manager.notify=true

Setting the Property with the REST API

You can also set this property after the server has been started using the REST API. See env.manager.server for details.

env.manager.registry.id

This is a read-only setting used by CTP. 

soatest.license.enabled

This option enables/disables the license related to SOAtest functionality. The default is true. If this option is not present in the .properties configuration file, the default is used. If this option is set to false, other license-related settings will be ignored.

Example Usage

soatest.license.enabled=true

virtualize.license.enabled

This option enables/disables the license related to Virtualize functionality. The default is true. If this option is not present in the .properties configuration file, the default is used. If this option is set to false, other license-related settings will be ignored.

Example Usage

virtualize.license.enabled=true

soatest.license.use_network

This option enables/disables licensing over a network. If you are using a network license, you must also configure either a connection to License Server or to Parasoft DTP. 

Configure the following options to connect to License Server:

• license.network.url

Configure the following options to connect to DTP:

• dtp.url
• dtp.user
• dtp.password

Example Usage

The following example enables licensing over a network:

soatest.license.use_network=true

soatest.license.network.edition

This option specifies the type of license to retrieve from License Server or DTP. You can specify either custom_edition or professional_ edition. Contact your Parasoft representative if you are unsure of which edition you should set.

Example Usage

soatest.license.network.edition=custom_edition

soatest.license.custom_edition_features

This option specifies a comma separated list of features that should be requested for a custom edition license from License Server or DTP. Contact your Parasoft representative if you are unsure of which features you should specify.

Example Usage

soatest.license.custom_edition_features=RuleWizard,Command Line,SOA,Web,Server API Enabled,Jtest Connect,Message Packs,Advanced Test Generation Desktop,Advanced Test Generation 100 Users

virtualize.license.use_network

This option enables/disables licensing over a network. If you are using a network license, you must also configure either a connection to Parasoft DTP or to License Server or to Parasoft DTP(deprecated). 

Configure the following options to connect to License Server:

• license.network.url

Configure the following options to connect to DTP:

• dtp.url
• dtp.user
• dtp.password

Example Usage

The following example enables licensing over a network:

soatestvirtualize.license.use_network=true

virtualize.license.network.edition

This option specifies the type of license to retrieve from DTP or License Server or DTP. You can specify either custom_edition or professional_ edition. Contact your Parasoft representative if you are unsure of which edition you should set.

Example Usage

soatestvirtualize.license.network.edition=custom_edition

virtualize.license.custom_edition_features

This option specifies a comma separated list of features that should be requested for a custom edition license from DTP or License Server or DTP. Contact your Parasoft representative if you are unsure of which features you should specify.

Example Usage

soatestvirtualize.license.custom_edition_features=RuleWizardVirtualize,Command LineValidate,SOAPerformance,WebExtension Pack,Server API Enabled,Jtest Connect,Message Packs,Advanced Test Generation Desktop,Advanced Test Generation 100 Users

virtualize.license.use_network

This option enables/disables licensing over a network. If you are using a network license, you must also configure either a connection to Parasoft DTP or to License Server (deprecated). 

Configure the following options to connect to License Server:

• license.network.url

Configure the following options to connect to DTP:

• dtp.url
• dtp.user
• dtp.password

Example Usage

The following example enables licensing over a network:

virtualize.license.use_network=true

virtualize.license.network.edition

This option specifies the type of license to retrieve from DTP or License Server. You can specify either custom_edition or professional_ edition. Contact your Parasoft representative if you are unsure of which edition you should set.

Example Usage

virtualize.license.network.edition=custom_edition

virtualize.license.custom_edition_features

This option specifies a comma separated list of features that should be requested for a custom edition license from DTP or License Server. Contact your Parasoft representative if you are unsure of which features you should specify.

Example Usage

virtualize.license.custom_edition_features=Virtualize,Validate,Performance,Extension Pack,Service Enabled,Unlimited Hits/Day

dtp.url

This option the URL of the DTP server. Include protocol and host name or IP address and, if appropriate, port and context path.

Example Usage

https://10.9.1.63:8443

dtp.server (deprecated)

Service Enabled,Unlimited Hits/Day

dtp.url

This option specifies the URL of the DTP server. Remember to include the https:// protocol; DTP does not support http:// connections. If DTP is deployed to a location other than the root of the host server, the URL should include a context path (a relative path from the host name; for example: https://server.company.com:8443/contextPath). This may be the case if your organization uses a reverse proxy. Refer to the DTP documentation on https://docs.parasoft.com for additional information about reverse proxy server configuration and context path configuration.

Example Usage

https://10.9.1.63:8443

dtp.server (deprecated)

This option specifies the host name of the DTP server. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network). This option is deprecated.

Example Usage

dtp.server=main1.parasoft.com

dtp.port (deprecated)

This option specifies the port number of the DTP server. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network). This option is deprecated.

dtp.user

This option specifies the username for DTP authentication. You must also set the This option specifies the host name of the DTP server. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network). This option is deprecated.

Example Usage

dtp.server=main1.parasoft.comuser=admin

dtp.

password

This option specifies the port number of the DTP serverpassword for DTP authentication. You must also set the the virtualize.license.use_network option to true (see virtualize.license.use_network). This option is deprecated.

Example Usage

dtp.portuser=8080mypassword

license.network.

url

This option specifies the username for DTP authentication. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network).

Example Usage

dtp.user=admin

dtp.password

This option specifies the password for DTP authentication. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network).

Example Usage

dtp.user=mypassword

license.network.url

This option specifies the URL of the License Server. Include protocol and host name or IP address and, if appropriate, port and context paththe URL of the License Server. Remember to include the https:// protocol; License Server does not support http:// connections. If License Server is deployed to a location other than the root of the host server, the URL should include a context path (a relative path from the host name; for example: https://server.company.com:8443/contextPath). This may be the case if your organization uses a reverse proxy. Refer to the License Server documentation on https://docs.parasoft.com for additional information about reverse proxy server configuration and context path configuration.

Example Usage

https://10.9.1.63:8443

license.network.host (deprecated)

This option specifies the host name of the License Server. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network). This option is deprecated.

license.network.port (deprecated)

This option specifies the host port of the License Server. You must also set the virtualize.license.use_network option to true (see virtualize.license.use_network). This option is deprecated.

license.network.user

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

Example: license.network.user=JohnDoe

license.network.password

Specifies the password for authentication on the secondary DTP server License Server specified with the license.network.url option. 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 strongly recommend encoding passwords to ensure successful authentication and a secure connection. The WAR distribution contains a script that can encode passwords. To use it, run:

<SOAVIRT_HOME>/scripts/encodepass.sh <YOUR_PASSWORD>

or

<SOAVIRT_HOME>/scripts/encodepass.bat <YOUR_PASSWORD>

as appropriate for your OS.

You can also run a command line instance of SOAtest or Virtualize with the -encodepass flag. Examples:

soatestcli.exe -encodepass <YOUR_PASSWORD> 

virtualizecli.exe -encodepass <YOUR_PASSWORD> 

Either method will generate an encoded string that you can use in place of the password property in the SOAtest and Virtualize Server configuration file. See CLI Options for additional information about command line options.  

license.network.use.specified.server

This option enables the server to connect to connect to either DTP and License Server or two instances of DTP simultaneously. If set to true, specify a license network connection type with the license.network.connection.type setting. and Virtualize Server configuration file. See CLI Options for additional information about command line options.  

license.network.

use.specified.

server

This option

enables the server to connect to connect to either DTP

and License Server

or two instances of DTP simultaneously. 

license.network.auth.enabled

Enables or disables authentication on the secondary DTP server License Server specified with the license.network.url option.

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

virtualize.license.local.password

This option specifies the password for the local Virtualize license. You must also set the virtualize.license.use_network option to false (see virtualize.license.use_network).

virtualize.license.local.expiration

This option specifies an expiration for the local Virtualize license. You must also set the virtualize.license.use_network option to false (see virtualize.license.use_network).

usage.reporting.enabled

This setting enables or disables collecting anonymous usage information and sending it to Parasoft. Read our privacy statement to learn more at https://www.parasoft.com/privacy-policy.

Example Usage

The following example enables anonymous usage data reporting:

usage.reporting.enabled=true 

security.kerberos.realm

This option specifies the Kerberos realm associated with your network. By convention, this is typically your domain name in all caps (for example, PARASOFT.COM).

For more information, see "About Kerberos Authentication" in Security Settings on the Additional Preference Settings page.

security.kerberos.kdc.server

This option specifies the hostname of your Key Distribution Center (for example, kdc.parasoft.com).

For more information, see "About Kerberos Authentication" in Security Settings on the Additional Preference Settings page.

...

...

1. Add the jar(s) using one of the following methods:
   • Copy the jar(s) into the <WORKSPACE>/VirtualAssets/system_jars folder, which is where Parasoft Virtualize Server searches for custom/external jar files to load. Add this folder if it does not already exist.
   • Upload the jar(s) using the REST API upload operation (/v5/files/upload) as described in the Swagger documentation (see API の使用Usage). The upload should specify the /VirtualAssets/system_jars as the parent folder. The /VirtualAssets/system_jars folder will be created if it did not already exist.
2. Reload the jars using one of the following methods:
   • If the jars contain Virtualize custom extensions, restart the server.

   • Otherwise, either restart the server or call the /v5/preferences/systemProperties/reload REST API. 

Additional Configuration Notes

If you want to modify the value of the "Server" HTTP Header in Parasoft Virtualize Server's HTTP Response to ‘Parasoft Server’ (this is the default for traditional Eclipse-based Virtualize server deployments), you need to modify the servlet container configuration.

...