IPnom Home • Manuals • ClearCase

 Rational ClearCase Commands Reference

ClearCase Stuff:ClearCase LinksClearCase BooksClearCase Commands ReferenceClearCase ForumsClearCase News
Keyword Live Search (10 results max):
 Type in part of a ClearCase command in the search box.
Commands Index:


Restores a VOB from backup media.


ProductCommand type
ClearCase LTcommand



vob_restore [ –restart restart-path ]  vob-tag


The vob_restore command restores a damaged VOB. It prompts for all required input and displays explanatory text at each step. If you quit vob_restore before it completes, you can use the –restart option to resume VOB restoration at the point where you stopped it.

If the VOB is replicated, you must run the MultiSite restorereplica command immediately after restoring the VOB from backup. For more information, see the Administrator's Guide.

Note: We strongly recommend that you do not retrieve VOB storage from backup until prompted to do so by vob_restore. If you get the VOB storage directory from backup media before running vob_restore, you must either unregister the VOB before retrieving the backup or stop ClearCase or ClearCase LT before retrieval and restart it afterward. If you wait until prompted, vob_restore performs the necessary steps, safeguarding the integrity of your restored VOB.



You must have one of the following identities:

  • root (UNIX)
  • Server host administrator (ClearCase on Windows)
  • Member of the ClearCase administrators group (ClearCase on Windows)
  • Local administrator of the ClearCase LT server host (ClearCase LT on Windows)


If the VOB is still accessible, lock it to prevent any further changes. vob_restore leaves the VOB locked when it completes.


(Replicated VOBs only) No mastership restrictions.


If you do not specify all required command line arguments, vob_restore prompts for input.

Specifying the VOB

None. You must supply a VOB tag. vob_restore prompts for all additional information.

The VOB's VOB tag, as specified in mkvob or mktag –vob.

Specifying a Restart File

None. If you omit this option, vob_restore does not attempt to find a restart-state file that may have resulted from an earlier, aborted vob_restore invocation on the same VOB tag.

–restart restart-path
Specifies the pathname of the restart file saved during a previous invocation. Always record the restart-path that is reported by vob_restore when you stop VOB restoration before it has completed.


Note: In the UNIX examples that follow, arguments and output that show multicomponent VOB tags are not applicable to ClearCase LT, which recognizes only single-component VOB tags. In this manual, a multicomponent VOB tag is by convention a two-component VOB tag of the form /vobs/vob-tag-leaf—for example, /vobs/src. A single-component VOB tag consists of a leaf only—for example, /src. In all other respects, the examples are valid for ClearCase LT.

  • Restore VOB /vobs/src. To complete the recovery, run checkvob to find and fix inconsistencies between the restored VOB database and the restored VOB storage pools. vob_restore prompts for all required information.

    Note: In this example, as is recommended, the restored data is not retrieved from backup media before running vob_restore.

    /opt/rational/etc/vob_restore /vobs/src 


checkvob, mktag, mkvob, restorereplica, vob_snapshot, vob_snapshot_setup, Administrator's Guide



ClearCase Links • ClearCase Books • ClearCase Commands Reference • ClearCase Forums • ClearCase News