Assigning licenses to users

Assigning licenses overview

To be able to work with StarTeam, users must have a named user license or a concurrent license. By default, users are assigned to use concurrent licensing. The StarTeam Server Administrator uses the User Manager in the Server Administration Tool to assign licenses to existing users or to new users.

From the User Manager, you can use the User Properties dialog box or context menu to assign licenses. Generally, use the context menu for bulk actions and the User Properties dialog box for assigning licenses to users one at a time. Which of these you choose depends on what you are doing as illustrated in these scenarios:

  • If you are adding a new user and filling in all the data about him/her, you can assign a license as part of the process. This would most likely be done in the New User Properties dialog box.
  • If you are upgrading and need to assign a group of existing users to a new license slip for the new release, you can multi-select the appropriate users and assign them to a slip simultaneously. You would do this from the context menu.
  • If you have been evaluating StarTeam and now have purchased native licenses or licenses to be used with a license server, you can select all the existing users (from the evaluation period) from your production server configuration and assign them to a license type or a license slip. You would do this from the context menu.
  • If a group of people have been laid off and you no longer want them to use StarTeam, you can select them all and change their license type to Unassigned.

Note: The named and concurrent user licenses are the same as the licenses in earlier StarTeam releases.

Back to top

Assigning licenses to an existing user

  1. Click Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server .
    The Server Administration Tool opens.
  2. Select a server configuration from the list of servers. If you have not yet logged on, you will be asked to do so.
  3. Click the Accounts bar and then click GUID-E1CAFC1E-1F2D-4F4F-9B3B-A87E82C747D2-low.gif (User Manager).
    The User Manager tab opens.
  4. Select one or more users.
  5. Right-click to display the context menu and choose Properties. The User Properties dialog box opens.
  6. Select the license type from the License list:
    (optionally) The license number of one or more license server slip files for either a named or concurrent license.
    StarTeam Named The user has a particular license assigned to them.
    StarTeam Concurrent The user is assigned one of the “floating” licenses when they log on to StarTeam.
    Unassigned Select this “license type” when a user has no license.
  7. Type the rest of the data on the General and other tabs as appropriate. Remember to use the network logon name for the User Name field on the Logon tab.
  8. Click OK.

Note: The status line at the bottom of the User Manager tab provides licensing statistics including the number of named user licenses that are currently available.

Back to top

Assigning a license to a new user

  1. Click Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server .
    The Server Administration Tool opens.
  2. Select a server configuration from the list of servers. If you have not yet logged on, you will be asked to do so.
  3. Click the Accounts bar and then click GUID-E1CAFC1E-1F2D-4F4F-9B3B-A87E82C747D2-low.gif (User Manager).
    The User Manager tab opens.
  4. Click New User. The New User Properties dialog box opens.
  5. Select the license type from the License list:
    (optionally) The license number of one or more license server slip files for either a named or concurrent license.
    StarTeam Named The user has a particular license assigned to them.
    StarTeam Concurrent The user is assigned one of the “floating” licenses when they log on to StarTeam.
    Unassigned Select this “license type” when a user has no license.
  6. Type the rest of the data on the General and other tabs as appropriate. Remember to use the network logon name for the User Name field on the Logon tab.
  7. Click OK.

Back to top

Managing named user licenses

Users can have either named user or concurrent licenses. A named user license (formerly called a fixed license) can be used only by the user who has been assigned that license whereas concurrent license users share the licenses and can log on as long as there are concurrent licenses available. Users who receive the named user licenses are guaranteed access to the StarTeam Server.

You can add as many users as you choose, but access to the server is granted only to users with named user licenses or to users who receive concurrent licenses as they log on. If you have named user licenses, you must assign them to specific users in the Server Administration Tool User Manager. An anchor appears before the name of users with named user licenses. Before assigning named licenses, you must add the users.

The StarTeam Server Administrator is automatically assigned a named user license which cannot be removed. This free license is not counted against the number of named user licenses you have available. After the server is licensed, named-user licenses can be assigned.

Tip: The User Manager status bar indicates how many named user licenses and how many concurrent licenses are in use.

  1. Click Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server .
    The Server Administration Tool opens.
  2. Select a server configuration from the list of servers. If you have not yet logged on, you will be asked to do so.
  3. Click the Accounts bar and then click GUID-E1CAFC1E-1F2D-4F4F-9B3B-A87E82C747D2-low.gif (User Manager).
    The User Manager tab opens.
  4. Select the user to whom a named user license will be assigned.

    Note: If the user is not displayed, you might need to select a particular group, or select the Show Users in All Descendant Groups check box.

  5. Right-click and choose Assign License > Add Named User License.

Note: If you have downloaded named or concurrent license files from the license server, the context menu contains the license number for each file.

After a named user license is assigned to a user, an anchor appears before the name of the user.

Note: When you change the type of license a user has, the change does not take effect until the user logs on the next time. To make the license change effective immediately, you need to force-logout the users affected by the change.

Note: To remove a named user license, go to the User Manager, select a user, and choose Assign License > Remove Named User License. Removing a user named license automatically changes the user to a concurrent use license.

Back to top