Creating a baseline staging stream from a baseline hierarchy

Teams might create a baseline staging stream from a baseline hierarchy to replace baselines of components with newer baselines that contain a fix.

Before you begin

  • You must have the Baseline Maker or Configuration Lead role to create baseline staging streams and manage their contributions.
    Note: To control who can replace contributions or add, remove, and move contributions in baseline staging streams, administrators can set finer-grained permissions. For details, see "Baseline Maker" in Role-based permissions for Global Configuration Management (GCM).
  • In the global configuration tree view, the root refers to the global configuration at the top of the tree. The root might be a member of another global configuration, so root does not necessarily mean the top-most global configuration.

About this task

Recall that a stream is modifiable, while a baseline is frozen.

In the following steps, create a baseline staging stream to fix part of a baseline. For example, during baseline testing, the testers find defects that must be fixed in some components of the system.

Before you commit the baseline, you must replace the baselines that contain the defects with the baselines that contain the fixes from contributing applications. After you commit the baseline, you can no longer change it.


  1. Create a baseline staging stream to fix defects in some components of your system by right-clicking the appropriate baseline and selecting Stage Baselines.

    The baseline hierarchy is replaced with the new baseline staging stream where you can replace or remove the appropriate baseline with the baselines or streams that fix the defects. Global configuration baselines above the selected baseline that are required to complete the baseline staging stream hierarchy are also replaced.

    Communication with team leads or other configuration leads in the contributing applications is important to help you understand when you can replace defective baselines from contributing applications with baselines in your global configuration.

    If the selected baseline has a root baseline, the new baseline staging stream is displayed in the tree view as the root.

  2. Enter a name suffix that describes the reason why you are capturing the milestone. The name suffix is used to form new baseline names by appending it to global configuration stream names.
  3. Add or remove tags, as needed. (Tags is displayed only if you are in the Stage Baselines dialog box.)

    After the baseline staging stream is created, you can modify tag and attribute values, add or remove tag and attribute values, and add or remove links. Learn about adopting changes made to attribute and link labels or values after they were added to a global configuration in Tags, attribute values, and links.

  4. Notify the team leads from contributing applications that the baseline staging stream is available. Then, for each defective baseline from contributing applications, ask team leads to tell you after they created fixed baselines in their application.
  5. After the contributing application team leads declare that a baseline is frozen in their application, right-click the stream or baseline, and select Replace. Ensure that you replaced each defective baseline in the baseline staging stream with a fixed baseline.

    For details, see "Replace a configuration" in Managing configurations.

  6. Commit the repaired part of the baseline hierarchy.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki