Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online image 5

Migrating file shares with SharePoint Migration manager

A while back I wrote about the SharePoint Migration Tool. Today I will share my experiences of the SharePoint Migration Manager.

Why SharePoint Migration Manager?

SharePoint Migration Manager is almost the same as the SharePoint Migration Tool.

When you look at the task settings for example, you wouldn’t really notice any difference.

Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online image 4

Architecturally however there is a large difference. The SharePoint migration manager uses agents to do exactly the same as the migration tool.

You can have multiple agents sharing the load of the migration.

Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online image 5

And as agents are progressing the tasks you can see fro each task how much progress has been made.

Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online scan progress

You can even run multiple migration tasks at the same time, but once you start using the SharePoint migration manager in real environments you will find that things don’t always turn green as shown below. In this post I’m hoping to help a bit with the more challenging situations.

Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online Scans progressing

Failing migrations

Quite often you will find that some migrations work and some migration don’t work. It might sometimes feel like just random behaviour.

But there are a lot of factors that can be important.

  • Resources available to the agents ( disk space, CPU power, memory, network speed)
  • Stability of the infrastructure
  • Users
Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online image 6

Time to have a look at some of the failures that may occur. When you click on the Download failure report a zip file is downloaded with a variety of csv files in it.

Migrating file shares with SharePoint Migration manager Microsoft SharePoint Online image 8

When things go seriously wrong there will be a FatalError_R1.csv file. this file will contain a reason for the migration manager to completely stop a migration task.

Some examples of errors that I found during some of the migration are:

Both these error messages are quite annoying and not completely clear.

The itemFailureReport_R1.csv is another one of those files to have a look at. you might get errors like this:

  • Scan File Failure:Path contains invalid characters. Valid path doesn’t start or end with space. Other invalid characters are <, ?, >, *, |, “, :, \, /
  • Scan File Failure:Unauthorized access to source folder
  • Failed to Read the file:Could not retrieve file’s metadata
  • Packaging Failure:Unauthorized access to source file

For these file related issues you will need to adjust file names and make sure that your migration account has access to the files.

On the fatal errors however we have to use a different trick.

Temporary storage on your local computer is too low

The Temporary storage on your local computer is too low error is very uinclear. My system has plenty of space and it doesn’t look like this is a problem, until I found the following article with a great solution:

https://social.technet.microsoft.com/Forums/en-US/f060d710-d8a5-44b6-84c7-afce4b5e157e/temporary-storage-on-your-local-computer-is-too-low-errorcode-0x02040012?forum=SharePointMigrationTool

The problem is the space in %appData%\Microsoft. this is most likely on your C-Drive and the idea is to use a different storeage space somewhere.

So you would need to delete the MigrationToolStorage folder in %Appdata%/Microsoft and then run the following two commands to create a link to a different storage with more space.

cd %appdata%\Microsoft
mklink /J MigrationToolStorage Z:\SomeOtherFolder

This solution isn’t just more stable it also makes the migration tool run a lot faster as my alternative storage is a lot faster than using the system drives.

Alternatively you can also go to the Agent settings and change the working folder to a different drive so that the migration manager uses that folder instead.

Ok, that is a great solution. Hopefully this will help someone else too.

4 thoughts on “Migrating file shares with SharePoint Migration manager

  1. How does migration manager (office 365)migrate modified files after completing the first task? Let’s say first time I ran migration task, it transferred all files to sharepoint library, how will it move modified or new files after that before the switchover?
    If I run task again, will this only transfer modified/new files or will re-transfer all files again?

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Enter your email address to subscribe to this blog and receive notifications of new posts by email.

Join 4,912 other subscribers

Recent Posts

Archive

Thank you for visiting SharePains