Google Drive File Stream

The Google File Stream service is a desktop solution created by Google which allows users to quickly access all of their files from their Google Drive account. Google Drive files are directly accessible from Google’s servers from the user’s Xi Frame session.

Requirements

  • A Xi Frame account.
  • The Google Drive Xi Frame integration must be disabled in order for GFS to function properly.

Initial Setup

  1. Start by navigating to the account Sandbox you would like to configure with Google Drive File Stream. Start the Sandbox session.

  2. Go to the following URL from the browser in your Sandbox session: https://dl.google.com/drive-file-stream/GoogleDriveFSSetup.exe

    Warning

    The installer URL above works only for Windows operating systems. The GFS integration is not available for Linux-based images.

  3. The GFS installer download should start automatically. When prompted, run the installer.

    ../_images/gfs_1.png
  4. A new prompt will appear asking you if you would like to install Google File Stream. Uncheck both boxes pertaining to shortcuts and click “Install.”

    ../_images/gfs_2.png
  5. When prompted to log in to your Google Drive account, simply close the window. When asked to Onboard to Frame, click “Cancel.”

  6. Another prompt will appear informing you that Google Drive File Stream has installed successfully. Click “Close.”

    ../_images/gfs_3.png
  7. Next, create a new directory in your C:\ProgramData Folder. The full path should be C:\ProgramData\Google\GFSCache

    Note

    You will need to enable the ability to show hidden items in your file browser in order to find the “ProgramData” folder.

  8. Navigate to your system tray and find the Google Drive File Stream icon.

    ../_images/gfs_4.png
  9. Click on the gear icon in the upper right corner of the Drive File Stream window and select “Preferences…”

    ../_images/gfs_5.png
  10. Uncheck the “Launch Drive File Stream on system startup” check box and change the “Local cached files directory” to the new file path you created earlier (as shown below).

    ../_images/gfs_6.png
  11. Click “OK” when you have updated the preferences above. Proceed when prompted to restart Drive File Stream. Ignore all prompts to log in to Drive File Stream.

  12. Navigate back to the Drive File Stream icon in the system tray, click on it, and select “Quit” from the gear icon menu.

    ../_images/gfs_7.png
  13. Navigate to and delete the following folder in your Sandbox session:

    C:\Users\Frame\AppData\Local\Google\DriveFS

  14. Now, close your Sandbox session and shut down your Sandbox from your Dashboard.

  15. From your Dashboard, navigate to the “Settings” page, click on the “Profiles” tab and enable “Basic Profiles.”

    ../_images/gfs_8.png
  16. Once enabled, you will see three new fields populate under the “Basic Profiles” section. In the “Folders to persist” field, enter C:\ProgramData\Frame\GFS. Be sure to click “Save” once completed.

    ../_images/gfs_9.png
  17. From the same “Settings” page of your Dashboard, click on the “Session” tab.

  18. Scroll down to the “Advanced options” section and enter -hookapp GoogleDriveFS in the “Advanced Server Arguments” field, as show below:

    ../_images/gfs_10.png
  19. Click “Save” in the upper right corner of the screen.

  20. Navigate back to your Sandbox and start your Sandbox session. Enter the session and confirm that Google Drive File Stream has not started automatically.

Warning

Do not publish your Sandbox changes.

Disable Auto Update

The second set of instructions will walk you through how to disable the auto update feature for Google Drive File Stream. These steps are required in order to prevent communication issues between the Sandbox and Production instances. Disabling auto updates is simple. Follow the steps as they are described below:

  1. If you have not already done so, start and launch your Sandbox session. Navigate to http://dl.google.com/update2/enterprise/googleupdateadmx.zip in your web browser.
  2. Open the GoogleUpdateAdmx folder.
  3. Copy google.admx and GoogleUpdate.admx and put them in your Policy Definitions folder. (Example: C:\Windows\PolicyDefinitions)
  4. In the GoogleUpdateAdmx/en-US folder, copy the google.adml and GoogleUpdate.adml files and put them in the en-US folder in Policy Definitions. (Example: C:\Windows\PolicyDefinitions\en-US).
  5. Navigate to “Group Policy” and go to Computer Configuration > Policies > Administrative Template > Google > Google Update to verify that the template loaded correctly.
  6. Next, go to Google > Google Update > Applications
  7. Enable the “Update policy override default policy.”
  8. Under “Options,” select “Updates disabled” from the drop-down menu.

Contact Xi Frame Support

The final step requires you to contact the Xi Frame Support team and inform them that you would like to complete the process of setting up Google Drive File Stream. When you create your Support case please provide the following:

  • Case Subject: “Complete Google File Stream Setup”

  • Case Body:
    • Your email address
    • Account name
    • Explicit written permission for support to access your account and make changes to your Sandbox

From this point, a Xi Frame Support representative will take over and finish up the process to enable Google Drive File Stream for your account. Support intervention is required since there are backend components of the Frame platform that need to be modified in order for the integration to work.