This section describes how to license the desktop instance of SOAtestFor information about licensing the web archive (WAR) deployment of the server, see Licensing the Server. 

In this section:

Network Licenses

You can configure SOAtestto use a license served from Parasoft DTP or a standalone instance of Parasoft License Server. Contact your system administrator for information about which type of license you should use. 

DTP License

You can use a license from DTP or license configuration settings from a DTP Project. Your Parasoft DTP (or Parasoft Concerto) administrators should verify that the product and version you are licensing appears in the DTP License Server. Administrators can refer to to the DTP documentation for information about updating the tools database. Refer to Connecting to DTP for additional information. 

  1. Choose Parasoft> Preferences and click on the DTP category.
  2. Enable the Enable option and specify the DTP host, port, and your DTP login credentials. 
  3. Click Test Connection to verify that the settings are correct. If you are going to use a license configuration associated with a specific DTP project, choose a project from the drop-down menu in the Project section.  
  4. Click Apply and click the Configure... link in the License section.
  5. If you have multiple Parasoft products installed, open the tab for the Parasoft product you want to license (e.g., Jtest, SOAtest, Virtualize).

  6. Enable the Network option and click the Configure... link.

  7. Enable the Use configured DTP settings option. If you are going to use a license configuration associated with a specific DTP project, enable the Use License Server settings from DTP project to use the license configuration associated with the project selected in step 3. 
  8. Click OK to close the dialog.
  9. Specify the product edition from the Edition drop-down menu. Contact your Parasoft administrator for assistance selecting an edition or custom edition features.

  10. You can enable the Borrow option and specify a length of time for which SOAtestwill consume a license token. Licenses can be  borrowed from 1 hour to 14 days. Refer to the DTP documentation for additional information about borrowing licenses.

  11.  Apply to save your settings.

License Server

You can connect to License Server to retrieve a license token, even if you are connected to a separate instance of DTP.

  1. Choose Parasoft> Preferences and click on the License category.
  2. If you have multiple Parasoft products installed, open the tab for the Parasoft product you want to license (e.g., Jtest, SOAtest, Virtualize).

  3. Enable the Network option and click the Configure... link.

  4. Enable the Use the following License Server  option and specify the host name or IP address where License Server is hosted and port. Common port numbers are 8443 or 8080  for HTTP/S and 2002 (default) for TCP.
  5. If the security configuration is enabled on License Server, enable the Enable authentication  option and enter your user credentials. 
  6. Click Test Connection to verify your settings and click OK to save your changes.
  7. Specify the product edition from the Edition drop-down menu. Contact your Parasoft administrator for assistance selecting an edition or custom edition features.

  8. You can enable the Borrow option and specify a length of time for which SOAtest will consume a license token. Licenses can be  borrowed from 1 hour to 14 days. Refer to the License Server documentation for additional information about borrowing licenses.

  9. Click Apply to save your settings.

Deactivating License

You can deactivate/activate licenses by choosing Parasoft> Deactivate License/Active License. 

You can also configure the license to automatically deactivate after 30 minutes of inactivity:

  1. Choose Parasoft> Preferences from the main menu and click the License category.
  2. Enable the Start deactivated, release automatically when idle option. 
  3. Click Apply to save your changes.

When the license is deactivated:

When the license is reactivated:

It is not necessary to use Parasoft / Activate License.  When the Parasoft Test product is run, it will acquire a license for only that specific product. The Start Deactivated option is enabled and cannot be disabled in this situation.

Waiting for a License in Command Line Mode

You can configure SOAtestto wait for a license token if a requested token is not currently available by specifying the  wait.for.tokens.time option when using the command line interface. For additional information, see Configuring Localsettings, as well as Testing from the Command Line Interface - soatestcli.

Using a Local License

Local licenses do not request a license token from a a server on the network. Instead, they are locked to the specific machine. You will need to provide your machine ID to your Parasoft representative, who will send you a license password. The machine ID appears in the Parasoft license configuration screen.  

  1. Choose Parasoft> Preferences to and select the License category.
  2. If you have multiple Parasoft products installed, open the tab for the Parasoft product you want to license (e.g., Jtest, SOAtest).
  3. Enable the Local option.
  4. If you have not already done so, note the machine ID in the Machine id field and send it to your Parasoft representative to obtain a license password. You can also run a command using the command line interface to print the machine ID to the console. Without a license, the following message will appear: Error: No valid license (MachineId: WIN32-12345678).
  5. Enter your license password from Parasoft and click Apply. The License preferences page will display the features that you are licensed to use, and the expiration date for your license.
  6. Click OK to set and save your license.


Manually Configuring the License

You can createSOAtestconfiguration file and specify your license settings. See Configuring Localsettings  for details on creating and configuring the file.

Importing and Exporting License Configuration Settings

You can export your configuration settings to a .properties file and share with team members. See Configuring Localsettings for details. 

Manually Specifying the License on Initialization 

You can specify a license configuration in a parasofttest.ini file. Parasoft Test is the common framework for many Parasoft tools. 

  1. Create a parasofttest.ini file in the Parasoft Test installation directory.

  2. Edit the parasofttest.ini file to provide licensing details. Use the following format:

    license.network.host=snake.parasoft.com
license.network.port=2002
enforce.configure=true

    See Configuring Localsettingsfor details on configuration properties. 

The license settings specified here will be read upon startup when the product is launched in UI mode.