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

Updated

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