Changes the configuration of a stream
Product | Command Type |
---|---|
ClearCase | cleartool subcommand |
ClearCase LT | cleartool subcommand |
Platform |
---|
UNIX |
Windows |
Begin a rebase operation using the graphical user interface:
Cancel or check the status of a rebase operation:
Preview a rebase operation:
Begin a rebase operation:
Resume or complete a rebase operation:
The rebase command reconfigures a stream by adding, dropping, or replacing one or more of the stream's foundation baselines. The file and directory versions selected by those new baselines (and thus their associated activities) then become visible in the stream's views.
Only labeled baselines can serve as foundation baselines.
Any changes made in the stream prior to a rebase operation are preserved during the rebase. For any file modified in the stream, rebase merges any changes that are present in versions of that file in the new foundation baselines into the latest version of that file in the stream, thereby creating a new version. All such merged versions are captured in the change set of an integration activity that rebase creates. This integration activity becomes the view's current activity until the rebase operation is completed or canceled.
You must perform a rebase operation in a view belonging to the stream that is being rebased. Before starting the rebase operation, check in all files in that view. This way, you avoid potential problems caused by rebase merging changes into an checked-out file; rebase cannot reliably unmerge those changes should you cancel the rebase operation.
If you want to recommend a baseline after rebasing to it, you must add it to the list of recommended baselines with chstream -recommended.
As a rule, you should rebase development streams often to pick up changes in the project's recommended baselines. By doing so you can find integration problems early, when they are easier to fix. In addition, rebasing just before performing a deliver operation should reduce or eliminate the need for manual merging during the delivery.
You may not rebase when a deliver operation is in progress.
A development stream can be rebased to baselines that were created in its parent stream, that are in the parent stream's foundation, or that were created in other streams in the project, provided that they have been delivered to the parent stream and they contain the foundation baselines for the stream to be rebased. The parent stream of a development stream can be the project's integration stream or a feature-specific development stream (a stream created for developers working together on specific parts of the project). These rules allow flexibility in sharing work across streams in the project, but also ensure that a stream only delivers work created by itself, and does not leave stranded changes created by the stream.
rebase is typically used to advance a stream's configuration, that is, to replace its current foundation baselines with more recent ones. However, you can also use rebase for other purposes:
To revert to earlier baselines
To add baselines for components not currently in the stream's configuration
To drop components from the stream's configuration
You cannot revert or drop a component that has been modified (that is, new versions have been created) in the development stream. Without this rule, rebase could leave stranded the changes made against baselines that are no longer in the stream's configuration.
rebase allows different baselines to be moved in different directions; you can advance one baseline while reverting another.
An integration stream can be rebased only to baselines created in other projects or to imported or initial baselines. See the mkcomp and mkbl reference pages for information about imported and initial baselines.
Just as for development streams, rebase can advance or revert baselines in an integration stream's configuration, and add or drop components. It can also switch to another baseline that originates from a project with a different foundation baseline; that is, a baseline that is neither an ancestor nor a descendant of the current foundation.
You cannot revert, switch, or drop baselines for components that are in the project's modifiable component list. This rule prevents rebase from leaving stranded the changes made to those components in the integration stream, as well as in the project's development streams in the same or a different VOB replica.
In a rebase operation, automatic merging is the default behavior for elements, unless user or never merge types were set for the elements. For information about setting merge behavior for an element type, see mkeltype.
Rebase and deliver operations handle elements of user or never merge types in much the same way. For more information, see this topic in deliver.
Identities: No special identity required.
Locks: An error occurs if one or more of these objects are locked: the project VOB, the development stream.
Mastership: (Replicated VOBs only) Your current replica must master the development stream.
INVOKING THE GRAPHICAL USER INTERFACE. Default: Command-line interface.
SPECIFYING THE REBASE VIEW. Default: If a stream is specified, the view attached to the stream (provided only one view is attached to the stream. If multiple views are attached, a view must be specified). If a stream is not specified, the current working UCM view.
SPECIFYING THE STREAM TO BE REBASED. Default: If a view is specified, the stream attached to the view. If a view is not specified, the stream attached to the current UCM view.
OBTAINING THE STATUS OF A REBASE OPERATION.
PREVIEWING THE RESULTS OF A REBASE OPERATION.
SPECIFYING BASELINES. Default: None.
RESUMING A REBASE OPERATION. Default: None.
COMPLETING A REBASE OPERATION. Default: None.
MERGE OPTIONS. Default: Works as automatically as possible, prompting you to make a choice in cases where two or more contributors differ from the base contributor. For general information, see the findmerge reference page.
CONTROLLING COMMAND-LINE PROMPTS. Default: Prompt for user input.
The UNIX examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.
Start a rebase operation.
cmd-context rebase -recommended
Advancing to baseline "BL1.119" of component "webo_modeler"
Updating rebase view's config spec...
Creating integration activity...
Setting integration activity...
Merging files...
No versions require merging in stream "chris_webo_dev".
Build and test are necessary to ensure that the merges were completed
correctly.
When build and test are confirmed, run "cleartool rebase -complete".
Complete a rebase operation.
cmd-context rebase -complete
Rebase in progress on stream "chris_webo_dev".
Started by "ktessier" at 06/06/00 15:36:42.
Merging files...
No versions require merging in stream "chris_webo_dev".
Checking in files...
Clearing integration activity...
Updating stream's configuration...
Cleaning up...
Rebase completed.
checkin, checkout, deliver, findmerge, setactivity
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |