In this section:

Overview

Selenic will execute your tests, even if you do not have a license. Self-healing and other features, however, will be disabled unless the product is licensed.

Open the selenic.properties file in the Selenic installation directory to configure your license settings. You can configure Selenic to use a local license, a license served from DTP, or a license served from License Server. For your convenience, all possible properties are included and commented out in the selenic.properties file. Uncomment the applicable properties and specify their values.

EULA Acceptance

Selenic will function as if it is unlicensed if the End-User License Agreement (EULA) is not accepted. New installations of the Selenic plug-in into an IDE require acceptance of the EULA before they can be completed, so in many instances this setting will already be correctly configured, but in some cases (for example, upgrades from a version prior to 2022.1), it might be necessary to manually accept the EULA in your properties. Open the selenic.properties file and set the EULA acceptance property to true.

parasoft.eula.accepted=true

If this setting does not exist in your selenic.properties file, add it manually. If it is there but commented out, be sure to uncomment it and set it to true.

Local License

You will need to provide your Parasoft representative with your machine ID so that we can generate a local license. There are two methods for accessing your machine ID:

  1. Install the Selenic plug-in into your IDE and open the license page (see IDE Installation). The ID will appear in the Machine ID field. 
  2. Run the Selenic analyzer with the -machineId flag from a command prompt:

    java -jar selenic_analyzer.jar -machineId 

    The analyzer will print your machine ID to the console.

Parasoft will provide a local license password after we've received your machine ID. Open the selenic.properties file and specify the password in the selenic.license.local.password property of LOCAL LICENSE section:

selenic.license.use_network=false
selenic.license.local.password=<license password from Parasoft>

DTP License

Parasoft DTP is a development testing analytics and reporting platform that can host and serve Parasoft licenses.

Locate the NETWORK LICENSE section and specify the following properties:

selenic.license.use_network=true

Locate the DTP SERVER SETTINGS section and specify the following properties:

dtp.url=<URL for DTP in the form https://host[:port][/context-path]>
dtp.user=<username for account on DTP>
dtp.password=<password for account on DTP>

You can run the selenic_analyzer.jar file with the -encodepass property to encrypt your password. See -encodepass <password> for details.

License Server

License Server is a lightweight repository that centralizes your Parasoft licenses.

Locate the NETWORK LICENSE section and specify the following properties:

selenic.license.use_network=true

Locate the LICENSE SERVER STANDALONE SETTINGS section and specify the following properties:

license.network.use.specified.server=true
license.network.url=<URL for License Server in the form https://host[:port][/context-path]>

If the License Server you are retrieving tokens from requires authentication, configure the following properties in the LICENSE SERVER STANDALONE SETTINGS section:

license.network.auth.enabled=true
license.network.user=<username>
license.network.password=<password>

Authentication may be required if the Parasoft security module (pstsec.war) has been deployed and connected to License Server. 

You can run the selenic_analyzer.jar file with the -encodepass property to encrypt your password. See -encodepass <password> for details.

Licensing the IDE Plug-in

The IDE plug-in enables you to import and convert UI transactions recorded with the Parasoft Smart Recorder into Selenium tests. The IDE also provides a user interface for working with Selenic features, such as viewing recommendations. You can configure the plug-in to use a local license or to retrieve a license from License Server or DTP.

Local License

You will need to provide your Parasoft representative with the machine ID so that we can generate a local license. The machine ID is printed to the Machine ID field of the Parasoft Preferences License field after installing the IDE plug-in. Send your machine ID to Parasoft and we will send a license password that you can provide in the Password field.

  1. Choose Preference (Eclipse) or Settings (IntelliJ) from the Parasoft menu.
  2. Choose License and enable the Local license option.
  3. Specify the password sent to you from Parasoft. 
  4. Click Apply.

DTP

The network license configuration is set to DTP by default, so if DTP is enabled then Selenic will retrieve a license from DTP unless a License Server is configured per the License Server section. 

  1. Choose Preference (Eclipse) or Settings (IntelliJ) from the Parasoft menu.
  2. Choose DTP and enable the Enable option.
  3. Specify the DTP URL, including protocol, host, and, if appropriate, port and context path, in the Base URL field.
  4. Enter your DTP login credentials in the User name and Password fields.
  5. Click Test Connection to verify that the settings are correct.
  6. If you are going to use a license configuration associated with a specific DTP project, click Configure in the Project section and choose a project, then click OK.
  7. Click Apply and click the Configure... link in the License section.
  8. If you have multiple Parasoft products installed, open the tab for Selenic.

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

  10. 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 6 instead. 
  11. Click OK to close the dialog.
  12. Choose the product edition from the Edition drop-down menu. Contact your Parasoft administrator for assistance selecting an edition or custom edition features.
  13. You can enable the Borrow option and specify a length of time for which Selenic will 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.
  14. Click Apply to save your settings.

License Server 

  1. Choose Preference (Eclipse) or Settings (IntelliJ) from the Parasoft menu.
  2. Choose License and enable the Network license option.
  3. Click the Configure… link in the License settings section. By default, the network license configuration is set to DTP.
  4. Enable the Use the following License Server option and specify the License Server URL, including protocol, host, and, if appropriate, port and context path, in the Base URL field.
  5. If License Server is configured to authenticate user access, enable the Enable authentication option and specify your login credentials. 
  6. Click Test Connection to verify that Selenic can connect to License Server.
  7. Click OK to close the network configuration dialog.
  8. Choose the product edition from the Edition drop-down menu. Contact your Parasoft administrator for assistance selecting an edition or custom edition features.
  9. You can enable the Borrow option and specify a length of time for which Selenic 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.
  10. Click Apply to save your settings.

About License Editions

You can configure specific license editions, which enables functionality based on your role.

#selenic.license.network.edition=automation_edition
#selenic.license.network.edition=desktop_edition
#selenic.license.network.edition=custom_edition