Configuring licenses for team spaces

As a Team Space Owner, you can configure Rational License Key Server for the team spaces on the License Configuration page so that members of the team space can perform various operations such as creating a project, running tests, and so on.

Before you begin

You must have completed the following tasks:

  • Configured the licenses that you purchased on Rational License Key Server.

  • Installed the product and signed up as a user on Rational® Test Automation Server.

  • Optional: Created a team space. See Creating a team space.

  • Been assigned the role of a Team Space Owner of the team space.

About this task

You must have a valid license to work with the team spaces that you create on Rational® Test Automation Server. You must provide a separate IP address or Fully Qualified Domain Name (FQDN) of IBM® Common License Key Server for the team spaces when you configure the licenses. If you provided the IP address or FQDN of IBM® Common License Key Server that is already configured for any other team space, then the configuration of the license for the team space fails with an error message. If you delete the team space, then the IP address or FQDN of IBM® Common License Key Server used for that team space is released. You can then use that IP address or FQDN of IBM® Common License Key Server for another team space.

Note: When you upgrade the server software from the previous version to the latest version, then the license configuration of the previous release applies to the initial team space. You can verify the information from the License Configuration page of the initial team space.

Procedure

  1. Log in to Rational® Test Automation Server.
  2. Click the Settings icon ibm_settings_icon from the left navigation pane.
  3. Open the team space for which you want to configure the license by using the Switch to option.
    Note: The Switch to option is displayed only if you have multiple team spaces.
  4. Click the Settings icon ibm_settings_icon, and then License.
    The License Configuration page is displayed.
  5. Optional: Enter the number of floating user licenses in the No. of floating users (Max) field to limit the number of licenses accessed by users in the team space if you have a shared Rational License Key Server.
    Note: The default selection is Maximum. Hence, the number of licenses is limited to the total number of licenses that are available in Rational License Key Server.
  6. Enter the IP address or FQDN of the license server in the Rational License Key Server field to configure the licenses for the team space.
    Note: You must enter either the IP address or FQDN in the port_number@<IP_address> or <FQDN> format. If you did not provide any port number, the default port number is used for Rational License Key Server.

    For example, the value of Rational License Key Server can be:

    • 27000@licenseserver.com

    • 27000@127.0.0.1

    You can view the following messages based on the value that you enter in the Rational License Key Server field:

    Values Messages

    No value

    Add the missing license details or enter the IP address or FQDN of License Server.

    Incorrect format of IP address or FQDN

    This is not a valid format of Rational License Key Server.

    Correct value

    License Server is already in use by another team space owner

  7. Perform the following actions to view or hide the details of the License Server:
    Fields Icons Action Results
    Rational License Key Server show_license_icon Click Rational® Test Automation Server shows the IP address or Fully Qualified Domain Name (FQDN) of Rational License Key Server that you have configured.
    show_license_icon Click Rational® Test Automation Server hides the IP address or Fully Qualified Domain Name (FQDN) of Rational License Key Server that you have configured.
  8. Click Check connection to verify the current status of Rational License Key Server.

    Based on the availability of License Server, you can view the following messages:

    • License Server is available

    • License Server is unreachable

  9. Click Configure.
    The Licensing compliance dialog is displayed.
  10. Click Confirm to apply the license configuration.

Results

You have configured the license for the team space. The License usage section displays the number of floating user licenses that are currently in use.

Remember: The License usage section does not display the number of Concurrent Virtual Service licenses that are currently in use.

What to do next

You can perform any of the following tasks: