Migrating Spaces between Microsoft 365 Groups

Table of Contents

Space is the new name for the board.
Welcome to the KanBo 3.0 release!

Prerequisites

You will need:

  • Administrator access to the Azure portal,
  • A .pfx self-signed certificate used in KanBo,
  • The KanBo migration tool,
  • A Microsoft 365 group for migrating the space,
  • A machine on which you can import the certificate and run the migration tool.

Migration

To migrate a space between M365 groups:

  1. Install your KanBo .pfx certificate in your current user store. To do so, run certmgr.msc.
  1. Go to Personal > Certificates, right-click on an empty space, and select All Tasks > Import.

If you no longer have the .pfx certificate used for your KanBo account, you will need to generate a new one and use it in the KanBo configuration (please refer to the relevant installation article for on-premises or cloud installation).

O365 (Office 365) is the former name of M365 (Microsoft 365).

3. In the Migrator tool, go to the ChangeO365Group folder and start editing the migrate.txt file. You will see the following lines at the beginning of the file:

{ type: "certificate", out: "cert-aad", config: { type: "store", storename: "my", storelocation: "currentuser", key: "thumbprint", value: "CERTIFICATE THUMBPRINT", validOnly: "false"  } }
{ type: "kanbo-db", out: "db", config: { "connectionString": "KANBO CONNECTION STRING" } }
{ type: "graph", out: "graph", cert: "cert-aad", config: { clientId: "KANBO CLIENT ID", tenant: "KANBO TENANT ID" }}

{ type: "set", "old-group": "KANBO BOARD O365 GROUP GUID", "new-group": "NEW GROUP GUID", boardId: INT OF THE KANBO BOARD, "old-drive-link": "LINK TO BOARDS' SHAREPOINT SITE DOCUMENTS", "new-drive-link": "LINK TO NEW GROUPS' SHAREPOINT SITE DOCUMENTS" }
  • Copy the certificate thumbprint, KanBo connection string, client ID, and tenant ID from KanBo’s appsettings.json file.
  • You can find the M365 group GUIDs in the Microsoft Entra admin center by searching for them and copying the “Object ID.”
  • After finding the M365 group, select the SharePoint icon under “Group links” to head straight to its SharePoint site.
  • Then, select Documents in the left panel and copy the URL. It should look like this: https://contoso.sharepoint.com/sites/MyKanBoBoard/Shared%20Documents/Forms/AllItems.aspx
  • Do not enclose the space (board) ID in quotation marks.
  1. After editing the file, open Command Prompt in the main folder of the migration tool.
  2. Run the following command to monitor the migration of your space to a new M365 group:
MigrateSpToGraph file .\ChangeO365Group\migrate.txt

Post-migration

Once the migration is complete, a new folder containing three text files called “filelist” will be created. The two important files for you are “drive-item.source.txt” and “drive-item.target.txt,” which list the paths of the files before and after migration.

It is essential to delete the "filelist" folder before performing another migration.

Was this article helpful?

Please, contact us if you have any additional questions.