Summary of rules for rebasing a stream

This topic summarizes the rules for rebase operations. You can rebase a stream to a baseline that meets any of the following criteria:

Additional rules apply to integration streams and development streams in selecting a baseline. The following are general rules that apply to all types of rebase operations:

You need to satisfy only the general rules if you are adding a component to a stream.

Note: Read-Only streams and nonmodifiable components in a development stream are exempt from the general rules. However, if the modifiability of the component changes in the future, the development stream might not be able to modify the component at the baseline with which it is configured. The development stream might be able to modify the component at the baseline it is configured with if the baseline is contained in its parent stream for this component. Otherwise, it may not until the baseline is rebased to a compatible baseline for that component.

Rebase typically advances the configuration of a stream, that is, it replaces the current foundation baselines of the stream with more recent ones. However, under certain conditions, rebase can be used to revert a baseline; to add or drop a component in the configuration of a stream; and to switch to a baseline that is neither an ancestor nor a descendant of the current foundation. When you advance, revert, drop, or switch a baseline, you need to satisfy the general rules and the following additional ones:

These rules ensure that any changes made in a stream are not lost when the configuration changes.