Create & run a scan

Next, conduct a scan of all the data that you intend to migrate from Google Workspace source environment. A scan generates reports that are used to assess the amount and type of source data and to identify any issues with the data.

Later in the process, you’ll put the data into manageable phases and rescan each phase. For now, you scan the whole data set.

Step 1: Create a scan

  1. In the Google Workspace Migrate platform, click New ""and thenScan.  
  2. Enter a name for the scan.
  3. Select your source connection.
  4. Under Scan scope, select Full scan
  5. (Optional) Click More options to access advanced scan settings, then proceed to step 2 below. 
  6. (Optional) To select the reports you want the scan to generate, check or uncheck the box next to the report under Report types.

    By default, all reports are generated. For a description of each report and details on any additional information you need to specify, go to Understand migration reports

  7. Click Create.

Step 2: (Optional) Advanced scan settings

  1. Under Crawl rules, select one of the following options:
    • Domain discovery–Crawls all content owned by users.
    • User Drive discovery–Crawls each user hierarchically, locating every object within their Google Drive folders. Move to step 5.
  2. Select the Crawl approach for the scan:
    • All owned content—Discovers all objects owned by users within the domain.
    • All content in My Drive—Discover all objects within each user's Drive folders on the domain, including files and folders owned by external users.
  3. (Optional) Check the Exclude users outside range box and enter a value for:
    • Start email—Enter any string value.
      The value is used as the starting point for the crawl. For example, if you enter an email address for a user, the crawl starts with that user. If you enter a letter, every user with an email address that starts with that letter or a letter that comes alphabetically after, is scanned.
    • End email—Enter any string value.
      The value is used as the endpoint for the crawl. For example, if you enter an email address for a user, the crawl ends with that user. If you don’t enter a value, the crawl scans until the end of the collection.
  4. Under Generator rules, choose an option: 

    Note: To generate correct object totals in the reports, one or both must be checked.

    • Scan Calendar Resources—Scans all calendar resources on the domain.
    • Scan Groups—Scans all Groups on the domain. 
  5. Click Create.

Step 3: Run a scan

  1. In the G Suite Migrate platform, click Scans. You might have to click Menu "" first.
  2. On the scan you want to run, click Run "".

What happens next? 

To balance the load, scans are partitioned into actions and distributed across the node servers. Scan partitions are automatically created when you generate a scan. After you click Run, the scan moves through these states:

  • Queued—The scan is waiting to start.
  • Generating partitions—The scan is creating the partitions, prior to beginning the scanning process. 
  • Running partitions—The scan is completing each of the partitions of scanning work. 
  • Completed—The scan is complete.

When the scan is running, you can see:

  • Completions—The number of processed items
  • Failures—The number of failures encountered
  • Crawled—The number of items discovered, but not yet completed

Delete a scan

Scans provide useful information for bridges. Only delete a scan after you migrate all data.

To delete a scan:

  1. In the G Suite Migrate platform, click Scans. You might have to click Menu "" first.
  2. On the scan you want to delete, click More ""and thenDeleteand thenDelete.

Next step

Analyze your scan


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.