Question & Answer
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.
Network Attached Storage Considerations
Rename a VOB
- Unmount the VOB.
Run cleartool umount \<VOB-tag> on the local host.
Notes: - 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.
- All snapshot views will need to load the VOB with the new name (tag).
- 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.
- Remove the VOB tag.
Run
to untag the VOB.
cleartool rmtag -vob -all \<VOB-tag>
- Remove the ClearCase registry entry.
Run
to unregister the VOB object.
cleartool unregister -vob <VOB-storage-pname>.vbs
- 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
- Register the new name of the VOB storage.
Run
cleartool register -vob <new-VOB-storage>.vbs
- Create a new tag for the VOB.
Run
cleartool mktag -vob -public -tag \<new-VOB-tag> <new-VOB-storage>.vbs
- Mount the new VOB tag.
Run
on all clients to remount the VOB
cleartool mount <new-VOB-tag>
Notes: - For ClearCase only (not CCLT).
- 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.
Rename a View
- 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.
- 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.
- Remove the view-tag.
Run
to untag the view.
cleartool rmtag -view <view-tag>
- Remove the ClearCase registry entry.
Run
to unregister the view object.
cleartool unregister -view <view-storage-pname>.vws
- 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
- Register the new name of the view storage.
Run
cleartool register -view <view-storage-pname>.vws
- Create a new tag for the view.
Run
cleartool mktag -view -tag <view-tag> <view-storage-pname>.vws
- (dynamic view only) Start the View.
Run
cleartool startview <new-view-tag>
- (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
- You can find online documentation on the following page.
Rational ClearCase welcome page
Related Information
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21124390