Restore Using Command Line Interface - Lotus Notes Document iDataAgent

Table of Contents

Generate the Command Line Script from the CommCell Console

Perform the Restore

Examples

Find Data

Generate the Command Line script from the CommCell Console

In order to run the restores from command line, you need an input xml file which contains the attributes for configuring the restore options. This input xml file can be obtained by generating the script from the CommCell Console and saving it on the computer from where the restore will be performed.

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

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Instance> | <Backup Set>.
  2. Right-click the <Instance> and then click All Tasks | Browse Backup Data.
  3. Click OK.
  1. In the right pane of the Browse window, select the data that you want to restore and click Recover All Selected.
  2. Select the required restore options which you want to execute using the script.
  3. Click Save as Script.
  1. Enter the location where you want to save the script or click Browse and navigate to the location.

    The script will be saved as a .xml file and a .bat file is created.

    If a file with the same name already exists in the specified location, the .xml file will be created with a timestamp. However, the .bat file will overwrite the existing file.

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

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

  3. Click OK.

Perform the Restore

  1. From Command prompt, navigate to <Software_Installation_Directory>/Base and run the following command:

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

  2. Navigate to the location where the .xml file is saved and execute the saved .xml script using the qoperation execute command.

    3. qoperation execute -af restore.xml -appName 'Notes Document' -clientName hop -backupsetName XML -destPath '/etc4' -sourceItem '/etc'

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

    qlist job –j JOBID

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

    qlogout [-cs commserver] [-all] [-tf tokenfile] [-tk token] [-h]

Examples

Restoring from a Current Backup

qoperation execute -af restore.xml -appName 'Notes Document' -clientName hop -backupsetName XML -destPath '/etc4' -sourceItem '/etc'

Find Data

The following command is available for finding backed up data.

qoperation find

Description

This command performs a wildcard search for a specific file in the backed up content. This command also allows you to search data from multiple indexing cycles. For example, consider a scenario where a user has backed up the following:

Even when the backup cycle is in a time frame beyond the third cycle, you can search the backed up data from all the three cycles without any additional input parameters.

Usage

qoperation find -af argsfile [-rf resultfile][-tf tokenfile] [-tk token] [-h]

Options

-af Reads arguments from an input file
-rf Saves results to a file
-tf Reads token from a file
-tk Token string
-h Displays help

Argument File

server CommServe host name
user User name (prompted if not specified)
password Password (prompted if not specified)
sourceclient Name of the client computer on which you want to perform search operation.
dataagent Agent type installed on source client computer
backupset Backup set name
sourcepaths File/Directory to be restored (using wildcard characters)
options Restore options
browsefrom Start date/time to be considered for search operation. Format: mm/dd/yyyy hh:mm[:ss] or yyyy/mm/dd hh:mm[:ss].
browseto End data/time to be considered for search operation. Format: mm/dd/yyyy hh:mm[:ss] or yyyy/mm/dd hh:mm[:ss]

Diagnostics

Possible exit status values are:

0 - Successful completion.

1 - CLI usage failures, due to the use of an unsupported option or missing argument.

2 - Any other failure.

Example

Use the following steps to perform a wild card search operation on backed up content using find command:

1. Create an input parameter file with the required arguments and values.

For example, see the sample input parameter sample.ini on the right.

[sourceclient]
silver

[dataagent]
Q_LOTUS_DOMINO_DOC

[backupset]
defaultBackupSet

[sourcepaths]
C:\*.xml

[browsefrom]
2011/8/22 00:25:00

[browseto]
2011/8/22 06:28:00

[options]
QR_BROWSE
QR_NORECURSE
QR_NOIMAGE
QR_WILDCARD
2. Run the qoperation from the command prompt.

C:\Calypso\Base>qoperation find -af " SAMPLEFILE.INI" -rf C:\out_find03.txt
1: Wed Aug 10 10:44:47 2011 1312987487 Unknown 237 \C:\1.xml