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

Updated

Name

browse

Synopsis

  • browse [path]

    Performs the browse operation with default options.

  • browse [-h] [-c CLIENTNAME] [-i INSTANCENAME] [-bk BACKUPSETNAME] [-sc SUBCLIENTNAME] -p BROWSEPATH [-ftime FROMTIME] [-ttime TOTIME] [-allVersions] [-filter BROWSE_FILTER [BROWSE_FILTER ...]]

Description

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

Before you perform the browse operation, you can change the working directory to the backup directory location by using the cd command, for example, cd /tmp/backup_location.

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

If you want to perform a point-in-time browse, 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 browse 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.

-p

The folder where you want to browse the data.

You can specify relative paths.

Note: if you do not want to specify the path, then you can use the cd command to change to the directory that contains the backed up data, and then use the browse command.

-ftime

The start time of the backup window that you specify for a point-in-time browse 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 browse operation. The format is yyyy-mm-dd hh:mm:ss.

-allVersions

Browse all versions of a file within a backup cycle.

-filter

File name filters for the browse operation.

-h

Displays the help for this command.

Examples

Browse a Path with Default Options

If you use path as a positional argument, the software overrides the user-provided values for options and performs the browse operation with default values.

cvc> browse /tmp/test

List of Files :

/tmp/test/output_file.txt

/tmp/test/55.jpg

/tmp/test/output.txt

Specifications of Files in the Given path name:

output_file.txt

size:1206464

modified_time:10/08/2017 13:44:07

type:File

name:55.jpg

size:287263

modified_time:05/08/2017 11:22:18

type:File

name:output.txt

size:24

modified_time:21/09/2017 00:07:24

type:File

Change to the Directory That Contains the Data

Change the working directory to the one that contains the backed up data, and then browse the example_backup_set backup set. In this example, the parameters are listed on the command line.

cvc> cd /example/example_backup_set_data 

cvc> browse -c example_client -bk example_backup_set

List of Files :

/tmp/test/output_file.txt

/tmp/test/55.jpg

/tmp/test/output.txt

Specifications of Files in the Given path name:

output_file.txt

size:1206464

modified_time:10/07/2017 13:44:07

type:File

name:55.jpg

size:287263

modified_time:05/07/2017 11:22:18

type:File

name:output.txt

size:24

modified_time:21/06/2017 00:07:24

type:File

Browse Backup Set Content

The following command browses the /tmp folder for the example_backup_set backup set. In this example, the parameters are listed on the command line.

cvc> browse -c example_client -bk example_backup_set -d /tmp/test 

List of Files :

/tmp/test/output_file.txt

/tmp/test/55.jpg

/tmp/test/output.txt

Specifications of Files in the Given path name:

output_file.txt

size:1206464

modified_time:10/07/2017 13:44:07

type:File

name:55.jpg

size:287263

modified_time:05/07/2017 11:22:18

type:File

name:output.txt

size:24

modified_time:21/06/2017 00:07:24

type:File

Browse Subclient Content

The following command browses the C:\Users\admin\Desktop\good2 folder for the good subclient. In this example, the parameters are listed on the command line.

cvc> browse -c example_client -sc good -path "C:\Users\admin\Desktop\good2" 

<?xml version="1.0" ?>

<Task> <JobID>589124</JobID>

</Task>

Browse Initiated Successfully Job ID : 589124

Browse to a Specific Time on a Subclient

The following command browses the C:\Users\admin\Desktop\good2 folder for the good subclient for the 9/23/17 at 8 A.M. In this example, the parameters are listed on the command line.

cvc> browse -c example_client -sc good -d "C:\Users\admin\Desktop\good2" -ftime "2017-09-23 08:00:00"

List of Files :

C:\Users\admin\Desktop\good2\PSEXESVC.exe

C:\Users\admin\Desktop\good2\CvCloudBkp.log

C:\Users\admin\Desktop\good2\cvcl.log

C:\Users\admin\Desktop\good2\ClSybBrowse.log

C:\Users\admin\Desktop\good2\ClSybAgent.log

C:\Users\admin\Desktop\good2\clRestore.log

Specifications of Files in the Given path

name:PSEXESVC.exe

size:189792

modified_time:18/01/2017 11:06:14

type:File

name:CvCloudBkp.log

size:15524

modified_time:04/01/2017 23:46:25

Browse Subclient Content By Using Wildcards

The following command browses the /test_restore folder for all XML files and files with prefix clB. In this example, the parameters are listed on the command line.

cvc> browse -c example_client -sc example_subclient -p /test_restore -filter *.xml clB*