Chat now with support
Chat with Support

Metalogix Essentials for Office 365 2.8 - Advanced Installation Guide

Essentials Permission Setup

In order to run the Essentials application, you can use a regular user logged into the workstation, or you can run the program as an Administrator.
However, you must run the tool as an Administrator when changing settings in the memory management section of the Profile Manager (located on the Advanced tab of the Profile Manager), or when using the automatic updates feature.


NOTE: When running the tool as an Administrator, you may not be able to see your network drives or mapped drives in the connections section. This may occur because the connections were set up while in regular user mode, so when the tool is launched as an admin, the admin user does not have access to the connections.

To resolve the issue in the above note, do one of the following:

1.Do not start the tool as an administrator, and insure that no settings are applied by default.

a.Navigate to the Properties for the Essentials.exe
permissions requirements 7

b.Ensure that under the Compatability tab, "Run this program as administrator" isn't selected.
permission requirements 8

2.Run the Registry Editor (regedit.exe), and locate the following key:



Create a new DWORD(32) with the name EnableLinkedConnections and value 1 and reboot.
permissions requirements 2


In the event that the tool only successfully launches when run as an admin, this could be occurring because the non-admin user that is launching the tool does not have permissions for the installation folder, to the run tool components, or to the workspace.

This may be caused as a result of various windows security settings and configurations. To resolve this issue, add the non-admin user, directly to the folder security settings.

1.Navigate to the folder that contains the Essentials Tool installation folder. Right click and select Properties.
permissions requirements 9

2.Navigate to the Security Tab, and select Edit group and usernames.
permissions requirements 10

3.Select Add and add the non-admin user.
permissions requirements 11

SharePoint Permissions Setup

To work with SharePoint locations, you must set up a valid level of permissions. When you work with individual Sites or Site Collections in the Navigator pane of Essentials, the lowest level of user to connect to a site is a Site contributor. However, this level allows a minimal list of actions (view structure, views, content etc.). With this permissions level, for example, we reconnect to use users who have direct site collection administrator permissions.
permissions requirements 5

When you work in Hyper Migration Mode and do bulk migrations using SharePoint Administrator or Global administrator. An account with less privileges will only be able to perform a limited set of migrations.

The Essentials tool requests certain user roles to start and successfully finish hyper migration or hyper backup jobs. These administrative accounts are required to connect to the tenant level, to each site collection, users OneDrive’s, Office 365 groups, Microsoft Teams sites, etc. In order to connect to all of this you must be either a Global Administrator or a SharePoint Administrator. If you use an Exchange Administrator or Billing Administrator, or any other user role, the Migration will fail. This is because Essentials will not be able to access the target site collection in order to upload content and/or the azure job would be restricted by Office 365.  
permissions requirements 6

Firewall Permission Setup

URLs that need to be Unblocked



Connection to Quest/Metalogix license server

Migrating to SharePoint Online

Migrating Nintex Forms and/or workflows to

SharePoint Online


Location for AutoUpdate

OAuth Permissions

The first time that OAuth Authentication is selected when connecting to SharePoint Online, the Metalogix Content Matrix SharePoint Client application must be registered for the tenant.

Instructions are available in the Using Office 365 OAuth Authentication section of the user guide.


It is recommended that an account with the Global Administrator role be used to register the application, because a Global Administrator can provide consent on behalf of the entire

organization. In the event that a Global Administrator does not register the application, users with the Application Administrator role can register the application for their own account only.


IMPORTANT: For an Application Administrator, the Metalogix Content Matrix SharePoint Client application records current SharePoint permissions as part of the registration process. Therefore,

a user who registers as an Application Administrator must already have the appropriate permissions to connect and perform migrations using OAuth authentication. For example, at the time of registration, a user who is going to make tenant-level connections must also be a SharePoint Administrator if they want the app to allow them to access to all site collections within the tenant and to be able to Paste as a Site Collection. Similarly, a user who will be migrating Managed Metadata must also be a Term Store Administrator at the time of registration.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating