Loading...

Advanced Restore

Table of Contents

Restore Considerations

Performing an In-Place Restore

Performing an Out-of-Place Restore

Performing Point-in-Time Restore Operations across Backup Cycles and Subclients

Scheduling Message Restore

Managing Restore Jobs

Additional Restore Options

Restore Considerations

Notes Document iDataAgent supports the following restore operations:

  • Option to Overwrite data documents
  • Option to Overwrite design documents (For AIX and Solaris in-place restores, this option requires the data document to also be selected.)
  • Option to Overwrite database links
  • Option to Database links only

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.
  • You can restore the contents of the mailbox when mailbox has older name. Restoring data from both old data and new data is allowed to the new .nsf mail file.
  • You cannot restore a folder structure inside a .nsf file, although all the documents are restored.

Performing an In-Place Restore

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

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Partition>.
  2. Right-click <Backupset> 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.

    In case you are restoring the database to a direct link, ensure that the directory link exists on the IBM Domino.

  5. Click OK.

Performing an Out-of-Place Restore

Restoring to a Different Folder on the Same Client

Follow the steps given below to restore data to a different folder on the same client from which data is backed up:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Partition>.
  2. Right-click <Backupset> 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. Clear the Recover to same folder check box.
  6. In the Specify destination path, type the folder name.

    To avoid Replication ID conflicts, ensure that the destination path is outside the Notes Data Path.

  7. Click OK.

Restoring to a Different Client

Follow the steps given below to restore data to a different folder on the same client from which data is backed up:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Partition>.
  2. Right-click <Backupset> 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. Clear the Recover to same folder check box.
  6. In the Destination Client list, select the name of client computer.
  7. Click OK.

Restoring to Network Path

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

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Partition>.
  2. Right-click <Backupset> 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. Clear the Recover to same folder check box.
  6. In the Specify Destination Path, type the network path.
  7. Check the Impersonate User checkbox.
  8. Type the credentials for the remote location.
  9. Click OK.

Performing Point-in-Time Restore Operations 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. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Partition>.
  3. Right-click <Backupset> and click All Tasks | Browse and Restore.
  4. Select the Time Range option.
  5. Select the Time Zone, enter the Start Date and time and the End Date and time.
  6. Click View Content.
  7. Expand the <Subclient> and select the required database. Its entire contents will be automatically selected in the right pane.
  8. Click Recover All Selected.
  9. From the General tab, select suitable options to locate the desired destination.
  10. Click the Job Initiation tab.
  11. Select Immediate to run the job immediately.
  12. Click OK.

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

Scheduling Message Restore

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Notes Document | <Partition>.
  2. Right-click <Backupset> and click All Tasks | 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 Job Initiation tab and click Schedule.
  7. Click Configure.
  8. 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.
  9. Click OK.

    The restore job will start as per the schedule set.

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

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 Document | <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.
  7. In the Advanced Restore Options dialog box, click Startup.
  8. On the Startup tab, select Change Priority.
  9. Enter a priority number - 0 is the highest priority and 999 is the lowest priority.
  10. Select the Start up in suspended State check box to start the job in a suspended state.
  11. 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 Document | <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.
  7. In the Advanced Restore Options dialog box, click Copy Precedence.
  8. On the Copy Precedence tab, select the Restore from copy precedence check box.
  9. Enter the copy precedence number.
  10. 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 Document | <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.
  7. In the Advanced Restore Options dialog box, click Data Path.
  8. On the Data Path tab, select the MediaAgent and Library.
  9. Select the Drive Pool and Drive for tape library.
  10. 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.

  11. Click OK.

Refer to Change Data Path.

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 Document | <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.
  7. In the Advanced Restore Options dialog box, click Alerts.
  8. Click Add Alert.
  9. From the Add Alert Wizard dialog box, select the required threshold and notification criteria and click Next.
  10. Select the required notification types and click Next.
  11. Select the recipients and click Next.
  12. Click Finish.
  13. 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.

Last modified: 8/28/2018 5:30:58 AM