SharePoint Migration Dashboard

Planning to migrate your SharePoint server farm to SharePoint Online? Then you absolutely must install this dashboard.

Reasons for Setting up the Migration Dashboard

• SharePoint migrations to Microsoft 365 can be a nightmare to plan and organize
• You want to keep track of your migration progress
• Dashboard is a self-service portal designed to provide SharePoint site owners with all migration-related questions
• Save time on reading SharePoint Migration Assessment Tool (SMAT) reports. Migration Dashboard presents SMAT data in a human readable form that will be available both for the migration team and site owners.

Watch a Demo

Deploy Migration Dashboard

Prerequisites

• Microsoft 365 subscription
• SharePoint Online Administrator role (for creating the App Catalog)
• SharePoint Site Administrator (for deploying the package)
• SharePoint App Catalog

Deployment Steps

1. Download and unzip latest release

2. Run Prerequisites.bat

3. In SharePoint Online:

   • Create App Catalog Site Collection if not already created
   • Navigate to the SharePoint App catalog > Apps for SharePoint library
   • Drag and drop sp-migration-dashboard.sppkg to the library
     
   • Create an empty site collection for hosting Migration Dashboard.
   • Add the "Migration Dashboard" app to this site collection.
   • Add Migration Dashboard webpart to the home page.
     

4. Deploy Dashboard Lists and Libraries by running Deploy-Dashboard.ps1

Upload Data to the Dashboard

1. Download SharePoint Migration Assessment Tool (SMAT)
2. Run SMAT in one of the SharePoint servers in your farm.
3. Run Upload_SMAT_Reports.ps1 to upload SMAT reports to the Dashboard site.
4. Enjoy the data provided by the Migration Dashboard!

💡 Known issue: Details View does not show fields ⚠️

If the "View Details" does not show any fields except for Title. Apply the following fix:

• Go to Site Contents
• Next to Sites Report click on the three dots (...) > Settings
• Under Content Type, click "Item" Content type
• Add from existing site or list columns
• Select all columns by pressing SHIFT and Left Mouse click
• Click Ad

Migration Dashboard Architecture

The Dashboard is a lightweight solution that includes the following components

• Communication SharePoint site.
• SharePoint Framework (SPFx) webpart.
• No heavy dependencies or external APIs.
• Your migration-related data will stay in your SharePoint Online tenant.
• Dashboard does not send any data to the outside world.
• Source code is available in this open source repository.

Build the Package

You can always take the latest release from here. But you can also build the package manually.

Prerequisites

• Install Node.js LTS 10.x
• Install gulp by running npm install gulp -g

Build the Migration Dashboard Package

npm install
gulp bundle --ship
gulp package-solution --ship

Navigate to the folder \sp-migration-dashboard\sharepoint\solution\ and confirm that the .sppg file is there:

Migration Dashboard in Action