Zum Hauptinhalt springen
Version: 3.2

Fixitätsprüfung

Mit box kann die Integrität der archivierten Objekte mithilfe von Prüfsummen überprüft werden. Dazu wird die Prüfsumme des Binärobjekts neu berechnet und mit der in den technischen Metadaten des Repositories gespeicherten Prüfsumme verglichen. Es gibt zwei Möglichkeiten, Fixitätsprüfungen durchzuführen: Manuelle Prüfung oder der automatisierte System-Fixitäts-Task.

Manuelle Fixitätsprüfung​

Eine manuelle Fixitätsprüfung für ausgewählte Ressourcen kann über die Suchansicht gestartet werden. Nach der Auswahl einer oder mehrerer Ressourcen aus der Ergebnisliste kann über den Button Aktionen ein Fixitäts-Task für die ausgewählten Ressourcen gestartet werden. Dieser Task wird im Hintergrund ausgeführt. Beachten Sie, dass Ordnerressourcen ignoriert werden, da sie keine Prüfsumme besitzen.

Der Status des Fixitäts-Tasks und seine Ergebnisse (einschliesslich der PIDs der Ressourcen, bei denen die Fixitätsprüfung eine Diskrepanz zwischen der berechneten und der gespeicherten Prüfsumme festgestellt hat) können in der Aufgabenansicht überwacht und heruntergeladen werden.

Automatisierter System-Fixitäts-Task​

Zusätzlich zu den manuell ausgeführten Fixitäts-Tasks kann box so konfiguriert werden, dass alle Binärdateien im Archiv kontinuierlich überprüft werden. Nachdem der Task alle Binärdateien im Repository geprüft hat, wartet er eine bestimmte Zeit (konfigurierbar) ab, bevor er wieder von vorne beginnt.

Dieser System-Fixitäts-Task wird ebenfalls im Hintergrund ausgeführt. Wie bei der manuellen Fixitätsprüfung kann die Aufgabenansicht genutzt werden, um zu prüfen, ob der System-Fixitäts-Task läuft, und um dessen Ergebnisse einzusehen.

Um den System-Fixitäts-Task einzurichten, sind einige Konfigurationsschritte erforderlich:

  • Stellen Sie sicher, dass die Funktion Fixity check im Funktionen-Menü aktiviert ist.
  • Falls erforderlich, passen Sie die Einstellungen in config/fixity_check.yml an:
  • delay_between_two_system_checks: Zeit in Sekunden, die box wartet, bevor der Vorgang nach Abschluss aller Binärdateien erneut startet.
  • delay_for_retry_on_error: Zeit in Sekunden, die box wartet, bevor ein fehlgeschlagener Fixitäts-Check erneut versucht wird.

Falls der System-Fixitäts-Task wartet oder nicht läuft, können Sie ihn im Wartungsmenü neu starten, indem Sie auf die Schaltfläche System-Fixity-Prüfjob neu starten klicken. Wenn Sie den Task neu starten, aber die Fixitätsprüfung-Funktion nicht aktiviert haben, wird er nach dem ersten Batch von Ressourcen stoppen.

Technische Details​

Im Hintergrund ruft box eine Fedora REST-API auf (GET-Request an /path/to/some/resource/fcr:fixity), die die SHA-512-Prüfsumme der ausgewählten Binärdatei in Fedora neu berechnet und sie mit der in den internen Fedora-Metadaten der Binärdatei gespeicherten SHA-512-Prüfsumme vergleicht (d. h. 000repository-cosmos.docuteam.cloud/fcrepo/rest/institution1/rr_20230314162820218/i_20230314162820200/b_20230314162820900/content). Das Ergebnis des Vergleichs wird anschliessend an box zurückgegeben.