Command Line - Backup - Image Level iDataAgent

  • This product is deprecated for AIX and Linux. New installations of the Image Level Agent are no longer supported in V10, but the agent will continue to function normally. Upgrade to the latest service pack in V10 is supported. You cannot use your installed version of the Image Level Agent to perform backups in the next version of SnapProtect.
  • This functionality is now available using Block-Level Backup. We recommend that you begin backing up data by using the block-level backup method instead of using the Image Level Agent as soon as you are able to. No new license is required for Block-Level Backup. For instructions on transitioning to block-level backups, see Transitioning from Image Level Agent to Block-Level Backups.

See Deprecated Features, Products, and Platforms for comprehensive information on deprecated products.

Table of Contents

Perform the Backup

In order to run the backups from command line, you need an input xml file which contains the parameter values for configuring the backup options. This 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 backup will be performed.
  • Generate the input xml file from the CommCell Console and save it on the computer from where the backup will be performed.

Use the following steps to perform the backup:

  1. Download the backup_template.xml file and save it on the computer from where the command will be executed.
  2. From Command prompt, navigate to <Software_Installation_Directory>/Base and run the following command:

    qlogin -cs <commserve host name> -u <user name>

  3. Execute the saved .xml script using qoperation execute command.

    qoperation execute -af backup_template.xml -backupLevel FULL -clientName xxxxx -backupsetName defaultBackupSet -subclientName xxxxx

  1. Verify the status of the job using the following command:

    qlist job –j JOBIDs

  2. Once the job completes, logout from the CommServe using the qlogout command.

    qlogout [-cs <commserve host name>] [-all] [-tf <tokenfile>] [-tk <token>] [-h]


Performing a Full Backup

qoperation execute -af backup_template.xml -backupLevel FULL -clientName client1 -backupsetName defaultBackupSet -subclientName subclient1

Performing an Incremental Backup

qoperation execute -af backup_template.xml -backupLevel INCREMENTAL -clientName client1 -backupsetName defaultBackupSet -subclientName subclient1

Generate the Command Line Script from the CommCell Console

In addition to the parameter values provided in the template xml file, if you want to include additional options for the backup, you can do so by selecting the required options from the CommCell Console and generate the command line xml script for the backup. 

Follow the steps given below to generate a script which you can use to perform a backup from the command line interface:

  1. From the CommCell Console, navigate to <Client> | File System | defaultBackupSet.
  2. Right click the default subclient and click Backup.
  1. Select the required backup options which you want to execute using the script.
  2. Click Save as Script.
  1. Enter the location to save the script along with the file name and extension. For example, "C:\scripts\myscript.bat" on Windows and "/usr/scripts/" on Unix. Alternatively, you can also click Browse and navigate to the location.

    The script will be saved as a .xml file and .bat/.sh file.

    If a file with the same name already exists in the specified location, both the .xml and .bat/.sh files will be overwritten.

  2. Enter the username and password for the user account which you want to use to perform the backup.

    By default, the user account which you have used to login to CommCell console is used for performing the backup. However, if the user account does not have access to any application or database, click Use a different account.

  3. Click OK.