...

In the above example, the package "aip4567.zip" is restored to the DSpace installation with the Handle provided within the package itself (and added as a child of the parent object specified within the package itself). In addition, any child AIPs referenced by "aip4567.zip" in the folder "/path/to/children-aips" are also recursively ingested. They are also restored with the Handles & Parent Objects provided with their package. If any object is found to already exist, it is skipped over (child objects are also skipped). All non-existing objects are restored.

Restoring Entire Site

Details Coming Soon! In all likelihood it will take the same parameters as the "Exporting entire Site", except that you'll be running the packager in -r (restore) mode.

Testing Special Cases during Restore/Replace

The below special cases need further testing, especially when performing a "Restore" or "Replace". Mostly, these are just notes for Tim (and other developers), to ensure that all these various "edge" cases can be restored properly (or perhaps not restored properly, if the decision is made that it needs not be restored).

As each special case is implemented, we can check off the item in the below list.

Item Restoration/Replacement

Special Cases

• Restore existing License from AIP – i.e. do not add a new license (or change the license) during restore/replace
• Restore item mappings to multiple collections (for items which are mapped to several collections)
• Restore withdrawal state
• Restore embargo state
• Restore permissions & roles (user/group permissions), if possible
• Options to restore just metadata or just particular bitstreams/bundles?
• Will not restore items which have not made it into the "archived" state. In other words, at this time, there are no plans to restore WorkspaceItems or WorkflowItems.

Collection Restoration/Replacement

Special Cases

• Restore permissions & roles (user/group permissions), if possible
• Restore Collection-specific license
• Restore Collection's Item Template?
• Restore Collection's content source info? (e.g. OAI-Harvesting Collections versus normal Collections)

Community Restoration/Replacement

Special Cases

• Restore permissions & roles (user/group permissions), if possible

Discussion / Use Cases

Please add your own potential use cases or discussion topics

...