Setting Up License Servers

You have a choice between using the Borland License Server (BLS) and the native StarTeam licensing found in this and earlier releases. If you use the license server, users must use their network logon names as their StarTeam user names. This section explains the steps the administrator follows to set up a license server.

  1. As the StarTeam administrator, you should receive licensing information from Borland via email (a sales representative should put this in motion).
  2. Install the license server (the license server documentation explains how to do this).
  3. Save the license files (this involves accessing a Micro Focus web site and downloading Micro Focus license files called slips).
  4. Place the slip files in the /License folder, a subdirectory of the StarTeam Server <version> installation folder.
  5. Configure the license server for users (this is covered in the license server documentation).
  6. Use the Server Administration tool to:
    • Change user names to network logon names.
    • Assign users to specific licenses by setting the license options.

When StarTeam Server starts, it checks for slips and stores information about them in memory. It does not recognize new slips until the next restart.

When a user logs in from a StarTeam client, the StarTeam Server tells the client what features are available to its user based on the license assigned to that user. If the user is assigned a license from a slip, but that slip is no longer in the /License folder, StarTeam Server displays an error message. If the user license type is Unassigned, the user is not logged on and StarTeam Server returns an exception.

Note: If you are using a license server, concurrent licenses are released immediately by StarTeam Server, but the license server might not find that out for a few minutes. StarTeam Server updates the license server about license usage at an interval specified in the licensing slip. The license server will know that a license has been released only when the next update for that license occurs.