7.6 Moving Views

This section discusses the following tasks:

• Changing the physical location of a snapshot view's directory tree

• Moving a view storage directory

For information on changing a view-tag, see the mktag reference page in the Command Reference.

Changing the Physical Location of a Snapshot View

If the snapshot view storage directory is in a storage location, you can use the standard mv command to move it. You can move the view to a different workstation, but the workstation must run a UNIX operating system.

CAUTION: If the view storage directory is located below the root directory of the view, do not use the standard mv command to move the snapshot view. Instead, see Moving a View Storage Directory.

To Find the Location of the View Storage Directory

Enter the following command:

cleartool lsview -long view-tag

The Global Path field displays the pathname for the view storage directory.

Update After Moving

After moving a snapshot view, you must use cleartool update (or cleartool update -print) to modify .ccase_svreg in your home directory. Some ClearCase operations use information from this file and will not succeed until you use update to modify it.

Moving a View Storage Directory

Each dynamic view and snapshot view includes a view storage directory, which ClearCase uses to maintain the view. Do not use the standard mv command to move a view storage directory for the following reasons:

• The view storage directory includes a database. Moving the database without first shutting down the view's view_server process can corrupt the database.

• ClearCase stores the location of view storage directories in its own set of registries. The information in these registries must be correct for you to perform ClearCase operations in your views. In a dynamic view, the location in ClearCase registries must be correct for you to access any file or directory in the view.

We suggest that you ask your ClearCase administrator to move view storage directories because it may affect other, potentially many other, ClearCase users at your site. The Administrator's Guide for Rational ClearCase describes the procedure for moving view storage directories.

CAUTION: You will lose data (including view-private files in a dynamic view) if you move a view storage directory without following the procedure described in the Administrator's Guide.