Loading...

Advanced Restore Data - Notes Database iDataAgent

Restore Data Browse and Restore
Table of Contents

Restore Considerations

Notes Database iDataAgent supports the following restore operations:

  • Database restore
  • Database + Transaction Log restore

In addition, the following restore options are also provided:

  • Option to unconditionally overwrite the database.
  • Option to change the Database Instance ID (DBIID).
  • Option to restore one or more specific version(s) of database. (Append the database name with its version number to select it during restore.)
  • Option to change Database Replica ID.
  • Option to not replay transaction logs.

Before performing any restore procedures for this agent, review the following information:

  • Database objects whose names contain backslash characters ( \ ) are displayed in the Browse window with the backslash changed to a space character. This change is only for the sake of the browse and has no effect on the way data is actually backed up or restored.
  • If the IBM Domino ID has a password associated with it, the IBM Domino ID must be running during the restore operation.
  • When there is a problem with IBM Domino or the operating system of a client computer, you should run full system restores.

Performing an In-Place Restore

Follow the steps given below to restore data to perform an in-place restore:

  1. Ensure that the IBM Domino ID is running if it has a password associated with it.
  2. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  3. Right-click <Partition> and click All Tasks | Browse and Restore.
  4. Click View Content.
  5. In the Browse window, click to select the backed up databases. Click Recover All Selected.
  6. Click OK.

    • In case you are restoring the database to a direct link, ensure that the directory link exists on the IBM Domino.
    • In case the Database Instance ID (DBIID) is changed, run a full backup of the new database.

Out-of-Place Restore of Database

Recovering to a Different Folder on the Same Client

By default, the Notes Database restores data to the client computer from which it originated; this is referred to as an in-place restore.

You can also restore the data to another client computer. The restored data assumes the rights (i.e., permissions) of the parent directory.

Even after the Notes Database iDataAgent is removed from a given client, you can browse the client's backup data and restore it to another computer, provided that the iDataAgent icon has not been deleted from the CommCell Browser and the backed up data has not expired.

  1. Ensure that the IBM Domino ID is running if it has a password associated with it.
  2. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  3. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  4. Click View Content.
  5. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  6. Click Recover All Selected.
  7. Uncheck the Restore to same folder checkbox.
  8. Click Browse and select the destination folder on the same client machine.

    • Ensure that the destination path selected for Out-of-place restore is outside the Domino Data Path to avoid Replication ID conflicts.
    • You can restore the transaction logs only using the Out-of-Place restore. Restore the transaction logs using the <Transaction Log Subclient>.

  9. Click OK.

Recovering to a Different Client

The Notes Database iDataAgent restores database backups as follows:

  • The restore destination must be on another IBM Domino within the same CommCell.
  • 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.
  • Cross-platform restore between the different versions of an operating system is supported on Windows.
  • On Windows, cross-application restore to the same and higher IBM Domino versions is supported. While on AIX, cross-application restores is supported only to the same IBM Domino version.

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.

Procedure

  1. Ensure that the IBM Domino ID is running if it has a password associated with it.
  2. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  3. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  4. Click View Content.
  5. In the Client Browse tab, select the data to be recovered and click Recover all Selected.
  6. From the Restore Options dialog box, select the appropriate Destination Computer
  7. Determine the restore path to the destination computer using Restore to Same Paths.

    When the Restore to Same Paths check box 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 the Restore to Same Paths check box is not 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 (for example, Change Database Instance ID (DBIID), Change Database Replica ID).

Recovering to Network Path

Follow the steps below to restore data to any network path, (supported on Windows):

  1. Ensure that the IBM Domino ID is running if it has a password associated with it.
  2. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  3. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  4. Click View Content.
  5. In the Client Browse tab, click to select the backed up databases. Click Recover All Selected.
  6. Clear the Recover to same folder checkbox.
  7. In the Specify Destination Path, type the network path.
  8. Check the Impersonate User checkbox.
  9. Type the credentials for the remote location.
  10. Click OK.

Restoring Data from a Backup Copy

You can perform a restore from the backup copy by setting the appropriate copy precedence number.
  1. Ensure that the IBM Domino ID is running if it has a password associated with it.
  2. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  3. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  4. Click View Content.
  5. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  6. Click Recover All Selected.
  7. Click the Advanced button.
  8. Click the Copy Precedence tab and select the Restore from copy precedence checkbox.
  9. In the Copy Precedence box, type or select the copy precedence number for the backup copy.
  10. Click OK.
  11. Click OK to close the Notes DB Restore Options dialog box and start the restore job.

Recover Messages across Backup Cycles and Subclients

You can browse and recover data spanning across multiple subclients. Browsing and recovering data across subclients within a backup set allows you to recover data from the mailboxes that have been moved from one subclient to another.

Follow the steps given below to browse and restore data spanning multiple subclients:

  1. Install the MediaAgent on the CommServe computer.
  2. Ensure that the IBM Domino ID is running if it has a password associated with it.
  3. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  4. Right-click <Partition> and click All Tasks | Browse and Restore.
  5. Select the Time Range option.
  6. Select the Time Zone, enter the Start Date and time and the End Date and time.
  7. Click View Content.
  8. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  9. Click Recover All Selected.
  10. From the General tab, select suitable options to locate the desired destination.
  11. Click the Job Initiation tab.
  12. Select Immediate to run the job immediately.
  13. Click OK.

    You can monitor the progress of the restore job in the Job Controller.

Scheduling Message Restore

  1. Ensure that the IBM Domino ID is running if it has a password associated with it.
  2. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  3. Right-click <Partition> and click All Tasks | Browse and Restore.
  4. Click View Content.

  5. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  6. Click Recover All Selected.
  7. Click the Job Initiation tab and click Schedule.
  8. Click Configure.
  9. From the Schedule Details dialog box, select the appropriate scheduling options. For example:
    • Click Weekly.
    • Check the days you want the run the restore job.
    • Change the Start Time to 9:00 PM.
    • Click OK.
  10. Click OK.

    The restore job will start as per the schedule set.

Disabling Replication of Restored Databases

By default, in a Domino cluster setup the restored databases are replicated to the other servers. However, you can configure to disable this replication of restored database by following the steps given below:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Database.
  2. Right-click <Partition> and click All Tasks | Browse and Restore.
  3. Click View Content.
  4. In the Browse window, click to select the backed up databases. Click Recover All Selected.
  5. In the General tab, select the Disable Replication check box.
  6. Click Ok.

    • To re-enable the replication process for restored database, manually edit the database properties in the Domino Admin client.
    • Replication will not be disabled when restoring:
      •  Database that was protected using the SnapProtect backup.
      • Multiple versions of non-logged databases.

Managing Restore Jobs

Once you initiate the restore operation, a restore job is generated in the Job Controller. Jobs can be managed in a number of ways. The following sections provide information on the different job management options available:

Restarting Jobs

Jobs that fail to complete successfully are automatically restarted based on the job restartability configuration set in the Control Panel. Keep in mind that changes made to this configuration will affect all jobs in the entire CommCell.

To Configure the job restartability for a specific job, you can modify the retry settings for the job. This will override the setting in the Control Panel. It is also possible to override the default CommServe configuration for individual jobs by configuring retry settings when initiating the job. This configuration, however, will apply only to the specific job.

Restore jobs for this Agent are resumed from the point-of-failure.

Configure Job Restartability at the CommServe Level

  1. From the CommCell Console ribbon, click the Home tab, and then click Control Panel.
  2. In the Data section, click Job Management.

    The Job Management dialog box is displayed.

  3. On the Job Restarts tab, select the job information.
    • In the Job Type box, select the job that you want set the restart capability for (for example, for DB2 backup jobs, select DB2 Data Protection).
    • Select the Restartable check box.
    • Optional: to change the maximum number of times that the Job Manager tries to restart a job, in the Max Restarts box, select the number of times.
    • Optional: to change the time interval between attempts for the Job Manager to restart the job, in the Restart Interval (Mins) box, select the number of minutes.
  4. Click OK.

Controlling Jobs

The following controls are available for running jobs in the Job Controller window:

Suspend

Temporarily stops a job. A suspended job is not terminated; it can be restarted at a later time.

Resume

Resumes a job and returns the status to Waiting, Pending, Queued, or Running. The status depends on the availability of resources, the state of the Operation Windows, or the Activity Control setting.

Kill

Terminates a job.

Suspending a Job

  1. From the Job Controller of the CommCell Console, right-click the job and select Suspend.
  2. The job status may change to Suspend Pending for a few moments while the operation completes. The job status then changes to Suspended.

Resuming a Job

  1. From the Job Controller of the CommCell Console, right-click the job and select Resume.
  2. As the Job Manager attempts to restart the job, the job status changes to Waiting, Pending, or Running.

Killing a Job

  1. From the Job Controller of the CommCell Console, right-click the job and select Kill.
  2. Click Yes when the confirmation prompt appears if you are sure you want to kill the job. The job status may change to Kill Pending for a few moments while the operation completes. Once completed, the job status will change to Killed and it will be removed from the Job Controller window after five minutes.

Additional Restore Options

Several additional options are available to further refine your restore operations. The following table describes these options, as well as the steps to implement them.

Be sure to read the overview material referenced for each feature prior to using them.

Option Description Related Topic
Skip Errors and Continue

This option enables you to continue the restore job regardless of media errors and create a file that lists the full path names of the files that failed to get restored. Follow the steps given below to set this option:

  1. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  3. Click View Content.
  4. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  5. Click Recover All Selected.
  6. Click the Advanced button.
  1. In the Advanced Restore Options dialog box, click General.
  2. On the General tab, select the Skip errors and continue check box.
  3. Click OK.
 
Startup Options

The Startup Options are used by the Job Manager to set priority for resource allocation. This is useful to give higher priority to certain jobs. You can set the priority as follows:

  1. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  3. Click View Content.
  4. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  5. Click Recover All Selected.
  6. Click the Advanced button.
  1. In the Advanced Restore Options dialog box, click Startup.
  2. On the Startup tab, select Change Priority.
  3. Enter a priority number - 0 is the highest priority and 999 is the lowest priority.
  4. Select the Start up in suspended State check box to start the job in a suspended state.
  5. Click OK.
Refer to Job Priority and Priority Precedence.
Copy Precedence By default, the system retrieves data from the storage policy copy with the lowest copy precedence. If the data was pruned from the primary copy, the system automatically retrieves data from the other copies of the storage policy in the lowest copy precedence to highest copy precedence order. Once the data is found, it is  retrieved, and no further copies are checked.

You can retrieve data from a specific storage policy copy (Synchronous Copy or Selective Copy). If data does not exist in the specified copy, the data retrieve operation fails even if the data exists in another copy of the same storage policy. Follow the steps given below to retrieve the data from a specific storage policy copy:

  1. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  3. Click View Content.
  4. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  5. Click Recover All Selected.
  6. Click the Advanced button.
  1. In the Advanced Restore Options dialog box, click Copy Precedence.
  2. On the Copy Precedence tab, select the Restore from copy precedence check box.
  3. Enter the copy precedence number.
  4. Click OK.
Refer to Recovering Data From Copies.
Data Path Options

The data recovery operations use a default Library, MediaAgent, Drive Pool, and Drive as the Data Path. You can use this option to change the data path if the default data path is not available. Follow the steps given below to change the default data path:

  1. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  3. Click View Content.
  4. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  5. Click Recover All Selected.
  6. Click the Advanced button.
  1. In the Advanced Restore Options dialog box, click Data Path.
  2. On the Data Path tab, select the MediaAgent and Library.
  3. Select the Drive Pool and Drive for tape library.
  4. Select the name of the Proxy server if you wish to restore using a proxy server.

    You can select the Proxy server only when you are restoring from a snapshot. This option is not available for a regular restore.

  5. Click OK.
Refer to Change Data Path.
Encryption

If the client's data is encrypted with a pass phrase, you must enter the pass-phrase to start the data recovery operation. Follow the steps given below to enter the pass-phrase:

  1. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  3. Click View Content.
  4. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  5. Click Recover All Selected.
  6. Click the Advanced button.
  1. In the Advanced Restore Options dialog box, click Encryption.
  2. Enter the Pass Phrase.
  3. Click OK.
Refer to Data Encryption.
Alerts

This option enables users or user groups to get automatic notification on the status of the data recovery job. Follow the steps given below to set up the criteria to raise notifications/alerts:

  1. From the CommCell Console, navigate to Client Computers | <Client> | Notes Database | <Partition>.
  2. In the right-pane, right-click the <Subclient> which contains the data you want to restore and click Browse and Restore.
  3. Click View Content.
  4. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  5. Click Recover All Selected.
  6. Click the Advanced button.
  1. In the Advanced Restore Options dialog box, click Alerts.
  2. Click Add Alert.
  3. From the Add Alert Wizard dialog box, select the required threshold and notification criteria and click Next.
  4. Select the required notification types and click Next.
  5. Select the recipients and click Next.
  6. Click Finish.
  7. Click OK.
Refer to Alerts and Notifications.
Command Line Restores Command Line Interface enables you to perform backups or restore from the command line. The commands can be executed from the command line or can be integrated into scripts.

You can also generate command line scripts for specific operations from the CommCell Browser using the Save As Script option.

Refer to Command Line.
CommCell Readiness Report The CommCell Readiness Report provides you with vital information such as connectivity and readiness of the Client, MediaAgent, and CommServe. It is useful to run this report before performing a backup or a recovery operation. Follow the steps given below to generate the report:
  1. On the CommCell Console menu bar, select the Reports tab.
  2. Click Readiness.

    The Report Selection dialog box appears.

  3. If necessary, select Reports | CommServe | CommCell Readiness in the left pane.
  4. Select the Computers tab, and then click Modify below the Computers list.
  5. In the dialog box that appears, clear Include All Client Computers and All Client Groups.
  6. Select the appropriate client from the Exclude list, and then click Include >.
  7. Click OK.
  8. Select the MediaAgent tab, and then clear Include All MediaAgents.
  9. Select the appropriate MediaAgent from the Exclude list, and then click Include >.
  10. Click Run.

    The report appears in your default Web browser.

Refer to CommCell Readiness Report.
Restore Job Summary Report

The Restore Job Summary Report provides you with information about all the data recovery jobs that are run in last 24 hours for a specific client and agent. You can get information such as failure reason, failed objects, job options, and so on. It is useful to run this report after performing the restore. Follow the steps given below to generate the report:

  1. On the CommCell Console menu bar, select the Reports tab.
  2. Click Summary.

    The Report Selection dialog box appears.

  3. If necessary, select Reports | Jobs | Job Summary in the left pane.
  4. On the General tab, select Data Recovery Jobs.
  5. Select the Computers tab.
  6. Select the appropriate client and the appropriate agent.
  7. Click Run.

    The report appears in your default Web browser.

Refer to Restore Job Summary Report.