Google Destination Advanced Options

Claude Morings Jr

Updated June 08, 2023 00:04

Google Destination Advanced Options

This document will give an overview on all the Google Destination Advanced Options in CloudM Migrate.

Email

Archive Inbox Email

Default Value: Off

Migrated Inbox email directly into 'All Mail' within Google Workspace and not to the Inbox.

Change Conditions: Enabling will remove the Inbox label and effectively archive any migrated email from the Inbox in the 'All Mail' label.

Modify Sent Address

Default Value: On

Modify the 'From' header on sent emails to the email address of the destination account if required to enable correct display in Google Workspace.

Change Conditions: Disabling will prevent modification of the sent address of migrated emails. This is required for sent mail to be correctly labelled, but can be disabled if performing a domain-switch migration and the destination domain name will be changed to the primary after switchover.

Email Import Thread Count

Default Value: 50

Set the number of threads that will be used per-user to migrate email to Google Workspace.

Change Conditions: The number of email threads can be increased or decreased. Increasing can result in throttling issues and should only be changed if instructed by CloudM Support.

Use Limited Scopes

Default Value: Off

Use Limited Scopes requires the following scopes to be enabled: 'https://www.googleapis.com/auth/gmail.labels' and 'https://www.googleapis.com/auth/gmail.insert'

Change Conditions: When enabled only the Gmail API scopes will be used. For email only migrations.

Create Sub Labels

Default Value: On

Create sub-labels when creating labels for messages.

Change Conditions: When disabled sub-labels will not be created and any label structure will be flattened.

Apply Inbox Label to Sub-Folders

Default Value: Off

When a message from the source system was in a folder in the inbox, create the message with both 'Inbox' and 'Folder Name' labels. Set to false to just create the folder label.

Change Conditions: As Gmail does not allow sublabels under the Inbox label, this can be enabled to apply both Inbox and other label to any items from an inbox sub-folder in the source.

Email Transfer Delay

Default Value: 0

Specify the time (in milliseconds) to wait between sending messages. Normally this can be left at zero (0), but may need to be adjusted in some circumstances.

Change Conditions: A delay can be added between email imports which will reduce speed but can help with throttling. Should only be changed if instructed by CloudM Support.

Maximum Batch Count

Default Value: 0

Specify the maximum number of messages in a single batch. Specify 0 to let CloudM Migrate automatically allocate batches. Only applicable for immediate migrations.

Change Conditions: The number of emails in an import batch can be specified. Not recommended to change as it can cause performance issues.

Explode Message Labels

Default Value: Off

Instead of labels based on nested folder structure create one label per folder.

Change Conditions: When enabled labels will be 'expolded' with one label per source folder.

Contact

Archive Inbox Email

Migrate to 'My Contacts'

{: .no_toc } Default Value: On

Migrate user contacts to 'My Contacts' instead of only to 'All Contacts'.

Change Conditions: When disabled contacts will be migrated to the 'All Contacts' label only.

Calendar

Force Appointment Acceptance
Appointment Privacy
Default Calendar Timezone
Color Categorized Appointments
Migrate Attachments
Exclude Appointment Attachment Extensions
Force Busy Status
Maximum Attendees
Send Individual Events
Appointment Attachment Document Sharing
Migrate Attachments Folder

Force Appointment Acceptance

Default Value: Off

Force acceptance of all migrated appointments.

Change Conditions: All calendar events will be accepted when enabled regardless of source status.

Appointment Privacy

Default Value: Original

Set the privacy of migrated appointments to the following setting.

Change Conditions: A default privacy setting can be selected from Original, Default, Private, and Public.

Default Calendar Timezone

Default Value: Europe/London

Specify the default calendar timezone to use where a timezone could not otherwise be obtained. This only applies to recurring items without a timezone and where the Google calendar timezone is UTC.

Change Conditions: A default calendar timezone can be selected.

Color Categorized Appointments

Default Value: On

Color appointments based on categories in the source system when the source system supports categories.

Change Conditions: When disabled color categories of calendar appointments will not be migrated.

Migrate Attachments

Default Value: Off

Migrate appointment attachments to Google Drive.

Change Conditions: Calendar attachments will be migrated to Google Drive when enabled.

Exclude Appointment Attachment Extensions

Default Value: None

Specify the list of file extensions of attachments that will not be migrated, Leave empty to migrate all attachments.

Change Conditions: One or more file extensions can be entered to exclude them from calendar attachment migrations.

Force Busy Status

Default Value: Off

Force busy status when appointments have been tentatively accepted.

Change Conditions: When enabled all tentatively accepted events will show as busy in the users calendar.

Maximum Attendees

Default Value: 500

The maximum number of event attendees. When this number has been reached, no more will be added.

Change Conditions: The maximum attendee number can be reduced.

Send Individual Events

Default Value: Off

Send individual appointment events rather than as a batch (recommended in some cases if rate limits are exceeded).

Change Conditions: When enabled appointments will be migrated individually. Should only be changed when advised by CloudM Support.

Appointment Attachment Document Sharing

Default Value: On

When migrating appointment attachments to Drive, choose whether the attachment should be shared with the appointment attendees.

Change Conditions: When disabled attachments will not be shared with the original email recipients when migrated to Drive.

Migrate Attachments Folder

Default Value: None

Migrate appointment attachments to the specified folder when 'Migrate Attachments' is enabled.

Change Conditions: If no folder is specified attachments will go to the Drive root.

Document

Use Cached Items Mapping
Allow Non-Google Sharing
Maximum Results Per Request
Notify Sharing Link Members
Replace Comment Mentions with Display Name
Preserve Modified Date
Allow Alternate Item Ownership
Batch Permissions
Trash Duplicate Items
Skip Post Processing of Existing Items

Use Cached Items Mapping

Default Value: On

Use cached item mappings when migrating to Drive. (Not applicable for Google to Google migrations)

Change Conditions: When disabled Drive items will not be cached. Can slow down delta migrations.

Allow Non-Google Sharing

Default Value: Off

Allow permissions to be added for users without Google accounts by sending notification emails to those users. Note this can result in many emails being sent to any non-Google addresses.

Change Conditions: Allows permissions of non-Google accounts to be added to ACLs when enabled.

Default Value: 100

The maximum number of results to return for individual queries to the Drive API.

Change Conditions: The max number of requests per query can be increased or decreased. Recommended to remain at default for best performance.

Replace Comment Mentions with Display Name

Default Value: Off

Replace an email address mention in a comment with the associated user's display name.

Change Conditions: When enabled internal email addresses will be replaced in file comments with the user's display name which prevents email notification.

Preserve Modified Date

Default Value: On

When migrating Google Drive items, attempt to preserve the last modified date in the destination domain.

Change Conditions: The last modified date will become the migration date when disabled.

Allow Alternate Item Ownership

Default Value: Off

When migrating items, allow the owner to be changed if the actual owner does not exist or is disabled in the destination Google Workspace domain. WARNING: setting this option can cause the ownership of items to change, use only in specialized scenarios.

Change Conditions: When enabled items can change ownership if the owner does not exist in the destination. Not recommended unless advised by CloudM Support.

Batch Permissions

Default Value: Off

Use batching to provide faster, but more error prone, Google Drive migrations.

Change Conditions: When enabled permissions will be batched which can result in more errors and/or retries.

Skip Post Processing of Existing Items

Default Value: Off

Skip permission and parent folder patching of existing Drive items. Items that have been explicitly updated will still be processed.

Change Conditions: When enabled folders and permissions will not be patched when running delta migrations. This will improve performance but changes could be lost.

Document Conversion

Convert Text
Convert Presentations
Convert OCR
Convert Spreadsheets
Convert Drawings

Convert Text

Default Value: Off

Where possible, convert Text (.doc, .txt, etc.) documents to Google Documents format.

Change Conditions:

Convert Presentations

Default Value: Off

Where possible, convert Presentations (.ppt, etc.) to Google Documents format.

Change Conditions:

Convert OCR

Default Value: Off

Where possible, convert images (*.png, *.jpg, etc.) via OCR to Google Documents format.

Change Conditions:

Convert Spreadsheets

Default Value: Off

Where possible, convert Spreadsheets (*.csv, *.xls, etc.) to Google Documents format.

Change Conditions:

Convert Drawings

Default Value: Off

Where possible, convert Drawings (.wmf) to Google Documents format.

Change Conditions:

Shared Drive

Shared Drive File Permissions
Shared Drive Same Domain Migration Type
Shared Drive Default Managers
Migrate External Shared Drive Members
Shared Drive Folder Permissions
Migrate Shared Drive Members
Remove Shared Drive Default Managers

Shared Drive File Permissions

Default Value: File

Select how file permissions will be applied when migrating to Shared Drive.

Change Conditions: There are three options for how to handle file permissions: None - No file permissions migrated. File - Original file permissions migrated. Root - Any items on file ACLs will be added as members of the Shared Drive.

Shared Drive Same Domain Migration Type

Default Value: Move

When migrating a Google Drive to Shared Drive within the same domain, move or copy the files and folders.

Change Conditions: Move will move the items to the target Shared Drive and Copy will copy them while preserving the original.

Shared Drive Default Managers

Default Value: None

Specify the list of managers email addresses. Should be valid user emails. Group emails are not allowed. These will be applied temporarily during migration of the Shared Drive, in order to improve performance, and removed upon completion if 'Remove Shared Drive Default Managers' is set to true.

Change Conditions: A list of default managers can be added.

Migrate External Shared Drive Members

Default Value: Off

Migrate External Shared Drive members when migrating a Shared Drive to Shared Drive. Please note sharing with external users will also be migrated.

Change Conditions: When enabled external Shared Drive members will be migrated.

Shared Drive Folder Permissions

Default Value: None

Select how folder permissions will be applied when migrating to Shared Drive.

Change Conditions: There are three options for how to handle folder permissions: None - No folder permissions migrated. Folder - Original folder permissions migrated. Root - Any items on folder ACLs will be added as members of the Shared Drive.

Migrate Shared Drive Members

Default Value: Off

Migrate Shared Drive members when migrating a Shared Drive to Shared Drive.

Change Conditions: When enabled Shared Drive membership will be migrated.

Remove Shared Drive Default Managers

{: .no_toc } Default Value: Off

Remove the Shared Drive Default Managers specified in 'Shared Drive Default Managers' field.

Change Conditions: When enabled any default managers specified will be removed from the destination membership after the migration.

User

Check Users/Resources/Groups/Shared Drives Exist
Check Services Enabled
Create Users/Resources/Groups/Shared Drives
Change Password On Login

Check Users/Resources/Groups/Shared Drives Exist

Default Value: On

Check that users/resources/groups/shared drives exist within the destination system.

Change Conditions: When disabled the check for existing users/resources/groups/shared drives will not be performed before the migration.

Check Services Enabled

Default Value: Off

When running the 'Check Users' action, also check if the selected Google services for that user are enabled.

Change Conditions: When enabled an additional check will be performed to check the Google services (Gmail, Drive etc.) are enabled for the users. An error will be returned if any services are not enabled.

Create Users/Resources/Groups/Shared Drives

Default Value: Off

Create any Users (Resources, Groups or Shared Drives) that do not exist within the Google Workspace domain.

Change Conditions: When enabled any items that do not exist will be created prior to migration. Note: First Name, Last Name and Password is required to create users.

Change Password On Login

Default Value: Off

Set this to force the user to change their password on first login.

Change Conditions: When enabled destination users will be forced to change their password. This will occur after each migration run if enabled.

Transfer and Performance

Timeout
Retry Count
Modify Request
Drive Locks from Listed Users
Maximum Batch Count
Lock Retry Count
Multi-Server Drive Migration

Timeout

Default Value: 3600000

The timeout (in milliseconds) that will be used for all calls to the Google Workspace services. This should be set to a high value to ensure large transfers can be made, unless there is a specific reason to change it, the default value should be retained.

Change Conditions: Timeout value can be changed, not recommended for best performance.

Retry Count

Default Value: 20

The number of times a failed transfer will be attempted before aborting.

Change Conditions: Retry count value can be changed, not recommended for best performance.

Modify Request

Default Value: Off

Remove the 'Expect-100' header from requests (required for use behind some proxies).

Change Conditions: When enabled the 'Expect-100' header' will be removed. Only required in specific proxy scenario. Do not change unless instructed by CloudM Support.

Drive Locks from Listed Users

Default Value: Off

Use only users from the user list to obtain locks for Drive files when migrating in multi-server configurations. WARNING: You must always perform migrations with the same user list at any one time to use this option or duplicate items will be migrated.

Change Conditions: When enabled only users listed will be used to obtsin file locks. Can impact performance but reduce potential errors if there are lots of suspended or Drive-disabled users.

Maximum Batch Count

Default Value: 10

The count of (non-mail) items that will be sent in a single request. Maximum 100.

Change Conditions: Number of request items can be changed, not recommended.

Lock Retry Count

Default Value: 20

The number of times a failed distributed lock will be attempted before aborting.

Change Conditions: Retry count value can be changed, not recommended.

Multi-Server Drive Migration

Default Value: On

Allow Google Drive migrations to be run on multiple servers (may slightly degrade performance on a single server).

Change Conditions: Disables multi-server capability when off. Only disable when running a single server.