Navigation
Basic Operations
Home
Issues & Requests
Member API
Partner Tools
Recent Changes
test page
 

Restoration

To restore a bag, find the intellectual object you want to retrieve and click the Restore Object button.

This adds a restoration task to the work queue, which you can monitor by clicking the Processed Items tab, or by calling the Items endpoint of the Member API.


The restoration process can take anywhere from a few minutes to a few hours, depending on the amount of traffic our system is handling and the size of the bag. Larger bags always take longer to restore, because we calculate md5 and sha256 checksums on the bag's contents. 

When we restore a bag, we retrieve all of the intellectual object's files from long-term storage, verify the checksums, reassemble the bag, write the manifests, tar up the bag, and leave it in your receiving bucket. When that's done, the Processed Items list will show your bag with a green background, with Action = Restore, Stage = Resolve, and Status = Success, like the first item in the list above.

It's up to you then to retrieve and delete the item from your restoration bucket. Your restoration bucket for the demo system is:

aptrust.restore.test.<institution.domain>

For the production system, it's:

aptrust.restore.<institution.domain>

Replace <institution.domain> with your organization's domain name. For example, virginia.edu, jhu.edu, etc. You can download your bags using Amazon's S3 CLI tools, or by integrating one of Amazon's S3 client libraries into your own tools, or by using APTrust's partner tools.

Format and Contents of Restored Bags

According to the "Other Files" section of our old documentation,  APTrust did not preserve or restore custom tag files. That changed as of March 29, 2016. 

When you restore a bag that was ingested after March 29, 2016, the version you get back will have the same contents and format of the bag you originally uploaded, except:
  • Individual files you deleted through our Web UI will not be restored.
  • The restored bag will include the following manifests:
    • manifest-md5.txt
    • manifest-sha256.txt
    • tagmanifest-md5.txt
    • tagmanifest-sha256.txt
  • All tag files will be listed in the tag manifests, even those that were omitted from tag manifests in the original upload.
  • If you uploaded multiple versions of the same bag with the same name, you'll see the following:
    • The restored bag contains the latest (last uploaded) version of each file.
    • Files that were not included in the later versions of a bag you uploaded multiple times, but were present in earlier versions, will be present in the restored version unless you manually deleted them through our Web UI. (Our policy not to delete your content. You have to do that deliberately.) 
Bags ingested prior to March 29, 2016, will be restored with the same contents as above, except:
  • No custom tag files will be restored, because we didn't preserve them.
  • The bag-info.txt file may differ from the one you uploaded, because we did not store. We reconstitute it upon restoration, including only a minimum of information. This means you may lose some valuable tag data.


Updated on Mar 29, 2016 by Andrew Diamond (Version 5)


Attachments (2)

ProcessedItems.png - on Mar 29, 2016 by Andrew Diamond (Version 1)

IntelObj.png - on Mar 29, 2016 by Andrew Diamond (Version 1)