Prerequisites and installation instructions

On this page you find information about the prerequisites for Migration Manager agents and instructions on how to install them.

Prerequisites for Migration Manager agents

The computers where you install the migration agents need to comply to the following requirements, else there is a big risk that the migration jobs will go very slowly or even stop, due to lack of memory/space.

Recommended requirements for best performance:

  • CPU: 64-bit quad core processor or better
  • .NET version: V4.6.2 or higher
  • RAM: 16 GB
  • Local Storage: Solid state disk: 150 GB free space
  • Network card: 1 Gbps
  • Operating system: Windows Server 2012 R2 or higher or Windows 10 agent

Minimum requirements (expect slow performance):

  • CPU: 64-bit 1.4 GHz 2-core processor or better
  • .NET version: V4.6.2 or higher
  • RAM: 8 GB
  • Local Storage: Hard disk: 150 GB free space
  • Network card: High-speed Internet connection
  • Operating system: Windows Server 2008 R2 or higher or Windows 10 agent

Anti-virus software on the computer where you run the agent can slow down the migration speed. Consider turning off the antivirus software during the migration.

How to install the agents

The agents are easily installed by following these steps:

  1. Open SharePoint admin center, click on Migration and under the Migration Manager option, click on the “Get started” button:
    Open Migration Manager
  2. Click on the “Donwload agent” button:
    Donload the agent
  3. Run the downloaded file (clientsetup.exe). Clicking on the “Next” button will prompt you to sign in with a SharePoint admin account:
    Migration agent - step 1
  4. You now need to sign in with a Windows account that at least has read access to the information that you want to migrate:
    Migration agent - step 2
  5. In the last step you can optionally test that your Windows account has read permissions to the file share that you want to migrate. Fill in the UNC-path and click on the “Test” button and hopefully you will get a message saying “You have access to this file share”. You can now click on the “Close” button, your agent installation is done:
    Migration agent - step 3
  6. If needed, you can now install agents on other computers, to improve the performance when running multiple migration jobs.

Links to external references