Thank you for stopping by! We're glad you're interested in trying out the Dataverse-Archivematica demonstration sandbox hosted by Scholars Portal. This page contains information on how to access the sandbox, notes on its limitations, and a description of the workflow to use it.
Scholars Portal sponsored Artefactual Systems Inc. to develop the ability for the preservation processing tool Archivematica to receive packages from connected Dataverse instances. The integration was released as part of Archivematica 1.8 in 2018. The sandbox has been updated to Archivematica v. 1.13.2.
You can read more about the project at the Dataverse-Archivematica wiki page as well as in Meghan Goodchild and Grant Hurley's 2019 iPres paper and presentation slides here: https://osf.io/wqbvy.
There are a handful of documented issues with the integration available in the Archivematica issues repository in GitHub. These impact especially the treatment of tabular derivative files and how they are represented in the AIP's METS file.
Please note that individuals at institutions that are members of the Ontario Council of University Libraries (OCUL) can access the sandbox as-is with the credentials below. If you are from an institution outside of OCUL, please email firstname.lastname@example.org to request access.
We are seeking feedback on the integration to identify areas for future development. Please send your feedback to email@example.com.
If you have any questions, or are experiencing technical issues? Send them to firstname.lastname@example.org too!
The sandbox is available at: https://archocul.scholarsportal.info/
Members of OCUL can access the sandbox without further setup - you're good to go!
All users outside of OCUL schools must submit a request to gain access to the instance. Please email email@example.com.
The sandbox is connected to a test Dataverse repository in Scholars Portal's demonstration Dataverse. The test Dataverse contains three sample datasets for testing purposes.
If you'd like to submit your own data to test, you may do so but you will need to create an account on the Demo Dataverse instance first. Your dataset will be reviewed by Scholars Portal staff and you will be informed whether it is suitable to open for testing. To submit a dataset for review, navigate to the Archivematica Test Dataverse and click the "Add Data" button on the right side. If you need instructions on how to add datasets, see this guide starting from step 3. Please also note that if you submit your own test data, it will be available to anyone who has access to the sandbox.
Visit the Dataverse page on Archivematica's wiki, as well as the Dataverse documentation for Archivematica and the Archivematica storage service for lots more documentation.
This workflow is specific to the Dataverse integration. OCUL users can also request instructions on testing other kinds of transfers by e-mailing firstname.lastname@example.org.
Need a quick intro to Archivematica? Check out the Overview guide in Archivematica's documentation.
Made an AIP and not sure what the heck it is? Check out the Archivematica Documentation's page on this subject.
3. Under ‘Transfer type’ select "Dataverse" as pictured above.
4. Enter a transfer name. You can leave "Accession no." and "Access system ID" blank.
5. Hit the 'Browse' button.
6. A window will pop up showing the available applicable transfers in the transfer source. Click on the dropdown menu that shows "Transfer Source in Swift via SVFS" and select instead "Archivematica Test on Demo Dataverse." The three sample datasets will appear as pictured below.
7. Select one of these transfers by clicking on it.
8. Click the blue ‘Add’ button. The transfer will be added to the top of the pane. If you add additional transfers at this stage, they will be processed separately.
9. Click the green “Start transfer” button and you’re off to the races! You may have to wait a few hot seconds until the transfer begins processing, so please be patient. Note: if the "Approve automatically" checkbox is clicked under the "Browse" button as pictured above, your transfer will begin running up to the file identification step. If the box is not checked, you will have to approve the transfer to initiate it.
The transfer steps are determined based on a standard configuration with some option-based stops along the way. It also does not make use of the backlog/appraisal functions, but you are welcome to do so. Consult the appropriate documentation to use these functions here.
You can search and download AIPs via the Archivematica interface.
3. To access a stored AIP, click on its name or UUID (universally unique identifier).
4. To download an AIP, click on the "Download" button (circled in purple).
5. Additional actions, such as re-ingest and deletion are available under "Actions." Note that re-ingest does not function with Dataverse packages, and stored packages are automatically deleted every evening, so there is no need to submit a delete request.
6. Archivematica by default compresses AIPs as 7z files, an open source type of zip file.
If you are in Windows, download 7-Zip to extract 7z files. In OSX, try out The Unarchiver.
By default, Archivematica compresses AIPs as 7z files, which is an open source type of zip archive. When you download a 7z-compressed AIP, you will need the 7Zip extraction software to extract the files. 7z files can be opened in Windows with the 7-Zip utility. OSX users can use the Unarchiver. For 7-Zip in Windows:
Here's how to open 7z files in Windows once you've installed 7-Zip:
A. Right-click on the file. Under 7-Zip, select "Extract files."
B. Another window will pop up. Select OK.
C. Navigate to your file folder and check out your AIP.
You can open your METS file with a text editor like Notepad++ or Sublime Text, or upload it to METSFlask (or run METSFlask on your own system if you want to keep the files private). Not sure what a METS file is? What to know more about the structure of an AIP? Check out the Archivematica documentation.
Accessing stored DIPs is not offered as part of the sandbox, as doing so requires navigating directly to storage. Please contact us if you wish to access a DIP.
We are currently seeking feedback on the integration to identify areas for future development. Please send your feedback to email@example.com.