Ad-hoc archive operations are on-demand archive operations that allow subclient content to be specified as an external input when starting an archive operation. When you start an ad-hoc archive operation from the command line, you can specify the content in a directive file.
On UNIX, the ad-hoc archive operation can automatically mount the subclient content. For information about the auto-mount requirements for ad-hoc archive operations, see Auto-Mount Path Requirements for Ad-Hoc Archive Operations.
Before You Begin
-
To perform ad-hoc archive operations from the command line, you need an input xml file (ad_hoc_archive_template.xml) which contains the parameter values for configuring the archive options. For more information on command line parameters and XML elements, see Command Line - Syntax.
The input xml file can be obtained from one of the following ways:
-
Download the input xml file template and save it on the computer from where the archive operation will be performed.
-
Generate the input xml file from the CommCell Console and save it on the computer from where the archive operation will be performed. For more information on saving operations as scripts, see Save as Script Overview.
-
-
You must create the following text file to specify where the content is located for ad-hoc archive jobs:
-
A directive file, which is a text file that defines the location of the data that you want to back up.
For information on the format of a directive file, see the following links:
For information on including files and folders with Unicode names in the directive file, see the following links:
-
Windows: Adding Files and Folders with Unicode Characters to Directive Files for Windows.
-
UNIX: Adding Files and Folders with Unicode Characters to Directive Files for UNIX
For information on configuring the directive file to exclude duplicate file names, see Configuring Directive File to Exclude Duplicate Entries.
-
-
Ad-hoc content is archived irrespective of the disk cleanup rules, redundancy check, and delayed stubbing configuration.
-
Procedure
-
Download the ad_hoc_archive_template.xml file and save it on the computer from where the command will be executed.
-
From Command prompt, navigate to software_installation_directory/Base and run the following command:
qlogin -cs $[commserve_host_name] -u $[user_name]
-
Execute the saved .xml script using qoperation execute command.
qoperation execute -af ad_hoc_archive_template.xml -clientName $[client_name] -backupsetName $[backup_set_name] -subclientName $[subclient_name] -onDemandInputFile $[absolute_path_to_directive_file.txt]
-
Verify the status of the job using the following command:
qlist job –j $[JOBID] -
Once the job completes, logout from the CommServe using the qlogout command.
qlogout [-cs $[commserve_host_name]] [-all] [-tf $[tokenfile]] [-tk $[token]] [-h]
Example
qoperation execute -af ad_hoc_archive_template.xml -clientName $[client1] -backupsetName $[backupset1] -subclientName $[subclient1] -onDemandInputFile $[E:directive1.txt]
What to Do Next
To restore ad-hoc backup data, perform a restore operation.