License Management

The Licenses > License Management tab enables you to manage ALM licenses.

In this topic:

Overview

You can do the following in the License Management tab.

  • View the total number of licenses in use, the maximum number of licenses that you have for each ALM project or domain, and the expiration dates for the licenses.

    When other tools, such as UFT One, are connected to an ALM project, you can view the total number of licenses in use for these tools.

  • Modify licenses and launch the licensing portal to retrieve licenses.

  • Assign licenses to the various domains and projects.

  • Assign named licenses to specific users.

Modify licenses

You can modify licenses and launch the licensing portal to retrieve licenses.

To modify licenses:

  1. In Site Administration, click the Licenses > License Management > Status tab.

  2. To modify licenses, click the arrow next to Modify Licenses, and select one of the following options:

    Option Description
    Upload License

    Opens the Upload License dialog box, enabling you to modify licenses by uploading a license file.

    ALM requires that all license keys should be of the same edition. Therefore, contact support for help if you encounter errors in the following scenarios:

    • The uploaded license file (or pasted licenses) contains keys of an edition that is not installed.

    • The uploaded license file (or pasted licenses) contains keys of multiple editions.

    • The existing license file contains keys of multiple editions.
    Paste License

    Opens the Paste License dialog box, enabling you to modify licenses by pasting a license key.

    ALM requires that all license keys should be of the same edition. Therefore, contact support for help if you encounter errors in the following scenarios:

    • The new license key is of an edition that is not installed.

    • The existing license file contains keys of multiple editions.

  3. To clear licenses, click Clear License.

    A confirmation dialog box opens that verifies whether or not you want to clear all the installed licenses and their assignments.

  4. To add licenses, click Launch Licensing Portal.

    The OpenText Licensing portal opens in a new browser, enabling you to purchase licenses.

Back to top

Assign licenses to domains and projects

Available to ALM site Administrators only.

You can assign licenses to specific domains or projects to allow users assigned to each project to use the assigned licenses. The number of remaining, available licenses is shown towards the bottom of the tab. If a project needs more licenses than the number it is assigned, extra licenses can be taken from the domain or from the available licenses, until all available licenses are used.

To assign licenses to domains and projects:

  1. In Site Administration, click the Licenses > License Management > License Assignments tab.

    For SaaS: This tab lists domains in all customers.

  2. Locate the domain or project to which you want to assign licenses. In the cells for the type of licenses you are assigning to the domain or project, enter the number of licenses you want to assign. The total of available licenses is reduced accordingly.

    To hide domains and projects that do not have licenses assigned, select the Show Only Assigned Project checkbox.

  3. ALM validates that the total number of licenses assigned to the projects and domains does not exceed the number of licenses in the site pool.

    • Available: Displays the number of available unassigned site-level licenses by license type.

    • Site Pool: Displays the total number of available site-level licenses by license type.

  4. Click Save to save the changes.

Back to top

Assign named licenses to users

You can assign named licenses to specific users. The user has exclusive access to this license but cannot use licenses from the Site Pool. The user must use this license for thirty days. After thirty days, the license assignment can be removed from the user. When a named license is assigned to a user, you have one hour to remove the assignment.

To assign a named license to a user:

  1. In Site Administration, click the Licenses > License Management > Named Licenses tab.

  2. In the License Status panel, select the license you want to assign and click Add User.

    To hide expired licenses, select the Hide Expired License checkbox.

  3. In the Add User window, form the All Users list, select the users you want to assigned the license to and click the right arrow . The users are displayed in the Assigned Users panel.

    Reassignment Time: The date and time that the license assignment can be removed from the user. After a named license is assigned to a user, you have one hour to remove the assignment. After that time, the assignment cannot be removed from the user for thirty days. During the first hour and after thirty days, this field is filled with Reassignable.

  4. Click Save to save the changes.

To remove a named license assignment from a user:

  1. Prerequisite: A license assignment can only be removed from a user when the value of Reassignment Time is Reassignable. See Reassignment Time.

  2. In the License Status panel, select the license.

  3. In the Assigned Users panel, select the user.

  4. Click Remove to remove the user. The user name is no longer displayed in the Assigned Users side.

  5. Click Save to save your changes.

Back to top

View customer license usage (for SaaS only)

Available in versions: 17.0.1 and later

From the Customer Licenses tab of a customer, you can view the number of licenses in use and the total number of license quotas assigned to the customer and its end customers, if any.

Note: This Customer Licenses tab is available to users with the Usage Report permissions.

Column Description
In Use The number of licenses in use by the current customer and its end customers.
Max

  • If license distribution is enabled (the ENABLE_SAAS_ADDON_ALM_LICENSE_DISTRIBUTION parameter is set to Y), this column shows the number of licenses assigned to the current customer and its end customers.

  • If license distribution is disabled (the ENABLE_SAAS_ADDON_ALM_LICENSE_DISTRIBUTION parameter is set to N), this column displays the number of the licenses in the shared license pool.

Back to top

See also: