Client access license management

The IBM Engineering Lifecycle Management products are role-based. When you purchase a client access license for a role, you receive read, write, and comment access to some or all of the capabilities of the applications based on that role.

Client access licenses in this release

When you install the Engineering Lifecycle Management products, you deploy applications, such as the Change and Configuration Management (CCM), Quality Management (QM), and Requirements Management (RM) applications, in addition to Jazz® Team Server. You then use activation kits to install product client access licenses on the Jazz Team Server and assign these licenses to users so that they can access the capabilities provided by the applications.

With role-based licensing, the client access license for a particular role provides read, write, and comment access to some or all of the capabilities of the applications based on that role.

In addition to role-based licenses, solution-based licenses (Practitioner, Contributor, and Stakeholder) are available. The solution-based Practitioner license supersedes the Developer, Quality Professional, and Analyst role-based licenses. Consequently, if you install the solution-based Practitioner license, you do not need to install any of those three role-based licenses. For details on what the solution-based licenses include, see Table 2.

If you have several licenses that are not a subset or superset of one another, and there is no checkout order property configured, then the least expensive of the available licenses is checked out for the given operation.

For more information about installing licenses, see Installing and managing client access license keys.

Token consumption

Multiple roles can be assigned to a single user. For example, a user can have a contributor role most of the time that consumes 5 tokens, and a developer role some of the time that consumes 8 tokens. The tool holds both the lower cost contributor role and the higher cost developer role for a period of time (the default is 30 minutes), and then releases one of the roles depending on the user's activity. For a complete list of token consumption by roles, see Table 1.
Table 1. Token consumption by role
Role Token consumption
Engineering Workflow Management Developer 8
Engineering Workflow Management Developer for IBM Enterprise Platforms 9
Engineering Workflow Management Contributor 5
Engineering Workflow Management Stakeholder 1
Engineering Test Management Quality Professional 10
Engineering Test Management Contributor 5*
Engineering Requirements Management DOORS® Next Analyst 9
Engineering Requirements Management DOORS Next Contributor 5
IBM Engineering Lifecycle Optimization - Engineering Insights User 7
IBM Engineering Systems Design Rhapsody® - Model Manager Systems and Software Engineer 4
IBM Automotive Compliance content user 1-2 (See Note)
Note:

If you access Engineering Workflow Management, Engineering Test Management, and Engineering Requirements Management DOORS Next project areas which make use of the Automotive Compliance content, an additional token is used, irrespective of the number of project areas you access. Note that the license does not provide access to the base applications; a role-based license is still required.

If you open the Rhapsody ASPICE profile included in IBM Automotive Compliance, one token is used.

Access to project areas

Licenses unlock capabilities, but they do not grant access to specific project areas. A server administrator or a project area administrator assign roles and permissions to users. For more information about permissions for project areas, see Permissions.

Types of client access licenses

Table 2. Role-based client access licenses
Roles Products Engineering Workflow Management Engineering Test Management Engineering Requirements Management DOORS Next Engineering Rhapsody Model Manager    
Engineering Lifecycle Management Engineering Workflow Management Engineering Test Management Engineering Requirements Management DOORS Next Engineering Rhapsody Model Manager Engineering Insights Change management Planning Software configuration management Build automation 1 Test management Requirements management Architecture Management Distributed SCM Host system development Jazz Foundation 2 Simple reporting (using BIRT)
Practitioner X           RW RW RW RW RW RW R RW RW RW RW
Developer   X         RW RW RW RW R R R RW   RW RW
Quality Professional     X       RW RW R R RW RW 3 R     RW RW
Analyst       X     RW RW R R R RW R     RW RW
Contributor X X X X     RW RW R R R R R R   RW RW 4
Stakeholder 6 X X         RW R               RW RW
Developer for IBM Enterprise Platforms   X         RW RW RW RW R R R RW RW RW RW
Systems and Software Engineer         X   RW RW RW 5 R R R RW 5     RW  
User           X R                    
Everyone             R 4                    
Table 3. Workgroup editions
Workgroup editions 7 Products Engineering Workflow Management Engineering Test Management Engineering Requirements Management DOORS Next Engineering Rhapsody Model Manager  
Engineering Lifecycle Management Engineering Workflow Management Engineering Test Management Engineering Requirements Management DOORS Next Change management Planning Software configuration management Build automation 1 Test management Requirements management Architecture Management Distributed SCM Host system development Jazz Foundation 2 Simple reporting (using BIRT)
Developer for Workgroups [Limit: 50]   X     RW RW RW RW R R R     RW RW
Analyst for Workgroups [Limit: 5]       X RW RW R R R RW R     RW RW
Quality Professional for Workgroups [Limit: 5]     X   RW RW R R RW RW 3 R     RW RW
Practitioner for Workgroups [Limit: 50] X       RW RW RW RW RW RW R     RW RW
Legend:
  • X = Role is available with this product.
  • RW = Read/write access.
  • R = Read-only access (and review and comment capability if the user has RW access to Jazz Foundation).
Note:
  1. All users can comment on an artifact if they have at least read (R) access to the artifact and read-write (RW) access to Jazz Foundation.
  2. The Jazz Foundation capability includes dashboards; review/comment; common reporting (without report customization); and server and project administration.
  3. Build automation refers to Jazz Team Build with support for multiple build engines, such as Hudson/Jenkins and Build Forge. Build Forge licenses are sold separately.
  4. Engineering Workflow Management Stakeholder and ELM Stakeholder licenses are for users who use only the Change Management capability.
  5. The Workgroup editions differ from Role editions as follows:
    • Limited to certain number of licenses per server. See the number in parentheses in table
    • No floating licenses, but licenses can be mixed with all types of other licenses
    • No support for cross-repository or distributed source-control management (SCM)
    • No support for high availability
  6. The Quality Professional license enables you to create requirements and requirement collections. The following operations require an Analyst license:
    • Creating custom requirement types in the Requirements Management application
    • Creating and editing project and artifact templates for requirements
    • Creating and editing most graphical requirements artifacts such as screen flows, user interface sketches, and use case diagrams
    • Modifying project types
    • Creating project snapshots
    • Creating link types
  7. A user who has not been assigned a client access license has read-only access to the Change Management capability.
  8. By default, the contributor role does not have permissions to display reports. For users in this role to run reports, administrators must configure the project area permissions in the Reports section.
  9. The systems and software engineer license must be updated for use with 7.0.x. If you plan to use Engineering Rhapsody Design Manager 6.0.6.1 with applications from IBM Engineering Lifecycle Management 7.x, update the license keys for Engineering Rhapsody Design Manager. For more information, see Working with Rhapsody Design Management 6.0.6.1 in Engineering Lifecycle Management 7.x.

Functional user licenses

Administrators may see reference to functional users in some administrative screens. The system uses functional user licenses to authorize certain actions. These licenses are built in.

Table 4. Functional user licenses
Product Client access license Description
Jazz Team Server Data Collector Assigned only to the user ID that runs background data warehouse and reporting tasks.
Global Configuration Management Application-Internal Assigned only to the functional user ID (gc_user) to deploy process templates for the Global Configuration Management (GCM) application.
To use the GCM application, users must be assigned a role-based client access license. See Table 2.
Engineering Workflow Management Build System or Engineering Lifecycle Management Build System Assigned only to a user ID used by a build system, this license enables the devices in the build system to have read access and write access to all capabilities unless otherwise restricted by process permissions.
ClearCase Synchronizer or Engineering Lifecycle Management ClearCase Synchronizer This license can be assigned only to the synchronization process account (the account used by a build engine that creates and synchronizes a ClearCase Synchronized Stream). The capabilities are restricted to only those needed by the ClearCase Synchronizer.
ClearQuest Synchronizer or Engineering Lifecycle Management ClearQuest Synchronizer This license can be assigned only to the single user ID being used by the ClearQuest Synchronizer. The capabilities are restricted to only those capabilities needed by the ClearQuest Synchronizer.
Engineering Test Management Connector or Engineering Lifecycle Management Connector The Connector client access licenses services Engineering Test Management adapter connections, import/export capability, and ClearQuest connections. This user ID does not allow web access to Engineering Test Management.
Engineering Insights ENI Application-Internal application Assigned only to the functional user ID for the ENI application to run tasks in the background.
Engineering Requirements Management DOORS Next RM Application-Internal Assigned only to the functional user ID for the Requirements Management application to run tasks in the background.
TRS Consumer-Internal TRS Consumer - Internal license

The Engineering Workflow Management functional client access licenses are valid only if you have at least one valid Developer or Practitioner client access license installed on the server.

Types of Developer client access licenses

Table 5. Types of Developer Client Access Licenses
  Subsequently installed license
  Developer for Workgroups Starter Pack Developer for Workgroups Developer or Developer for IBM Enterprise Platforms
  Support Cross-server SCM Support Cross-server SCM Support Cross-server SCM
Currently installed license Developer for Workgroups Starter Pack     Fully supported Not permitted Fully supported Not permitted
Developer for Workgroups Fully supported Not permitted     Fully supported Not permitted
Developer or Developer for IBM Enterprise Platforms Fully supported Not permitted Fully supported Not permitted    
Note:
  • There is a 50-user limit for Developer for Workgroups client access licenses. The 10-user Developer for Workgroups Starter Pack does not count toward the 50-user limit.
  • For the Developer for Workgroups client access license, high availability deployments are not supported.

Trial licenses

When you install the server applications, trial licenses keys for Engineering Workflow Management, Engineering Test Management, Engineering Rhapsody Model Manager, and Engineering Requirements Management DOORS Next products are installed along with the server components unless you cleared the option to install trial license keys package. You can activate the keys for a product while you set up the Jazz Team Server application or when you are ready to try a particular application:
  • To modify source control or build artifacts, activate the Engineering Workflow Management Developer license key.
  • To modify test management artifacts, activate the Engineering Test Management Quality Professional license key.
  • To modify requirements management artifacts, activate the Engineering Requirements Management DOORS Next Analyst license key.
  • To modify architecture management artifacts, activate the Engineering Rhapsody Model Manager Systems and Software Engineer license key.

For any deployment topology, you must install the Engineering Workflow Management Required Base License Keys, including Trials package on any machine with a Jazz Team Server that has one or more registered instances of the Change and Configuration Management application.

After Jazz Team Server is installed, you can install additional license keys. For more information, see Installing and managing client access license keys.

Considerations for multiple Jazz Team Server applications

Client access licenses enable capabilities for all applications that are registered with the same Jazz Team Server application. For example, if you use a Stakeholder license, you have the same capabilities in every Change and Configuration Management application that is registered with that Jazz Team Server: you do not need two licenses to access two CCM applications.

However, if you have multiple Jazz Team Server environments, you need multiple licenses to unlock capabilities on applications that are registered with a different Jazz Team Server. For example, if you have one CCM application registered with a Jazz Team Server, and another CCM application that is registered with a different Jazz Team Server, you need two licenses: one for each CCM application.

Purchasing licenses

You can purchase new licenses if your current product license is about to expire or if you want to acquire additional product licenses for team members. Complete the following steps to purchase a license.
  1. Determine the type of license you want to purchase.
  2. Go to ibm.com or contact your IBM sales representative to purchase the product license.
When you want to import the activation kit or enable floating license support for your product, see Installing and managing client access license keys, Installing and managing floating client access license keys, and Setting up the IBM Common Licensing token service keys.

IBM Automotive Compliance licenses

You can download the Automotive license from the License Key Center. You can download a .zip file that contains all offering contents, including the templates, from Passport Advantage.

Make note of the following when assigning Automotive Compliance licenses:
  • Automotive Compliance content license must be assigned together with a base license to make use of this content.
  • Do not assign multiple Automotive Compliance licenses to a single user.
1 Build automation refers to Jazz Team Build with support for multiple build engines, such as Hudson/Jenkins and Build Forge. Build Forge licenses are sold separately.
2 The Jazz Foundation capability includes dashboards; review/comment; common reporting (without report customization); and server and project administration.
3 The Quality Professional license enables you to create requirements and requirement collections. The following operations require an Analyst license:
  • Creating custom requirement types in the Requirements Management application
  • Creating and editing project and artifact templates for requirements
  • Creating and editing most graphical requirements artifacts such as screen flows, user interface sketches, and use case diagrams
  • Modifying project types
  • Creating project snapshots
  • Creating link types
4 By default, the contributor role does not have permissions to display reports. For users in this role to run reports, administrators must configure the project area permissions in the Reports section.
5 The systems and software engineer license must be updated for use with 7.0.x. If you plan to use Engineering Rhapsody Design Manager 6.0.6.1 with applications from IBM Engineering Lifecycle Management 7.x, update the license keys for Engineering Rhapsody Design Manager. For more information, see Working with Rhapsody Design Management 6.0.6.1 in Engineering Lifecycle Management 7.x.
6 Engineering Workflow Management Stakeholder and ELM Stakeholder licenses are for users who use only the Change Management capability.
7 The Workgroup editions differ from Role editions as follows:
  • Limited to certain number of licenses per server. See the number in parentheses in table
  • No floating licenses, but licenses can be mixed with all types of other licenses
  • No support for cross-repository or distributed source-control management (SCM)
  • No support for high availability