title | ms.author | author | manager | audience | f1.keywords | ms.topic | ms.service | localization_priority | ms.collection | search.appverid | description | |||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Troubleshooting SPMT installation issues |
jhendr |
JoanneHendrickson |
serdars |
ITPro |
|
troubleshooting |
sharepoint-online |
Priority |
|
MET150 |
Troubleshoot common installation errors in the SharePoint Migration Tool. |
If you are having trouble installing the SharePoint Migration Tool, this article provides information on the possible causes and steps to correct the problem.
If after troubleshooting you still are experiencing problems, consider downloading and installing the public preview (beta) of SPMT. It contains the latest updates and fixes.
Download SPMT Public Preview
If you are having issues loading the SharePoint Migration tool, here are a few items that are commonly forgotten.
Item | Requirement |
---|---|
System architecture | Must be x64 |
.Net version | Must be 4.6.2 or higher. See How to determine which versions are installed |
Microsoft Visual C++ 2015 Redistributable for X64. | SPMT is trying to add all the redistributions in packages, but missing some system dlls. Trying to install the package might help to resolve all the dependencies. Download: Microsoft Visual C++ 2015 Redistributable Update 3 RC. |
Anti-virus | Stop 3rd party anti-virus software on your computer prior to installation. |
Error | Suggested action |
---|---|
"Application SharePoint Migration Tool is already installed from another location". | An unfinished installation may be the cause of this error. Uninstall the tool and then reinstall. |
If you are on a government cloud, you must first take these steps:
-
Open microsoft.sharepoint.migration.common.dll.config.
-
Change the value of SPOEnvironmentType to:
- 2 if you are GCC high or DoD
- 0 if you use the Worldwide consumer cloud or GCC
For example: -
Double-click "microsoft.sharepoint.migrationtool.advancedapp.exe" to start SPMT.
Note
0 = Worldwide consumer cloud and GCC
2 = GCC high and DoD