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| Field | Type | Description |
|---|---|---|
| id | Long | The ID of the Replication |
| createdAt | DateTime | The time of creation |
| updatedAt | DateTime | The last time the Replication was modified |
| status | ReplicationStatus | The status of the Replication |
| bagLink | String | URI to download the bag |
| tokenLink | String | URI to download the token store |
| protocol | String | The protocol to use for replication |
| receivedTagFixity | String | The computed fixity of the Bag (currently the sha256sum of the tagmanifest) |
| receivedTokenFixity | String | The computed fixity of the TokenStore (currently sha256) |
| node | Node | The replicating Node |
| bag | Bag | The bag being replicated |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
|
...
"id": 1, |
...
|
...
|
...
|
...
|
...
"createdAt": "2016-06-07T12:26:18.13944Z", "updatedAt": "2016-06-07T12:26:18.13944Z", |
...
|
...
"status": "SUCCESS", "bagLink": "chronopolis@chron-ingest.ucsd.edu:/export/outgoing/ |
...
bags/prodtest000/bb0102820h", "tokenLink": "chronopolis@chron-ingest.ucsd.edu:/export/outgoing/tokens/prodtest000/bb0102820h2015-06-04", |
...
|
...
|
...
|
...
|
...
|
...
|
...
"protocol": |
...
"rsync", |
...
"receivedTagFixity": "c1d96946d276079b300ccc05118f63fb04eaec256df9a7faa3438e785e388525",
"receivedTokenFixity": "8bcc01d4ec3651da33e6e127821ced0a69e38a8b15c3b63e93ced8903169a555",
"node": "umiacs",
"bag": {...}
} |
...
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 Replicating NodeIngest 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 Ingest-ServerReplicating Node. Acknowledges that the transfer was valid and the received fixity values are correctACE 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.