Chat now with support
Chat with Support

Welcome, erwin customers to Quest Support Portal click here for for frequently asked questions regarding servicing your supported assets.

Metalogix Essentials for Office 365 2.4 - User Guide

Metalogix Essentials for Office 365 User Guide
Administrator Architect Backup
Interface Overview Common Functions
Connecting to SharePoint and OneDrive for Business Connecting to Cloud Storage Global and SharePoint Administrators Hyper Backup Creating a Full Backup Creating an Update Backup Creating an Exchange Online Mailbox Backup Creating an Office 365 Group Backup Creating a OneDrive for Business Backup Backup Resume Backup Search Restore from Backup Scheduling Backup Jobs Retention Policies Import/Export Backup Archives Moving the Backup Location Backup Project Conversion
Interface Overview Common Functions
Connecting to Drives Copy Google Drive Copy File Share Copy My Sites to OneDrive for Business Copy Tenant Copy Box Copy Dropbox OneDrive Management Progress Tab Hyper Migration Path Length Overflow
File Manager Informant Migrator
Interface Common Functions
Connect to SharePoint and OneDrive for Business Global and SharePoint Administrators Copy Sites Live Compare Copy Lists and Libraries Copy, Move, and Tag SharePoint Content Copy Alerts Pre-Migration Report Azure Turbo Mode In-Place Tagging of SharePoint Items Incremental Copy Nintex Workflow Migration Orphaned Users Copy Preserving Content Authorship and Approve/Reject Statuses Save Site to XML Using Scripts and Integration With Windows Task Scheduler
Profile and Global Variables Public Folders for SharePoint Reporting and Re-Mapping Users and Templates Security Manager Term Store Manager Scripts Wizards Appendix

Proxy Configuration

Sometimes a connection to an Office 365 location can be initiated only with the help of proxy settings. 


To enable proxy mode for Hyper Migration please do the following:


1.Navigate to the Help tab, and select Proxy Mode.

2.On Connect to SharePoint pop up screen, enable the Use Proxy fucntion by selecting the check box and click the Proxy Configuration button.
proxy configuration

3.In the Proxy configuration screen, enter all of your proxy configuration settings, or import the settings from Internet Explorer by clicking the Import Settings button. Click Save.

4.Finish setting up your connection and click Start Migration.

Note: The Proxy option is disabled after the restart of the tool.


To use it permanently or with scripts, please do the following:

1.Navigate to the location in Explorer where Essentials is installed (this location is C:\Program Files\Quest\Essentials by default).
proxy configuration 3

2.Open Essentials.ini file using NotePad.

3.Add the following parameter at the end of the document:
-Dproxy mode=y
proxy configuration 2

4.Save the file.

5.Run Metalogix Essentials as usual, creating a new hyper migration or hyper backup job using proxy settings for the connection.

Auto Resume

Auto Resume allows users to set automatic resume sessions in order to bypass issues caused by Office 365 throttling. This functionality works by analyzing a hyper backup or hyper migration at the medium stage, looking for errors that occurred during migration. Once a "is not responding" error is found, the next auto resume round is started, and only objects with the "is not responding" status are re-migrated.

The number of Auto Resume attempts can be specified in in the Profile Manager.

1.In the Essentials, select the Help tab, and then Profile Manager.
auto resume 3

2.In Profile Manager, select Hyper Migration/Backup from the left hand tab.
Auto Resume 1

3.On the right hand half of the Profile Manager window, find the "Number of Rounds" setting. This setting is set to 1 by default, which means that only one migration round will be launched and the auto-resume function is not enabled. Changing this number, to 5 for example, will cause the tool to run the first migration round, and then it will run auto resume attempts until the connection problem is solved, or up to 4 more times (for a total of 5 rounds). (This means if the connection problem is resolved by the second attempt, then auto resume will stop and have no need to run 2 more times)
Auto Resume 4


NOTE: Auto Resume will only retry for throttling issues and will skip issues connected with permissions, authentication, lost internet connections, and non-supported objects, etc.


NOTE: You can use Admin Pool in combination with Auto-Resume or use only one of the functions to solve the problem with connections to Office 365.

Admin Pool

The Admin Pool functionality uses a set of global administrators for hyper migration and hyper backup operations in order to provide a solution for Office 365 throttling issues.

This functionality allows you to provide a list of admins from within wizards, instructing Essentials to use these global admin accounts when running the hyper migration or hyper backup. The more admin accounts you provide, the more users used to send requests to Office 365, thereby reducing the pressure on the target service.

In order to add more administrators you must use the +Admin button from within the Hyper Migration or Hyper Backup wizards. This button appears in place of the Connect button, after the first global administrator has been approved. You will see a list of users from within the wizard once the admin user has been authenticated.Admins pool 1


NOTE: Admin pool is not supported for connection by Claims.


You can track the admin pool in detail from within the migration logs. First, you will see the list of provided global administrators. Next, in each request, you can see the ID for each administrator used in the current request.Admins pool 2


NOTE: Site Collection Administrators are required to perform a hyper migration to SharePoint site (Box to SharePoint or File Share to SharePoint options) or a hyper backup of SharePoint only site.

The admin pool feature can be used in migration via the user interface, or via script. You can generate a script or create a scheduled task


essentials -cmd fileSharesToOneDrive -trgtsite https:// -trgtuser -trgtepass WW4P5qweqMFmMSHasdasdvRnQP0C6EmQ  == -trgtuser_1 -trgtepass_1 WW4P5MFmMSHasdasdvRnQP0C6EmQ== -usermapping 'D:\fileshare-onedrive.csv' -overwritebehavior dont_copy - log 'output.xml' -noSplash


Clean Tab

The Clean Tab button is available in on the Hyper Migration tab, and is used to remove finished jobs and their configurations (Successful, Paused, Failed) from the hyper migration folder in .metadata. The jobs that have not yet been started, and those that are in progress will be left in the hyper migration tab.
clean tab 1

You must hit refresh once the removal has completed.
clean tab 2

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating