Recover

Deprecated

See End-of-Life, Deprecated and Extended Support - Products for information about deprecated products.

If you want to continue to use the Exchange Mailbox Archiver Agent for archiving and recovery operations, you cannot upgrade the client.

Performing an Initial Recovery

We recommend that you perform a recover operation immediately after your first archive.

  1. From the CommCell Console, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the defaultArchiveSet, and then click All Tasks >Browse and Restore.

    The Browse and Restore Options dialog box appears.

  3. Click View Content.

  4. In the left pane of the Client Browse window, expand the defaultArchiveSet, and then select a mailbox.

  5. Click Recover All Selected.

    The Recover Options for All Selected Items dialog box appears.

  6. Do either of the following:

    • To recover to a mailbox, click To Mailbox, and then in the Destination Client list, select the name of client computer.

    • To recover to a PST file, click To PST File, and then type the path to the location where you want to restore the PST file, including the PST file name with the .pst extension.

      If you want to restore the PST file to a network location, type the UNC path to the location, including the PST file name with the .pst extension.

  7. Click OK.

  8. Click the Job Initiation tab, and then select Immediate.

  9. Click OK.

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

  10. After the restore job has completed, right-click the agent and click View > Recover History.

  11. Click OK.

  12. Right-click the job and do one of the following:

    • View Job Details.

    • View Paths.

    • View Events of the recover job.

    • View or send log files of the restore job.

    • Resubmit the job if the job is not too old.

  13. If you recovered the archive as a PST file, import the PST file into Outlook.

    Note

    This step is based on Outlook 2010. The steps might be different if you are using another version of Outlook.

    1. Open Outlook.

    2. On the File menu, click Open.

    3. Click Import.

      The Import and Export Wizard appears.

    4. Select Import from another program or file option, and then click Next.

    5. Select Outlook Data File (.pst), and then click Next.

    6. Click Browse and choose the .pst file that was restored, and then click Next.

    7. Do either of the following:

      • Select Import items into the current folder.

        When Import items into the same folder is selected, the data from the imported file is added to the same folder in Outlook if the folder matches. If the folder does not match in Outlook, it will be created.

      • Select Import items into the same folder in, and then select the appropriate folder from the list.

    8. Click Finish.

Recovering a Message or a Mailbox Item

Browse an archiveset and recover an archived message or a mailbox item, such as a folder, a contact, or a calendar entry.

  1. From the CommCell Console, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, and then click All Tasks >Browse and Restore.

    The Browse and Restore Options dialog box appears.

  3. Click View Content.

  4. In the left pane of the Client Browse window, expand the ArchiveSet > mailbox > folder, and then select a mailbox.

  5. Click Recover All Selected.

    The Recover Options for All Selected Items dialog box appears.

  6. Select To Mailbox.

  7. In the Destination Client list, select the name of client computer.

  8. Click OK.

Finding and Recovering

Use Find to search and locate messages from an archived mailbox. Find is available from an ArchiveSet, subclient, or by right-clicking a mailbox or message from a Browse and Recover operation.

Note

When entering criteria, note that up to 24 characters are supported for Sender and Recipient entries. Similarly, up to 42 characters are supported for Subject entries.

Finding a Message with a Specific Subject
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. Type the Subject name of the message to narrow the search by a specific subject line containing the specified text string or wildcard pattern. You can search for partial words without the need for wildcard characters at the beginning and/or end of the search string.

    These wildcards, or a combination of these wildcards, are supported in the Subject field:

    • * for any number of characters. For example, Accounting*.

    • ? for any one character. For example, user_group?.

    • [ ] for a range of characters. For example, [a-k]Lee.

    • [!] for a negation of a range of characters. For example, [!a-k] Lee.

  4. Click Search.

The messages that match the criteria are displayed in Search Results.

Finding a Message from a Specific User
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. In From, narrow the search by entering a specified user who sent the message.

  4. Click Search.

The messages that match the criteria are displayed in Search Results.

Finding a Message Sent to a Specific User
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. In To, narrow the search by entering a specified user the message was addressed to. When searching Public Folder data using this field, keep in mind that only e-mails posted to mail-enabled Public Folders will be searchable. If you wish to search posts made to a Public Folder, use the Subject or From fields instead.

  4. Click Search.

The messages that match the criteria are displayed in Search Results.

Finding a Message Received in a Specific Time Range
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. In Received Time, select an entry from the drop-down list to narrow the search to messages received on the specified date or within the specified date range according to date criteria (Any, Today, Yesterday, This Week, This Month, This Year, Is, After, Before, Between, Specific Date). Depending on your selection, additional date range fields may appear below the Received Time field.

  4. Click Search.

The messages that match the criteria are displayed in Search Results.

Quick Search Using Sampling
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. Click Advanced Options to expand and display the fields.

  4. In Sample Every, specify the rate at which messages are sampled to determine whether they match the search criteria. The default value of 1 indicates that every message will be sampled. Keep in mind that the order in which messages are sampled is based on the order in which the messages were backed up.

  5. Click Search.

The messages that match the criteria are displayed in Search Results.

Finding a Message Backed Up at a Specific Time
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. Click Advanced Options to expand and display the fields.

  4. In Backup Time, specify a time or time range (Latest Cycle, After, Before, Between, Specific Date, Any, Today, Yesterday, This week, This Month, This Year, or Relative) to narrow searches to messages that were backed up within the time period specified.

  5. Click Search.

The messages that match the criteria are displayed in Search Results.

Adding Search Results to a List

Moving items to the Selected List lets you control the items you need to recover. You can narrow down the list from the Search Results so that you are able to recover only the items from the Selected List.

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. Enter search criteria (for example, Subject, From, To, and so on) as explained in the previous sections.

  4. Click Search.

    The messages that match the criteria are displayed in Search Results.

    Right-click a message and select Add to Selected List.

  5. Click the Selected Items tab and the message will be displayed.

Using Find from a Browse Window

When you access Find as part of a Browse operation, keep in mind that the time range values are not pre-populated by any previously selected time range settings entered on the Browse Options or Advanced Browse Options dialog.

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Right-click a mailbox or mailbox item (for example, calendars, journals, and so on) and select Find.

  5. Enter search criteria (for example, Subject, From, To, and so on) as explained in the next few sections.

  6. Click Search.

The search results are displayed in the right pane. You can optionally save the results, email, or print them.

Restoring a Message or a Mailbox Item from the Search Results
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. Enter search criteria and click Search.

  4. Right-click a message or a mailbox item from the search results and then select Recover.

  5. Click To Mailbox.

  6. In the Destination Client list, select the name of client computer.

    Note

    In cases where the mailbox alias name has changed, it is strongly recommended to recover archived messages out-of-place to the current mailbox alias name. Otherwise, attempting to recover the data in-place to a mailbox alias that no longer exists will cause the recover operation to fail.

  7. Click OK.

Save, Email, or Print Search Results
  1. From the CommCell Browser, expand the appropriate client.

  2. Right-click ArchiveSet or Subclient, point to All Tasks and then click Find.

  3. Enter search criteria and click Search.

  4. Click Save, Email, or Print in the upper-right corner of the window.

  5. If Email is selected, enter the SMTP parameters (SMTP Host, To, From, Subject).

Performing an Out-of Place Recovery

By default, the Exchange 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 or another folder on the same client.

When you perform an out-of-place recovery, the recovered data assumes the rights (that is, permissions) of the parent directory.

Recovering to a Different Folder on the Same Client

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

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Select a mailbox or a message from a mailbox or a mailbox item from the Client Browse window and click Recover All Selected.

  5. Click To Mailbox and clear the Recover to Same Folder check box.

  6. Click Browse and select a folder on the Destination client.

  7. Click OK.

  8. Click OK to start the recovery.

Recovering to a Different Client
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Select a mailbox or a message from a mailbox or a mailbox item from the Client Browse window and click Recover All Selected.

  5. Click To Mailbox.

  6. In the Destination client list, select the client. The source and destination clients must reside in the same CommCell Console. The destination client must have the Exchange Mailbox Archiver Agent located on it.

  7. Click OK to start the recovery.

Recovering Archive Mailbox

Follow the steps given below to recover an entire Archive Mailbox, or a specific message or a mailbox item. For example, a specific folder, contact, calendar entry, and so on.

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Expand ArchiveSet > Mailbox Archiver > Archive Mailbox Folder in the left pane of the Client Browse window.

  5. Select a message or a mailbox item from the right pane.

  6. Click Recover All Selected.

  7. Click To Mailbox.

  8. In the Destination Client list, select the name of client computer.

  9. Click OK.

Recovering to a Different Exchange Version

When performing a cross-application recovery of Exchange mailboxes from a newer version of Exchange Server to an older version, it follows the same compatibility support provided by the Exchange Server, unless otherwise noted.

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Select a mailbox or a message from a mailbox or a mailbox item from the Client Browse window and click Recover All Selected.

  5. Click To Mailbox.

  6. In the Destination client list, select the client. The source and destination clients must reside in the same CommCell Console. The destination client must have the Exchange Mailbox Archiver Agent located on it.

    If you want to recover to a different folder, clear the Recover to Same Folder check box and specify the destination path.

  7. Click OK to start the recovery.

Recovering a Message Archived from a PST File

Follow the steps given below to browse and recover a message archived from a PST file:

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Expand the Migrated From PST folder and select the message that you want to recover.

  5. Click Recover All Selected.

  6. Click To Mailbox.

  7. In the Destination Client list, select the name of client computer.

  8. Click OK.

Recovering a Message from a Stub in an Archived PST File Using Outlook

Follow the steps given below to recover a message from a stub in an archived PST file using Microsoft Outlook:

  1. Start Microsoft Outlook

  2. Enter your Profile Name.

  3. Click OK.

  4. On the File menu, click Open > Personal Folders File (or Outlook Data File on XP).

  5. Browse to the location where the PST files reside, and select the PST file you want to recover, then click OK to open the PST file.

  6. Navigate to the folder where the message stub resides, then double-click the stub.

  7. Click Recover.

    Note that the message will be recovered in the Recovered Items folder in the mailbox.

Recovering to a PST File

Follow the steps given below to recover a mailbox or a message or a mailbox item to a PST file:

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Select a mailbox or a message from a mailbox or a mailbox item from the Client Browse window and click Recover All Selected.

  5. Click To PST File.

  6. Click Browse and select a folder on the client computer to save the PST file.

    You can also save the PST in a network location. Click Network and browse to select a folder on any other client in the domain.

  7. Click OK to start the recovery.

Reviewing Data Selected for Recovery

When you select multiple mailboxes, messages and mailbox items from multiple locations, you can review all the data and locations before starting the recovery. Follow the steps give below to review the data selected for recovery:

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet, point to All Tasks and then click Browse.

  3. Click OK.

  4. Select a mailbox, a message, or a mailbox item from the Client Browse window and click Recover All Selected.

  5. Click To Mailbox.

  6. In the Destination client list, select the client. The source and destination clients must reside in the same CommCell Console. The destination client must have the Exchange Mailbox Archiver Agent located on it.

    If you want to recover to a different folder, clear the Recover to Same Folder check box and specify the destination path.

  7. Click Advanced.

  8. Select the Selected Paths/Filters tab.

  9. Click OK.

  10. Click OK to start the recovery.

Using the MassRecall Utility to Recall Messages for an Entire Mailbox

Use the MassRecall utility to recall multiple stubs and replace the stubs with restored messages. For example, the utility can be used to recall stubs that have been moved to a folder other than the original folder, and then restore the messages to the original folder.

Mailbox objects can be recalled to the original mailbox folder from which they were archived (such as the Inbox) or to a different folder within the same mailbox.

Note

  • MassRecall Utility is not applicable for the Exchange Online mailbox.

  • MassRecall Utility is applicable to the Exchange Mailbox Agent where stub recalls in Cvrecallmailbox should use the -appguid parameter.For example, CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 -targetserver -targetevmgrcport -appguid

  • There no need of the -appguid parameter for the Exchange Mailbox (Classic) Agent and v9/v10 mailbox archiver stub recalls. For example, CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 -targetserver -targetevmgrcport

Before You Begin

  • Run the MassRecall utility on the same client computer where the agent is located.

  • Use the same Microsoft Outlook profile for the MassRecall utility that you use for the Archiver account.

Listing Stubs Prior to a Recall

Before you run a recall operation using the MassRecall utility, you can list the stubs that exist in a folder or in an entire mailbox.

Procedure
  1. Create an argument file, for example input.txt.

  2. Specify the following parameters in the argument file, and then save the file to the local computer.

    user1@email.com,inbox\folder1,inbox

    Where:

    • user1@email.com is the SMTP address.

    • inbox\folder1 is the folder for which you want to list the existing stubs. If this parameter is left blank, then all of stubs in the entire mailbox are listed.

  3. Run the MassRecall utility from the same location where the agent is located.

    1. In Windows, on the taskbar, click Start, and then type cmd in the Search box.

      The Command Prompt window appears.

    2. Navigate to the folder where the agent is located.

    3. To list the existing stubs in the mailbox folder, run the following command.

      CvRecallMailbox.exe outlook1 -f C:\input.txt ExchangeServer1 ActiveDirectory1 targetserver targetevmgrcport [-archmb] [-ReportingMode] [-o C:\output.txt]

      Where:

      • outlook1 specifies the name of the Outlook profile set for the Archiver administrator account.

      • C:\input.txt specifies the argument file with the saved path.

      • ExchangeServer1 specifies the name of the Exchange server.

      • ActiveDirectory1 specifies the name of the Active Directory server.

      • targetserver is the server where the agent is located.

      • targetevmgrcport is the port number where the ClMgrS is running on the target server. This applies to upgraded clients or clients from previous Commvault versions.

      • archmb provides the option to recall the stubs from the Archive mailbox only.

      • C:\output.txt specifies the new text file that will be created.

      • - o C:\output.txt is optional. The output appears in the Command Prompt window if this parameter is left blank.

    The new output.txt file contains the name of the mailbox folder, the number of stubs, and the size (in bytes) of the original messages that can be recalled in the mailbox folder.

Recalling Messages to the Same Folder in a Mailbox

You can use the MassRecall utility to recall archived messages to the original folder from which they were archived. In this case, all the stubs in the original folder are overwritten.

Procedure
  1. Create an argument file, for example input.txt.

  2. Specify the following parameters in the argument file, and save the file to the local computer.

    user1@email.com,inbox\folder1

    Where:

    • user1@email.com is the SMTP address.

    • inbox\folder1 is the folder to be recalled.

  3. Run the MassRecall utility from the same location where the agent is located.

    1. In Windows, on the taskbar, click Start, and then type cmd in the Search box.

      The Command Prompt window appears.

    2. Navigate to the folder where the agent is located.

    3. To perform an in-place recall of the objects present in the mailbox folder, run the following command.

      CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 -targetserver -targetevmgrcport -appguid

      Where:

      • outlook1 specifies the name of the Outlook profile set for the Archiver administrator account.

      • C:\input.txt specifies the argument file with the saved path.

      • ExchangeServer1 specifies the name of the Exchange server.

      • ActiveDirectory1 specifies the name of the Active Directory server.

      • targetserver is the server where the agent is located.

      • targetevmgrcport is the port number where the ClMgrS is running on the target server. This applies to upgraded clients from previous <Companyname> versions or newly installed V11 clients. The port number must be set to 8402 on the nEVMGRCPORT registry key located in \HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance001\Session\ on the target server. You must restart client services after you set the port number to 8402 using the Registry editor.

      • appguid specifies the GUID that can be retrieved in the following ways:

        Note

        You must specify the appguid parameter only if you want to recall stubs that were backed up using version 10 or version 11 of the SIMPANA_ONEPASS_FOR_EXCHANGE agent.

      • Run the below queries from the CommServe database to retrieve the client ID and the APPGUID information.

        select * from app_client where name =
        select * from APP_Application where clientId =

        APPGUID information can be found in the GUID field.

      • The APPGUID information can be retrieved from cvmailbackup.log. For more information see, View Log Files.

        Note

        Admin users must be included in theCommCell user group and must be assigned the Master role.

    All the archived messages in folder1 are recalled to the original folder, and all the stubs are overwritten.

Recalling Messages to a Different Folder in a Mailbox

You can use the MassRecall utility to recall archived messages to a different folder than the folder from which they were archived.

Procedure
  1. Create an argument file, for example input.txt.

  2. Specify the following parameters in the argument file, and save the file to the local computer.

    user1@email.com,inbox\folder1,inbox

    Where:

    • user1@email.com is the SMTP address.

    • inbox\folder1 is the folder to be recalled.

    • inbox is the destination folder where the stubs are recalled.

  3. Run the MassRecall utility from the same location where the agent is located.

    1. In Windows, on the taskbar, click Start, and then type cmd in the Search box.

      The Command Prompt window appears.

    2. Navigate to the folder where the agent is located.

    3. To perform an in-place recall of the objects present in the mailbox folder, run the following command.

      CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 -targetserver -target evmgrcport

      Where:

      • outlook1 specifies the name of the Outlook profile set for the Archiver administrator account.

      • C:\input.txt specifies the argument file with the saved path.

      • ExchangeServer1 specifies the name of the Exchange server.

      • ActiveDirectory1 specifies the name of the Active Directory server.

      • targetserver is the server where the agent is located.

    target evmgrcport is the port number where the ClMgrS is running on the target server. This applies to upgraded clients or clients from previous Commvault versions.

Recalling Legacy Stubs

You can use the MassRecall Utility to recall stubs that were backed up using the version 9 or the version 10 Exchange Mailbox Archiver Agent by using version 11 of either the Exchange Mailbox Agent or OnePass for Exchange Mailbox (Classic). If you deconfigured the older version of the Exchange Mailbox Archiver Agent, then recalling the stubs using version the version 11 agents works as expected. However, if you use only a fresh install of the version 11 agent, you must configure the client where the MassRecall Utility is installed.

In the case of a fresh install, to recall stubs that were backed up using the version 9 Exchange Mailbox Archiver Agent, you must initiate a recall of version 10 stubs first. Recalling the version 10 stubs creates a persistent recovery job. While that job is running, you can then recall the version 9 stubs. If the persistent recovery job completes before you recall the version 9 stubs, you must initiate the version 10 recall again.

By default, the persistent recovery job completes 7 days after the last recall request. Use the nDMRSIDLETIMEOUT additional setting to increase the amount of time that it takes the persistent recovery job to complete.

Procedure
  1. Configure the client by doing the following:

    1. Log on to the client where you located the agent.

      Use the credentials for the Windows account that you defined in the mailbox agent properties.

    2. In Windows on the client computer, click Start, and then type regedit in the Search programs and files box.

    3. Press Enter.

    4. In the Registry Editor, expand HKEY_LOCAL_MACHINE > Software > CommVault Systems > Galaxy > Instance001 > Machines > machine_name.

    5. Right-click the machine name, click New > Key, and then type MSExchangeDMAgent.

    6. Right-click MSExchangeDMAgent, click New > DWORD, and then type nINSTALL.

    7. Right-click nINSTALL, type 1 in the Value data box, and then click OK.

    8. Close the Registry Editor.

  2. On the client where the agent is located, add the nDMRSIDLETIMEOUT additional setting as shown in the following table.

    For instructions about adding the additional setting from the CommCell Console, see Adding or Modifying Additional Settings from the CommCell Console.

  3. Property

    Value

    Name

    nDMRSIDLETIMEOUT

    Category

    EventManager

    Type

    Integer

    Value

    Enter a value in seconds.

    The value should be an extended amount of time such as 259200 seconds (that is, 72 hours).

  4. Restart the services.

Updating the Stub Recall URL in a Mailbox

You can use the MassRecall utility to change the recall URL that appears inside the body of the stub file.

Procedure
  1. Create an argument file, for example input.txt.

  2. Specify the following parameters in the argument file, and save the file to the local computer.

    user1@email.com,inbox\folder1

    Where:

    • user1@email.com is the SMTP address.

    • inbox\folder1 is the folder to be recalled.

  3. Run the MassRecall utility from the same location where the agent is located.

    1. In Windows, on the taskbar, click Start, and then type cmd in the Search box.

      The Command Prompt window appears.

    2. Navigate to the folder where the agent is located.

    3. To change the stub recall URL, run the following command.

      CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 targetserver target evmgrcport -update old_URL New_URL

      Where:

      • outlook1 specifies the name of the Outlook profile set for the Archiver administrator account.

      • C:\input.txt specifies the argument file with the saved path.

      • ExchangeServer1 specifies the name of the Exchange server.

      • ActiveDirectory1 specifies the name of the Active Directory server.

      • targetserver is the server where the agent is located.

      • target evmgrcport is the port number where the ClMgrS is running on the target server. This applies to upgraded clients or clients from previous Commvault versions.

New_URL is the new URL that appears inside the body of the stub file.

Recalling Stubs from a Specific Time Range

You can use the MassRecall utility to recall stub files from a specific time range.

Procedure
  1. Create an argument file, for example input.txt.

  2. Specify the following parameters in the argument file, and save the file to the local computer.

    user1@email.com,inbox\folder1

    Where:

    • user1@email.com is the SMTP address.

    • inbox\folder1 is the folder to be recalled.

  3. Run the MassRecall utility from the same location where the agent is located.

    1. In Windows, on the taskbar, click Start, and then type cmd in the Search box.

      The Command Prompt window appears.

    2. Navigate to the folder where the agent is located.

    3. To change the stub recall URL, run the following command.

      CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 -targetserver -target evmgrcport -timerange -Reportingmode

      Where:

      • outlook1 specifies the name of the Outlook profile set for the Archiver administrator account.

      • C:\input.txt specifies the argument file with the saved path.

      • ExchangeServer1 specifies the name of the Exchange server.

      • ActiveDirectory1 specifies the name of the Active Directory server.

      • targetserver is the server where the agent is located.

      • target evmgrcport is the port number where the ClMgrS is running on the target server. This applies to upgraded clients or clients from previous Commvault versions.

      • timerange is the FROM(mm-dd-yyyy)<SPACE>TO(mm-dd-yyyy) format that you must use to specify the dates in the time range.

      • Reportingmode generates a report.

Generating a Stub Detail Report

You can use the CVRecallMailbox tool generate reports on stub details. You can use the -ReportingMode parameter to generate the report with a low level of detail, generate the report with a high level of detail, or generate both types of reports.

Procedure
  1. Create an argument file, for example input.txt.

  2. Specify the following parameters in the argument file, and save the file to the local computer.

    user1@email.com,inbox\folder1

    Where:

    • user1@email.com is the SMTP address.

    • inbox\folder1 is the folder to be recalled.

  3. Run the MassRecall utility from the same location where the agent is located.

    1. In Windows, on the taskbar, click Start, and then type cmd in the Search box.

      The Command Prompt window appears.

    2. Navigate to the folder where the agent is located.

    3. To generate a report, run any of the following commands:

      • To generate the report with a low level of detail, run the following command:

        CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 targetserver evmgrcport -ReportingMode –low

      • To generate the report with a high level of detail, run the following command:

        CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 targetserver evmgrcport -ReportingMode -high

      • To generate both the low and high reports, run the following command:

        CvRecallMailbox.exe outlook1 –f C:\input.txt ExchangeServer1 ActiveDirectory1 targetserver evmgrcport -ReportingMode –complete

    Where:

    • outlook1 specifies the name of the Outlook profile that is set for the Archiver administrator account.

    • C:\input.txt specifies the argument file with the saved path.

    • ExchangeServer1 specifies the name of the Exchange server. Use a semicolon between Exchange servers to specify multiple Exchange servers.

    • ActiveDirectory1 specifies the name of the Active Directory server. You can use a fully qualified domain name (FQDN), an IP address, or the server name.

    • targetserver is the server where the agent is located.

    • evmgrcport is the port number where the ClMgrS is running on the target server. This applies to upgraded clients or clients from previous Commvault versions.

Result

The CVRecallMailbox tool creates the following report files in the specified directory:

  • Low level: CompleteStubDetails.csv

  • High level: HighLevelStubDetails.csv

Both levels: CompleteStubDetails.csv and HighLevelStubDetails.csv

Recovering Messages Across Backup Cycles and Subclients

You can browse and recover data that spans multiple backup cycles or across subclients. By default, a new cycle begins on the first day of the year with the creation of a new index. You can also schedule creating the new index according to your individual backup requirements.

Browsing and recovering data across subclients within an archive set allows you to recover data from the mailboxes that have been moved from one subclient to another.

Browsing and recovering data across backup cycles also allows you to recover data that was backed up before the last backup cycle. This is accomplished by specifying a time range during browse and recovery. The data that was backed up during the specified time period is marked as a candidate for recovery.

  1. From the CommCell Console, expand client > Exchange Mailbox Archiver.

  2. Right-click the archive set that contains the data you want to restore and click All Tasks > Browse Backup Data.

  3. Select Specify Browse Time, select date and time from the Browse data before drop down menu.

  4. Click Advanced.

  5. Select Exclude Data Before and select the specific time range. Both the FROM and TO values are required.

  6. Click OK.

  7. Select the folder level under the backup set. Its entire contents will be automatically selected in the right pane.

  8. Click Recover All Selected.

  9. From the General tab, either specify Recover to Same Paths or Specify destination path by typing a path or clicking Browse to locate the desired destination.

  10. Click the Job Initiation tab.

  11. Select Immediate to run the job immediately.

  12. Click OK.

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

  14. This will restore the data in the specified destination.

Scheduling a Recovery

  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox Archiver.

    Right-click an ArchiveSet point to All Tasks and then click Browse.

    Click OK.

  2. Select one or more mailboxes in the left pane. The mailbox items (for example, calendars, journals, and so on) will be selected in the right pane.

    Click Recover All Selected.

  3. Click Job Initiation tab and click Schedule.

    Click Configure.

  4. Select the appropriate scheduling options. For example:

    • Click Weekly.

    • Check the days you want the run the recovery job.

    • Change the Start Time to 9:00 PM

    • Click OK to close the Schedule Details dialog

    • Click OK to close the Recovery Options dialog

    The recovery job runs according to the schedule.

Managing Recovery Jobs

Once you initiate the recovery operation, a recover 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.

Caution

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 that 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.

Note

Backup 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. Under Data, click Job Management.

    The Job Management dialog box appears.

  3. Click the Job Restarts tab.

  4. From the Job Type list, select the appropriate item.

  5. Select the Restartable check box to make the job restartable.

  6. In the Max Restarts box, change the maximum number of times the Job Manager will try to restart a job.

  7. In the Restart Interval (Mins) box, change the time interval between attempts for the Job Manager to restart the job.

  8. Click OK.

Configure Job Restartability for an Individual Job
  1. From the CommCell Browser, expand Client Computers > client > Exchange Mailbox > <ArchiveSet>.

  2. Right-click the subclient in the right pane and then click Browse Backup Data.

  3. Click OK.

  4. Select the data that you want to restore and click Recover All Selected.

  5. Click Advanced and select the Job Retry tab

  6. Select Enable Total Running Time and specify the maximum elapsed time before a job can be restarted or killed

  7. Select Kill Running Jobs When Total Running Time Expires to kill the job after reaching the maximum elapsed time.

  8. Select Enable Number Of Retries and specify the number of retries.

  9. 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 Recovery Options

Several additional options are available to further refine your recovery 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 Browser, click Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet that contains the data you want to recover, point to All Tasks and then click Browse.

  3. Click OK.

  4. In the Client Browse tab, select the data to be recovered and click Recover all Selected.

  5. Click Advanced.

  6. In the Advanced Restore Options dialog box, click General.

  7. On the General tab, select the Skip errors and continue check box.

  8. 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 Browser, click Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet that contains the data you want to recover, point to All Tasks and then click Browse.

  3. Click OK.

  4. In the Client Browse tab, select the data to be recovered and click Recover all Selected.

  5. Click Advanced.

  6. In the Advanced Restore Options dialog box, click Startup.

  7. On the Startup tab, select Change Priority.

  8. Enter a priority number - 0 is the highest priority and 999 is the lowest priority.

  9. Select the Start up in suspended State check box to start the job in a suspended state.

  10. 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 Browser, click Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet that contains the data you want to recover, point to All Tasks and then click Browse.

  3. Click OK.

  4. In the Client Browse tab, select the data to be recovered and click Recover all Selected.

  5. Click Advanced.

  6. In the Advanced Restore Options dialog box, click Copy Precedence.

  7. On the Copy Precedence tab, select the Restore from copy precedence check box.

  8. Enter the copy precedence number.

  9. 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 Browser, click Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet that contains the data you want to recover, point to All Tasks and then click Browse.

  3. Click OK.

  4. In the Client Browse tab, select the data to be recovered and click Recover all Selected.

  5. Click Advanced.

  6. In the Advanced Restore Options dialog box, click Data Path.

  7. On the Data Path tab, select the MediaAgent and Library.

  8. Select the Drive Pool and Drive for tape library.

  9. Select the name of the Proxy server if you wish to restore using a proxy server.

  10. 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.

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 Browser, click Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet that contains the data you want to recover, point to All Tasks and then click Browse.

  3. Click OK.

  4. In the Client Browse tab, select the data to be recovered and click Recover all Selected.

  5. Click Advanced.

  6. In the Advanced Restore Options dialog box, click Encryption.

  7. Enter the Pass Phrase.

  8. Click OK.

Refer to Data Encryption.

Browse Options

Deleted files can be manually restored by the user. You can specify the time range for the deleted items to be restored.

  1. From the CommCell Browser, click Client Computers > client > Exchange Mailbox Archiver.

  2. Right-click the ArchiveSet that contains the data you want to recover, point to All Tasks and then click Browse.

  3. Click OK.

  4. In the Client Browse tab, select the data to be recovered and click Recover all Selected.

  5. Click Advanced.

  6. From the Browse Options tab, select Restore deleted items option.

  7. Select Specify Time Range option to specify the time zone, start time and end time for the deleted items to be restored.

  8. Click OK.

Refer to Job Management.

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 Interface.

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.

Loading...