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 to time
The from and to time

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 from time that you specify for a point-in-time find operations. The format is yyyy-mm-dd hh:mm:ss.
-ttime	The to time that you specify for a point-in-time find operations. 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