License Server facilitates network access to a Parasoft license. Parasoft products deployed to stores and distributes license tokens to Parasoft products deployed to your network. Parasoft provides you with license passwords that you can add to and manage in License Server (administrator access required). Parasoft tools on your network can be configured to connect to License Server to retrieve a license. You can add new licenses or manage existing licenses in License Server if you have the appropriate privileges. Choose License Server from the settings drop-down menu to access License Server.
Included in this section:
...
Your Parasoft representative will provide you with license passwords that you specify in add to your License Server. The license passwords are specific to the machine ID on which License Server is running.
- Open the Choose License Server home page from the settings drop-down menu and click Add New License.
- Either fill out the license parameters in the Add New License form, or paste the complete license password as provided into the space provided. The password is sent in an email from your Parasoft representative.
- Click the Add license link to save changes
...
Information about the added license is accessible on the Installed Tool Licenses List page. An entry about this license will be added to the .psrc.xml file (the file that records license information); this file is located in the License Server installation directory.
Viewing Installed Licenses
Open the License Server home page and click Manage Licenses to view a list of all licenses currently installed.
You can perform the following tasks:
- Click on a link in the Tool name column to view license details
- Click the Remove link to remove a license.
Viewing License Details
Click the supported tool name link in the Installed Tool Licenses List to view the following details
- Tool
- Machine ID
- Expiration data
- Tokens (used/available/all) - The values shown in this row refer to the following token statuses:
- The used status refers to the number of tokens currently being used by Parasoft tools in your company
- The available status refers to the number of tokens that are available to be used by Parasoft tools in your company
The all status refers to the total number of installed (purchased) license tokens
- License features - All available licensed features are listed.
...
Adding and Linking Upgrade Licenses to Base Licenses
An upgrade license extends the access rights of the base license the base license by providing authorized access to the newer version of a licensed tool. Its limit is determined by the number of tokens available within the base license of the specific tool. Linking licenses allows you to use base license tokens or upgrade tokens interchangeably.
...
Another reason why the upgrade license should be linked to its base license is because an upgrade license can only be reserved within the base license. By reserving base license tokens, you can use either main or upgrade tokens, based on your needs. See See Reserving Licenses for instructions about how to do this. Any available upgrade licenses are displayed on the Manage Licenses page.
- Click the Link to link to open the Linking upgrade license page.
The Linking upgrade license page lists the upgrade license (on the right) and the proper base license to which the upgrade refers (on the left). Matching is done automatically based on the tool version and its features. - Click the Select the Select link to link the two licenses. You can click the the Clear link link to unlink the upgrade—removing authorized access to the upgraded version of the tool.
Filtering License Access
...
Viewing Installed Licenses
Open the License Server home page and click Manage Licenses to view a list of all licenses currently installed.
You can perform the following tasks:
- Click on a link in the Tool name column to view license details
- Click the Remove link to remove a license.
Viewing License Details
Click the supported tool name link in the Installed Tool Licenses List to view the following details
- Tool
- Machine ID
- Expiration data
- Tokens (used/available/all) - The values shown in this row refer to the following token statuses:
- The used status refers to the number of tokens currently being used by Parasoft tools in your company
- The available status refers to the number of tokens that are available to be used by Parasoft tools in your company
The all status refers to the total number of installed (purchased) license tokens
- License features - All available licensed features are listed.
Reserving Floating Licenses
You can manually a reserve a license token and allocate it to a specific user on a specific host. Use the format specified by the tools. Tools on different platforms use different formats, for example, one the same machine can be defined by the following in three different namesways: 10.9.1.50
...
, gina
...
...
Verify . You can verify the user/host format in the following reports to prevent issues with filtering:by checking the Tokens Usage Details
...
...
To filter a license access for a user:
- Enter the following information in the Filter requests for section of the License Details page:
- User name
- Host name
- Click the Deny or Allow button.
To filter a license access for a group:
- Choose the group name in the Filter requests for section of the License Details page.
- Click the Deny or Allow button.
Group creation and editing is described in Pattern Group Management. The user name or group name appears in the Filtered requests for report.
- Open the License Server home page and click Manage Licenses.
- Click on a tool name and specify a user name and host name.
- Specify the number of licenses needed and click the Add link.
The user name appears in the License Reserved section. You can remove one or all filters, selected reservations if necessary. Filters action accumulates, but clicking the Deny button eliminates Allow activity.
Reserving Licenses
When configuring license reservations, use the format used by the tools for the user and host names
Filtering License Access
Any Parasoft tool connected to License Server can request a license. The license will be granted if a token is available. You can use the filtering mechanism, however, to define a set of machines that are specifically allowed to or blocked from consuming license tokens.
When a filter is configured and the [Allow] action is used, all other machines that are not included in the filter will not be allowed to request a license. If the [Deny] action is used, all machines that are not defined in the filter can request a license. You can either filter by user on a specific host or define a pattern to filter by groups of hosts and users.
Filtering by User
Specify the user name and host name in the Filter requests for section of the License Details page and click [Deny] or [Allow].
Use the format specified by the tools. Tools on different platforms use different formats, for example, one the same machine can be defined by the following in three different namesways: 10.9.1.50
...
, gina
...
, gina.parasoft.com.pl
...
Verify . You can verify the user/host format in the following reports to prevent issues with filtering:by checking the Tokens Usage Details
...
...
To reserve a license for a user:
...
report.
Example
Specify the . (regex wildcard) for the user name and 10.10.4.* in the host name and click [Deny].
This will block all users on the host from requesting a license.
Filtering by Group
- Choose the group name in the Filter requests for section of the License Details page :
- User name
- Host name
- Click the Add link.
...
- Deny or Allow button.
Group creation and editing is described in Pattern Group Management. The user name or group name appears in the Filtered requests for section. You can remove one or all selected reservations filters, if necessary.
Managing Node-Locked Licenses
Machine-locked licenses are a subpart of reservations. During the first use of the license, fully reserve the license (all available tokens) for the requestor IPs. You can make a reservation manually by adding a machine IP using the host name field. You may need to remove the existing reservation if the license is fully reserved by other machines. Filters action accumulates, but clicking Deny eliminates Allow activity.
Example
Refer to the Pattern Group Management section for additional details.
- Define a group called Deny Group.
- Edit the group and specify
.as the user name and10.10.4.*as the host name.
- Click Add and define a new pattern using
.as the user name and10.10.5.*as the host name. - Use the [Back] links to return to the License details screen. Your group will appear as a filter option.
- Click [Deny] to block all users defined in the group from requesting the license.
Pattern Group Management
- Choose Management > Manage Pattern Groups from the License Server home page to add a new pattern group or edit an existing group.
Enter a new pattern for the group and click Add to create a new empty group. The group name appears in the Existing groups section, along with the following codes in parenthesis:
- p: Indicates the number of licenses that contain the specified user name and host.
- g: Indicates the number of licenses that contain sub-groups and patterns for the specified user name and host.
Click Edit button next to the name of a new or existing group to edit.
- You can perform the following actions:
- Enter a user name and host name in the New pattern section and click Add to create a new pattern.
- Browse for a CSV file containing users and click Import to add a bulk list of users to the group. The CSV file should be formatted as username, hostname with no header, e.g.,
user1,.*oruser2,192.168.1.101. - Choose a group from the Group name drop-down menu and click Add to add an existing group.
- ClickRemove in the Existing patterns or Existing groups section to remove an existing pattern or group.
...