Licensing with FlexLM #30440918/HEAD / v131 |
Licensing with FlexLMSince Codebeamer release 2.0 (HUSKY), the FlexLM license server is available which enables the management of licenses for multiple servers.
LicensesThe following four licenses are available for the customers:
The Codebeamer Collaboration license in not available as a standalone license but can be purchased as an addition to the Codebeamer, the Codebeamer Advanced or the Codebeamer Premium license.
The licenses as well as the license combinations available for the customers are:
License TypesWithin the offered license packages, two types of licenses are available:
License ManagementCodebeamer 2.0 (HUSKY)Since Codebeamer release 2.0 (HUSKY), FlexLM server is supported besides the legacy licensing.
To start Codebeamer with FlexLM, the following environment variables must be set on the instance where the Codebeamer server is running:
Licenses can only be activated and managed via environment variables for which two options are available:
The following environment variable is optional:
In case of a running Codebeamer instance, it needs to be stopped and then restarted to process the environment variables settings, and to switch to FlexLM licensing.
Codebeamer 2.1 (IMPALA)Since Codebeamer release 2.1 (IMPALA), the CB_FLEX_LM_LICENSE_SERVER_LINES environment variable has been introduced which allows FlexLM licensing to operate also without an actual license file stored in a file in the config folder of the installed Codebeamer instance. Instead, the license key is requested and checked online. Starting from Codebeamer release 2.1 (IMPALA), storing the license file is no longer required. If set, the CB_FLEX_LM_LICENSE_SERVER_LINES environment variable is used as it is superior to the CB_FLEXLM_LICENSE_CONTENT or CB_FLEXLM_LICENSE_PATH environment variables. However, the original FlexLM licensing configuration introduced in Codebeamer release 2.0 (HUSKY) can still be used. To start Codebeamer with this type of FlexLM licensing, the following environment variables must be set on the instance where the Codebeamer server is running:
The CB_FLEX_LM_LICENSE_SERVER_LINES environment variable can be used for a single node or for a triad where the nodes are comma-separated. The following table provides the description of the parameters.
Operation of License ServersIf one FlexLM license server is configured, Codebeamer requests and gets the license key from that one server. When the configured server fails, licenses are not served and users are not able to login to Codebeamer until the issue is fixed.
Setting up a license triad configuration helps avoid such issues. In case of a license triad configuration, there is a primary FlexLM server, as well as a secondary and a tertiary backup server. The license servers send so-called heartbeat messages to each other periodically to monitor the operation of the other servers. If no response is received by a license server, it shuts down the vendor daemon so that it cannot serve licenses. By using the HEARTBEAT_INTERVAL property, the time until the license server waits for the receipt of a heartbeat can be configured by a license administrator.
One of the license servers is a master server which serves the licenses to Codebeamer and records information into the debug and report logs. If the primary or master license server fails, the secondary license server takes over its role and becomes the master server to serve the licenses. The tertiary license server cannot be a master. If both the primary and secondary license servers fail, licenses are no longer served to Codebeamer. The master only serves licenses if there are at least two license servers operating properly in the triad. Configuration of License ServersAfter obtaining the license server package from the publisher,
License FileIn case one license server is used, there is one SERVER line with the details for the given server, and the license key in the generated license. When generating a key for a triad configuration, all three servers must be defined in the license key as well. SERVER primary 8A9ACBC9B26B 27000 PRIMARY_IS_MASTER SERVER backup1 8A9ACBC9B26C 27000 SERVER backup2 8A9ACBC9B26D 27000 VENDOR ptc_e PORT=28001 FEATURE Codebeamer_Collaboration_Reg ptc_e 2.0 01-dec-2029 20 \ SIGN="" FEATURE Codebeamer_Collaboration_Con ptc_e 2.0 01-dec-2029 20 \ SIGN="" FEATURE Codebeamer_Premium_Reg ptc_e 2.0 01-dec-2029 20 SIGN="" FEATURE Codebeamer_Premium_Con ptc_e 2.0 01-dec-2029 20 SIGN=""
The following table describes the various parts of the license file.
License IssuesSince Codebeamer release 2.0 (HUSKY), users are not allowed to log in after a new Codebeamer installation if the CB_FLEXLM_ENABLED environment variable is set to true until the proper license is provided. Only the Codebeamer License page is displayed in read-only mode showing the license type the user will have once Codebeamer is up and running.
FlexLM does not allow users to log in to Codebeamer in case of license issues, for example, if the license in the environment variable does not match with the one added to the FlexLM server.
To fix license issues,
The used license added to the environment variable and to the FlexLM server must be the same for successful authentication. Expired LicensesIn case of an expired license, users can still log in to Codebeamer after which a notification is displayed that the license has expired PTC needs to be contacted. FlexLM ServerFlexLM provides detailed information about licensing.
In case a user with a registered license logs out of Codebeamer, that registered (seat) license is still displayed as In Use. When a user with concurrent (float) license logs out of Codebeamer, that license is released and is shown as available.
User AuthenticationThe FlexLM server does not provide information on who is logged in to Codebeamer, but on where the user is logged in from. The FlexLM server differentiates between the users based on the Host name of the instance and the related unique user ID to calculate the number of available licenses.
Example: User A is logged in to Codebeamer instance A with user ID 1001. User B is logged in to Codebeamer instance B with user ID 1001. Although, User A and User B are logged in with the same license file to the same license server with the same user ID, they are logged in to different Codebeamer instances, therefore, they use separate licenses. |
Fast Links
codebeamer Overview codebeamer Knowledge Base Services by Intland Software |
This website stores cookies on your computer. These cookies are used to improve your browsing experience, constantly optimize the functionality and content of our website, furthermore helps us to understand your interests and provide more personalized services to you, both on this website and through other media. With your permission we and our partners may use precise geolocation data and identification through device scanning. You may click accept to consent to our and our partners’ processing as described above. Please be aware that some processing of your personal data may not require your consent, but you have a right to object to such processing. By using our website, you acknowledge this notice of our cookie practices. By accepting and continuing to browse this site, you agree to this use. For more information about the cookies we use, please visit our Privacy Policy.Your preferences will apply to this website only.