Environment Scan allows you to plan and prepare your migration by performing analysis of your source file and mail environment and reporting important information such as item counts, data volume, permissions, and folder depth.
Reports are produced which can be exported and analysed. Using the information provided you can estimate your migration's duration more accurately, and address any potential issues before your migration even begins.
It is not currently possible to estimate how long an Environment Scan will take due to the number of variable factors involved.
The following table shows the supported export platforms for file and mail environment scan.
|Microsoft Office 365
Hosted Microsoft Exchange
|IBM / Lotus Notes
|Exchange/O365 Online Archive
Selecting Scope of Scan
Depending on your source platform, you can choose to scan files, emails, or both sets of items.
- Leaving the Report on File Permissions setting unchecked will speed up the Environment Scan process.
- In order to include Report on File Permissions in the process, you will need to check this setting AND enable Document Sharing (or a setting related to document sharing) in the Source Platform settings. If either is not enabled, the Environment Scan will not scan or report on File Permissions.
- Enabling the Report on File Permissions will allow you to see the owner and permissions for all files.
- Enabling the Report on File Permissions may require a higher spec migration VM depending on the size of the migration data set.
- Setting the Max User Threads allows you to specify the maximum number of users that will be scanned concurrently.
- The value is not guaranteed and depends on available resources.
- Although using the default value of 50 is recommended, there is a possibility of reaching / exceeding the discovery quota. This may need to be reduced. In order to increase the number of threads, a higher specification migration VM is required.
- If the Environment Scan shows Failed Users, you can press the Retry Failed Users button to run the scan for failed users only, instead of the entire scan again. This allows you to restart at the point where the Environment Scan failed or stopped.
Your CloudM Migrate userlist is used to define the scope of the scan. You can choose to scan all accounts from your list, or restrict the scan to users selected for migration.
The email and file date range values, set in General Migration Settings, limit the scope of the scan. The default values will scan all objects but this can be changed to limit the scope of your scan.
For files, it is possible to select whether the modified or created date is used in conjunction with the date range.
File Name and Extensions
You can include or exclude file extensions or names within the configuration.
How to run an Environment Scan
After entering your source and destination server settings, populating your userlist, and configuring your settings, you will be prompted to run an environment scan. It is optional, but recommended, for all file platforms.
Click 'Start' to begin the scan. CloudM Migrate will connect to your source environment and capture file and/or mail information. This can take up to several hours, depending on the amount of data present.
Once the scan completes, the data is reported on the Environment Scans page and can be exported to file.
Drive shortcuts will be counted as an "item" in the users scan, but can be filtered in the CSV by mimetype to get a true count, if required.
File Scan Reports
The following reports are produced for all file platforms:
|Total number of unique files found for all scanned accounts
|Total number of unique folders found for all scanned accounts
|Total Scanned Files
|Total number of scanned files, including those found in multiple accounts
|Total Scanned Folders
|Total number of scanned folders, including those found in multiple accounts
|Total number of permissions found across all scanned files and folders
|Total Skipped Files
|Total number of files skipped during the scan
|Total Unique Files Size
|Total size of all unique scanned files
|Total Files Size
|Total size of all scanned files, including those found in multiple accounts
|Number of errors encountered during the scan
|Total External Permissions
|Total number of external permissions found in all scanned items
In addition to the above, additional reports are available for Google Drive and OneDrive/Team Sites:
Externally owned Google Drive files will not be included in the "Total Scanned Files" count if Google Workspace is not the destination platform. However, their file sizes will still count towards the "Total Files Size".
|Files Shared Externally
|Total number of files shared with users outside of the source domain
|Folders Shared Externally
|Total number of folders shared with users outside of the source domain
|Files Owned Externally
Total number of files owned by users outside of the source domain. These items cannot be migrated
|Folders Owned Externally
|Total number of folders owned by users outside of the source domain. These items cannot be migrated
|Total Library Count
|Total number of document libraries found
|Total Library Count Versioning Enabled
|Total number of document libraries with versioning enabled
|Total Empty Library Count
|Total number of empty libraries
|Total Site Collection Administrators
|Total number of site collections admins found
|Total Checked Out Files
|Total number of currently checked out files
|Total Unused Libraries
|Total number of libraries last modified over 12 months ago
Mail Scan Reports
The following reports are produced for all mail platforms:
|Total number of emails found
|Total number of labels/folders found. This will not include any that are skipped due to Migration Folder configuration settings, and folders/labels will only be counted if they are associated with at least one scanned email
|The total size, including attachments, of all scanned emails
|Number of errors encountered during the scan
The following information is provided per-user:
|Total number of emails found for the user
|Total number of archived emails found for the user
|Total Encrypted (platform dependent)
|Total number of encrypted emails found for the user
|The date/time of the oldest email scanned for the user
|The date/time of the newest email scanned for the user
|The total size, including attachments, of all scanned emails in the user's mailbox
|The average size, including attachments, of all scanned emails in the user's mailbox
|Number of Labels/Folders
|The number of labels/folders found in the user's mailbox. This will not include any that are skipped due to Migration Folder configuration settings, and folders/labels will only be counted if they are associated with at least one scanned email
|Number of items with multiple labels/folders
|The number of items with multiple labels/folders. This primarily applies to GMail, as duplicate emails are not scanned when traversing mail folders.
|Number of folders under inbox
|The number of scanned folders that exist underneath the user's inbox
|Number of shared folders
The number of shared folders in the user's mailbox. Only relevant for GroupWise and Zimbra
Accessing previous scan results
Migrate supports accessing details from the last 10 environment scans you have run. To do this, click on the “Previous Environment Scan Results” button and the bottom of the page, and you will then be able to select which of your previous scans to download the results for.
Q: In a Google Environment scan, what items are scanned for each user?
A: The environment scan will scan and report all items that exist within a users MyDrive for each user being scanned.
Q: Are Externally owned files included when scanning Google as a source?
A: If Google Workspace is the destination, externally owned files are included in the count and in the total file size. If Google Workspace is not the destination, externally owned files are only included in the total file size.
Q: In a Google Environment scan, are versions of files included?
A: No, Migrate does not scan versions of files.
Q: In a Google Environment scan, does Migrate scan items in the Bin?
A: No, Migrate does not scan items located in the Bin.