Set up and configure the Google Vault Extractor

To migrate Google Vault data, BitTitan uses the utility Google Vault Extractor.  Google Vault Extractor creates a matter for each user, searches their Vault, then, extracts and exports the information. The export will download a copy of the searched results to a local Export Server before uploading it to a predefined Azure BLOB container. Once the data is accessible in the Azure BLOB container, MigrationWiz will migrate the data. 

In this article, you will find information on the commands available in Google Vault Extractor, as well as a  command you can use to extract most Google Vault environments. 

Export Server Setup 

1. BitTitan requires Google Vault Extractor be run from a locally managed server. This export server is setup and maintained by the customer. The export server is a requirement and not provided by BitTitan. It can be a local workstation, on-premise server, or a virtual server. 
2. Prepare the export server, to run the Google Vault Extractor and store the exported files. Requirements for the client: 

a. Internet access. The server needs to be able to access Google Vault and Microsoft Azure.

b. Windows 7+ or Server 2008+.  

c. Enough free storage to hold the Google Vault exports. This is determined by the number of users you want to export per batch.

After the data is searched and prepared for export by Google, the file is downloaded to the Export Server then uploaded to the Azure BLOB. Storage management is critical on the Export Server.  

d. Local administrator rights to run a command prompt.

e. .NET Framework version 4.6.1 or later installed.

3. Download and install the Google Vault Extractor  here.  

a. The installation routine will place a shortcut (GoogleVaultExport.lnk) on the desktop and a folder in this location:  %userprofile%\AppData\Local\GoogleVaultExport. 

b. Create a folder on your data disk. This folder will be used as the working directory (e.g. \GVault).

c. Copy the GoogleVaultExport.lnk shortcut from step a, into the folder.

d. The Create and Export folder inside the folder you just created in the step above (e.g. \GVault\Export) will appear like this:

4. Download and install UploaderWiz.  

a. Refer to the article Installing and Using BitTitan UploaderWiz for instructions on how to use UploaderWiz. 

b. Copy the UploaderWiz.exe and UploaderWiz.exe.config files.

In order for the Google Vault Extractor to use UploaderWiz, UploaderWiz needs to be copied into the install directory of Google Vault Extractor. 

c. Paste the files into the current version install directory of Google Vault Extractor: %userprofile%\AppData\Local\GoogleVaultExport\app-??????  

Updates

By default, every time the Google Vault Extractor is started, it checks and installs available updates. As part of the update, a new folder is created (with a new version number) under %userprofile%\AppData\Local\GoogleVaultExport\.

Once a Google Vault Extractor update is completed, the following manual steps are required:

• The GoogleVaultExport.lnk shortcut file in your working directory (e.g. \GVault) should be updated.

• UploaderWiz.exe and UploaderWiz.exe.config files should be copied over to the latest install directory of Google Vault Extractor (%userprofile%\AppData\Local\GoogleVaultExport\app-xxxxx)

Disable auto updates

Follow the steps below if you prefer to disable Google Vault extractor auto updates:

1. Navigate to the latest install directory of Google Vault Extractor (%userprofile%\AppData\Local\GoogleVaultExport\app-xxxxx)

2. Locate ‘App.config’ file and open it in edit mode:

   1. Remove or comment out the AutoUpdate link (GoogleVaultUpdateUrl)

   2. Save file

3. Locate ‘GoogleVaultExport.exe.config’ file and open it in edit mode:

   1. Remove or comment out AutoUpdate link (GoogleVaultUpdateUrl)

   2. Save file

Commenting out a statement

To comment out a statement you should:

• add <!-- at the beginning of the statement to mark the start of comment and

• add --> at the end of statement to mark the end comment.

• example:

<!-- <add key="GoogleVaultUpdateUrl" value="https://api.bittitan.net/public/downloads/GoogleVaultExport"/> -->

The end result will look like this: