Renaming a ClearCase VOB or View

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

Rename a view

Network Attached Storage Considerations

Documentation

---

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

• On-line documentation can be found:
  
  About the ClearCase Information Center
  
  Note: The on-line ClearCase version 7.x documentation can be found in the IBM Publication Center and has been organized for you in technote 1239261.