vob_restore

Restores a VOB from backup media.

APPLICABILITY

SYNOPSIS

vob_restore   [ -restart restart-path ]  vob-tag

DESCRIPTION

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.

RESTRICTIONS

Identities: You must have one of the following identities:

• root (UNIX)

• Server host administrator (ClearCase on Windows)

• Member of the administrators' group (ClearCase on Windows)

• Local administrator of the ClearCase LT server host (ClearCase LT on Windows)

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

Mastership: (Replicated VOBs only) No mastership restrictions.

OPTIONS AND ARGUMENTS

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

SPECIFYING THE VOB.   Default: None. You must supply a VOB-tag. vob_restore prompts for all additional information.

vob-tag

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

SPECIFYING A RESTART FILE.   Default: 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.

EXAMPLES

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.

/usr/atria/etc/vob_restore /vobs/src

SEE ALSO

checkvob, vob_snapshot, vob_snapshot_setup, Administrator's Guide