Loading...

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

Name

browse

Synopsis

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

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 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 browse operation on the default backup set.
  • The browse operation does not honor ACLs.

    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.

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

    -ttime

    The to time that you specify for a point-in-time browse operations. The format is yyyy-mm-dd hh:mm:ss.

    -allVersions

    Browse all versions of the data within a cycle.

    -filter

    File name filters for the browse operation.

    -h

    Displays the help for this command.

Examples

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*

Last modified: 3/13/2020 8:15:35 AM