Commvault End-User Command Line (cvc) Interface Example: restore

Updated

Name

restore

Synopsis

restore [-h] [-c CLIENTNAME] [-i INSTANCENAME] [-bk BACKUPSETNAME] [-sc SUBCLIENTNAME][-path SOURCEPATH [SOURCEPATH ...] | -l RESTOREFILELIST | -list])[-dc DESTCLIENT] [-dp DESTPATH] [-ftime FROMTIME] [-ttime TOTIME] [-versions VERSIONS] [-uo UNCONDITIONALOVERWRITE {True,False}] [-filter BROWSE_FILTER [BROWSE_FILTER ...]] [path]

Description

Restore the backup.

You can perform the following restore types:

  • In-Place

  • Out-of-Place

  • Point-in-Time

If you want to perform a point-in-time restore, then you must use one of the following options:

  • The from time

  • The to time

  • The from and to time

The table lists the options that the software supports.

Option

Description

-c

The CommCell Console client name.

The software uses the information that is in the computer registry when you do not specify this option.

-i

The CommCell Console instance name.

-bk

The CommCell Console backup set name.

The software uses the DefaultBackupSet when you do not specify this option.

-sc

The CommCell Console subclient name.

The software uses the DefaultBackupSet and the default subclient when you do not specify this option.

-path

The path on the source that contains the data that you want to restore.

You can specify relative paths.

-l

The list of files that you want to restore.

-dc

This is the destination client name. You must use this option, or the -dp option when you perform an out-of-place restore operation.

-dp

This is the path on the destination client where you want to restore the data. You must use this option or the -dc option when you perform an out-of-place restore operation.

-ftime

The from time that you specify for a point-in-time restore operations. The format is yyyy-mm-dd hh:mm:ss.

-ttime

The to time that you specify for a point-in-time restore operations. The format is yyyy-mm-dd hh:mm:ss.

-uo

Configure the software to automatically overwrite the data on the destination. Valid values are:

  • True

  • False

-versions

Restore all the versions, or a specific version. The software restores all versions by default. To restore a specific version, set this to the backup versions number that you want to restore, for example, "1".

-list

Dynamic list for the restore operation.

-filter

File name filters for the restore operation.

-h

Displays the help for this command.

Examples

Perform an Out-of-Place Restore Operation to a New Folder

The following command performs an out-of-place restore operation. The data is restored to a new path on the source client. In this example, the parameters are listed on the command line.

cvc> restore -c example_client -sc good -path "C:\Users\admin\Desktop\good2" -dc example_client -dp "C:\Users\admin\Desktop\logs" -ftime "2017-09-23 08:00:00" 

Restore Job Initiated successfully

<?xml version="1.0" ?>

<Task> <JobID>589132</JobID>

</Task>

Restore Initiated Successfully Job ID : 589132

Perform an Out-of-Place Restore Operation to a New Client

The following command performs an out-of-place restore operation. The data is restored to a new client. In this example, the parameters are listed on the command line.

cvc> restore -c example_client -sc good -path "/tmp/test" -dc example_client_latest -dp "/tmp/test/new"

Restore Job Initiated successfully

<?xml version="1.0" ?>

<Task> <JobID>595584</JobID>

</Task>

Restore Initiated Successfully Job ID : 595584

Perform a Restore Operation That Overwrites the Data on the Destination

The following command overwrites the data at the destination. In this example, the parameters are listed on the command line.

cvc> restore -c example_client -sc good -path "/tmp/test" -outplace True -dc example_client_latest -dp "/tmp/test/new" -uo True

Restore Job Initiated successfully

<?xml version="1.0" ?>

<Task> <JobID>595583</JobID>

</Task>

Restore Initiated Successfully Job ID : 595583

Perform a Restore Operation from a List

The following command creates a restore list, and then performs a restore operation from the list. In this example, the parameters are listed on the command line.

cvc > restore_list

cvc > add /testdata/Dir_0_705/Dir_1_705

cvc > add /tmp/restore

cvc > list

Restore list: {'/testdata/Dir_0_705/Dir_1_705', '/tmp/restore'}

cvc > restore -list -dp /tmp

<TMMsg_CreateTaskResp taskId="4325">

<jobIds val="34417"/>

</TMMsg_CreateTaskResp>