Backup Exec 23 Administrator's Guide

Tuning Scenarios

For the following scenarios tuning of the default parameters may be required.

If you observe less than expected backup job rate, change some parameters in the o365_settings.conf file. If the new values work, you can retain them for subsequent jobs.

Default path

C:\Program Files\Veritas\Backup Exec\SCFPlugins\O365\o365_settings.conf

For OneDrive, refer to the section named: onedrive

Change the following parameters to improve the backup speed:

 # Maximum number of requests in a download batch  
#backup_max_requests_per_batch = 6 

Set the value of backup_max_requests_per_batch to a higher value. The value ensures that more requests are sent to OneDrive during backup.

# Wait time between download batches. 
#backup_waitime_between_batches = 5 

Reduce the value of backup_waitime_between_batches to ensure lesser wait time between different batch requests.

Changing these values may increase throttling from Microsoft. While setting these parameters, consider the parallel streams configured in the backup job.

Throttling may also depend on other factors such as:

It is recommended to check the throttling behavior for a few runs before changing these parameters.

If high amount of throttling is observed during consecutive backup job runs, tune the following parameters:

# Wait time between download batches. 
#backup_waitime_between_batches = 5

Value of backup_waitime_between_batches can be higher so that there is more time between requests and throttling is reduced.

# Default number of attempts to retry a failed request. 
#backup_max_retry_attempts = 5 

If multiple requests are failing after retries and this is seen in multiple job runs, then the retry attempts can be higher.

# Maximum number of requests in a download batch  
#backup_max_requests_per_batch = 6 

Value of backup_max_requests_per_batch can be set to a lower value so that maximum requests per batch are reduced and there is less throttling.

When the OneDrive plugin restores an item, the plugin also restores properties and permissions of that item. It requires multiple API calls for a single item, which my result in throttling if there are many items or multiple OneDrives restores running in parallel.

If throttling errors or errors during properties restore are observed, try to restore each OneDrives in separate jobs instead of a single job.

Other options to reduce throttling in restore are to disable properties and permissions restore.