Restore Data - Lotus Notes/Domino Server - How To

Topics | How To | Full System Restore | Related Topics

Perform Cross-Machine Restore of Databases

Command Line Restores

Perform Cross-Machine Restore of Databases

The Lotus Notes Database iDataAgent restores database backups as follows:

• If the source and destination computer have a partition with the same data path then the data is restored to the common data path.
• If all partitions on the destination computer are different than the source computer, then the data will be restored to the first partition.

No transaction logs are restored, and no transactions are replayed. Follow the procedure for this mode if:

• You don't want to shut down the destination server during the restore operation.
• The last database backup is more recent than the last transaction log backup. In this case, there is no need to restore the transaction log.

Required Capability: See Capabilities and Permitted Actions

To perform a database-only cross-machine restore:

Follow the procedure described in Browse and Restore. Make sure to:

1. Select the appropriate Destination Computer from the Restore Options (General) dialog box. 
2. Determine the restore path to the destination computer using Restore to Same Paths.

   When Restore to Same Paths is selected:

   • If the source computer and the destination computer have a partition with the same data path, the data is restored to the common data path.
   • If all partitions on the destination computer are different than the source computer, the data will be restored to the first partition.

   When Restore to Same Paths is de-selected:

   • You can select any Destination Folder on the selected destination computer.

NOTES

• For out-of-place restores, any database can be restored to a new location while the server is running.
• Because this job does not restore log files, some restore options are not made available (e.g., Change database instance id (DBIID), Change database replica id).

Command Line Restores

You can restore Lotus Notes Database from the command line interface.

Command line restores enable you to perform restore operations on multiple clients at the same time. It also allows you to reuse the command line scripts for additional restores.

When performing command line restores, note that backups taken from the CommCell Console can be restored using Command Line and vice versa. However, backups taken from a previous version of the CommCell Console can be restored only from the Command Line.

In order to run the restores from command line, you need an input xml file which contains the parameters for configuring the restore options. This input xml file can be obtained using one of the following ways:

• Download the input xml file template and save it on the computer from where the restore will be performed.
• Generate the input xml file from the CommCell Console and save it on the computer from where the restore will be performed.

Log on to the Commserve

To run command line operations you must first login to the CommServe as follows:

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

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

• For example, to log on to CommServe 'server1' with username 'user1':

  qlogin -cs server1 -u user1

Perform the Restore

1. Download the restore_template.xml file and save it on the computer from where the command will be executed.
2. Execute the saved xml script using qoperation execute command.

   qoperation execute -af restore_template.xml -clientName hop

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

   qlist job –j JOBID

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

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

Generate the Command Line Script from the CommCell Console

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

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

From the CommCell Console, navigate to <Client> | Lotus Notes Database iDataAgent | defaultBackupSet. Right-click the <Subclient> in the right pane and then click Browse Backup Data. Click OK. In the right pane of the Browse window, select the data that you want to restore and click Recover All Selected. Select the required restore options which you want to execute using the script. Click Save as Script.

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. 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. Click OK.