Step 2: Scan and assess Box users

Note

Scanning is an optional but recommended step for Box migrations. If you experience Box throttling during scanning, you can skip "Step 2: Scan and assess Box users" and proceed directly to migration.

Uncheck the Automatically start scanning now option in the Add users panel if you wish to skip scanning. After the Box users (tasks) are added to the scan list, they can be directly copied to the migration list for migration operations. Migration Manager won't discover and report potential errors and warnings before migration if the scan process is skipped. Any problems will only be reported during migration.

After connecting to Box, add the Box users you want to migrate and optionally scan and assess their content. Scanning takes an inventory of accessible files and folders, calculates their sizes and item counts, and detects potential issues that could impact migration.

  1. Select Add users from the menu bar to choose how to add users:
    • All new users to autodiscover all users in Box.
    • Single user for only one account.
    • Multiple specific users to bulk upload users by entering them into a CSV file to upload.
  2. Select to Automatically start scanning now, or clear it to scan later or skip scanning.
  3. Select Add.
  4. Select one or more Box users and then select Scan if you chose not to automatically scan earlier.
  5. Once the scan is complete, Migration Manager displays an overview of the source content and scan status.
  6. Review the scanned users. Search for specific text or select a filter to review the list more easily.

Important

The total number of rows (tasks) in the scan list cannot exceed 50,000.

Download reports

Scan summary report and Scan detailed reports are available to assist you in troubleshooting. Download the generated reports to investigate any possible issues that might block your migration.

Check the status code in the Scan summary report to address task-level errors. For file-level errors, refer to the failure code (ResultCode) in the Scan detailed report.

Managing users who own large amounts of data

After the scan finishes, download the Scan reports and identify and review any Box users with large data sets.

For best performance, keep each migration task (Box user) below 100,000 items and 1 TB of data. If a Box user exceeds either recommended threshold, divide it into separate, non-overlapping migration tasks based on the root folders.

To split a user into multiple migration tasks, follow these steps:

  1. Delete the Migration Manager task that represents the Box user.
  2. Select Add users from the command bar.
  3. In the side panel that appears, select Multiple specific users.
  4. Download and edit the provided .csv template file to divide the user into multiple tasks. For example:
    • LargeUser@contoso.com/folder01
    • LargeUser@contoso.com/folder02
    • LargeUser@contoso.com/folder03
    • LargeUser@contoso.com/folder04
  5. Save the updated .csv file and upload it to create the divided migration tasks.

Step 3: Copy to migrations