Difference between revisions of "UM transfer"

From Archivematica
Jump to navigation Jump to search
Line 88: Line 88:
 
#When a micro-service fails or encounters an error, the micro-service background turns from green to pink and a "failed" icon appears next to the transfer or SIP name. See [[UM error handling|Error handling]] for more information about how to handle an error.
 
#When a micro-service fails or encounters an error, the micro-service background turns from green to pink and a "failed" icon appears next to the transfer or SIP name. See [[UM error handling|Error handling]] for more information about how to handle an error.
  
#Once the transfer micro-services are completed, a bell icon will appear next to the transfer. This means that the transfer is ready to be packaged into a SIP for ingest ('''figure 5'''). Select "Create single SIP and continue processing" See [[UM ingest|Ingest]] for next steps.[[Image:CreateSingleSip.png|600px|right|thumb|'''Figure 5'''  A transfer that is ready to be packaged into a SIP and moved into ingest]]
+
#Once the transfer micro-services are completed, a bell icon will appear next to the transfer. This means that the transfer is ready to be packaged into a SIP for ingest ('''figure 5'''). Select "Create single SIP and continue processing". (Note that Create SIP(s) manually is not currently functional. However, the ability to create one or more SIP(s) from one or more transfer(s) will return in Archivematica 1.0 with improved functionality in the web browser. See [File_Browser_Requirements|File browser requirements - Create SIP] and [Transfer_and_SIP_creation|Transfer and SIP creation workflows) 
 +
 
 +
#See [[UM ingest|Ingest]] for next steps.[[Image:CreateSingleSip.png|600px|right|thumb|'''Figure 5'''  A transfer that is ready to be packaged into a SIP and moved into ingest]]

Revision as of 14:52, 23 August 2012

Main Page > Documentation > User manual > User manual 0.9 > Transfer


General description

During transfer, the user moves digital objects from source directories accessible via the MCP server into Archivematica. See Administrator manual for instructions on how to set up shared source directories. Once uploaded to the dashboard, transfers run through several micro-services: UUID assignment; checksum verification (if checksums are present); package extraction (i.e. unzipping of zipped or otherwise packaged files); virus checking; indexing; format identification and validation; and metadata extraction. For a definition of "transfer", please see the Glossary.

At the end of transfer, the user creates a SIP from one or more standard transfer(s). Once this is done, the SIP is moved into ingest.

If your transfer is a DSpace export, please see DSpace export.

If your transfer is a CONTENTdm export, please see CONTENTdm export

If your transfer is a bag or a zipped bag, please see Bags

If your transfer is an email transfer, this feature is still under development, please see [[]]

If your transfer is composed of objects that are the result of digitization, please see Digitization output.

Create a transfer

Open the web browser and the Archivematica dashboard to sign in (figure 1). Default user name is demo, with password demo.

Figure 1 Log in to the Archivematica dashboard

Option 1

Use this option if you do not wish to structure your transfer using the file browser or include submission documentation.

  1. In transfer tab, name your transfer and browse to a source directory to select your object or set of objects for upload. Your transfer can be composed of multiple directories and files from different source directories. Repeat this step if your transfer is composed from multiple sources. (figure 2)
    Figure 2 Select transfer(s) from source directory(ies)
  1. Once all of your digital object sources have been uploaded, hit the Start Transfer button for the transfer processing to begin. (figure 3)
    Figure 3 Start transfer

Option 2

Use this option if you wish to compile your objects and/or directories into a folder ready for processing using the file browser interface.

  1. Navigate to a directory of files to be preserved.
  1. Right-click the directory and select "Restructure for compliance". This will create a structured directory containing the subdirectories required to transfer the files into Archivematica: logs, metadata, objects. You can create subdirectories within objects if desired.(Note that in Option 1, these subdirectories were automatically generated when you hit Start Transfer)
  1. If you would like to add Submission Documentation, in the transfer you have just created, navigate to the /metadata/submissionDocumentation folder and add files if desired. These files could be donor agreements, transfer forms, copyright agreements and any correspondence or other documentation relating to the transfer. Any SIPs subsequently made from this transfer will automatically contain copies of this documentation.
  1. To upload your transfer into Archivematica and begin processing, follow the steps in Option 1.

Process the transfer

  1. In the dashboard transfer tab, the transfer will appear in the dashboard with a bell icon next to it. This means that it is awaiting a decision by the user. (figure 4)
    Figure 4 In the Actions drop-down menu, select "Approve transfer"
  1. Click on the micro-service to display jobs that have completed, including the one requiring action.
  1. In the Actions drop-down menu, select "Approve transfer" to begin processing the transfer (figure 4). You may also "Reject transfer" and quit processing.
  1. The transfer will now run through a series of micro-services. These include:
    • Verify transfer compliance (verifies that the transfer is properly structured - i.e. with the logs, metadata and objects folders)
    • Create transfer UUID (assigns a unique universal identifier for the transfer as a whole)
    • Assign file UUIDs to objects (assigns a unique universal identifier to each file in the /objects directory)
    • Verify metadata directory checksums (verifies any checksums included with the transfer)
    • Assign checksums to objects (assigns a sha-256 checksum to each file in the /objects directory)
    • Generate METS.xml document (creates a METS file capturing the original order of the transfer. This METS file is added to any SIPs generated from this transfer)
    • Extract packages (extracts contents from zipped or otherwise packaged files)
    • Sanitize object's file and directory names (removes prohibited characters from folder and filenames, such as ampersands)
    • Scan for viruses (scans for viruses and malware)
    • Characterize and extract metadata (identifies and validates file formats; extracts technical metadata embedded in the files)
    • Index transfer (Indexes transfer)
  1. A transfer that is in the middle of processing will show which micro-services have been completed (green) and which are in progress (orange).
  1. When a micro-service fails or encounters an error, the micro-service background turns from green to pink and a "failed" icon appears next to the transfer or SIP name. See Error handling for more information about how to handle an error.
  1. Once the transfer micro-services are completed, a bell icon will appear next to the transfer. This means that the transfer is ready to be packaged into a SIP for ingest (figure 5). Select "Create single SIP and continue processing". (Note that Create SIP(s) manually is not currently functional. However, the ability to create one or more SIP(s) from one or more transfer(s) will return in Archivematica 1.0 with improved functionality in the web browser. See [File_Browser_Requirements|File browser requirements - Create SIP] and [Transfer_and_SIP_creation|Transfer and SIP creation workflows)
  1. See Ingest for next steps.
    Figure 5 A transfer that is ready to be packaged into a SIP and moved into ingest