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

Updated

Name

ondemand

Synopsis

ondemand [-l {full,incremental,synthetic_full,differential}] -c CLIENTNAME] [-i INSTANCENAME] [-bk BACKUPSETNAME](-d [DIRPATH [DIRPATH ...]] | -df DIRECTIVEFILE) [-dsp DSP]

Description

Perform an On-Demand backup operation on the client.

When you run this command, the software looks for an existing On-Demand subclient for one of the following backup sets:

  • The backup set that you specify on the command line

  • The default backup set when you do not specify the backup set

If there is no On_Demand subclient for the backup set, then the software creates an On-Demand subclient (named ondemand) with your specified content, and then performs an On-Demand backup.

If there is an On-Demand subclient for the backup set, then the software adds the specified content to the On-Demand subclient and then performs an On-Demand backup.

The table lists the options that the software supports.

Option

Description

-l

The backup type. Valid values are:

full - For information on full backups, see Full Backups.

incremental - For information on incremental backups, see Incremental Backups.

differential - For information on differential backups, see Differential Backups.

-c

The CommCell Console client name. This option is mandatory.

-i

The CommCell Console instance name.

-bk

The CommCell Console backup set name.

-d

The folders to include in backup operations.

-f

The path to a text file on the local host that contains a list of directories to include in in the On-Demand backup.

-df

The path to a text file on the local host that contains a list of directories to include in backup operations.

-dsp

The On-Demand backup storage policy that the software assigns to the On-Demand subclient. This option is mandatory when there is no existing On-Demand subclient.

Examples

Perform an On-Demand Backup on a Backup Set That Does Not Have an On-Demand Subclient

The following command performs an On-Demand backup. In this example, the software creates the subclient. In this example, the parameters are listed on the command line.

cvc> on_demand -c example_client -d /tmp/d17 -dsp on_demand_storage_policy

Ondemand subclient is not existing.

creating new subclient :

Job ID : 1205777

Perform an On-Demand Backup on a Backup Set That Has an On-Demand Subclient

The following command performs an On-Demand backup. In this example, the software adds the content to the ondemnd subclient. In this example, the parameters are listed on the command line.

cvc> on_demand -c example_client -d /tmp/d15 -dsp on_demand_storage_policy 

Ondemand Subclient exist already

We are going to add this content to existing subclient ondemand

Job ID : 1205778

Perform an On-Demand Backup by Using a Text File

The following command perform an on-demand backup by using the option that points to a text file that contains the directories to include in backup operations. In this example, the parameters are listed on the command line.

cvc> ondemand -c example_client -bk example_backup_set -f "E:\filelist.txt" -dsp on_demand_storage_policy

Ondemand subclient is not existing.

creating new subclient :

Job ID : 1205779

All the entries that are listed in the filelist.txt file are added to the ondemand subclient content. For example, all of the following entries are added.

/tmp/data1

/tmp/data2

/tmp/data3