StarTeam Server licensing
StarTeam Server can be run as an Express, Enterprise, or Enterprise Advantage server. Which server edition you have (or more explicitly, what features a client can access on that StarTeam Server) is determined by the product license.
Understand licensing
Licenses determine how many users can access StarTeam Server. Users can have either named user or concurrent licenses. A named user license can be used only by the user who has been assigned that license. For example, if you have 5 named user licenses, the 5 users who are assigned the named user licenses are guaranteed access to the StarTeam Server. No one else can use their licenses.
A concurrent license can be used by any user who does not have a named user license. For example, users without named user licenses receive concurrent licenses on a first-come, first-served basis. After all the concurrent licenses are in use, users attempting to log on are notified that there are no more licenses available at this time. They can try again later.
You can add as many users as you choose, but access is granted only to users with named user licenses or to users who receive concurrent licenses as they log on.
The Server Administrator is automatically assigned a named user license which cannot be removed. This is a “free” license that is not counted against the number of named user licenses you have available.
Note: The Server Administrator should not have a password that is verified by a directory service because, if you change the service, the administrator will be locked out.
StarTeam Server can be licensed in either of two ways:
- StarTeam licensing, also referred to as native licensing, which is internal to the product.
- License Server licensing (using either BLS or FLEXnet Server).
If you have StarTeam native named user licenses, you must assign them to specific users in the User Manager dialog box. Everyone else is assumed to have a concurrent license. See the StarTeam Server online help for details.
If you have Borland License Sever (BLS) or FLEXnet License Server, users must be assigned to the correct slip in the User Manager dialog box, regardless of their named or concurrent user status. An additional status, Unassigned, may be used instead of a slip.
Use StarTeam licensing
If you attempt to access a StarTeam Server configuration that is managed by an unlicensed version of StarTeam Server, the tabs in the upper and lower panes of their clients will not display.
Customers buy named Enterprise, concurrent Enterprise, named Enterprise Advantage, or concurrent Enterprise Advantage licenses. Any client can access any StarTeam Server as long as that StarTeam Server recognizes the user and has a license for that user. Customers usually choose just one method of licensing, but combinations can be supported as long as they are all for the same edition. Licensing is handled after the installation, either by setting up a licensing server and putting "slip" files in the \Licenses folder (a child of the StarTeam Server's installation folder) or by registering native licenses using the Server Administration tool.
Before entering native licenses, you must delete the evaluation key. For Enterprise and Enterprise Advantage, licenses are stackable as long as they are for the same edition of StarTeam Server. For example, when you first register, you might enter two serial numbers: one for named user licenses and another for concurrent licenses. For more information about licensing, see Understand licensing.
You can add more named users or concurrent licenses. StarTeam Server keeps track of the total number by summing the licenses supplied in each serial number or slip. This is referred to as stackable licensing.
Note:
- You cannot license StarTeam Server while any of its server configurations are running as a Microsoft Windows service.
- If you change the registered license while a project is open on a user’s workstation, the licensing takes effect for that user by closing and reopening the project window.
To license StarTeam Server from the Server Administration tool (native licensing):
- Click . The Server Administration tool opens.
- On the Server Administration menu bar, click . The About StarTeam Server dialog box opens.
- Select the License node in the left pane of the dialog box.
- If you have yet to enter a license, you must delete the evaluation key by selecting it from the right pane of the dialog box and clicking Delete.
- Click Register. The Server Registration dialog box opens.
- Enter the correct numbers in the Serial Number and Access Key text boxes. Serial numbers are case sensitive; access keys are not.
- Click OK.
- Close the About StarTeam Server dialog box.
To license a version of StarTeam Server at the command prompt, enter the following: starteamserver -serial Number -access Key
Use a license server
You can use Borland License Server (BLS), or FLEXnet License Server or AutoPass License Server with StarTeam Server.
For details, see Set up license servers.
Evaluate the StarTeam Server
The first time you run StarTeam Server, an evaluation license is created for StarTeam Enterprise Advantage, which is StarTeam the edition of StarTeam with the largest feature set. Before the 30-day product review period expires, you can extend the evaluation period by contacting sales for an extended evaluation key.
Be sure to register the product or extend the evaluation period before it expires. Otherwise, when clients access a server configuration managed by StarTeam Server, no components (such as the file or change request component) will be available. For example, in the StarTeam Cross-Platform Client, the upper and lower panes will not show any tabs.
To extend the evaluation period for StarTeam Server:
- After you obtain an extended evaluation key, click . The Server Administration tool opens.
- Click from the menu bar. The About StarTeam Server dialog box opens.
- Select License in the left pane of the dialog box.
- Click Extend Evaluation. The Extend Evaluation dialog box opens.
- Enter the evaluation key, and click OK.
- Close the About StarTeam Server dialog box.