In this topic:

• Prerequisites
• Considerations
• Starting an Migrate Workspaces Task
• Reviewing the Migrate Workspaces Task
• Reviewing the Migrate Workspaces Task Events

Prerequisites

Any Connections that are required by Reports must be migrated before scheduling a Workspace migration.

The Default Target Admin User configured in your Power BI project, is added to migrated Workspaces to ensure that access to migrated Workspaces is retained if a matching administrator account is not available for a migrated Workspace. We recommend that you retain this for safety.

Considerations

Your target tenant might already host Power BI Workspaces created before the migration. In cases where a Workspace name already exists in the destination, the migration will merge report, semantic model and Workspaces permissions data from the source tenant.

We recommend that you run only one migration task at a time to avoid scheduling delays.

Starting a Migrate Workspaces Task

1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
2. From the navigation pane, click Migration to open the My Projects list.
3. Create a new project or open an existing project.
4. From the Power BI tile on the project dashboard click Open. Then select the Workspaces tab.
5. Select one or more Workspace that you want to migrate.
6. Click Migrate in the List View menu. The New Migrate Workspaces Task wizard starts.
7. Step 1: Migration Options
   1. Default Target Admin User - specify the default target admin user to use for any user that has no match on the target. If a default admin user was configured from the project previously, it will automatically appear in this field.
   2. Incremental migration - select this option to migrate modified or missing data. This option is very helpful in subsequent migrations to keep your migrated data synchronized between source and target tenants.
   3. Click Next.
8. Step 2: Schedule
   1. Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
      • Run now - task runs immediately.
      • Run later - task must be started manually.
      • Schedule - task will be started at a future date and time entered in the corresponding calendar field.
   2. Click Next.
9. Step 3: Summary
   1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Migrate Workspaces Task. You can specify a custom name.
      2. Default Target Admin User - name of the admin user specified for this task.
      3. Incremental migration - indicates whether or not this option has been selected.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
   2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
10. When the task completes, the Workspace State column in the Workspaces list is updated.

Reviewing the Migrate Workspaces Task

1. Open the Tasks tab.
2. Select the Workspace migration task that you want to review.
3. In the task details pane that opens, the information presented is as described below:
   1. Task Status - current status of the task.
   2. Type - Type of the task. The type is MigrateWorkspaces.
   3. Created - Date and time when the task was created.
   4. Modified - Date and time when the task was last updated.
   5. Last Operation - The action that was most recently performed in this task.
   6. Schedule - Date and time when the task started. Now indicates that the task started immediately after the task was created.
   7. Events (number) - Number indicates the count of events that the task encountered. The values indicate the type of the events and the event count for each type.
   8. Workspaces (number) - The number of Workspaces that were selected for migration and the number of Workspaces passing through the various states from Migrating to Migrated.

Reviewing the Migrate Workspaces Task Events

1. Open the Tasks tab.
2. Select the Workspace migration task for which you want to review the events.
3. In the task details pane that opens, click Events (number). The Events tab opens with a filtered list of events for the selected task.
4. Select an event that you want to review. In the event details pane that opens, the information presented is as described below:
   1. Object - name of the Power BI object if applicable.
   2. Task - name of the task.
   3. Time - date and time when the event occurred.
   4. Summary - a descriptive statement about the event if an exception occurs.