Updating streams to match baselines in the Global Configuration Management application

You can update a global stream by replacing its baselines with those from another global baseline. For example, update a stream to include content from a more recent milestone baseline, or roll back to a previous baseline. Configurations in the global stream are added, removed, and replaced to match the baseline that you choose.

Before you begin

  • Consider creating a baseline of the global stream so that if the changes are not what you expect, you can roll back to undo the changes.
  • The hierarchy to update must contain a global stream of the same component as the global baseline you update with. Using the example in this topic:
    • You can update Car Sport Global Stream with Car Sport June 1 Global Baseline; they're both configurations of the Car component.
    • You can update Car Sport Global Stream with Engine Sport June 1 Global Baseline; the nested Engine Sport Global Stream and Engine Sport June 1 Global Baseline are configurations of the Engine component.
    • You can't update Engine Sport Global Stream with Car Sport June 1 Global Baseline because Engine Sport Global Stream doesn't contain a configuration of the Car component.
    • You can't update Engine Sport Global Stream with Infotainment Sport Global Stream because they're configurations of separate components and neither contains configurations of the other's component.

About this task

Remember:
  • To expand or collapse nested configurations in the tree, click the parent configuration and select Expand All or Collapse All from the menu or the toolbar.
  • You can update only global streams. You cannot update local streams with baselines.
  • Use the Replace action to exchange a configuration in the hierarchy with a different configuration of the same component. You can replace a stream with a stream, a baseline with a baseline, a stream with a baseline, and the reverse.

    For example, you can replace Engine Sport Global Stream with Engine Sport June 1 Global Baseline . The Engine Sport Global Stream and its configurations are removed from the car stream and replaced with Engine Sport June 1 Global Baseline and its configurations.

You can update a global stream that your team uses to match a global baseline produced by another team. For example, as your team develops a product variant, you can update your stream with baselines that are produced by the platform team to use more recent versions of common components.

The update action makes these changes:
  • Baselines in the target global stream are replaced to mirror the source baseline hierarchy that you update from.
  • Global streams have their configurations that are updated to mirror the configurations in the source baseline you update from.
  • Local streams do not change, but they might be removed. See the next item.
  • Streams are removed if there is no corresponding baseline in the same component. In Example 1, see how Sunroof Sport Global Stream is removed because there's no sunroof baseline in the car component.

You do not have to select a baseline that matches the top level of the target stream hierarchy. The baseline might not have an obvious relationship with the stream; it might match a configuration that is deeply nested in the target stream hierarchy. See Example 2, which updates the high-level Car Sport Global Stream with Engine Sport Global Baseline. The system then determines which configurations to update.

Procedure

  1. Right-click a global stream in tree view and click Update.
  2. Select a global baseline from the list.
    The Confirm Update Stream dialog box shows the maximum number of configurations that might be added, updated, or removed. If the information isn't what you expect, select another baseline or select a different starting point in the stream hierarchy.

Results

The baselines in the target stream are replaced to match those in the source baseline that you chose in the Update dialog box.

Example

Example 1. Updating an entire hierarchy

Consider the Car Sport Global Stream hierarchy in the "Before" column of the following image. This stream contains configurations of the car's infotainment, engine, and sunroof components.

To update this stream with the contents of a more recent baseline of the car, in the configuration hierarchy, right-click Car Sport Global Stream > Update, and select Car Sport June 1 Global Baseline.

The system determines that Car Sport Global Stream and Car Sport Global Baseline are configurations of the same component, so it examines only that stream and its nested configurations. Though not shown in this example, streams higher than or peer to Car Sport Global Stream are not examined.

After the update finishes, only baselines are updated in the target stream. The global and local streams and their location in the hierarchy do not change (except the Sunroof Sport Global Stream).

Car Sport Global Stream and Car Sport Global Baseline both contain configurations of the infotainment and engine components, so the following elements are updated:
  • All the baselines in Infotainment Sport Global Stream are replaced
  • Satellite Radio - Sprint 17 Global Baseline is replaced with Satellite Radio - Sprint 18 Global Baseline
  • Engine CU 2176 May 28 Global Baseline is replaced with Engine CU 2176 June 1 Global Baseline
  • Engine CU 3295 May 28 Global Baseline is removed because it is not in Car Sport June 1 Global Baseline
  • Engine CU 4796 June 1 Global Baseline is added to the hierarchy
  • Sunroof Sport Global Stream is removed because Car Sport Global Baseline doesn’t contain a baseline of the sunroof component
Example 2. Ensuring only specific sections in the hierarchy are updated

Suppose that you want to ensure that only specific streams are updated. You might do it to strictly control changes to sections of the hierarchy. Configurations that are higher than or peer to the source baseline you choose are not affected.

In this example, you update the infotainment and engine streams in separate steps to preserve the other sections of the hierarchy.
  1. Right-click Infotainment Sport Global Stream > Update and select Infotainment June 1 Global Baseline.

    Only the infotainment stream is updated. The higher-level car global stream and peer engine and sunroof streams do not change.

  2. You might then update the engine stream with an engine baseline. Right-click Engine Sport Global Stream > Update and select Engine Sport Global Baseline.

    Only the engine stream is updated:

Example 3. Updating a stream with no obvious relationship to the baseline

Suppose the stream to update is deeply nested in the hierarchy or there's no obvious relationship to the baseline to update with. Right-click a high-level stream and let the system determine which baselines to update.

In this example, you want to update the stream to use a more recent engine baseline but you aren't sure where it is in the hierarchy.
  1. Right-click Car Sport Global Stream > Update and select Engine Sport June 1 Global Baseline.

    The system finds the nested Engine Sport Global Stream and updates the configurations as shown in this image: