License Server can manage local area network access to a Parasoft License, including DTP and Parasoft code analysis tools. 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:
Adding a License
You must generate licenses for the machine ID of the server on which License Server is running. For more information, contact your Parasoft representative.
- Open the License Server home page 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
About License Parameters
| Tool | Parasoft tool, e.g., dotTEST, C++test, SOAtest, etc. |
|---|---|
| Version | You can access the version number from the tool's About panel. |
| Architecture | The correct architecture for which the license is assigned must be selected (for example LINUX2; this is the first part of the machine ID). |
| Expiration date | You can enter the expiration date code given to you by your Parasoft representative, the date that the license server expires, or the time for which the license is valid. Use the format: mm/dd/yyyy or mm/dd/yy. |
| Password | The password code for the license. |
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
- Licenses (Used, available, and all.)
- License features (All available licensed features are listed.)
Linking Licenses
An upgrade license extends the access rights of the main 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 main license of the specific tool. Linking licenses allows you to use main license tokens or upgrade tokens interchangeably.
For example, if you purchase five licenses (tokens) but eventually upgrade to a new version of your product, you can link the old and new product versions and use the original five licenses across both versions. You could use three license tokens for the new version and two for the old version. You could also use all five for another other distribution.
Another reason why the upgrade license should be linked to its main license is because an upgrade license can only be reserved within the main license. By reserving main license tokens, you can use either main or upgrade tokens, based on your needs. 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 main license to which the upgrade refers (on the left). Matching is done automatically based on the tool version and its features. - Click the Select link to link the two licenses. You can click the Clear link to unlink the upgrade—removing authorized access to the upgraded version of the tool.
Filtering License Access
When configuring license access filters, use the format used by the tools for the user and host names. Tools on different platforms use different formats, for example, one machine can be defined by the following three different names:
- 10.9.1.50
- gina
- gina.parasoft.com.pl
Verify the user/host format in the following reports to prevent issues with filtering:
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 section. You can remove one or all filters, 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. Tools on different platforms use different formats, for example, one machine can be defined by the following three different names:
- 10.9.1.50
- gina
- gina.parasoft.com.pl
Verify the user/host format in the following reports to prevent issues with filtering:
To reserve a license for a user:
- Enter the following information in the Reserve Licenses section of the License Details page :
- User name
- Host name
- Specify the number of licenses needed.
- Click the Add link.
The user name appears in the License Reserved section. You can remove one or all selected reservations 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.
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.
Removing Licenses
- From the Installed Tool Licenses List, click the [Remove] link that corresponds to the appropriate tool license to remove.
- Confirm that you want to remove the license when prompted.
Information about the removed license is displayed.
