Home
Microsoft

Introducing the SharePoint Migration Tool from Microsoft

Taking advantage of cloud services doesn’t have to be difficult or a long-phased migration project.  At Microsoft Ignite we announced a new free, simple, and fast migration solution to help you migrate content from on-premises SharePoint sites and file shares to SharePoint or OneDrive in Office 365.

 

Splash.png

 

Based on the learning and experience from Microsoft FastTrack, using the SharePoint Migration Tool from Microsoft with a few simple clicks you can begin to bring your information to the cloud and take advantage of the latest collaboration, intelligence, and security solutions with Office 365.

 

Whether you’re looking to migrate from file shares on-premises to SharePoint or OneDrive or from on-premises versions of SharePoint, the SharePoint Migration Tool is designed to support the smallest of migrations to large scale migrations with support for bulk scenarios.

 

Using the SharePoint Migration Tool, you can quickly and easily migrate files from file shares, SharePoint sites, or support bulk migrations with a few simple clicks in the intuitive user interface.

 

Sources.png

 

The SharePoint Migration Tool also provides detailed information on the process of existing and completed migrations and task reports to help identify and resolve issues that may have occurred during the migration process.

 

Migration_Status.png

 

For additional details and to see the SharePoint Migration Tool in action, check out the video below.

 

 

While the SharePoint Migration Tool provides support for many migration scenarios, we recognize your needs may differ in scope and complexity.  For more complex migrations, support with adoption and usage, or help planning Microsoft FastTrack includes resources, tools, and experts to make your rollout of Office 365 a success.

 

To learn more about Microsoft FastTrack visit https://fasttrack.microsoft.com/office.  In addition, consider one of Microsoft’s many partners that can help ensure your migration to Office 365 is both seamless and successful.

 

Getting Started
To get started and preview the new SharePoint Migration Tool from Microsoft visit https://aka.ms/spmt.

 

Resources
How to use the SharePoint Migration Tool
How the SharePoint Migration Tool works
How to format your CSV file for data content migration
Create a user mapping file for data content migration
SharePoint Online and OneDrive Migration Speed SharePoint Online provided Azure containers and queues for SPO Migration API

 

 

183 Comments
Microsoft

@Bradley Weir  @Steven Yurgelevic  Thanks for your feedback. It is possible that you are seeing different versions in different network environment. We roll out new version at 30% percentage. That means you will get new version at 30% probability. But if you stay in a network environment, the version is fixed.

@Hongliang Zhu i got this link from the slides from the Ignite. It doesn't really matter because it's just a vanity url and at the end it takes me to the same location you provided above. 

Contributor

@Hongliang Zhu the link is in @Bill Baer original post, at the top of this thread

 

"

Getting Started
To get started and preview the new SharePoint Migration Tool from Microsoft visit https://aka.ms/spmt.

"

Contributor

Looks like the migration path for a on premise personal file share (aka home directory)  to OneDrive, is as follows:-

 

https://<TENANT-NAME>-my.sharepoint.com/personal/< UPN (substitute _ for .>

 

If the above is correct, do Admins need to have any additional permissions at the user OneDrive end for this to work?

 

Is it possible to exclude some folders from the migration as well?

 

 

Occasional Visitor

Is it open source ?

Regular Contributor

Is it expected for the tool to run the GPU at around 70-80%?  I've been running it for approx 6 hours today, and my Surface Pro 4 is pretty warm now! :-)

Frequent Contributor

Will  metadata associated with each file get retained during the migration ?

Occasional Visitor

@Ben Stott you need to enable incremental sync in settings before migration then only it will resume migration from where it stopped. 

 

New Contributor

I'm having trouble trying to select my SP 2013 on-prem system. Even as Site Collection admin, I can't pass the sign-in page. 

Our farm is using ADFS with a web form (federated with our Office 365 tenant). In the log files, I see the following:

[] Check on-prem credential fails for user xyz@domain.com, site https://ouronpremsiteURL
Microsoft.SharePoint.MigrationTool.MigrationLib.SharePoint.MigSPCredentialException: Credential Issue when doing SP Query --->
Microsoft.SharePoint.MigrationTool.MigrationLib.Common.Web.WebCredentialException --->  System.Net.WebException: The remote server returned an error: (403) Forbidden.

The next lines in the log are:

[] Check on-prem credential fails for user xyz@domain.com, site https://ouronpremsiteURL
Microsoft.SharePoint.MigrationTool.MigrationLib.SharePoint.MigSPServerException: Server Issue when doing SP Query ---> 
Microsoft.SharePoint.Client.ClientRequestException: Cannot contact site at the specified URL https://ouronpremsiteURL

Any ideas on how come the SPMT isn't working for me?

Thanks,

Dan

Microsoft

@Daniel TSHIN

On-PREM ADFS auth isn't supported now. That will be supported soon in earlier 2018. If you are with TAP contract with Microsoft, you can try the feature more soon.

New Contributor

Hi ,

I have tried the tools from files share to Share point sites and it works well.

However I cant see to upload from user personal files  to onedrive for business .

I use https://<TENANT-NAME>-my.sharepoint.com/personal/< UPN (substitute _ for .>

and I login as Share point admin ;when I run the tools I don't get access to the user library in onedrive . If I use CSV import I get Share point login fail.

 

Can some one help please ?

 

 

 

Occasional Contributor

Can you open the URL to the users OneDrive in the browser when logging in as the SharePoint admin?

 

If you get access denied, you may want to try this...

 

https://www.eugenedauphin.com/2015/01/get-administrative-access-onedrive-business-environment-user/

 

...to add yourself to the site collection admins. By default admins *don't* get access to users OneDrive data.

 

Once you have confirmed you can gain access through the browser, re-try the migration.

 

New Contributor

Hi Alex ,

 

thank you , that works fine . is it anywhere to easily add the admin to One Drive Data  for all the users ?

 

 

 

Piero

 

 

 

Occasional Contributor

I have never had cause to do this myself but this PowerShell solution looks to do what you want:

www.jijitechnologies.com/blogs/add-remove-secondary-site-collection-admin-to-all-onedrive-for-busine...

 

Disclaimer: I have not tried the above and I am in no way affiliated with the site!!

New Contributor

Thank You Alex for your help. 

Microsoft

@Piero Adamo

which version are you using? there is a CSV issue on the version of 0.2.68.0.

Could you please share your logs? Once the migration is done, there is a link "view reports" in the final page of the tool. Open that link and the logs should be in its parent folder

Senior Member

@Lei CAO

I had performance issue when running a migration so updated from 0.2.65 and 0.2.68 and have lost my pending migrations.

I've also tried to load a previous working bulk CSV and now get the error Line#2 Sharepoint Login failed.

 

Question, is it possible to resume the previous incremental migrations? If not' want's the best way for me to continue to migration.

 image.png

 

Michael

Microsoft

Hi, @Michael Milad-Said

 

sorry for that CVS bug. It should be fixed in 0.2.68.1 build. for this build, please run the migration task one by one as a workaround. Sorry for the inconvenience.

 

for your question "is it possible to resume the previous incremental migrations", the tool should support this. But I am not sure whether is there anything wrong in these builds. Let me confirm with my colleague and will get back to you soon.

 

 

Senior Member

Hi @Lei CAO,

 

Thanks for your prompt response.

Does 0.2.68 resolve any performance issue? I notice when I start a migration in 0.2.65, the internet download and upload speeds becomes extremely slow (nearly unusable).

Regarding the upgrade is it possible to downgrade to 0.2.65 ? If not, is it expected behaviour to have to re-import previous incremental jobs?

 

Michael

Senior Member

Hi @Lei CAO,

 

Further to the above, I'm unable to upload to a document library subfolder so won't be able to use the manual method.

 

Any other suggestions?

 

Thanks

Michael

 

 

Microsoft

Hi, @Michael Milad-Said

 

Do you mean 68 is slow or 65 is slow? During our internal test there is no big performance change during these builds. and I have to mention that performance will change significantly for different tenant.

 

Currently it is not possible to downgrade. I think it will work to re-import the previous incremental jobs for different versions.

 

If you have many jobs and have to use CSV, I suggest you can wait a few days for the 68.1 build.

 

for your another question in a different post "I'm unable to upload to a document library subfolder ", this is a strange thing... It would be grateful if you can prove the logs.  

Senior Member

Hi @Lei CAO,

 

Regarding performance. when I was running a migration using v 65, I noticed the Internet became extremely slow (20Mb/20Mb) with very high ping time (800-1000ms). Not sure if this is to be expected.

 

With v68, if I use the manual method to configure a migration I don’t have the option to select or upload to a document library sub folder (an option available when using CSV).

 

is there any way around that or I have to wait for 68.1 to be available ?

 

Michael

Microsoft

Hi, @Michael Milad-Said

 

How many jobs do you have? If not many, how about only add one line in the csv then migrate, after migration is done, change that line for another target?

There should be no issue if there is only one line in the csv file.

Sorry for the stupid bug.

Senior Member

Hi @Lei CAO,

 

I've tested doing 1 entry in the CSV, but each time I start the migration I get the error "There was a problem during the migrations - Invalid Sharepoint Online Document library 'Documents'. I had previously run a migration to this exact location and have confirmed that the documents Library exists. I have even tried using the Wizard to create the job (and able to select the relevant document library) and get the same error.

 

The 2.68 version of the tool is currently unusable to upload content to Sharepoint.

 

Is there any chance I can download the v65 version?

 

On a separate note, I have noticed that the Sharepoint Migrator tool (v2.65 and 2.68) don't exit correctly. After you click the close button, the Application goes to a Not Responding state (see below). The only way to close is to press the X button and terminate the application.

This is a computer running Windows 10 Pro Creator Fall update (16299)image.png

Regular Visitor

Hi, I keep getting these "Scan File Failure:Target path is too long" scan issues in the report CSV files. I've double checked the target path and it is only 272 characters long, which is well under the 400 character limit according to this technet blog (https://blogs.technet.microsoft.com/wbaer/2017/05/09/new-maxpath-limits-in-sharepoint-and-onedrive/). I can manually upload the files to the target path so it doesn't seem to be a OneDrive issue. Is there a setting in the SharePoint Migration Tool that I have to enable to increase the target path to 400 characters? Thanks!

Microsoft

@Adam Boon

What's the .NET version you are using? Supporting 400 character file path need at .NET version at 4.6.2+

 
Senior Member

Hi Team,

 

Not sure if it's something in my environment but thought I'd provide some feedback on the Sharepoint tool.

I've tried to perform a 100GB file migration and consistently finding the Migration makes the Internet unusable and consistently get the error "Several packages failed to upload, Pause the task" (see below)

 

The environment is Windows 2008 R2 Server as File Server and we are running the Sharepoint migrator from a Windows 10 Client PC (i5, 12GB Ram, 256GB SSD)

 

Happy to provide logs if requires (i've logged a case via the Support site but haven't heard back from anyone)

image.png

 

Thanks

Michael

Regular Visitor

@Zhigang Zhang

Thanks for the .NET advice, I was using version 4.5.2. Things are looking much better with .NET version 4.7.1.

Microsoft

@Michael Milad-Said There is an inner mechanism in SPMT that it will pause the migration if the network connection to Azure storage is quite slow (always timeout to upload the files). Generally it is recommended to retry the migration later. If you consistently encounter this issue, please better involve your IT team to diagnose the connections to https://*.blob.core.windows.net.

BTW, could you provide the link of the Support site where you logged the case?

Senior Member

 

Hi @Jian He

 

Thanks for your reply. It would be good if there was an automatic retry so that the upload could resume with no intervention. This would make the tool more resilient to network issues (dropout, high load etc). As I wasn't able to easily diagnose the issue, I ended up reverting to another 3rd party migration tool which was able to upload with minimal issues.

 

Please see link to previous logged case - https://social.technet.microsoft.com/Forums/en-US/5f696d6e-8ced-4fff-863c-a27447f151fc/several-packa...

 

Let me know if there is a better place to get support in future.

 

Thanks

Michael

Occasional Contributor

Its great news.

Earlier i used SharePoint Online migration api to migration document library & list from SharePoint 2013 to SharePoint Online.

Now, This tool is used to migrate SharePoint 2010 Document Library to SharePoint Online Developer Site. Its work like charm.

 

Note:-

In both the case, Schema need to create at destination before migration.

Using Microsoft Migration tool, I didn't find the option to migrate the list or am i missing any steps or configuration ?

Microsoft

@Manoj Mittal

"list' migration isn't supported in this version yet. It will be supported in next major version. You can expect it in sometime in earlier part of 2018.

Occasional Contributor

@Zhigang Zhang - Thanks for the update on list support. This is a blocker for our migration plans currently.

Deleted
Not applicable

Great work on the number of updates MSFT SharePoint Migration Tool Team! Adding a refresh button to refresh loading the libraries for destination would be very handy :) tmp_refresh.JPGAllow users to reload the list of destination libs

 

Senior Member

1. We are Migrating from SharePoint 2013 OnPrem to O365 SharePoint Online used Microsoft Fast Track Tool, we are facing some Issue with Metadata Information (File Created Date). After Migration: File Created Date is wrongly displayed as July 13 2015, instead of July 14 2015.

 2. Picture Library is not Migrating from SharePoint 2013 OnPrem to O365 SharePoint Online Error :

      There was a problem during the migrations. The Provided list template is not supported.

Kindly help us resolve the issue.

Visitor

@Seenivasan. T 

 

From issue 1) Just out of curiosity. Did you verify regional settings on your On-Prem vs your O365/SP Online?

Senior Member

I have two PDF Files, one file is migrating the another one file is not migrating.

Failure Report : PACK FAILURE Packaging Failure:A version of this file is missing.

Microsoft

for the PDF migration failure, could you share the logs?  

Microsoft

@Seenivasan. T for the meta data issue you met, please also share the logs. 

Senior Member

log file share I don't have attachment icon here. 

Microsoft

@Deleted, a backlog item  is created on your feature request-adding a refresh button to refresh loading the libraries for destination. 

Senior Member

error.png

Microsoft

@Seenivasan. T please send your logs to Migration feature crew <migration_team@microsoft.com>. 

Senior Member

Helen Hua

 
Your message to migration_team@microsoft.com couldn't be delivered.
The group migration_team only accepts messages from people in its organization or on its allowed senders list, and your email address isn't on the list.
Microsoft

@Seenivasan. T, do you mind sharing your email so that I can contact you for logs? 

Senior Member

email: tseenivasan@hotmail.com

Visitor

Hi, 

 

I have tried to migrate files/folders that have a '#' or '%' character in them using SPMT v0.2.75.0 but they are not migrating.

The tenancy has been configured to accept these characters and this has been tested by manually uploading files/folders with these characters in them.

 

 

Microsoft

@muks_h, There is a switch in settings to let the tool disalbe the filtering out these special characters.

Senior Member

Please help to resolve this issue. After Click Migration Button:

There was a problem during the Migrations.

The Provided user 'Default' is not a site administrator.