Renaming a ClearCase VOB or View

Technote (FAQ)


Question

How do I rename an IBM® Rational® ClearCase® VOB or view on Microsoft® Windows®, UNIX® or Linux®?

Answer

To completely rename a ClearCase VOB (replicated or non-replicated) or View requires that both the storage and the tag be renamed.

These operations can be performed from a command line.

The instructions below are designed to provide the basic steps. Refer to the documentation listed at the bottom of this technote for further details about the commands and their options.






Rename a VOB

  1. Unmount the VOB.

    Run cleartool umount \<VOB-tag> on the local host.

    Notes:
    1. For ClearCase only (not CCLT), any host that has it mounted with the old name after the rename has been completed will need to be rebooted to clear the MVFS.
    2. All snapshot views will need to load the VOB with the new name (tag).

  2. Kill the vob_server process for the VOB. The command will vary on differing operating systems, refer to technote 1148639 for directions.

    Note: Stopping the ClearCase services on the host will also kill the process; refer to technote 1134178 for directions on stopping the services.

  3. Remove the VOB tag.

    Run cleartool rmtag -vob -all \<VOB-tag> to untag the VOB.

  4. Remove the ClearCase registry entry.

    Run cleartool unregister -vob <VOB-storage-pname>.vbs to unregister the VOB object.


  5. Rename the VOB storage directory using operating system commands:

    Example:
    • UNIX or Linux

      mv <old-VOB-storage> <new-VOB-storage>.vbs
    • Windows

      rename <old-VOB-storage> <new-VOB-storage>.vbs

  6. Register the new name of the VOB storage.

    Run cleartool register -vob <new-VOB-storage>.vbs

  7. Create a new tag for the VOB.

    Run cleartool mktag -vob -public -tag \<new-VOB-tag> <new-VOB-storage>.vbs

  8. Mount the new VOB tag.

    Run cleartool mount <new-VOB-tag> on all clients to remount the VOB

    Notes:
    1. For ClearCase only (not CCLT).
    2. For MultiSite® replicated VOBs, the steps are the same as above to rename the VOB. When renaming a replicated VOB it is recommended that the VOB tags match with the other sites to avoid confusion.
Refer to the IBM Rational ClearCase Administrators Guide on the topic of Moving VOBs for information on moving instead of renaming the VOB.


Rename a View

  1. Stop the view.
    Run cleartool endview <view-tag>

    Note: For ClearCase only, any host that has a dynamic view started with the old name after the rename has been completed will need to be rebooted to clear the MVFS.

  2. Kill the view_server process. Run cleartool endview -server <view-tag>

    Note: Stopping the ClearCase services on the host will also kill the process; refer to
    technote 1134178 for directions on stopping the services.

    Refer to technote 1148639 About albd_list for further information regarding how to list active ClearCase server processes.

  3. Remove the view-tag.
    Run cleartool rmtag -view <view-tag> to untag the view.

  4. Remove the ClearCase registry entry.
    Run cleartool unregister -view <view-storage-pname>.vws to unregister the view object.

  5. Rename the view storage directory using operating system commands:

    Example:
    • UNIX or Linux
      mv <old-view-storage> <new-view-storage>.vws
    • Windows
      rename <old-view-storage> <new-view-storage>.vws

  6. Register the new name of the view storage.
    Run cleartool register -view <view-storage-pname>.vws

  7. Create a new tag for the view.
    Run cleartool mktag -view -tag <view-tag> <view-storage-pname>.vws

  8. (dynamic view only) Start the View.
    Run cleartool startview <new-view-tag>

  9. (snapshot view only) Rename the view root directory if you wish to have the name correspond with the storage directory name change.

    Note: This procedure describes a rename and there are additional steps that would need to be taken if you decide to move (rather than rename) the snapshot view directory which contains special files.

Refer to the IBM Rational ClearCase Administrators Guide on the topic of Moving a View for information on moving instead of renaming a view.



Network Attached Storage (NAS) considerations


To register or create a tag for a VOB or view that resides on a network attached storage (NAS) device, you must specify the option set, –host –gpath.

In the following example the VOB storage is located in the net/nasdevice/vobst_aux/flex.vbs directory on a NAS device and the UNIX or Linux hosting server is ccvobsvr1.

Example:

cleartool register –vob –host ccvobsvr1 –hpath /net/nasdevice/vobst_aux/flex.vbs –gpath /net/nasdevice/vobst_aux/flex.vbs /net/nasdevice/vobst_aux/flex.vbs

cleartool mktag –vob –replace –host ccvobsvr1 –tag /vobs/flex –hpath /net/nasdevice/vobst_aux/flex.vbs –gpath /net/nasdevice/vobst_aux/flex.vbs /net/nasdevice/vobst_aux/flex.vbs


Documentation



Related information

About the MultiVersion File System (MVFS)
Remove view references from ClearCase Admin Console

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearCase VOB
Software Development Rational ClearCase View: Snapshot
Software Development Rational ClearCase View: Dynamic
Software Development Rational ClearCase View: Snapshot

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational ClearCase
VOB

Software version:

7.0, 7.0.1, 2003.06.00, 2003.06.16

Operating system(s):

AIX, HP-UX, IRIX, Linux, Solaris, Windows

Reference #:

1124390

Modified date:

2010-11-23

Translate my page

Machine Translation

Content navigation