Getting started with the Library Switcher

The Library Switcher lets you switch the storage platform of your AODocs libraries from Google Drive to Google Cloud Storage or Azure Blob Storage. This process is done by the AODocs Service team.

Learn more:

This article describes the prerequisites for using the Library Switcher.

Important: Before using the Library Switcher, contact your sales representative or send an email to sales@aodocs.com. They will guide you through the initial steps. 


Prerequisites

On the AODocs side

The AODocs Service team will activate Google Cloud Services storage or Azure Blob Storage on your AODocs domain. 

Note: AODocs Content Services licenses are required to activate Google Cloud Storage or Azure Blob Storage on your AODocs domain. Contact your Sales representative or send an email to sales@aodocs.com.

On your side

1. Make sure that no users access the library or Google Drive during the switch.

2. You need the AODocs service account ao-docs-library-switch@appspot.gserviceaccount.com to perform a switch.

During the switch process, actions are performed in the name of this service account – you must temporarily:

Learn more about service accounts from the Google Help Center.

Note: The service account consumes a license on your domain for the duration of the switch. Learn more: How are user licenses allocated in AODocs?

3. Prepare your library:

  • Check in all documents in your library.
    If any documents are checked out, a switch creation error occurs and the switch doesn't start. Learn more: 
  • Make sure Documents are read-only when not checked out is not set in the document class or workflow settings.
  • You are recommended to remove any documents from the trash. All documents in the trash are ignored during the switch process.
  • You must deactivate any "Update action" type custom scripts. To do this, delete all your update custom actions defined in the Custom tab in the Document classes section of the library administration. You don't need to delete the associated custom script.

Learn more: Custom scripts.

image01.png

  • Remove or replace any files identified by Google as malware. They can't be processed by the Library Switcher and are removed from the document if you run the library switch without removing them first.
  • Remove attachment types from documents that aren't supported by the Library Switcher. Learn more about which file types are incompatible with the Library Switcher.  
  • Remove or fix any attachments with invalid values or with evaluation errors. They can't be processed by the Library Switcher. 
  • Make sure no documents have more than 45 attachments.

Tip: To identify invalid values and evaluation errors you can configure columns or set up filters in views. 
image02.png

Was this article helpful? 1 out of 1 found this helpful
If you didn’t find what you were looking for, don’t hesitate to leave a comment!
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.