vob_restore

Restores a VOB from backup media

Applicability

Product

Command type

ClearCase®

command

Platform

UNIX®
Linux®

Windows®
Parent topic: Backing up and restoring VOBs
Parent topic: Rational ClearCase command reference

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 IBM Rational ClearCase Administrator's Guide.

Important: 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 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 and Linux)
  • Server host administrator (ClearCase on Windows)
  • Member of the ClearCase administrators group (ClearCase 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

  • Restore VOB /vobs/src on a UNIX or Linux system. 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/clearcase/etc/vob_restore /vobs/src

See also

checkvob, mktag, mkvob, vob_snapshot, vob_snapshot_setup, IBM Rational ClearCase Administrator's Guide, and in the IBM Rational ClearCase MultiSite Administrator's Guide, the restorereplica command.

Feedback