Rehome is a quick and easy way to switch a work area from one stream to another.
Key Facts
Rehome fetches any required content into your existing work area so that it matches the stream you are rehoming to.
Rehome avoids the need to fetch to a clean work area when switching to a different stream and is faster.
Rehome preserves locally modified files and new files, for example, built outputs.
Rehome is ideal for use with topic streams as switching work is easier.
Rehome works for any stream, not just topic streams.
Rehome works even if your work area is not up to date with the tip of the stream.
If rehoming fails because of conflicting changes between the local content and the target stream, Micro Focus recommends using a clean work area.
You cannot rehome just a sub-folder if the parent work area contains other controlled items that are not in the selected sub-folder.
Amy is working on the stream Feature_1. She has made changes locally and delivered them to a CM repository.
A request for a change comes in and Amy starts work on it by creating a new topic stream.
Amy needs a work area for the topic stream development work. She could fetch to a new local folder, but this may be slow as it fetches all the files from the topic stream.
Instead, Amy rehomes her existing work area. The work area is updated so it is now associated with the topic stream instead of the feature stream.
