A Replication request serves as the primary data structure a node looks at when attempting to replicate a bag. It contains (most of) the information necessary to replicate a bag and verify that it was successful.
Replication
replicationId: Long
node: Node // Correlated Node
status: ReplicationStatus // enum
bag: Long // Correlated Bag
bagLink: String // uri to download the bag
tokenLink: String // uri to download the token store
protocol: String // currently only rsync, will be expanded in the future maybe
receivedTagFixity: String // set by the replicating node on completion of transfer of the Bag
receivedTokenFixity: String // set by the replicating node on completion of transfer of the ACE Token Store
Example: {
"replicationID": 4,
"status": "STARTED",
"bagID": 1,
"bagLink": "chrono@chronopolis-stage:/export/bags/test-bag-0",
"tokenLink": "chrono@chronopolis-stage:/export/tokens/test-bag-0-tokens",
"protocol": "rsync",
"receivedTagFixity": "",
"receivedTokenFixity": ""
}
ReplicationStatus
Enumerated type describing the current state a replication request is in.
- PENDING - Set by the Ingest-Server. A request has been made and is waiting for acknowledgement/transfer.
- STARTED - Set by the Replicating Node. Acknowledges the existence of a transfer, and replication is likely queued if not started.
- TRANSFERRED - Set by the Ingest Server. Both the transfer of the ACE Token Store and Bag have been completed and are valid.
- ACE_REGISTERED - Set by the Replicating Node. The collection has been registered in ACE.
- ACE_TOKEN_LOADED - Set by the Replicating Node. The token store has been uploaded to the collection in ACE.
- ACE_AUDITING - Set by the Replicating Node. The collection in ACE is auditing.
- SUCCESS - Set by the Replicating Node. Acknowledges that the ACE audit was successful.
- FAILURE_TOKEN_STORE - Set by the Ingest-Server. The received fixity value for the token store was incorrect.
- FAILURE_TAG_MANIFEST - Set by the Ingest-Server. The received fixity value for the tagmanifest was incorrect.
- FAILURE - Set by the Replicating Node. There was a general failure in transfer of the content.