Loading...

Configuration - OnePass for Exchange Mailbox (Classic)

Table of Contents

Before You Begin

Configure Office 365 with Exchange

Configuring the Backup Mode

Before You Begin

Remember: Make sure you have completed all of the required prerequisite procedures before you configure the agent.

Verify the Exchange Server Name and the Exchange Version. The version of Exchange Server that you use determines which configuration procedures you must perform.

Procedure

  1. From the CommCell Browser, expand client.
  2. Right-click the agent, and then click Properties.

    The Exchange Mailbox (Classic) Properties dialog box appears.

  3. Configure your environment based on the version of Exchange Server that you use.

Configure Office 365 with Exchange

Important:

On October 31, 2017, Microsoft ended support for RPC over HTTP for Office 365. For more information, see the Microsoft support article: "RPC over HTTP reaches end of support in Office 365 on October 31, 2017", https://support.microsoft.com/en-us/help/3201590/rpc-over-http-reaches-end-of-support-in-office-365-on-october-31-2017.

After December 15, 2018, Commvault will not support backup nor archiving operations using Office 365 (Exchange Online) for the Exchange Mailbox (Classic) Agent nor OnePass for Exchange Mailbox (Classic).

Transition to the Exchange Mailbox Agent. The Exchange Mailbox Agent uses EWS for backup and archiving instead of MAPI.

For information, see Transitioning to the Exchange Mailbox Agent.

Before You Begin

Review the considerations for backing up Office 365 with Exchange mailboxes.

To configure Office 365 with Exchange, you must:

  • Configure an Office 365 with Exchange-only environment if you do not use a hybrid environment.
  • Verify the execution policy
  • Disable MAPI over HTTP
  • Configure an Office 365 with Exchange (Exchange Online) Administrator account
  • Create a service account profile for Outlook
  • Disable the User Account Control setting in Windows
  • Skip user impersonation
  • Prevent backup failures caused by logon errors
  • Prevent backup failures caused by MAPI network errors

Configure an Office 365 with Exchange-Only Environment

If you use an Office 365 with Exchange-only environment, and not an Exchange hybrid environment that has an on-premises Active Directory that is synchronized with Office 365 with Exchange, you must configure the nExchangeOnlineOnly additional setting for discover and backup operations to complete.

Procedure

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the client, and then click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Additional Settings tab.
  5. Click Add.

    The Add Additional Settings dialog box appears.

  6. In the Name box, type nExchangeOnlineOnly.
  7. In the Value box, type 1.
  8. Click OK.

Configuring Office 365 with Exchange Administrator Accounts

In this procedure, you configure the Exchange Administrator (Windows user) account, and the Office 365 with Exchange (Exchange Online) Administrator Account.

Procedure

  1. From the CommCell Browser, expand Client Computers > client.
  2. Right-click the agent, and then click Properties.

    The agent Properties dialog box appears.

  3. Click Change Account beside Exchange Administrator Account.

    The Change Exchange Administrator Account dialog box appears.

  4. Enter the credentials that you use to log on to Windows.
  5. Select the Exchange Online check box.

    A warning message appears.

  6. Click OK.
  7. In the Profile Name box, type the Microsoft Outlook profile name.
  8. Click Change Account beside Exchange Online Administrator Account.

    The Change Exchange Administrator Account dialog box appears.

  9. In the Exchange Administrator Account box, type the primary SMTP address of the online account.

    The primary SMTP address is the address that you use to connect to Office 365 with Exchange using Windows PowerShell.

  10. In the Password box, type the service account password, and then type the password again in the Confirm Password box.
  11. Click OK.

Skip User Impersonation

On the proxy client, configure the appropriate services to use the Windows user log on account, and then disable user impersonation.

Procedure

  1. On the proxy client, in Windows, click the Start button.
  2. In the Search box, type services.msc, and then press Enter.

    The Services snap-in appears.

  3. Configure the Commvault Communications Service to use the Windows user log on account.
    1. In the services list, right-click Commvault Communications Service, and then click Properties.

      The Commvault Communications Service Properties dialog box appears.

    2. Click the Log On tab.
    3. Select This account, and in the corresponding box, type the name of the Office 365 with Exchange service account.
    4. In the Password box, type the account password.
    5. In the Confirm password box, type the account password again.
    6. Click OK.
    7. In the services list, right-click Commvault Communications Service, and then click Restart.
  4. Configure the Commvault Client Manager Service to use the Windows user log on account.
    1. In the services list, right-click Commvault Client Manager Service, and then click Properties.

      The Commvault Client Manager Properties dialog box appears.

    2. Click the Log On tab.
    3. Select This account, and in the corresponding box, type the name of the Office 365 with Exchange service account.
    4. In the Password box, type the account password.
    5. In the Confirm password box, type the account password again.
    6. Click OK.
    7. In the services list, right-click Commvault Communications Service Properties, and then click Restart.
  5. On the client where the Exchange package is installed the agent is added, disable user impersonation by adding the nSkipUserImpersonation 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.

    Property

    Value

    Name

    nSkipUserImpersonation

    Category

    MSExchangeMBAgent

    Type

    Integer

    Value

    1

Preventing Backup Failures Caused by Logon Errors

To prevent backups from failing because of mailbox logon errors, reset the MAPI session using the nMailboxesPerSession additional setting. The value in the additional setting is the number of mailboxes that are backed up before the MAPI session is reset. We recommend that you set the value to 1 for an Office 365 with Exchange environment.

Procedure

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the client, and then click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Additional Settings tab.
  5. Click Add.

    The Add Additional Settings dialog box appears.

  6. In the Name box, type nMailboxesPerSession.
  7. In the Value box, type 1.

    We recommend that you set the value to 1 for Office 365 with Exchange.

  8. Click OK.

Preventing Backup Failures Caused by MAPI Network Errors

A network error (MAPI_E_NETWORK_ERROR) might cause the backup or archive of Office 365 with Exchange mailboxes that are larger than 5 GB to fail. To prevent this, you must configure the nRestartMAPIOnNetworkError additional setting.

Procedure

  1. From the CommCell Browser, expand Client Computers.
  2. Right-click the client, and then click Properties.

    The Client Computer Properties dialog box appears.

  3. Click Advanced.

    The Advanced Client Properties dialog box appears.

  4. Click the Additional Settings tab.
  5. Click Add.

    The Add Additional Settings dialog box appears.

  6. In the Name box, type nRestartMAPIOnNetworkError.
  7. In the Value box, type 1.
  8. Click OK.
  9. Restart the services.

Result

If a network error occurs while an Exchange mailbox backup or archive job is running, the job will resume at the same folder and the same message in the mailbox that was being processed when the job was interrupted by the network error.

Configuring the Backup Mode

Answer the following questions to determine the method:

  • How much data do you want to backup?
  • Do you want to stub data to reclaim space on primary storage?

Choose the method that best matches your objectives:

  • Method 1: Backup Mode

    Backup mode allows you to protect all content within the mailboxes and does not reclaim space on primary storage.

  • Method 2: Backup with Selective Stubbing Mode

    Backup with selective stubbing mode allows you protect all content within the mailboxes and also archive based on stubbing rules. Stubbing rules allows you to reclaim space on primary storage.

  • Method 3: Archive Mode

    Archive mode allows you to protect the mailbox content that meets the pre-defined stubbing rules. This option allows you to aggressively reclaim space on primary storage.

Backup Mode

In this mode the data on the primary storage (mailbox) remains intact and a copy of the data is created on the media. This mode is recommended if:

  • You are primarily looking for the ability to perform granular data recoveries.
  • You want to restore an entire mailbox to a point-in-time, but you do not want to do it from a database backup.
  • You want to content index your Exchange data so that full mailboxes will be searchable for end users and the compliance officers.
  1. From the CommCell Browser, expand Client Computers > client > agent.
  2. Right-click defaultBackupSet, and then click All Tasks > New Subclient.

    The Subclient Properties dialog box appears.

  3. On the General tab, type the Subclient Name.
  4. Click the Storage Device tab.
  5. Select the Storage Policy from the list.
  6. Click OK.
  7. If you do not have storage policy created, create one.
    1. Click Create Storage Policy.
    2. Follow the prompts displayed in the Storage Policy Wizard. The required options are mentioned below:
      1. Select the Storage Policy type as Data Protection and Archiving and click Next.
      2. Enter the name in the Storage Policy Name box and click Next.
      3. From the Library list, click the name of a disk library to which the primary copy should be associated and then click Next.

        Ensure that you select a library attached to a MediaAgent operating in the current release.

      4. From the MediaAgent list, click the name of a MediaAgent that will be used to create the primary copy and then click Next.
      5. For the device streams and the retention criteria information, click Next to accept default values.
      6. Select Yes to enable deduplication for the primary copy.
      7. From the MediaAgent list, click the name of the MediaAgent that will be used to host the Deduplication database (DDB).

        In the Location box, type the name of the folder in which the DDB must be located or click the Browse to select the folder, and then click Next.

      8. Review the details and click Finish to create the Storage Policy.
  8. Click the Content tab.
  9. Click Configure.
  10. Click Discover
  11. Hold down the Ctrl key and click the mailboxes that are listed in the Mailbox Name list.
  12. In the Change all selected mailboxes to list, click the name of the custom subclient.
  13. Click OK.  
  14. Select Include All Messages to backup all the emails that are present in the selected mailboxes, and then click OK.

Backup with Selective Stubbing Mode

In this mode all content within the mailboxes is backed up and is also archived based on stubbing rules.

This mode is recommended if:

  • You are primarily looking for the ability to perform granular data recoveries.
  • You are looking for the added benefit of primary storage (mailbox) space reclamation by stubbing Exchange data that qualifies the stubbing rules.
  • You want the option to stub the items on primary storage (mailbox) or delete them entirely.
  • You want to content index your Exchange data so that full mailboxes will be searchable for end users and the compliance officers.

Configuring the Backup with Selective Stubbing Mode

  1. From the CommCell Browser, expand Client Computers > client > agent.
  2. Right-click defaultBackupSet, and then click All Tasks > New Subclient.

    The Subclient Properties dialog box appears.

  3. On the General tab, type the Subclient Name.
  4. Click the Storage Device tab.
  5. Select the Storage Policy from the list.
  6. Click OK.
  7. If you do not have storage policy created, create one.
    1. Click Create Storage Policy.
    2. Follow the prompts displayed in the Storage Policy Wizard. The required options are mentioned below:
      1. Select the Storage Policy type as Data Protection and Archiving and click Next.
      2. Enter the name in the Storage Policy Name box and click Next.
      3. From the Library list, click the name of a disk library to which the primary copy should be associated and then click Next.

        Ensure that you select a library attached to a MediaAgent operating in the current release.

      4. From the MediaAgent list, click the name of a MediaAgent that will be used to create the primary copy and then click Next.
      5. For the device streams and the retention criteria information, click Next to accept default values.
      6. Select Yes to enable deduplication for the primary copy.
      7. From the MediaAgent list, click the name of the MediaAgent that will be used to host the Deduplication database (DDB).

        In the Location box, type the name of the folder in which the DDB must be located or click the Browse to select the folder, and then click Next.

      8. Review the details and click Finish to create the Storage Policy.
  8. Click the Content tab.
  9. Click Configure.
  10. Click Discover
  11. Hold down the Ctrl key and click the mailboxes that are listed in the Mailbox Name list.
  12. In the Change all selected mailboxes to list, click the name of the custom subclient.
  13. Click OK.  
  14. Select Include All Messages to backup all the emails that are present in the selected mailboxes, and then click OK.
  15. Click the Message Rules tab.
    1. Select the Enable these message rules check box.
    2. Select Create stubs if it is not already selected.
    3. On the Message subtab, set the Collect Messages after n Days to 30 and the Collect Messages larger than n Kb to 1024.
  16. Click the Retention tab.

    Note: On the Source Pruning tab, if the options are selected, then based on the received time, the messages and the stubs will be deleted from the primary storage (mailbox) after the specified number of days.

    1. Select the Prune Stubs check box.
    2. Select the Prune Messages check box.
    3. Click OK.
  17. Click OK for the warning message.

    Note: In order to set up the end-user recovery options for mailboxes that are backed up with selective stubbing mode enabled, see Deployment Web Console.

Configuring the Recall Services

After the Web Server and the Web Console are configured, configure the recall services.

Consider the following when configuring recall services:

  • Specify a Domain Namespace.
  • The Recall Service URL should be in either of the following formats: http://server.domain.com or https://server.domain.com.
  • The Recall Server can be a load balancing server.
  • The recall services should be accessible from outside the firewall. For details see, Configure to access archived emails from outside the firewall.

Procedure

  1. From the CommCell Console, expand Client Computers.
  2. Right-click the client, and then click Properties.
  3. Click Advanced.
  4. Click the Web Server URLs tab.
  5. Do either of the following:
    • In the Recall Services box, type the address of the recall service.
    • Specify a Domain Namespace to enable external connectivity.

      For example: http://web_console or https://web_console

  6. Replace web_console with the client name of the computer where the Web Console is installed.
  7. Click OK.

Archive Mode

In this mode, mailbox content that meets the predefined stubbing rules is protected.

This mode is recommended if:

  • You are looking for primary storage (mailbox) space reclamation by stubbing Exchange data that qualifies the stubbing rules.
  • You want the option to stub the items on primary storage (mailbox) or delete them entirely.
  • You want to enable the end users to recover their emails.
  1. From the CommCell Browser, expand Client Computers > client > agent.
  2. Right-click defaultBackupSet, and then click All Tasks > New Subclient.

    The Subclient Properties dialog box appears.

  3. On the General tab, type the Subclient Name.
  4. Click the Storage Device tab.
  5. Select the Storage Policy from the list.
  6. Click OK.
  7. If you do not have storage policy created, create one.
    1. Click Create Storage Policy.
    2. Follow the prompts displayed in the Storage Policy Wizard. The required options are mentioned below:
      1. Select the Storage Policy type as Data Protection and Archiving and click Next.
      2. Enter the name in the Storage Policy Name box and click Next.
      3. From the Library list, click the name of a disk library to which the primary copy should be associated and then click Next.

        Ensure that you select a library attached to a MediaAgent operating in the current release.

      4. From the MediaAgent list, click the name of a MediaAgent that will be used to create the primary copy and then click Next.
      5. For the device streams and the retention criteria information, click Next to accept default values.
      6. Select Yes to enable deduplication for the primary copy.
      7. From the MediaAgent list, click the name of the MediaAgent that will be used to host the Deduplication database (DDB).

        In the Location box, type the name of the folder in which the DDB must be located or click the Browse to select the folder, and then click Next.

      8. Review the details and click Finish to create the Storage Policy.
  8. Click the Content tab.
  9. Click Configure.
  10. Click Discover
  11. Hold down the Ctrl key and click the mailboxes that are listed in the Mailbox Name list.
  12. In the Change all selected mailboxes to list, click the name of the custom subclient.
  13. Click OK.
  14. Select Include Only the messages that meet the message rules to backup all the emails that meet the message rule criteria, and then click OK.
  15. Click the Message Rules tab.
    • Check the Enable these message rules check box.
    • Ensure Create stubs option is selected.
    • In the Message Rule tab set the Collect Messages after n Days to 30 and the Collect Messages larger than n Kb to 1024.
  16. Click the Retention tab.

    Note: On the Source Pruning tab, if the options are selected based on the received time, then the messages and the stubs will be deleted from the primary storage (mailbox) after the specified number of days.

    • Select the Prune Stubs check box.
    • Select the Prune Messages check box.
    • Click OK.

Last modified: 4/12/2018 9:00:25 PM