Difference between revisions of "Fixity checking and reporting"

From Archivematica
Jump to navigation Jump to search
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Main Page]] > [[Documentation]] > [[Requirements]] > Fixity checking and reporting
 
[[Main Page]] > [[Documentation]] > [[Requirements]] > Fixity checking and reporting
 +
 +
<div style="padding: 10px 10px; border: 1px solid black; background-color: #F79086;">This page is no longer being maintained and may contain inaccurate information. Please see the [https://www.archivematica.org/docs/latest/ Archivematica documentation] for up-to-date information.</div><p>
  
 
This wiki page describes requirements for gathering fixity check information from the [https://github.com/artefactual/fixity | Fixity app] and reporting through the Archivematica Storage Service.
 
This wiki page describes requirements for gathering fixity check information from the [https://github.com/artefactual/fixity | Fixity app] and reporting through the Archivematica Storage Service.
 +
 +
[[Category:Feature requirements]]
  
 
==Requirements==
 
==Requirements==
Line 23: Line 27:
  
 
Failures should be reported as such if they are actual fixity failures, or if there were errors in the tool.
 
Failures should be reported as such if they are actual fixity failures, or if there were errors in the tool.
 +
 +
'''In the case of a fixity failure''' the report should have the following:
 +
 +
* Date/time that fixity was run
 +
* AIP UUID
 +
* Which files (names, UUIDs) failed fixity check
 +
 +
'''In the case of an error''' the report should have the following:
 +
 +
* Date/time that fixity was run
 +
* AIP UUID
 +
* Nature of the error- for example:
 +
 +
"data/objects/no_such_file exists in manifest but not found on filesystem"
 +
 +
(Source: https://github.com/artefactual/archivematica-storage-service/blob/stable/0.7.x/storage_service/locations/models/package.py#L742-L762)

Latest revision as of 16:24, 11 February 2020

Main Page > Documentation > Requirements > Fixity checking and reporting

This page is no longer being maintained and may contain inaccurate information. Please see the Archivematica documentation for up-to-date information.

This wiki page describes requirements for gathering fixity check information from the | Fixity app and reporting through the Archivematica Storage Service.

Requirements[edit]

  • Modify Storage Service to record time and results of fixity checks by adding columns to packages tab
  • Add script to send email alerts to administrator(s) when a fixity check fails

Mockups[edit]

Storage Service packages tab[edit]

Fixity report SS.png

Two columns are added to the Storage Service packages tab:

  • Fixity Date, showing the date and time that the fixity check was run
  • Fixity Result, showing the outcome (Succeeded or Failed) with links to tool output in cases of failures or errors (successful fixity scan reports are empty)

Fixity Results: Failed[edit]

Failures should be reported as such if they are actual fixity failures, or if there were errors in the tool.

In the case of a fixity failure the report should have the following:

  • Date/time that fixity was run
  • AIP UUID
  • Which files (names, UUIDs) failed fixity check

In the case of an error the report should have the following:

  • Date/time that fixity was run
  • AIP UUID
  • Nature of the error- for example:

"data/objects/no_such_file exists in manifest but not found on filesystem"

(Source: https://github.com/artefactual/archivematica-storage-service/blob/stable/0.7.x/storage_service/locations/models/package.py#L742-L762)