IBM Tivoli Storage Manager for Mail, Data Protection for Microsoft Exchange Server, Version 7.1

Restoremailbox command

Use the restoremailbox command to restore mailbox-level data or mailbox-item-level data from Data Protection for Microsoft Exchange backups.

The following information provides details about this command:

Before you start, ensure that you have the required privileges to run Mailbox restores.
The restoremailbox command applies to any Data Protection for Microsoft Exchange VSS backups:
- VSS backups that are stored on Tivoli® Storage Manager server
- VSS backups that are stored on local shadow volumes
You can use the mailbox restore operation in the GUI to restore mailbox-level data or mailbox-item-level data. The GUI also provides the Mailbox Restore Browser, an interactive action panel that lists all available mailbox actions. Some features of the restoremailbox command are only available on the command-line interface:
- The /mailboxoriglocation parameter is necessary when the mailbox history is disabled and if the mailbox being restored has either moved or been deleted after the time of backup.
  The /mailboxoriglocation parameter is available when you select Show Restore Options from the Recover tab. Use this setting to specify the server and the database where the mailbox was at the time of backup.
- Alternatively use the command-line interface from the Automate tab to specify the /mailboxoriglocation.
- Set the /tempmailboxalias optional parameter by selecting Properties from the Actions pane. In the Data Protection Properties dialog, click the General tab to specify the alias of the temporary mailbox. Use this selection for mailbox restore operations on mailboxes that were deleted or recreated after the time of the backup you are restoring from.
  Select Properties from the Actions pane to open the Data Protection for Exchange Server Properties form. Select the General page, where you can specify the temporary log restore path, the temporary database restore path and the alias of the temporary mailbox.
With Data Protection for Microsoft Exchange you can restore multiple mailboxes with the same mailbox restore operation.
You can use the restoremailbox command to restore data into a mailbox in an online Exchange Server or to restore data as an Exchange Server personal folders (.pst) file.
You can use the restoremailbox command on the primary Exchange Server or on an alternate Exchange Server that is in the same domain.
For non-Unicode .pst files, you can limit the range of the mailbox data to restore by using the /mailboxfilter parameter to specify filters that are based on the following mailbox message elements:
- Sender name
- Folder name
- Message body
- Subject line
- Attachment name
- Range of the message delivery date and time
When restoring to a Unicode .pst file, except for the Folder Name and All Content filters, the filters are ignored.

The amount of time that is needed to complete the restore process depends on the size of the mailbox databases, the network speed, and the number of mailboxes to process.

Prerequisites for Data Protection for Microsoft Exchange mailbox restore tasks

Review these prerequisites before you run mailbox restore tasks on Exchange Server 2010 and later:

See Security requirements for Data Protection for Microsoft Exchange mailbox tasks in Security requirements
See Perform these tasks to configure your system for mailbox-level and item-level restore operations
Temporary space is needed to accommodate the mailbox database during mailbox restore operations. Specify the location of this temporary space by setting these two optional parameters in the Data Protection for Exchange configuration file with the tdpexcc set command:
- TEMPDBRESTorepath
  If you choose to not enter a path, the default value of TEMPDBRESTorepath is the value of the TEMP environment variable.
- TEMPLOGRESTorepath
  If you choose to not enter a path, the default value of TEMPLOGRESTorepath is the value of the TEMP environment variable.
The temporary restore locations must have enough space to restore the entire restored databases and log files.
Ensure that correct version of Microsoft Exchange Server MAPI Client and Collaboration Data Objects is installed on the Exchange server that you use to run the mailbox restore operations. The correct version is identified in the Hardware and Software Requirements technote that is associated with the level of your Data Protection for Exchange program. This technote is available in the TSM for Mail - All Requirement Documents website at http://www.ibm.com/support/docview.wss?uid=swg21219345. When you are at the website, follow the link to the requirements technote for your specific release or update level.

The amount of time that is needed to complete the restore process depends on the size of the mailbox databases, the network speed, and the number of mailboxes to process.

Feedback