Migrating from Google Vault

Setting up a service account and Google APIs

In order to access your users' email, files etc. you will need to create a google project and set up a service account. You will also need to enable the relevant APIs.

Firstly, go to your google cloud console, (login as an administrator if you are not already) and click 'Project' at the top and then 'Create Project'.

Enter a name for your project and click 'Create'.

When you have created your project, click on the options menu  in the top left of the page, then 'API Manager', then 'Credentials'. Click on 'New credentials' and then 'Service account key'

Next, select 'New service account', name it anything and select 'Project' and then 'Owner' as the role from the dropdown list, finally select P12 as the key type and click 'Create'. Upon clicking 'Create', a P12 file will be downloaded; this is important for later so keep a note of where you downloaded it.

Dismiss the dialog box and on the right hand side of the page, click 'Manage service accounts' and click the three dots  beside your service account, then select 'Edit'

You should now be met with the edit service account window, check 'Enable Google Apps Domain-wide Delegation' and click 'Configure consent screen'.

Next, give your product any name you wish and click 'Save' to be taken back to the previous window. Click 'Save' again.

Now make a note of the email address of the service account you just made as you will need this later to configure Cloud M Migrate. Click 'View Client ID' in the right most column of the service account table and make a note of that too.

Next, click on the options menu  again, then 'API Manager', then 'Library'. This will take you to a page where you can search for and enable various google APIs, just use the search box and the enable button at the top of each APIs respective page to enable to following APIs.

• Admin SDK
• Drive API
• Gmail API
• Calendar API
• Contacts API
• Tasks API
• Groups Migration API
• Google Vault API
• Google Storage API

Nearly there! Once all the APIs are enabled, launch the Google Apps Admin Console for your source domain.

Go to 'Security', then to 'Show More', then to 'Advanced Settings' and then finally to 'Manage API client access'. Enter the Client ID you noted earlier into the 'Client Name' field and paste the following into the 'Scopes' field:

https://www.googleapis.com/auth/admin.directory.resource.calendar, https://apps-apis.google.com/a/feeds/emailsettings/2.0/, https://mail.google.com/, https://sites.google.com/feeds/, https://www.google.com/m8/feeds, https://www.googleapis.com/auth/admin.directory.group, https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/apps.groups.migration, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/email.migration, https://www.googleapis.com/auth/tasks, https://www.googleapis.com/auth/gmail.settings.basic, https://www.googleapis.com/auth/ediscovery, https://www.googleapis.com/auth/ediscovery.readonly, https://www.googleapis.com/auth/devstorage.read_write

Finally, click on 'Authorize' on the right on the 'Scopes' field and an entry for your Client ID and its associated now-accessible APIs will appear. Do this for both the source and destination domains.

Choose Google Vault as the migration source and enter your Google Vault settings into Cloud M Migrate and then click next.

• Domain Name - The domain name you will be migrating from. This should be the Internet domain name, not the local domain name.
• Admin Email - The email address of a super admin account for the primary G Suite domain. If migrating using multiple workstations, use one super admin user per workstation.
• Service Account Email Address - Before attempting to configure Cloud M Migrate, you should have created a google cloud platform project and created a service account for it. Input the service account's email address in this field.
• Private Key Path - The file path to the P12 key that was generated and downloaded when creating the service account.

Cloud M Migrate will now perform a small connection test to verify that the details you have entered are correct. If this fails you may have entered something incorrectly. If you are failing to resolve the issue please contact CloudM Support.

Select G Suite as your destination platform.

Select where you would like your data to be migrated. If you have purchased G Suite for Business or Google Vault you may want to migrate data directly into Google Vault.

To enable Google Vault for your domain, please see the following article: http://support.google.com/vault/bin/answer.py?hl=en&answer=2584132

Enter information for your G Suite admin account.

Cloud M Migrate will perform a connection test against your G Suite domain to verify that everything has been entered correctly.

It's now time to add which users you'd like to migrate.

When migrating from Google Vault you may be able to Get Users from the actions menu. If this option is unavailable, you can manually import users via a CSV file or simply add them individually via the plus icon.

Selecting a star next to any specific user or users will prioritize their migration. When a migration starts, threads will be assigned to any starred user so that their migration can start immediately. 

At this point you can choose what to migrate for each user, when migrating from Google Vault you can migrate mail 

Enter your user's full email address within the Export Name field. If you have already created your G Suite users then you will just need to enter their username.

Cloud M Migrate lets you decide how much mail you'd like to migrate to your shiny new system.

If you are changing your email address as part of the migration you can verify that the domain names are correct here. You can also specify specific address replacements in the respective section of the advanced settings.

For more information on domain and address replacements, see this page.

We know that you may want to start your migration in the middle of the night, or over the weekend, but we don't expect you to stay up in order to do so. With Cloud M Migrate, you can decide to schedule exactly when you'd like the migration to occur.

Start the migration.

During the migration process, Cloud M Migrate will report back in real time exactly who is being migrated and the items being processed. All you now need to do is sit back, relax and wait for your migration to complete.

Check the progress of your migration.

Once complete you can download a full report for your migration.

For more information about this page, please visit the summary page.

Conversion table - Google documents

Documents that are created in G Suite applications will be converted to the following Microsoft Office formats when migrated: