Activating configuration management in applications

This topic applies only to the Requirements Management (RM) and Quality Management (QM) applications. Configuration management helps you develop in multiple streams, reuse versioned artifacts in different streams and baselines, and use components to organize artifacts into logical collections. The environment where you will use these capabilities determines how you activate them. In the Quality Management (QM) and Requirements Management (RM) applications, you activate these capabilities by using a key.

Before you begin

  • Read a guidance article for links to videos, considerations, and other resources to help you decide if using configuration management tools is right for your team.
  • You should understand the affects of enabling configuration management. Then:
    • For pilot environments, generate an activation key at
      Note: Configuration management capabilities of RM and QM, and global configuration management is an added service for IBM Collaborative Lifecycle Management on Cloud and IBM IoT Continuous Engineering on Cloud customer environments, and should only be enabled by the SaaS provider. Software configuration management (SCM) in CCM is included in Cloud offerings at no additional cost.
    • For production environments, discuss your plans with your IBM® Client representative or contact IBM Support.
  • You must have Jazz™ Administrator privileges.


  1. For the RM and QM applications, go to the administration page: https://fully_qualified_host_name:9443/application_context/admin.
  2. In the left navigation pane, click Advanced Properties.
  3. On the application administration page, search (click Ctrl+F) for Local Versioning Component.
  4. For the Enter license key to enable configuration management property in that section, in the Current Value field, paste the activation key.
    Note: Other CLM applications and Jazz Team Server also have this advanced property, but you add the key to the property only in the QM and RM applications.
  5. Scroll to the top of the page and click Save.

What to do next

QM and RM applications only: Configuration administrators and project administrators must now enable configuration management capabilities in specific project areas. By enabling this feature, administrators can create components that represent collections of artifacts instead of working with all the projects artifacts in one stream; and, within components, team leaders or members can create streams and baselines that use versioned artifacts. Then, teams can add streams and baselines to global configurations.

RTC and DM application: No additional enablement steps are required. You can now add streams and baselines to global configurations.

video icon Watch videos

CLM playlist channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog