Recover and Retrieve Data - Domino Mailbox Archiver Agent

Topics | How To | Related Topics

Overview

How to Set Up and Run a Recovery Operation

Message-Level Recovery Options

Recover a Message from Lotus Notes or Lotus Notes Webmail

Recovering Multiple Files from Stubs

Recovery Destinations

• In-Place Recovery
• Out-of-Place Recovery
• Cross-Application Recoveries
• Restore to Network Drive/NFS-Mounted File System

Recovery Considerations for these Agents

Registry Keys for Recovery Operations

Overview 

The Domino Mailbox Archiver Agent supports the following types of recoveries:

• No Image Browse and Recovery of migrated mail messages using the CommCell Console.
• Non-Browse Recovery of migrated mail messages from stubs.

  Note that stubs are not automatically refreshed in the Notes mailbox. A manual refresh is required to view stubs recovered to the mailbox.

Recoveries can be performed in-place or out-of-place, and in certain scenarios cross-application and cross-platform recoveries are also supported. (See Recovery Destinations below for comprehensive information.)

Browse and recovery operations for Domino Mailbox Archiver Agent can be performed from the client, agent, and backup set (i.e., archive set) levels in the CommCell Browser.

When there is a problem with the Domino Server or the operating system of the client computer, full system restores may be required. The Domino Mailbox Archiver Agent relies upon the corresponding Lotus Notes Database iDataAgent to perform a full system restore of Domino Server data. See Full System Restore - Lotus Notes/Domino Server iDataAgents for more information.

How to Set Up and Run a Recovery Operation

The following section provides the steps to set up and run a Recovery Operation:

1. Enable the Archiving Rules for the subclient that contains the content you wish to archive. See Enable (Disable) Archiving Rules for step-by-step instructions and configure the Archiving Rules. In particular, decide if you want to create stubs in your environment. Even if the Archiving Rules are disabled, the Stub Rules will apply. See Configure Archiving Rules - Domino Mailbox Archiver Agent for step-by-step instructions.
2. Run an archive operation. See Start a Migration Archiving Operation for step-by-step instructions.
3. Determine your Recovery Destinations.
4. Recover one or more files with a Browse and Recovery or non-Browse Recovery operation.
   • If stubs were created, end-users or applications can recover files with a non-browse recovery operation by simply opening the stub file, thereby causing it to be restored. (see Recover a Message from a Lotus Notes Mailbox Client).
   • If stubs were not created, then you can perform a browse recovery with CommCell Console (see Recover a Message from the CommCell Console).

Message-Level Recovery Options

The Domino Mailbox Archiver Agent offers a variety of options for recovering selected messages and items, which are available in the Domino Mailbox Archiver Agent's Recovery Options dialog box in the CommCell Console. These options and their descriptions are as follows:

• Append - All data objects selected for recovery will be added to the folder regardless of whether they currently exist or not. The Append option is selected by default.
• Unconditional Overwrite - If a data object that is selected for recovery already exists, that object will be overwritten by the recovered object.
• Unconditionally Overwrite only if target is a stub - Specifies whether a stub will be unconditionally overwritten during recovery. This option is useful for avoiding the overwriting of an object with the same name that was previously recalled or which may be a more recent version than the one being recovered.
• Skip - If an object is selected for recovery and that object already exists, it will not be recovered.

Recover a Message from Lotus Notes or Lotus Notes Webmail

In addition to browsing and recovering messages from the CommCell Console, the Domino Mailbox Archiver Agent provide a method to allow end-users to selectively recover mail messages and public folder items from their Lotus Notes clients or Lotus Notes webmail. If the subclient was configured to create stubs during migration archiving operations, users can click on a message/item stub to initiate a recovery of a previously archived message/item.

Recovering Multiple Files from Stubs

More than one archived file can be recovered at a time from stubs via a third-party application (e.g., Windows Explorer, Unix Terminal or Console window).

Multiple stub recoveries from magnetic media or tape are submitted to the Job Controller as one job. For such stub recoveries, only one job (i.e., called a Persistent Recovery job) will display in the Job Controller. However, the Event Viewer and Job History log will treat the jobs as separate jobs (using the same Job ID associated with the common open pipeline). Also, the job will wait for approximately 5 seconds in order to allow other stub recovery requests being submitted on the same client to be batched into the same job. It is worth noting that stub recoveries from magnetic media are faster than tape, because the pipeline remains open for up to 20 minutes of idle time, allowing quicker recovery and avoiding the time needed to find and load tapes.

The stub recall history is viewable at the client and agent levels in the Commcell Console and is associated with the first instance, which was created in the Migration Archiver agent. Stub recall history can be turned on by creating nDMRSendFileStatus key and setting the value to 1.

Back to Top

Recovery Destinations

By default, the Domino Mailbox Archiver Agent recovers data to the client computer from which it originated; this is referred to as an in-place recovery. You can also recover the data to another Client computer in the CommCell. Keep in mind the following considerations when performing such recoveries:

• The destination client must reside in the same CommCell as the client whose data was migrated.
• Note that when you perform recoveries other than in-place recoveries, the recovered data assumes the rights (i.e., permissions) of the parent directory.

The following section enumerates the types of recovery destinations that are supported by the Domino Mailbox Archiver Agent. See Recover Options - Recover Destinations - Support for a list of Agents supporting each restore/recovery destination type.

In-Place Recovery

• Same path/destination

When performing a non-browse recovery of migrated data from a stub, keep in mind that the data can only be recovered in-place to the same path/destination on the same client from which the data was migrated.

Out-of-Place Recovery

• Same path/destination

Keep in mind the following when performing an out-of-place recovery:

• Out-of-place recoveries can only be accomplished via a Browse and Recovery operation from the CommCell Console.
• After recovering data out-of-place, the database design must be replaced by opening the database locally using the Lotus Domino Designer. Once the database design has been replaced, the database can be opened and viewed in the Lotus Notes Client.

Cross-Application Recoveries

• Support for restoring/recovering/retrieving data from one application version to another generally follows the same compatibility support provided by the associated third-party application vendor, unless otherwise noted.

• The recovery destination can be the same mailbox, or a different mailbox on another Domino Server with a compatible version of Domino Mailbox Archiver installed and operational.

Restore to Network Drive/NFS-Mounted File System

Data secured by the Domino Mailbox Archiver Agent can be restored to a UNC path. (See Restore to Network Drive/NFS-Mounted File System for comprehensive information.)

Recovery Considerations for This Agent

Before performing any recovery procedures for these agents, review the following information.

• In a Domino Cluster environment, data restored on one server will not propagate to other servers within the Domino Cluster. Messages will be restored with the original sequence ID, which may be lower than the existing message within the Domino Cluster. In such cases, the restored Document will be overwritten by the existing Document during replication.

  To avoid these conflicts, perform recovery operations using one of the following two methods:

  • The Out-of-Place recovery method. This will ensure all restored messages are given new sequence IDs and thus will not be overwritten during replication.
  • Recall the message directly from the Lotus Notes Client mailbox by double-clicking either the message itself or the message's stub icon (if configured).
• DAOS links are not preserved during Domino Mailbox Archiver Agent recoveries. To reintroduce these links, the following compact operation must be performed:

  load compact -C -daos on test.nsf

• Messages that have been migrated do not automatically appear as stubs in the Lotus Notes client mailbox when the migration operation has been completed. To display the stubs created during the migration operation, users mush refresh the client mailbox manually by either:
  • using the F9 function on the keyboard.
  • restarting the Lotus Notes client mailbox.
• If the message or item you want to recover was migrated using the Do not create stub option or the stub was manually deleted after the archive, then use the procedure to Recover a Message from the CommCell Console to perform the recovery.

• You can use the nDMRSendFileStatus registry key to reduce the frequency at which the stub recovery job statistics are sent to Job Manager for updating the Recovery Job History views and reports. This is useful for increasing the efficiency of system resources in cases where there are frequent stub recalls and there is no need to update the Job History immediately after each stub recall.

• To change the default value of how long the persistent pipeline of this Archiver Agent will stay open during idle periods of a recovery operation, you can use the nDMRSIDLETIMEOUT registry key to accomplish this task. The pipeline stays persistent for 1200 seconds (20 minutes) by default.

Registry Keys for Recovery Operations

Use the following registry keys to modify the default behavior of the Migration Archiver Agent:

Back to Top