This is an old revision of the document!
AhsayOBM allows you to backup all users' data in an Office 365 domain with the Office 365 Backup Module. This module provides a set of tools to backup and restore individual emails, contacts, calendars and other mail items in Office 365 Outlook, files on OneDrive and SharePoint, with snapshots / versioning, and retention policy.
Below are the system architecture diagrams illustrating the major elements involved in the backup process among the Office 365 service, AhsayOBM and AhsayCBS.
No need to install AhsayOBM. The AhsayCBS backup server connects to the Office 365 directly through the Internet.
The latest version of AhsayOBM is installed on the remote backup machine which is connected to Office 365 and AhsayCBS backup server through internet.
To achieve the optimal performance when AhsayOBM is running on your machine, refer to this article for the list of hardware requirements: Ahsay Hardware Requirement List (HRL)
Make sure the operating system where you have the Office 365 installed is compatible with the AhsayOBM. Refer to this article for the list of compatible operating systems and application versions: Ahsay Software Compatibility List (SCL)
To optimize performance of AhsayOBM on Windows, and to avoid conflict with your antivirus software, refer to the following Wiki article the list of processes and directory paths that should be added to all antivirus software white-list / exclusion list: Suggestion on antivirus exclusions to improve performance of Ahsay software on Windows
NOTE The bJW.exe process is automatically added to Windows Defender exclusion list for Windows 10 and 2016, and 2019 during installation / upgrade via installer or upgrade via AUA.
For agent-based backup and restore, make sure that the latest version of AhsayOBM 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 AhsayOBM is released.
Make sure that the Office 365 Backup feature has been enabled as an add-on module in your AhsayOBM user account and there is enough Office 365 Backup license quota to cover the backup of your users.
Below is a sample screen shot of an AhsayOBM User with an add-on module of Office 365 with 20 licenses.
The licenses for the Office 365 module are calculated by the number of unique Office 365 accounts. If same Office 365 account is backed up on multiple backup sets with an OBM user account would be counted a one Office 365 license.
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.
It is now possible to perform agentless backup and restore, which can be done via the AhsayCBS User Web Console without using the AhsayOBM client agent. In order to access the User Web Console, make sure you have Internet connection and a web browser installed on your computer or mobile device.
AhsayOBM licenses are calculated on a per device basis:
Make sure that your AhsayOBM user account has sufficient quota assigned to accommodate the storage of the Office 365 users for the new backup set and retention policy. Please contact your backup service provider for more details.
The Continuous backup add-on module is required if would like to enable the continuous backup feature.
The default Java heap size setting for AhsayOBM is 2048 MB / 2.048 GB. To avoid any inconveniences and ensure smooth operation when performing Office 365 backup, it is highly recommended to allot extra memory.
Below is the table for the memory requirement:
Per OneDrive Account | 100 MB |
Per SharePoint Site Collection | 150 MB |
NOTE The memory requirement is dependent on the number of OneDrive or SharePoint Site Collections selected for backup. The Java heap size to be configured should not exceed 2/3 of the RAM available, to allow sufficient resources for the operating system.
The following subscription plans with Office 365 email services are supported to run backup and restore on AhsayOBM or AhsayCBS User Web Console.
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 |
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 Ahsay. When your account is expired, depending on your role, certain access restrictions will be applied to your account. Refer to the URL below for more details. Microsoft Office 365 Subscription Status
Before the Office 365 account administrator or other accounts can create a backup set, the administrator has to grant permission to the account(s) which are going to create backup set. The account must be a member of the following security groups:
Follow the steps below to grant permission to user account.
This permission allows users added under the Members section of the Discovery Management group (refer to the previous section 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. To grant permission for this feature, you have to add the Application Impersonation & Mail Search role by following the steps below.
The Global Admin permission allow SharePoint account to list other account’s Personal Site and OneDrive in the backup source tree. So before using AhsayOBM to create backup set, please ensure the SharePoint account has already owned the permission in order to apply AhsayOBM to back up and/or restore user item(s) not only for their own account, but also the accounts of other users.