Limiting GCM contributions by enforcing project area associations

To limit which project areas team members see when they add local or global configurations to global streams or set their configuration context in applications such as the Requirements Management (RM) or Quality Management (QM) applications, you can configure the Global Configuration Management (GCM) application to enforce project area associations.

Before you begin

  • The GCM application must have a friend relationship with each application that contains project areas that teams need to access. By default, all applications registered to the same Jazz™ Team Server are automatically friends, and GCM shows the configuration-enabled project areas of its friends.
  • Applications that provide configurations must be at the same version as the GCM application.

    If other applications that contribute configurations to GCM hierarchies are at earlier versions than the GCM application, the configuration pickers in those applications do not filter the list of project areas that team members see. However, the GCM application still enforces project area associations, so team members might select a local configuration that is not valid for the GCM associations.

About this task

By default, project area associations are not enforced and all accessible configuration-enabled project areas of friend servers are shown. When team members set their configuration context or add configurations to global streams (if they have permission), they can choose configurations from any project area that they belong to.

Consider a scenario where Team1 is working in a GCM project area for a car. Separate components represent items in the car such as the cruise control, engine, infotainment system, and so on.

Team2 is working in a separate GCM project area for a truck, and Team3 is working in a separate GCM project area for a hybrid-powered car.

In this example, a Jazz Team Server has the following applications registered, and each application has several project areas:

Shows a sample JTS configuration that contains 6 CLM project areas from different applications

For each IBM® Engineering Lifecycle Management (ELM) application, the configuration leads confirm which project areas contain configurations that their teams need.

Not all the project areas are relevant to each other. For example, the team working on the hybrid-powered car doesn't need configurations from the truck. To limit the options that team members have when they build configuration hierarchies, in each GCM project area (GCM-Car, GCM-Truck, and GCM-Hybrid), you define the project area associations (Uses – Configurations) to each project area that contributes or might contribute configurations, as follows:
Shows a GCM instance that has 3 project areas
Note: When you add the Uses – Configurations association from a GCM project area to another project area, the corresponding Provides Configurations is added automatically in the other project area.
After you set up the project area associations and configure the GCM instance to enforce the associations, these changes occur:
  • The Add Configurations dialog box in GCM shows only the project areas that have a Provides Configurations association to the project area of the selected configuration.
  • The Select the Configuration Context dialog box for setting a global configuration context in other applications, such as the RM and QM applications, shows GCM project areas where there is a direct or indirect (transitive) Uses Configurations association to the current project area.

Procedure

  1. Go to the GCM application administration page at https://hostname:port/gc/admin, and click Project Areas > Active Project Areas on the banner.
  2. For each project area in the list, determine the project area associations that you must create based on present and anticipated contributions.
    1. To identify the project area associations based on the present contributions between project areas, run the SPARQL query provided on the Global Configuration Management - Project Area Associations wiki.
    2. Ask configuration leads which project areas might contribute configurations to the current project area in the future.
  3. For each project area in the list, add the project area associations based on your findings from step 2.
    Note: You must complete this step before you complete step 5. Otherwise, team members will not see the configurations they need in configuration pickers and in the Select the Configuration Context dialog box when they set the configuration context.
    1. Click a project area name.
    2. In the Associations section, click Add.
    3. In the Add Association dialog box, select the application that contains the project areas to access.
    4. On the Association menu, click Uses – Configurations. A corresponding Provides - Configurations association is added in the other project area.
    5. Select a project area and click OK.
    6. Repeat steps 3.b to 3.e to add more project areas.
    7. Click Save.
  4. Open the GCM Advanced Properties page. On the banner, click Application, and then click Advanced Properties.
  5. Set the Project area associations are required for contributions property to true, and then click Save.
  6. Stop and restart the GCM application.
  7. Stop and restart each application that you added in step 3.c.

    You must restart this GCM and all Jazz applications that use it when you change the Project area associations are required for contributions property as described in step 5. You don't have to restart an application if you only add or remove project area association from the list.

    Note: If you install other applications that contribute to global configurations and the Project area associations are required for contributions property is not set to its default value (false), you must restart those new applications after you register them.

Results

  • The Add Configurations dialog box in GCM shows only the project areas that have a Provides Configurations association to the project area of the selected configuration.
  • The Select the Configuration Context dialog box for setting a global configuration context in applications such as the RM and QM applications shows GCM project areas where there is a direct or indirect (transitive) Uses Configurations association to the current project area.
  • The GCM server enforces the constraint that the selected configuration's project area has a Uses Configurations association with the contribution's project area.
  • Team members can see the project area associations on the All Projects page. On the banner, click Home Menu and, in the Global Configuration Management section, click All Projects.
  • Administrators can see the associations on the Overview tab of the project area editor. On the banner, click Administration Shows the Administration icon > Manage Project Areas > project_area and, on the Overview tab, scroll to the Associations section.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki