Search <book_title>...

Veritas Enterprise Vault™ Installing and Configuring

Last Published: 2017-07-28

Product(s): Enterprise Vault (12.1)

Configuring the Exchange throttling policy on the Vault Service account

Note:

The following procedure describes the configuration of the Vault Service account. If you run Exchange archiving tasks under a service account other than the Vault Service account, run the procedure against this other account.

Exchange Server has a default throttling policy which restricts user accounts to no more than 20 open connections to the server. This restriction on the Vault Service account would cause failures of the Enterprise Vault tasks that run under the account.

You must remove the restriction from the Vault Service account, and Enterprise Vault includes a PowerShell script called SetEVThrottlingPolicy.ps1 which creates a new policy and assigns it to the Vault Service account to remove the restriction.

Note the following requirements for the throttling policy script:

If you archive from both Exchange 2010, and Exchange 2013 or later in your environment, you must run the script in the Exchange Management Shell on an Exchange 2013 or later server.
If both Exchange 2010, and Exchange 2013 or later are present in your environment, SetEVThrottlingPolicy.ps1 automatically configures Exchange 2010 servers before later servers, which is mandatory. If you use the -version to configure Exchange throttling policies separately for each Exchange version, you must configure the Exchange 2010 throttling policy first.

The syntax for SetEVThrottlingPolicy.ps1 is:

.\SetEVThrottlingPolicy.ps1 -user domain\user_name [-server exchange_mailbox_server] [-version exchange_version] [-DomainController domain_controller_name]

where:

domain\user_name is the Vault Service account and the domain it belongs to. If user_name contains spaces, enclose the whole domain\user_name string in quotation marks.
If you run Exchange in a cross-forest environment, run the PowerShell script against the disabled user account that owns the Vault Service account's linked mailbox.
See Creating a mailbox for the Vault Service account.
exchange_mailbox_server is the name of the Exchange mailbox server. You must specify an Exchange mailbox server if you run SetEVThrottlingPolicy.ps1 on a computer other than the mailbox server.
exchange_version is the Exchange server version whose throttling policy you want to configure.
exchange_version can be 2010 or 2013AndLater.
domain_controller_name is the name of a domain controller in the domain of which the Vault Service account is a member. This parameter is optional but you should specify a domain controller in environments with multiple domain controllers, to ensure consistency across all the commands in the throttling policy script.

To configure the Exchange throttling policy on the Vault Service account

Log in to an Exchange server using an account that is assigned the following management roles:
- Mail Recipients
- Recipient Policies
By default, members of the "Organization Management" role group are assigned these roles.
Copy the script called SetEVThrottlingPolicy.ps1 from the \Veritas Enterprise Vault\PowerShell Scripts folder on the Enterprise Vault media to the Exchange Server.
On the Exchange server, open the Exchange Management Shell.
If you moved an existing Vault Service account mailbox from Exchange 2007 or earlier, update the mailbox using the following command:
Set-Mailbox mailbox_name -ApplyMandatoryProperties
where:
mailbox_name is the name of the Vault Service account's mailbox. If mailbox_name contains spaces, enclose it in quotation marks.
Run SetEVThrottlingPolicy.ps1.
Note:
In a cross-forest environment, you must specify the resource domain so that SetEVThrottlingPolicy.ps1 runs against the Vault Service account's linked mailbox in the resource forest.
When SetEVThrottlingPolicy.ps1 finishes, close the Exchange Management Shell.
If you want to force these changes to take effect immediately, restart the Microsoft Exchange RPC Client Access service on each Exchange server where the service exists.
If you do not restart the service, the changes can take up to two hours to take effect by default.

You can also run SetEVThrottlingPolicy.ps1 remotely from the Exchange server under PowerShell. When you run the script remotely, use the -server switch to specify the name of the Exchange mailbox server.

In this case, the full syntax for this script is:

.\SetEVThrottlingPolicy.ps1 -user domain\user_name -server exchange_mailbox_server

More Information

Creating a mailbox for the Vault Service account