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:
|
-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 : 589132Perform 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 : 595584Perform 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 : 595583Perform 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>