Compare registered Minoc files with verify¶
Use verify to check whether the Minoc files recorded by Datatrail have consistent
metadata in Minoc and the Luskan inventory. Datatrail supplies the file list;
verify compares the sizes and MD5 checksums reported by the two CADC services.
datatrail verify chime.event.baseband.raw EVENT_ID
Replace the scope and EVENT_ID with your dataset's actual identifiers. The CLI
needs its normal configuration and a valid CADC certificate with service access.
Use doctor to troubleshoot configuration or authentication first.
Read the results¶
The report starts with the scope, dataset, and registered count: the number of
unique Minoc file URIs returned by Datatrail. It then shows these result counts
and lists the URIs with problems:
| Result | Meaning |
|---|---|
present |
Both services returned complete, matching size and checksum metadata. |
missing |
A successful metadata lookup did not return the registered URI from Minoc, Luskan, or both. |
size-mismatch |
Both sizes are available, but their byte counts differ. |
checksum-mismatch |
Both MD5 values are available, but they differ. |
unavailable |
A service request failed, a response was invalid, or required metadata was incomplete. The comparison could not be completed. |
One file can have more than one problem, so problem counts need not add up to
registered. An unavailable lookup is not reported as proof that a file is
missing.
An empty check can succeed
If Datatrail returns no registered Minoc files, the command reports
registered: 0 and succeeds. This does not establish that the dataset has
been replicated. Inspect its recorded locations with ps.
This command reads metadata; it does not download files, recompute checksums from their contents, or repair registrations. It checks only the registered Minoc URIs supplied by Datatrail, so it does not discover unregistered files or verify other storage elements. Matching service metadata is not a fresh integrity check of the stored bytes.
Save a detailed report¶
datatrail verify chime.event.baseband.raw EVENT_ID --json > verification.json
--json writes a JSON object on standard output, including on verification
failure. It contains scope, dataset, registered, ok, summary, and
results. The category keys use underscores (size_mismatch and
checksum_mismatch). Detailed results identify the URI, affected services, or
the differing Minoc and Luskan values as appropriate.
| Exit status | Meaning |
|---|---|
0 |
No missing files, mismatches, or unavailable metadata were reported; this includes an empty registered file list. |
1 |
Missing files or metadata mismatches were found, with no unavailable results. |
2 |
At least one result was unavailable, even if other files also had mismatches. |
For unavailable results, check service readiness and retry after the underlying
problem is resolved. For missing files or mismatches, retain the detailed report
and investigate the dataset with ps and scout before
requesting corrective work.