Table of Contents

2. Preparation

2.1 Hardware Requirement

To achieve the optimal performance when CloudBacko Pro is running on your machine, refer to the following article for the list of hardware requirements.
CloudBacko Pro's Hardware Requirement List

2.2 Software Requirement

Make sure the operating system where you have the Office 365 installed is compatible with the CloudBacko Pro. Refer to the following article for the list of compatible operating systems and application versions.
CloudBacko Pro's Software Compatibility List

2.3 CloudBacko Pro Installation

For agent-based backup and restore, make sure that the latest version of CloudBacko Pro is installed on your computer with Internet access for connection to your Office 365 account.

User should also stay up-to-date when newer version of CloudBacko Pro is released. To get our latest product and company news through email, please Follow us on Facebook.

2.4 Antivirus Exclusion Requirement

To optimize performance of CloudBacko Pro on Windows, you need to avoid conflict with your antivirus software. Refer to Exclusion of CloudBacko in your Antivirus software for details.

2.5 Upgrade VMware Tools Requirement

To avoid unexpected java crash, if the Windows machine is a guest VM hosted on a VMware Host then it is highly recommended that the VMware tools version installed on the guest VM must be 10.0.5 or above.

Below is the warning message that will be displayed if the version of the VMware Tools is less than 10.0.5.

2.6 CloudBacko Pro License Requirements

CloudBacko Pro licenses are calculated on a per device basis:

i. To backup users with one (1) backup client computer

Example: If one CloudBacko Pro is installed then, one CloudBacko Pro license is required.

ii. To backup users with multiple backup client computers, the number of CloudBacko Pro licenses required is equal to the number of devices.

Example: If there are ten (10) users to be backed-up with three (3) backup client computers, then 3 CloudBacko Pro licenses are required

2.7 Add-on Module Requirement

Make sure that enough Office 365 Backup modules have been purchased in your CloudBacko Pro license to cover the backup of your users.

The licenses for the Office 365 module are calculated by the number of unique Office 365 accounts.

If you are trying to backup SharePoint Sites under the Site Collections and/or files or folders under Public Folder, only one Office 365 license module is required.

However, if you are trying to backup Items from Outlook, Items from OneDrive, Personal Sites under Users, the Office 365 license count will be calculated based on the number of the user account selected.

2.8 Public Folder Backup

A licensed Exchange Administrator or a licensed user with Public Folder permission is required otherwise you will not be able to access the public folder to select items and for backup or restore.

2.9 SharePoint Site Backup

To be able to backup Personal Sites and/or SharePoint Sites, ensure that you use Hybrid Authentication when creating a backup set. Due to the current limitation with Microsoft API, Modern Authentication is currently not suitable for backup sets with Personal Sites and/or SharePoint Sites selected. As backup and restore of SharePoint metadata are not fully supported.

2.10 Java Heap Size

The default Java setting heap 2048M, is sufficient for Office 365 backups based on the default 4 concurrent backup threads.

The Java heap size should only be increased if the number of current backup threads is increased as more backup threads is expected to consume more memory. But this does not guarantee that the overall backup speed will be faster since there will be an increased chance of throttling.

As the value of 4 concurrent backup threads is found to be the optimal setting for Office 365 backups, to ensure best backup performance, minimal resource usage, and lowest probability of throttling of Ahsay backup requests by Microsoft Office 365.

For more detailed information on how to change the Java heap size, please refer to here.

2.11 Office 365 License Requirements

Office 365 Subscription Plan

The following subscription plans with Office 365 email services are supported to run backup and restore on CloudBacko Pro.

Office 365 Business Office 365 Business Essentials
Office 365 Business Premium Office 365 Enterprise E1
Office 365 Enterprise E3 Office 365 Enterprise E4
Office 365 Enterprise E5 Office 365 Education

Office 365 Subscription Status

Make sure your Office 365 subscription with Microsoft is active in order to enjoy all privileges that come along with our backup services. If your account has expired, renew it with Microsoft as soon as possible so that you can continue enjoy the Office 365 backup services provided by CloudBacko.

When your account is expired, depending on your role, certain access restrictions will be applied to your account. Refer to this URL for more details: Microsoft Office 365 Subscription Status

Restore Requirement

When restoring data of Office 365 user, the account which the data will be restored to requires valid license(s):

  • Requires Exchange License
    Example: Exchange Online Plan and Office 365 E3 are required when restoring Outlook's / Public Folder's items.
  • Requires SharePoint License
    Example: SharePoint Online Plan and Office 365 E3 are required when restoring OneDrive's / Personal Site's items.

2.12 Office 365 Permission Requirements

The basic permissions required by an Office user account for authentication of an Office 365 backup set is as follows:

Global Admin Role

The Office 365 account used for authentication must have Global Admin Role, since Modern Authentication will be used. This is to ensure that the authorization configuration requirements will be fulfilled (e.g. connect to Microsoft Azure AD to obtain the App Access Token).

Term Store Administrator Role

The Term Store Administrator Role may be required for backup and restore of SharePoint items.

A member of Discovery Management security group

The Discovery Management security group must be assigned the following roles:

  • ApplicationImpersonation
  • Legal Hold
  • Mailbox Import Export
  • Mailbox Search
  • Public Folders

2.12.1 Assigning Global Admin Role to Accounts

To assign the Global Admin role to accounts, follow the steps below:

i. Click the App launcher in the upper left side then click Admin to go to the Microsoft 365 admin center.

ii. In the Microsoft 365 admin center, on the left panel click Users. Find the user you want to assign the Global Admin role and select Manage roles.

iii. In the Manage roles window, select Admin center access then check the box beside Global admin. Click Save Changes to save the role you assigned.

2.12.2 Granting Term Store Administrator Role

To add Term Store Administrator role to the Office 365 user account used to authenticate the Office 365 backup set.

i. In the SharePoint admin center, under Content services, click Term store.

ii. In the tree view pane on the left, select the Taxonomy.

iii. In the Term store page, for Admins, select Edit. The Edit term store admins panel appears.

iv. Enter the names or email addresses of the Office 365 user who you want to add as term store admins. Select Save.

2.12.3 Granting Permission Discovery Management Group

This permission allows users added under the Members section of the Discovery Management group (refer to 2.12.4 for setup) to back up and/or restore user item(s) not only for their own account, but also the accounts of other users in the same Members section.

i. Open https://outlook.office365.com/ecp

ii. Log in to the Office 365 as an account administrator.

iii. Select the permissions menu on the left, then double click on Discovery Management on the right.

iv. Click the + icon under the Roles section. These are the following roles:

v. Click Save to confirm and exit the setting.

2.12.4 Granting Permission to Accounts for Creating Backup Set

i. Open https://outlook.office365.com/ecp

ii. Log in to the Office 365 as an account administrator.

iii. Select the permissions menu on the left, then double click on Discovery Management on the right.

iv. You can now add users to this group. Click the + icon under the Members section.

v. Look for the username(s) of the account that you would like to add permission for, then click add > OK to add the corresponding user(s) to the permission group.

vi. Click Save to confirm and exit the setting.

To successfully restore all share link types to alternate location of the same organization in Office 365, follow the settings below:

2.12.5.1 Allowing anonymous users to access application pages

i. Go to the alternate Site > in the left pane, select Site Contents > Site Settings

ii. Go to Site Collection features

iii. Deactivate “Limited-Access user permission lockdown mode” feature

2.12.5.2 Allowing sharing to external users

i. Go to your Microsoft 365 Admin Center > All admin centers > in the right pane select SharePoint

ii. Go to Sharing

If using Classic sites view, go to Policies > Sharing.

iii. Under Sharing outside your organization, select “Allow sharing only with the external users that already exist in your organization’s directory” and click OK.

If using Classic sites view, under External sharing the button must be in line with “Existing guests” and click Save.

2.13 Data Synchronization Check (DSC) Setup

To compensate for the significant backup performance increase, there is a tradeoff made by the Change Key API, which skips the checking of de-selected files in the backup source, which over time can result in a discrepancy between the items or files/folders selected in the backup sources and the those in the backup destination(s). However, the Change Key API will continue to check for de-selected Office 365 user accounts or Site Collections. Un-selected individual Office 365 user accounts or Site Collections detected during a backup job and will be automatically moved to retention area.

To overcome this, it is necessary in some cases to run a Data Synchronization Check (DSC) periodically. The DSC is similar to a regular Office 365 Change Key API backup job but with the additional checking and handling of de-selected files and/or folders in the backup source. So that it will synchronize the data in the backup source and backup destination(s) to avoid data build-up and the freeing up of storage quota.

Here are the pros and cons of performing the data synchronization check.

Enabled Disabled
Backup time Since data synchronization check is enabled, it will only run on the set interval. For example, the default number of interval is 60 days.
The backup time for the data synchronization job will take longer than the usual backup as it is checking the de-selected files and/or folders in the backup source and data in backup destination(s).
As data synchronization check is disabled, the backup time will be not be affected.
Storage Management of storage quota will be more efficient as it will detect items that are de-selected and moved it to retention and will be removed after it exceeds the retention policy freeing up the storage quota. Management of storage quota will be less efficient even though files and/or folders are already de-selected from the backup source, these files will remain in the data area of backup destination(s).

2.13.1 Setting the Data Synchronization Check (DSC)

Data Synchronization Check (DSC) is enabled by default and will run every 60 days.

Assumption: AhsayOBM Installation path is C:\Program Files\AhsayOBM

To disable the data synchronization check, follow the instructions below:

1. Make sure there are no active backup or restore job running.

2. Close AhsayOBM UI.

3. Stop the Ahsay Online Backup Manager services

4. Go to C:\Program Files\AhsayOBM\ folder.

5. Open cb.opt file using a text editor such as Notepad or Notepad++.

6. Add this line, Office365.DSCInterval=-1 A value of -1 indicates data synchronization check is disabled.

7. Start the Ahsay Online Backup Manager services

To check if the data synchronization check is enabled, follow the instructions below:

1. Go to C:\Program Files\AhsayOBM\ folder.

2. Open cb.opt file using a text editor such as Notepad or Notepad++.

3. Look for this line, Office365.DSCInterval=xx.

Note: If xx is a positive value this indicates the data synchronization check is enabled and represents the interval number of days until the next run of data synchronization check. -OR- If the interval value is not -1.

To adjust the interval number of days, follow the instructions below:

1. Make sure there are no active backup/restore job running.

2. Close AhsayOBM UI.

3. Stop the Ahsay Online Backup Manager services

4. Go to C:\Program Files\AhsayOBM\ folder.

5. Open cb.opt file using a text editor such as Notepad or Notepad++.

6. Change the interval number.

For example: Current interval: Office365.DSCInterval=60 Updated interval: Office365.DSCInterval=10

Explanation: On the current interval, the number of days is 60. While, the updated interval, the number of days is reduced to 10.

WARNING! If the interval value is 0, Office365.DSCInterval=0, then the Data Synchronization Check (DSC) will run for every backup job.

7. Start the Ahsay Online Backup Manager services

2.14 Authentication

To comply with Microsoft’s product roadmap for Office 365, in the latest CloudBacko Pro, Basic Authentication (Authentication using Office 365 login credentials) will no longer be utilized. Instead all new Office 365 backup sets created will use either Modern Authentication or Hybrid Authentication.

By second half of 2021, it will be a mandatory requirement for organizations still using Basic Authentication or Hybrid Authentication to migrate to Modern Authentication.

Modern Authentication provides a more secure user authentication by using app token for authentication aside from using the Office 365 login credentials. In order to use Modern Authentication, the Office 365 account is registered under Global region and the Office 365 backup is configured to use Global region. As both Germany and China region do not support Modern Authentication.

Existing backup sets using Basic Authentication created prior to AhsayOBM v8.3.6.0 can be migrated to Hybrid Authentication or Modern Authentication. However, once the authentication process is completed, the authentication can never be reverted back to Basic Authentication. For more information on how to migrate to Hybrid Authentication or Modern Authentication please refer to Appendix J: Migrating Authentication of Office 365 Backup Set. After the upgrade to AhsayOBM v8.3.6.0 or above, the backup and restore process of existing Office 365 backup sets still using Basic Authentication will not be affected during this transition period since Modern Authentication is not yet enforced by Microsoft.

In order to migrate existing backup sets to Hybrid Authentication or Modern Authentication there are two (2) methods:

Please note that Modern Authentication with enabled security in Azure Active Directory (AD) will be made default if there is zero-usage on any Office 365 organization by October 2020.

To check the current authentication being used in your Office 365 backup set, see criteria below:

Basic Authentication

If you click on the backup set and the following pop up message is displayed, then the backup set is using Basic Authentication.

Modern Authentication

Go to Backup Sets > backup set name > General > Change settings.

Hybrid Authentication

1. There is no pop up authentication alert.

2. In the Office 365 credentials page, the region is Global and there is a Username and Account password then the backup set is using Hybrid Authentication.

2.15 Supported Services

Below are the supported services of Office 365 Backup module. It is also specified in the table some services that are currently not yet supported by the Office 365 Backup module.

Below are the supported Outlook Mailbox types of Office 365 Backup.

Below are the items that you can back up or restore from OneDrive.

Below are the Site Collections/Personal Site items that you can back up or restore from an Office 365 backup set.

Below are the SharePoint Site Collections template that you can back up or restore from an Office 365 backup set.

Below is the Site Column Type that you can back up or restore from an Office 365 backup set.

Below are the items from the Public Folder that you can backup and restore from an Office 365 backup set.

2.16 Maximum Supported File Size

The following table shows the maximum supported file size per item for backup and restore of each service.

2.17 Limitations

CloudBacko's Limitations

Modern Authentication

  • Some list settings, currently known as Survey Options on survey list.
  • Feature setting for SharePoint Site and Personal Site.

SharePoint

  • Backup User (except for Global Admin) may not have permission to back up the site collection even if he/she can view it in the backup source tree. FOR EACH site collection, the user can backup it only if he/she is assigned as a site admin of that site collection.
  • If the user is assigned as site admin of the root level site collection only, he/she is not automatically added as site admin of other site collection under that root level site collection (i.e. If user is to backup specific site collection under the root, he/she has to be added as site admin of that specific site collection under the root also).
  • For site collection that can be viewed by user in the source tree which he/she is not yet assigned as a site administrator:
  • when user expand the node of that site collection, access denied error pop up will be given.
  • when user tick such site collection to backup, access denied error will be given in the backup log.

OneDrive

Outlook

  • In the backup source tree of the same backup set:
  • the original ticked item still use the old mail id to reference and becomes red item.
  • there is another item (with the latest mail id) created for that mail item

User will need to deselect the red item and tick the mail item again in the backup source tree in order to do the next backup properly. As per development team, the issue will not be handled as user's selected source should not be modified by system

Restore to Alternate location

| |

Example: Item from Outlook of User-A and User-B will be restored to the Outlook of the alternate location User-C.

Restore to Alternate Office 365 account

If you are trying to restore item(s) from multiple Office 365 user account to an alternate Office 365 user account, AhsayOBM can only restore one Office 365 user account at a time.

Restore to Alternate Organization

Restore data to a destination user which has a different language

If you are trying to restore the item to a destination user which has a different language setting than the original user, AhsayOBM will restore item(s) to their respective destination folder based on the translation listed below.

For folders such as ‘Calendar’ or ‘Notes’, a new folder ‘Calendar’ or ‘Notes’ will be created.

For folders in OneDrive and SharePoint, a new folder will be created.

Restore existing documents in checked-out status

Restoring of existing documents in checked out status is supported only when the user who has checked out the file is the same user who is performing the restore.

Backup source (English) Action Destination User with Chinese as default language settings
Inbox Merge 收件箱
Outbox Merge 寄件匣
Sent Items Merge 寄件備份
Deleted Items Merge 刪除的郵件
Drafts Merge 草稿
Junk E-Mail Merge 垃圾電郵
Calendar Create new folder Calendar
Notes Create new folder Notes
OneDrive Folder Create new folder OneDrive Folder
SharePoint Folder Create new folder SharePoint Folder

Microsoft Limitations

Exchange Online

For more detailed information on the limitations of Exchange Online, please refer to this Microsoft article, Exchange Online Limits. These are some of the limitations that will be discussed in the Exchange Online Limits article:

OneDrive

For more detailed information on the limitations of OneDrive, please refer to this Microsoft article, OneDrive Limits. These are some of the limitations that will be discussed in the OneDrive Limits article:

SharePoint

For more detailed information on the limitations of SharePoint Online, please refer to this Microsoft article, SharePoint Online Limits. These are some of the limitations that will be discussed in the SharePoint Online article:

2.18 Best Practices and Recommendations

The following are some best practices or recommendations we strongly recommend you follow before you start any Office 365 backup and restore.

Temporary Directory Folder Location

Temporary directory folder is used by CloudBacko for storing backup set index files and any incremental or differential backup files generated during a backup job. To ensure optimal backup/restoration performance, it is recommended that the temporary directory folder is set to a local drive with sufficient free disk space.

Performance Recommendations

Consider the following best practices for optimized performance of the backup operations:

Backup Destination

To provide maximum data protection and flexible restore options for agent-based backup, it is recommended to configure:

Periodic Backup Schedule

The periodic backup schedule should be reviewed regularly to ensure that the interval is sufficient to handle the data volume on the machine. Over time, data usage pattern may change on a production server, i.e. the number of new files created, the number of files which are updated/deleted, and new users may be added etc. schedule.

Consider the following key points to efficiently handle backup sets with periodic backup schedule.

  • so that the data is always backed up within the periodic backup interval
  • so that the backup frequency does not affect the performance of the production server

Authentication

Although Microsoft has moved the enforcement date for Modern Authentication from end of 2020 to the second half of 2021, since this new authentication is already available starting with AhsayOBM v8.3.6.0 or above, it is recommended that backup sets are migrated to Modern Authentication. All newly created Office 365 backup sets on AhsayOBM v8.3.6.0 or above automatically use Modern Authentication.

However, due to the current limitation with Microsoft API, Modern Authentication is currently not suitable for backup sets with Personal Sites and/or SharePoint Sites selected. As a temporary workaround for Office 365 backup sets which require backup of Personal Sites and/or SharePoint Sites selected should be migrated to Hybrid Authentication until the issue has been resolved by Microsoft.

Large number of Office 365 users to Backup

In general, we recommend that each Office 365 backup set does not contain more than 2000 Office 365 users, to ensure a daily incremental backup job completes within 24 hours assuming that only small incremental daily changes will be made on the backup set.

However, the actual number of Office 365 users in a backup set may vary depending on the total number of Outlook, OneDrive, and SharePoint items, as well as the total size of these items. The actual number of Office 365 users in a backup set could be considerably less or could be more than 2000.

For details on the actual item count and size of Office 365 user, it is recommended to check in the Microsoft 365 Admin Centre, please refer to Appendix I: Steps on How to view Item count and Storage used in Microsoft 365 Admin Center.

Also, by splitting up all the users into separate backup sets, the more backup sets, the faster the backup process can achieve.

It is also a requirement that for every split backup sets should have its own unique user account for authentication to minimize the probability of throttling from Microsoft.

Example: If there are 10 split backup sets, then there should be 10 unique user accounts for authentication.

For more detailed example, refer to Appendix B: Example for backup of large numbers of Office 365 users.

Concurrent Backup Thread

The value of 4 concurrent backup threads is found to be the optimal setting for Office 365 backups, to ensure best backup performance, minimal resource usage, and lowest probability of throttling of Ahsay backup requests by Microsoft Office 365.

Backup Source

For Office 365 backup sets there are two approaches for backup source selection. Below are the sample screenshots of the selection All Office 365 users and Selective 365 user.

All Office 365 users Selective Office 365 user

These are the Pros and Cons when selecting a backup source from all Office 365 users and selective Office 365 user.

All Office 365 users Selective Office 365 user
Backup Set Maintenance The Admin does not need to manage the backup set, i.e. to select or unselect use when an Office 365 user account was added or removed, the changes are automatically updated in the backup source. The Admin will have to select or unselect users manually when an Office 365 user account was added or removed, as the changes are not automatically updated in the backup source this can be very time consuming.
If an Office 365 user account is removed from the domain and the admin forgets to unselect the Office 365 user account from the backup source, then this will cause a warning that the user does not exist.
Office 365 License The backup user account must have additional Office 365 license modules assigned to cover any increases Office 365 users. Otherwise, if additional users are added without sufficient modules, then this will cause backup quota exceeded warning and additional users will not be backed up. This will allow the admin to easily control or manage the number of license modules used for the backup set.
Backup Time All Office 365 user accounts will be backed up. This means the initial of full backup job will take longer, any subsequent incremental backup will take longer. Only selective Office 365 user accounts will be backed up. This will mean the initial of full backup job will be faster, any subsequent incremental backup will be faster.
Storage As all Office 365 user accounts are backed up, more storage will be required. As only selective Office 365 user accounts will be backed up, the backup set will require relatively less storage.