Recover

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.

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.

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.

• To use the CvRecallMailbox.exe to recall stubs, you must configure the Exchange Mailbox (Classic) Agent with the same exchange servers that are configured in the Exchange Mailbox Agent.

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.

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.

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:

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.