15.3 Before Relocating Elements

Take the following steps before moving elements from one VOB to another:

1. Inform users of your intentions. The affected source and target VOB elements must be inactive during the relocate operation.

Inform users that relocated elements will cause rebuilding of DOs that include them as dependencies.

2. Have users move view-private files out of directories that are to be relocated. If view-private files are not moved from relocated directories, they become stranded.

These files can be recovered to view-stg-dir\.s\lost+found with recoverview -sync view-tag. However, it is easier to move them to new locations before running relocate.

Checked-out files are also view-private and must be resolved before running relocate. The command aborts if any files are checked out from a directory it is trying to relocate.

3. Coordinate with administrators of all other VOB replicas, if any. Affected elements must be inactive at all replica sites. See the section on replicated VOBs in the relocate reference page.

4. Check for views with checkouts or DOs in the VOB. Use the VOBs node in ClearCase Administration Console. This node has DOs and Referenced Views subnodes that list all views with checkouts and/or DOs in the VOB and allow you to manage these objects from the console window. You can also use the cleartool lsdo and lscheckout commands to list DOs and checkouts on a per-view basis.

5. Resolve any checkouts. Resolving checkouts typically involves notifying the appropriate users about the problem. relocate aborts if it encounters an active checkout in any directory it is trying to move.

6. Establish a working view. Use a working view whose config spec selects the branch (typically \main) on which the move is to occur.

This step is very important. Your view must be able to see and check out elements in both the source and destination VOBs. Therefore, a working view configured without a CHECKEDOUT rule, for example, is inappropriate. Also, run relocate with the same view or with the same config spec that you will use to adjust makefiles, rebuild libraries, reset config specs, modify development tools, or complete any other work that may accompany the relocate task. See also After Relocating Elements.

7. Run relocate in test mode. Run the intended relocate command and monitor its output, but stop short of moving any elements by responding no at this prompt:

Do you want to relocate these objects? [no]

You may want to include the -qall option in your test run, to examine relocate's potential handling of borderline elements:

cleartool relocate -qall dir1 \new

When relocate encounters a borderline element, its output looks like this:

Element "f3" is
located outside the selection tree as "f3" in
directory "\bigdir\dir2",
located inside the selection tree as "f3" in
directory "\bigdir\dir1".
Do you want to relocate it? [no]