This topic explains how to set licensing information from the GUI. It covers:
You can also specify licensing via localsettings (e.g., for sharing team-wide settings via DTP or specifying options at the command line). See Localsettings for details.
Using a DTP License
- (Recommended for Concerto/DTP admins) Verify that the product and version you are licensing appears in the DTP License Server. If not, update the tools database as described in the DTP Admin Guide.
- Choose Parasoft> Preferences to open the Preferences dialog.
- Select the License category in the left pane.
If the appropriate server is not already set , specify the server’s host (either a name or an IP address) and port (the default is 2002).
- If you have multiple Parasoft products installed, open the tab for the Parasoft product you want to license (e.g., Jtest, SOAtest).
- Select the Enable license option.
- Select the Network option.
- Indicate the license type that you want this product to use by selecting the appropriate option in the Edition box.
- If you want to use the product for a short period of time when you will not have access to Concerto/DTP (e.g., because you expect to be working from home, you will be travelling, your team will be upgrading the machine hosting Concerto/DTP, etc.), check borrow and specify how long you need to "borrow" the license.
- When you borrow a license, one of the available licenses (on the Concerto) is locked to your machine for the specified amount of time. You can then disconnect from the network and use the product without accessing Concerto/DTP.
- Licenses can be borrowed from 1 hour to 14 days.
- License borrowing requires PST 2.6 or higher or Concerto/DTP.
- Click OK to set and save your settings.
License Activation and Deactivation
If you want to deactivate a license, choose Parasoft> Deactivate License. To reactivate it, choose Parasoft> Activate License.
If you want to have a license automatically deactivated after 30 minutes of inactivity, enable the Start deactivated, release automatically when idle option. To change this behavior, disable this option.
When the license is deactivated:
- The Parasoft Test views are disabled and results are cleared from the Quality Tasks view.
- The product’s license is released on Concerto/DTP.
When the license is reactivated:
- All of the licensed Parasoft Test views are restored and the Quality Tasks view will display available results.
Note that:
- Using Parasoft / Activate License will acquire a license for all installed Parasoft Test products
- 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
If you want the product to wait for a license if the requested license is not currently available, use the localsettings option virtualize.wait.for.tokens.time=[time in minutes]
. For example, use virtualize.wait.for.tokens.time=3
to wait 3 minutes for license tokens. For details on the command line mode and localsettings options, seeLocalsettings.
Using a Machine-Locked License
To install a machine-locked license:
- Choose Parasoft> Preferences to open the Preferences dialog.
- Select the License category in the left pane.
- If you have multiple Parasoft products installed, open the tab for the Parasoft product you want to license (e.g., Jtest, SOAtest).
- Select the Local option.
- Contact your Parasoft representative to receive your license. You will need to provide the Machine ID listed in this panel.
- In the United States, call 1-888-305-0041. In other locations, use the contact information available at Contacting Parasoft Technical Support.
- If you don’t yet have a valid license set and you want to obtain the Machine ID without opening the GUI, run the command line invocation from the command line. The Machine ID will be reported in the output message (for example,
Error: No valid license (MachineId: WIN32-12345678)
.
- Enter your license password.
- Click Apply. The License preferences page will display the features that you are licensed to use, and the expiration date for your license.
- Click OK to set and save your license.
Manually Adding the License to localsetttings
To add or change license settings via localsettings:
If you will be using a custom edition license, define the appropriate license features in the localsettings as follows:
virtualize.license.custom_edition_features= All enabled features
Note that license feature settings apply only to custom edition licenses.
Define the main license settings in the localsettings as follows:
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 number
See Localsettings details on localsettings and a list of all license-related options.
Additional Licensing Options for Virtualize
The following license options are available for Virtualize:
- Virtualize: The core Virtualize license. It is required in order to access any Virtualize functionality.
- Performance: Enables throughput to exceed 11 hits per second.
- Validate: Allows validation tools to be chained to the Incoming Request output in order to validate messages coming to the Responder (messages produced by the application under test and received by Virtualize). See Adding an Output for more details.
- N Hits per Day: Specifies how many hits per day (starting at 12am) are allowed for that Virtualize server. A hit is any request message (for Message Responders) or query (for SQL Responders).
- Service Enabled: Provides the ability to:
- Connect Virtualize server to CTP.
- Manage Virtualize server from external Virtualize desktops.
- Access the REST API of the Virtualize server.
- Start the Virtualize server in headless mode.
- Deploy the Virtualize server using the container-deployable war file
- Extension Pack: Enables support for advanced protocol, message formats, tools and custom tools and extensions.
- Message Packs: Enables advanced EDI message formats in applicable tools.
Manually Adding the License without Using localsetttings
If you do not want to specify the license with a localsettings file, you can configure it with a parasofttest.ini file as follows:
- In the Parasoft Test installation (e.g., c:\Program Files\Parasoft\Test\<version>), create a parasofttest.ini file.
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
The license settings specified here will be read upon startup when the product is launched in UI mode.