Environment Scan

To run an environment scan, you will first need to have purchased a CloudM Migrate license, issued for the correct destination domain.
The environment scan should not be used as a comparison against platform reporting tools as this may differ due to various reasons. You can find more detail in the FAQ section of this article below.

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.

ENV_Scan.png

 

Platforms

The following table shows the supported export platforms for file and mail environment scan.

Platform File Scan Mail  Scan
Google Workspace
 
 
Microsoft Office 365
 
 

Hosted Microsoft Exchange

 
 
Microsoft Exchange
 
 
Novell GroupWise
 
 
IBM / Lotus Notes
 
 
Zimbra
 
 
Scalix
 
 
Generic IMAP
 
 
PST Archive
 
 
Mail Archive
 
 
Exchange/O365 Online Archive
 
 
Google Vault
 
 
File System
 
 
Dropbox
 
 
Box
 
 
Sharepoint
 
 

 

Selecting Scope of Scan

Items

Depending on your source platform, you can choose to scan files, emails, or both sets of items.

Environment_Scan_-_Scan_Configuration.png

  • 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.

Users

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.

Environment_Scan_-_Scan_Configuration_Users_to_Scan.png

Date Ranges

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.

General_Mig_settings_1.PNG

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.

Doc_options.PNG

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.

Environment_Scan_1.PNG

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.

Environment_Scan_2.PNG

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:

Report Description
Unique Files Total number of unique files found for all scanned accounts
Unique Folders 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
Permission Count 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
Scan Errors 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:

Google Drive

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".

Report Description
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

 

OneDrive/Team Sites

Report Description
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:

Report Description
Total Emails Total number of emails found
Total Labels/Folders 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
Total Size The total size, including attachments, of all scanned emails
Scan Errors Number of errors encountered during the scan

 

The following information is provided per-user:

 

Report Description
Total Emails Total number of emails found for the user
Total Archived Total number of archived emails found for the user
Total Encrypted (platform dependent) Total number of encrypted emails found for the user
Oldest item The date/time of the oldest email scanned for the user
Newest item The date/time of the newest email scanned for the user
Total Size The total size, including attachments, of all scanned emails in the user's mailbox
Average Size 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.

 

FAQ

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.

Was this article helpful?
10 out of 18 found this helpful