13.2 Taking a VOB Out of Service

Suppose that the VOB to be taken out of service has storage directory /net/sol/vobstore/libpub.vbs and has VOB-tag /proj/libpub. To make the VOB inaccessible:

1. Have all clients unmount the VOB. On each client, this command unmounts the VOB:

cleartool umount /proj/libpub

NOTE: You can also unmount and unregister a VOB from the ClearCase shortcut menu in Windows Explorer or, on UNIX, using the clearvobadmin utility

2. Remove the VOB from the object registry. Removal prevents anyone from reactivating the VOB. Use the ClearCase Administration Console's VOB Objects node (a subnode of the ClearCase Registry node) to remove the VOB object. You can also use this command:

cleartool unregister -vob /net/sol/vobstore/libpub.vbs

3. (Optional) Remove the VOB from the tag registry. Use the VOB Tags node of the ClearCase Administration Console to remove the VOB's VOB-tag from each region where you want to temporarily take the VOB out of service. If you do not remove the VOB-tag from the tags registry, attempts to mount the VOB produce the following error message at the client:

cleartool mount /proj/libpub
cleartool: Error: An error occurred mounting.
Refer to the log file "/var/adm/atria/log/mntrpc_server_log"
for more information on the warning or failure.

If you remove the VOB-tag, the error message from cleartool mount is more informative:

cleartool rmtag -all -vob /proj/libpub
cleartool mount /proj/libpub
cleartool: Error: /proj/libpub is not a registered vob tag.

(The -all option ensures correctness in a network with multiple regions; the VOB-tag is removed from all the logically distinct tags registries.)

4. Terminate the VOB's server processes. If the VOB host is a UNIX computer, search the server's process table for the vob_server and vobrpc_server processes that manage that VOB. Use ps -ax or ps -ef, and search for /vobstore/libpub.vbs; use kill(1) to terminate any such processes. (On UNIX, only the root user can kill a vobrpc_server process.)

Restoring the VOB to Service

To restore a VOB to service:

1. Restore the VOB to the object registry. Use the VOB Objects subnode of the Registry node in ClearCase Administration Console to create a VOB object entry. Or use this command:

cleartool register -vob /net/sol/vobstore/libpub.vbs

NOTE: If you are registering a UCM project VOB, you must use the -ucmproject option with the register command.

2. (If necessary) Restore the VOB to the tag registry. This is necessary only if you removed the VOB-tag in Step #3 of Taking a VOB Out of Service. Use the VOB-Tags node of the ClearCase Administration Console. Or use this command:

cleartool mktag -vob -tag /proj/libpub /net/sol/vobstore/libpub.vbs

(Repeat, as necessary, for other network regions.)

3. Have clients reactivate the VOB. On each client host, this command mounts the VOB:

cleartool mount /proj/libpub