Offer Offer

News We Recently Launched AD Migrator and AD Reporter.

SysTools Teams Migrator Guide

Follow step by step guide to migrate Teams Data using SysTools Teams Migrator.

Following are the Steps for Teams to Teams Migration

        Pre-Requisites

  • SysTools Customer Management domain should be whitelisted in users network firewall.
  • Create project in Microsoft Azure, Allow Application permission and generate Application ID. Read more.
  • Microsoft Visual C++ Redistributable Latest (Visual Studio 2015, 2017, 2019, and 2022) Should Be Installed. Download

Note: Before starting the migration please make sure about the destination domain name(e.g., @domain.com, @domain.onmicrosoft.com, or hosted domains), as this cannot be changed later, because the software licenses will be consumed and these cannot be revoked afterwards.

Download and Launch the migration tool

In case, tool is not activated, see how to activate the product: Activation Steps

Tool provides the help section for the details about each migration mode. Click on "Help" button to view this section.

Start screen

To enable advance settings for Concurrent migration (optional). Read more: Advance Settings

STEP 1

Now, Select Office 365 as source & Office 365 as destination.

main screen

STEP 2

In this workload selection, select Teams, It will automatically select Teams Creation, Channel creation, channel message & files. Users can also select the group workload as per their needs.

teams workload selection

STEP 3

Now, Enter Admin email ID & Application ID of Source tenant & then click on Validate button to validate associated permissions.

m365 source details

STEP 4

Now, You can see the Teams permissions are validated. Click on Next button to proceed.

source account validation

STEP 5

Enter the Destination Admin email and Application ID & then click on the Validate button to validate all permission.

m365 destination details

STEP 6

Now, Teams permissions are validated. Click on Next button.

destination account validation

STEP 7

Now under Resources tab, in the Users screen, there are several ways in which you can add users from the source Users that needs to be processed.

users window

Fetch Users: It will fetch all the users from Source domain.

fetch users

Import Users: This will import users through CSV.

import users

Download Template: In this option, you will get a sample CSV file in which you can add source and destination users manually.

download template

STEP 8

Fetch User – This option will fetch all source user accounts, then you have to enter destination user's email addresses.

Click on Continue.

fetch users

STEP 9

All source Office 365 users are fetched.

users fetched

STEP 10

In this screen, you can see all the source user emails.

users list

STEP 11

Map sources users emails to the destination user emails by entering destination emails (enter destination email where you want to migrate source Teams).

Click on (…) icon, if you want to import a CSV file containing destination accounts.

users add option

STEP 12

Users can also filter out the selected users for migration and also allocate Priority if they have multiple user mailboxes and want to migrate some of them prior to others.

user selected

Now, Validate permissions by clicking on Validate button. It's compulsory to validate Users in case of Teams Migration

validate users

After successful validation, you will see user icons in green colour.

validated users

STEP 13

Now proceed to the Resources tab. In the Teams screen, there are several ways in which you can add Teams from the source account that needs to be processed.

teams window

Fetch Teams: It will fetch all the Teams from Source domain.

fetch teams

Import Teams: This will import Teams through CSV.

import teams

Download Template: In this option, you will get a sample CSV file in which you can add source and destination users manually.

download teams template

STEP 14

Fetch Teams – This option will fetch all Teams in source domain.

Click on Continue.

fetch teams

STEP 15

All source Office 365 Teams are fetched.

teams fetched

STEP 16

In this screen, you can see all the source Teams.

teams list

STEP 17

You need to map destination Team with selected source Team. For this, Click on Create Team button. Now you'll see below screen, Provide the Team name as per your requirement or software will pre-populate destination Team names according to source Team name.

teams creation

Click on Start button

All required teams will be created in the destination domain. Teams will be created in "In-Migration Mode".

teams created

STEP 18

Users can also filter out the selected Teams for migration from the drop down menu.

teams selected

STEP 19

Now, validate permissions by clicking on the validate button.

validate teams

Now, after successful validation, you'll see all the green icons.

validated teams

Once the required source and destination permissions are validated, you can expand a particular team to list the channels in that team. Additionally, you can also check / uncheck the channels that you want to migrate.

select channels

STEP 20

After successful validation. Click on Start Migration button to initiate the process.

teams start migration

You can see the migration task In-Progess / Pending / Completed tab.

migration in progress

STEP 21

After completion, you can see the green tick icon in front of all the teams that are migrated.

teams files migrated

After completion of the migration process, you can click on the drop down button to see the count of the channel names, messages & files that are migrated

teams migration count

STEP 22

Re-Run Migration option is also provided in order to perform the migration again.

  • Retry Failed Items: To migrated the data which didn't get migrated.
  • Re-Run Full Migration: To perform the entire migration process again.
  • Delta Migration: To migrate the newly arrived data in between the migration process

Users can perform these actions before marking Teams as complete. They won't be able to execute these steps after they've clicked on Mark Teams Complete.

re run migration

The software will show you a prompt screen. Click on Yes. Users can not perform Re-run or Delta Migrtion once marked Teams as complete.

teams prompt screen

STEP 23

After completion of migration, click on the Download Report button to generate the detailed migration report.

teams download report.webp

The tool provides two options for downloading the reports:

Summary Report: The summary report will be a single .csv file containing migration reports of all the selected users for migration.

teams summary report

Detailed Report: Here, you get the option to save the detailed migration report of the mailboxes you want to. Select the mailbox and click on Download button.

teams detailed report

Choose the destination location where you want to save the Detailed Report.

teams detailed report save

STEP 24

Now, users need to migrate Teams Groups. Under Resources tab, in the Groups screen, there are several ways in which you can add Groups from the source account that needs to be processed.

groups window

Fetch Groups: It will fetch all the Groups from Source domain.

fetch groups

Import Groups: This will import Groups through CSV.

import groups

Download Template: In this option, you will get a sample CSV file in which you can add source and destination users manually.

download groups template

STEP 25

Fetch Groups – This option will fetch all Groups in source domain.

Click on Continue.

fetch groups

STEP 26

All source domains Groups are fetched.

groups fetched

STEP 27

In this screen, you can see all the source Groups list.

groups fetched list

STEP 28

To start migration you have to enter Destination Groups emails (enter destination email where you want to migrate source Groups).

Click on (…) icon, if you want to import a CSV file containing both source and destination accounts.

Destination ID of "Team Group" which Team has been marked as completed will be automatically get mapped.

Note:- “No license will get consumed for Group migration”

groups list

STEP 29

Users can also filter out the selected Groups for migration.

groups selected

STEP 30

Now validate the permissions by clicking on the Validate button

groups validate

STEP 31

After successful validation, Click on Start Migration button

start groups migration

STEP 32

After completion of migration, click on the Download Report button to generate the summary or detailed migration report for Groups.

groups summary report

Following are the Steps for Teams Personal Chat Migration

Pre-Requisites

  • Application should be registered on both source and destination domain’s Azure platform to get service account credentials. For detailed steps, refer to the SysTools Migrator application.
  • Application should be granted all required scopes on the Azure portal.
  • Source and destination users must have a valid O365 license.
  • A temporary user should be created in the destination domain with a valid O365 license. This account will be used for chat migrations.
  • Before migrating personal chats, ensure that other workloads (like document migration with permissions) are complete.
  • All users' documents and chats should be migrated from the same server.
  • User mapping for all users must be provided.
  • Ensure that the antivirus does not block the application.
  • Proxy settings should not block network calls.
  • Sleep and Hibernate modes should be disabled on the migration server.
  • Internet bandwidth should be a minimum of 100Mbps.

Note: Before starting the migration please make sure about the destination domain name(e.g., @domain.com, @domain.onmicrosoft.com, or hosted domains), as this cannot be changed later, because the software licenses will be consumed and these cannot be revoked afterwards.

STEP 1

Launch the Software, Select Microsoft 365 as both the Source and Destination.

endpoint selection

Under the User's Option, mark the checkbox next to Documents and Chat Workloads.

workload selection

If Chat Migration is your only priority, then don’t apply the Date Filter on Documents.

Note: This is an explicit boundary that is selected from the day you start migration and goes back two months.

After workload selection click on Next.

STEP 2

On the Source Page, add the Admin Credentials and enter the Application ID in their respective spaces.

source pre validation

After putting in the credentials, click on the Validate Button.

The tool will perform the Validation process and show the results Successful or Not in a box next to the credentials area.

The entire process competes in a few minutes.

When the Source side Validation completes successfully, click on Next.

credential validated

STEP 3

In the Destination area, you must redo the validation steps.

destination screen

Use the Destination Admin email and the equivalent Application ID.

destination details filled

Press the Validate Button, let the Process complete, and Press Next.

destination details validated

STEP 4

The User Mapping screen is where you can add the list of users whose chat data you want to transfer.

teams resources screen

There are three options present to make a list of users.

The Fetch operation can use the Microsoft 365 admin id to pull out a list of users directly from the source.

fetch users

Use Import CSV option when you have a pre-made list of specific users whose chat you want to transfer.

import csv

Download Template provides you with a blank CSV where you can add the user accounts and then upload the CSV in the tool.

download template

STEP 5

After going forward with any of the user addition options, the tool loads in the list in the Preview area.

user preview screen

There you can mark the users whose chat data is to be migrated with the help of a checkbox.

user preview screen

Apply priority marking to specific accounts to move their accounts to the top of the migration order.

The Show Selected toggle filters out the list to display only those accounts which have been selected for migration.

Once the user-level settings are done, add the destination email and press Validate.

user selection complete

A popup appears indicating the Validation process. Press OK once it completes.

user validation complete

STEP 6

Then click on the Start Migration Button at the top right corner.

A popup containing two options becomes visible. As you are yet to migrate Document data, stay with the default selection that says “No, please continue to migrate workloads other than Personal Chat” and click on Start Migration.

migration popup

Take a look at the license consumption data and press Start.

migration license count

The popup changes to an alert indicating the start of Document Migration; click on OK.

migration started

STEP 7

The details of the current status of migration can be found in one of three tabs.

Pending: Contains the accounts which are still in line for the migration.

migration pending list

In Progress: Keeps the accounts whose data is being migrated in real-time.

migration ongoing

Completed: Contains the accounts whose data migration is done.

migration complete

STEP 8

While the migration is going on, you can end the process midway by hitting the Stop Migration button.

Once hit, a secondary confirmation popup appears on the screen. Click Yes to confirm.

stop migration

Once all accounts you are migrating come under the Completed tab, the Document Migration is done.

After the Document Migration completes, go back to the Setup Page.

Deselect the Documents workload and continue by only selecting the Chat option.

Perform the re-validation of Source and Destination one after the other.

In the User Preview Section, revalidate for all those accounts which underwent a Document Migration.

No need to change the selections as the tool remembered it for you.

STEP 9

Once all basic steps are done, click on Start Migration.

Inside the Personal Chat Migration box, mark the radio button next to “Yes, document migration is completed, please continue migrating only the Personal Chat workload.”

add temp user

Add the temporary user ID on behalf of whom the migration takes place.

Note that this should be a new account with no historical chat data with any of the members.

Then press Authenticate.

authenticate temp user

A sign-in window appears; put in the password of the temp user account and press Sign in.

The sign-in window will close on its own after validating the credentials. Click on the Continue button of the Personal Chat Migration box.

A temporary user with a valid Office 365 license should be created in the destination domain. Otherwise, empty chat folders will be created at the destination.

temp user authenticated

STEP 10

A second pop-up informing you about the Chat creation process appears on the screen. Click on the Create Chat button.

chat creation alert

Inside the same popup, a chat creation count will begin. Once it completes, click on OK.

chat creation complete

The topmost popup window will close, then click on the Start Migration button of the Personal Chat Migration box.

start chat migration

This produces a license consumption alert. Take a look and click on Start.

chat migration license alert

The box displays a Migration Started successfully alert. Click on OK to continue.

chat migration start alert

STEP 11

An account undergoing chat migration can exist in one of three phases.

Pending: Houses those accounts still in line for the Chat Migration.

chat migration pending

In Progress: Keeps the Accounts whose chats are being migrated in real-time.

chat migration in progress

Completed: Contains the accounts whose chat migration is done.

chat migration complete

STEP 12

Once every account you selected for chat migration appears in the Completed tab, the migration is done.

mark chat complete

STEP 13

If the migration encounters any issues or there is data missing, try the troubleshooting options under the Rerun Migration tab.

Retry Failed Items: Brings in the data that was left out during the initial run.

Re-run full Migration: Use when you believe you have to re-do the entire migration again.

Delta Migration: Migrate the data generated during the first migration cycle.

STEP 14

Once the migration is done, indicate chat completion by expanding Rerun Migration option and clicking Mark Chat as complete.

mark chat complete alert

STEP 15

This opens a new box where every account that has undergone chat migration is pre-selected. Note you can't change selections so just hit the Start button to continue.

mark chat complete process

STEP 16

A warning alert appears on top of the screen, informing you that once marked as complete, the chat migration option will permanently freeze for that user.

set chat complete

Proceed only when you have double-checked that all chat contents have arrived safely in the destination. Click Yes to proceed.

chat migration done

STEP 17

Once the process completes, the box will indicate that the selected users' status has changed to Migration Completed.

You won't be able to migrate the same chat again.

Chat Migration is now truly completed.

chat migration done

STEP 18

The tool provides an in-built reporting option to document the migration process. Click the Download Report option.

reporting options

Choose from two options:

Summary Report: Contains overall transfer records of the entire process.

migration summary report

Detailed Report: Makes user-specific reports on the migration data.

detailed report

STEP 19

Login to the Teams application with the destination account credentials to check all users.

check teams app