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®?

Cause

You chose VOB names that resemble your project names to easily distinguish the VOBs. Now, you changed your project names, because you merged two products into one.

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; see technote refer to Start and stop ClearCase from the Windows command line 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; see technote Start and stop ClearCase from the Windows command line
    for directions on stopping the services.

    See technote How to use the Rational ClearCase albd_list utility for further information about 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

Document information


More support for:

Rational ClearCase
VOB

Software version:

7.1.2, 8.0, 8.0.1

Operating system(s):

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

Reference #:

1124390

Modified date:

2010-11-23

Translate my page

Content navigation