Manage licenses

This section describes how to manage your licenses.

License modes: Standalone or shared

You can work with licenses in the following ways.

License mode Description
Standalone

You install a license directly in OpenText Software Delivery Management. This is the default mode.

For details, see Install or uninstall a standalone license.

Shared license

You allocate licenses from OpenText Application Quality Management for use in OpenText Software Delivery Management.

For details, see Share licenses.

You define your license mode during installation.

Back to top

License types: Named or concurrent

There are two types of licenses in OpenText Software Delivery Management:

License type Description
Named Defines how many users you can register in OpenText Software Delivery Management.
Concurrent Defines how many users can access the system at the same time.

OpenText Software Delivery Management does not allow you to work with mixed licenses. You can either use named licenses, or concurrent licenses. Note that license sharing with OpenText Application Quality Management is for concurrent licenses only.

An active license is released when a user logs out of a session, or after the session timeout (by default, 3 hours). If there are no available licenses, a user trying to log in receives an error message.

Named license consumption:

  • In the named license model, each active user consumes a license.

  • To view details on your license capacity, access Settings > Site > Users. It shows how many licenses are in use, and how many are still available.

  • If you need to deactivate a user to release a license, the site admin should deactivate the user at the site level. If you deactivate a user at the shared space or workspace level, their license is not released.

  • If a user accesses OpenText Software Delivery Management from within an IDE, they need to be an active user in OpenText Software Delivery Management, and they therefore consume a named license.

Concurrent license consumption:

  • In the concurrent model, license consumption is calculated based on the following factors: user, shared space, and authentication. If you open a connection to OpenText Software Delivery Management from another browser, another session is opened. Each different combination opens a separate session that consumes another license.

    For example, when a user opens multiple sessions on a single browser, authentication is performed once, and only one license is consumed. When a user opens sessions on different browsers or different machines, multiple licenses are consumed. When a user accesses a new shared space, a new license is consumed.

  • For details on how to view information regarding usage, see View concurrent site license usage.

Switching between license types:

  • You can switch from a named license to a concurrent license without limitation.

  • If you need to switch from a concurrent license to a named license, the number of active users must be within the named license capacity limits.

You switch modes when the site admin installs a new license of another type, for example, named instead of concurrent.

Back to top

Install or uninstall a standalone license

This section describes how to use a standalone license.

To install/uninstall a standalone license:

  1. Select Settings > Site > Licenses.

  2. Click the Install License button , browse to the license file that you received from OpenText, and click Install.

  3. To remove a license, select a license and click Uninstall.

Note: The site admin receives an email notification when a standalone license is approaching its expiration date.

To switch from sharing to standalone mode:

If you were previously sharing licenses with OpenText Application Quality Management and you now want to work in standalone mode, you need to edit the octane.conf file.

  1. Open the <Repository folder>/conf/octane.conf configuration file and locate the license section.

  2. Change the value of license-mode to STANDALONE.

Back to top

Allocate concurrent licenses to a shared space

After installing a concurrent-type license, you can allocate a minimum number of licenses to be reserved for a specific shared space.

The allocated licenses per shared space are the minimum number of concurrent users that can log in to the shared space. If there are more users trying to log in, and there are available licenses that are not allocated to any shared space, the additional licenses are taken from the unallocated pool of licenses which is available to all shared spaces.

To allocate concurrent licenses to a shared space.

  1. Select Settings > Site > Licenses.

    The Allocation tab shows the number of installed licenses.

  2. Enter the number of licenses that you want to reserve for a specific space.

For example, suppose you have 1,000 licenses, and you have a particular shared space that is particularly important. You can allocate 100 licenses to this space, and the other spaces have a limit of 900 licenses.

Back to top

Assign Developer licenses

Developer licenses provide a subset of functionality for developer team members and are provisioned on top of a Pro and Enterprise core license. For details, see Editions.

Developer licenses are always named, so they do not impact allocation or usage of concurrent licenses.

To assign Developer licenses:

  1. Install a Developer license using Settings > Site > Licenses.

  2. In Settings > Site > Users, the License type column shows whether a user is assigned a Core or Developer license.

    • To assign a Developer license to a user, or to restore their Core license, click Core or Dev in the user's License type column and modify as needed.

    • You can switch a user from Developer to Core and vice versa at any time.

    • Deactivating a user releases their license even if the license is still assigned.

  3. Assign a role to your Dev user.

    The Developer license determines the maximum capabilities available to this user. For example, you can assign one Dev user to be a Viewer and another to be a Team Member. However, if you assign Workspace Admin to a Dev user, they will have maximum Developer license capabilities, but will not have admin capabilities.

  4. To track developer license usage, in the Licenses tab, in either the Concurrent Usage or Named Usage sidebar tab, look for the Developer Licenses widget.

Back to top

View concurrent site license usage

The site admin can track the maximum number of concurrent users that consumed licenses in the Concurrent Usage pane. This shows the maximum number of licenses, giving you an indication of how many licenses you actually need.

To configure the concurrent license usage settings:

  1. Select Settings > Site > Licenses.
  2. In the Concurrent Usage pane, click the Graph settings button and select Configure.

  3. Select the Time Period to see data over a specified length of time, and a Time Unit to see data per day, week, or month.

Note: The graph can show a maximum of 250 data points, so if (for example) you choose a time period of days, you must specify up to 250 days in the time period.

How usage is calculated

  • Usage data is calculated periodically. You can also trigger the calculation manually using the REST API, as described in License usage and View on-premises site license usage (technical preview).

  • License usage relates only to sessions that consume licenses. Usage is based on sessions, so if a user logs into two browsers, two licenses are consumed. Access to two different spaces also results in two licenses.

  • The Usage pane is applicable for concurrent licenses only.

  • Usage calculations do not take client time zones into consideration.

Tip: You can find details about all the sessions opened in the Sessions tab. The Licenses > Concurrent Usage pane refers only to sessions that consume licenses.

Back to top

View license and session details

To view details on your active license edition, go to Settings > Site > Licenses.

To view details on active sessions, go to Settings > Site > Sessions.

Details include the user ID that logged in, the type of access (UI, API user, or API key), the IP address used for the session, the start and end time of the session, and the license edition.

Back to top

Share licenses

You can allocate licenses from OpenText Application Quality Management to OpenText Software Delivery Management.

After allocating licenses you can change the allocation dynamically. If you need more licenses in OpenText Software Delivery Management, you can allocate more from OpenText Application Quality Management. If you need fewer in OpenText Software Delivery Management, you can reduce the number of licenses allocated.

License sharing is supported for concurrent licenses only.

Note: The maximum number of licenses that you can share is 15% of the installed licenses or up to 150 licenses, the lower of the two. If you have fewer than 100 licenses, you can share up to 15 licenses, even if it exceeds 15%.

Supported editions

For details on supported OpenText Application Quality Management versions, see Support Matrix.

You can allocate licenses as follows.

Allocate from Allocate to
OpenText Application Quality Management (ALM.Net) Edition OpenText Software Delivery Management Enterprise Edition
OpenText Application Quality Management (QC) Enterprise Edition OpenText Software Delivery Management Pro Edition

For details about Enterprise and Pro capabilities, see Editions.

Step 1: Perform the following in OpenText Application Quality Management site administration:

  1. Define an integration user and password to be used for the license integration. You can either create a new user, or use an existing integration user. The user must have permissions to view in OpenText Application Quality Management.

  2. Create a dedicated project to be used for the integration only.

  3. Assign the above user to this project.

  4. Define a new site parameter: OCTANE_INTEGRATION_PROJECT_NAME. Assign the value: <domain name>/<project name>.

  5. Allocate a number of OpenText Application Quality Management full licenses to the project.

    1. In the Licenses > License Assignments tab, locate the integration project.

      In the tab you can see how many licenses are available, which means the number of licenses that are not yet assigned to a project.

    2. In the Full License column, enter the number of licenses that you want to allocate from OpenText Application Quality Management, and click Save.

      The licenses are allocated from the available quota in the licenses pool.

    Note:

    • To enable license sharing, you need to set up a connection between the OpenText Software Delivery Management server and the OpenText Application Quality Management server. If there is a Forward proxy server between the systems that requires authentication, license sharing cannot be configured.

    • If OpenText Application Quality Management is using an SSL connection, you must import the OpenText Application Quality Management certificate into OpenText Software Delivery Management's Java cacert file.

Step 2: Define the following in the octane.conf file:

  1. Open the <Repository folder>/conf/octane.conf configuration file and locate the license section. Change the value of license-mode to ALM_SHARING.

  2. In the alm-sharing section, define the following.

    Field Description
    url

    Enter the full path that you use to access OpenText Application Quality Management.

    integration-user name

    Enter the user that you defined in OpenText Application Quality Management for the integration.

    integration-user password

    Enter the password for the above user. This password is automatically encrypted after you restart the OpenText Software Delivery Management server.

    Note: If you are using an LDAP user in OpenText Application Quality Management whose password changes periodically, you need to regularly update the password here to maintain license sharing.

  3. Restart OpenText Software Delivery Management so that it is updated with the allocated licenses.

    Note:  

    • If there is a connectivity problem such as network issues, or changes to a user name or password, an email is sent to the OpenText Software Delivery Management administrator describing the problem. Details are written to site.log. Users are able to log in to OpenText Software Delivery Management for a limited time, enabling you to fix the problem before access is blocked.

    • If you add licenses to the designated project in OpenText Application Quality Management, OpenText Software Delivery Management can take up to 3 hours to update the license allocation.

Enable license sharing when OpenText Application Quality Management uses SSO

To enable license sharing when OpenText Application Quality Management is using SSO authentication, follow the above steps with a few modifications.

  1. After Step 1 above: Ask your OpenText Application Quality Management administration to create a new API key in OpenText Application Quality Management.

    In the Create a new API key window > User field, enter the user that you defined in OpenText Application Quality Management for the integration.

  2. In Step 2 above: In the octane.conf file, enter the CLIENT ID from the OpenText Application Quality Management API key in the integration-user name field.

    Enter the API key secret in the password field.

Back to top

See also: