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

Name

find

Synopsis

find [-c CLIENTNAME] [-i INSTANCENAME] [-bk BACKUPSETNAME] [-sc SUBCLIENTNAME] [-path SOURCEPATH [SOURCEPATH ...] -f FILENAME [-ftime FROMTIME] [-ttime TOTIME]

Description

Search the backed up data to find a particular backup that you want to restore.

After you find the backup, you can restore the backup.

You can search for backups for a particular backup set, or for a particular subclient.

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

The from time (the start time of the window during which the data was backed up)
The to time (the end time of the window during which the data was backed up)
The from and to time (the window during which the data was backed up)

The table lists the options that the software supports.

Note

If you do not specify the backup set and the subclient, then the software performs the find operation on the default backup set.

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 find. You can specify relative paths.
-f	A file that is part of the backup.
-ftime	The start time of the backup window that you specify for a point-in-time find operation. The format is yyyy-mm-dd hh:mm:ss.
-ttime	The end time of the backup window that you specify for a point-in-time find operation. The format is yyyy-mm-dd hh:mm:ss.

Example

Perform a Find for a Subclient

The following command searches for a file called example.txt for the data_subclient subclient. In this example, the parameters are listed on the command line.

cvc> find -c example_client -bk example_backup_set -sc data_subclient -f"example.txt"
Find List: /tmp/data3/example.txt 
Specifications of Files in the Given path 
name:example.txt 
size:7756 
modified_time:15/09/2016 11:24:51

Perform a Find for a Backup Set

The following command searches for a file called example.txt for the example_backup_set backup set. In this example, the parameters are listed on the command line.

cvc> find -c example_client -bk example_backup_set -f"example.txt"
Find List: /tmp/data3/example.txt 
Specifications of Files in the Given path 
name:example.txt 
size:7756 
modified_time:15/09/2016 11:24:51

Perform a Find for the Default Backup Set

The following command searches for a file called example.txt in the default backup set. In this example, the parameters are listed on the command line.

cvc> find -c example_client -f"example.txt"
Find List: 
/tmp/data3/example.txt 
/tmp//test/example.txt
Specifications of Files in the Given path 
name:example.txt 
size:7756 
modified_time:15/09/2016 11:24:51
type:File
name:example.txt 
size:7756 
modified_time:15/09/2016 11:24:51
type:File

Perform a Find for a Specified Time Period

The following command searches for a file called example.txt for a specified time. In this example, the parameters are listed on the command line.

cvc> find -c example_client -f"example.txt" -ftime "2017-09-24 11:12:13" -ttime "2017-09-26 11:22:18
Find List: 
/tmp/data3/example.txt 
/tmp//test/example.txt
Specifications of Files in the Given path 
name:example.txt 
size:7756 
modified_time:15/09/2016 11:24:51
type:File
name:example.txt 
size:7756 
modified_time:15/09/2016 11:24:51
type:File