Addons

Nuxeo Cold Storage

Updated: October 1, 2024

The Nuxeo Cold Storage addon allows you to optimize your costs by storing your archived content into a long-term storage solution that leverages AWS's Glacier service. See frequently asked questions - principles for additional information around cost principles. Content can be sent individually or in bulk and while under cold storage, content can still be previewed and searched for.

The addon is based on the usage of Amazon S3 Glacier Flexible Retrieval (formerly Glacier) to store cold content.

Functional Overview

Send to Cold Storage

Once the Nuxeo rendition of the document is available, the user can trigger the flow by clicking on Send to cold storage button.

Sending content to cold storage requires the dedicated WriteColdStorage permission.

This will immediately turn the storage class of the document's main file into the Glacier class.

While the file is under cold storage, a low-resolution preview is provided to the users instead of the original file so that users can keep accessing, viewing the content (or a sample of it by default for files with multiple pages) and working with the document. The document remains searchable as well.

For additional details on the rendition used depending on the file type, refer to the preview file configuration section of the addon installation documentation.

Send Multiple Documents to Cold Storage

There's an option to send multiple documents to cold storage as long as all of them satisfy the requirements:

  • They are not yet in cold storage
  • The user has the correct permission

Select the files that you want to upload and there will be an action button to move them to cold storage.

Send Multiple To Coldstorage

For moving content in bulk, refer to frequently asked questions - content ingestion.

Retrieve from Cold Storage

When the user wants to have temporary access to the full file for download, he/she can trigger the retrieve flow.

Restore from coldstorage button

The user can then trigger the flow by clicking on the restore button. This is an asynchronous process that takes 3 to 5 hours to complete. Therefore, a banner is displayed on the document stating that the retrieve is in process, and the Nuxeo Platform monitors regularly the status of the retrieval.

Retrieve from Coldstorage

The frequency at which cold storage content retrieval is checked is configurable. See the cold storage configuration page for how to change this value.

When the Nuxeo Platform detects that the retrieval is done, an email is sent to the user and the banner displays information about the preview availability and the option to download the content.

Retrieved from Coldstorage

By default, the file will be available for download for 24h. That value can be changed for all files by adding a configuration to the nuxeo.conf file. So, for example, if we want the file available for 48 hours, we can add:

nuxeo.coldstorage.numberOfDaysOfAvailability.value.default= 2

Restore from Cold Storage

When you no longer want the file to be stored in cold storage, you can request a restore by clicking on the restore button. The operation is also asynchronous, and the user will be notified via email once it's completed and the banner will disappear. The send to cold storage button will be available again.

Restore from Coldstorage button

Delete from Cold Storage

You can delete a document moved to cold storage as any other document.

Technical Overview

Flowchart

Move to Nuxeo Cold Storage

moveToColdstorageFlowChart

Retrieve from Nuxeo Cold Storage

retrieveFromColdstorageFlowChart

Restore from Nuxeo Cold Storage

restoreFromColdstorageFlowChart

Learn More

For a deeper look into the specifics of the addon, feel free to take a look at our frequently asked questions about the cold storage addon.