Skip to content

Aktualisierungshinweise auf Kitodo.Production 3.x

Matthias Ronge edited this page Jun 22, 2020 · 14 revisions

Übersicht

Voraussetzungen

Diese Anleitung setzt voraus, dass Sie Ihr System zuerst auf Version 2.3 migriert haben.

Vorbereitende Schritte

XStream-Dateien konvertieren

Die Production-Version 2.3 unterstützte zwei verschiedene interne Dateiformate: METS und XStream. Version 3.2 unterstützt nur METS. Daher müssen Sie Ihre Version 2.3 verwenden, um zuvor alle internen XStream-Dateien in METS-Dateien zu konvertieren.

Gehen Sie dazu zu den Projekteinstellungen und ändern Sie die interne Formateinstellung in METS. Wählen Sie dann alle Vorgänge dieses Projekts aus und führen Sie KitodoScript action:rewriteProcessMetadata aus.

Filter anlegen

Dies ist ein eher hypothetischer Schritt für ein System mit Live-Daten, aber bei einem Testaufbau können Sie Probleme damit haben. Vor dem Merge des entsprechenden Fixes schlägt die Datenbankmigration fehl, wenn kein Benutzer einen gespeicherten Filter hat.

Gehen Sie zur Vorgangsliste. Wenn die Filterliste leer ist, speichern Sie einen Filter.

Update des Systems

Regelsätze erstellen

In Version 3 wurde das Regelsatz-Dateiformat geändert. Sie sollten sich intensiv mit dem neuen Format beschäftigen und einen neuen Regelsatz für Ihre Daten erstellen. Wenn Sie möchten, können Sie einen von Zeutschel GmbH bereitgestellten experimentellen Regelsatzkonverter verwenden, um einen Vorschlag zu generieren. Beachten Sie, dass die Ausgabe dieses Programms nicht perfekt ist und später manuell überprüft und korrigiert werden muss. (Sie ersparen sich jedoch einiges an Schreibarbeit).

Datenbank migrieren

⚠️ Erstellen Sie vor dem Ändern der Datenbank eine Sicherungskopie und stoppen Sie die laufende Webanwendung!

Bevor Sie das Migrationsskript ausführen, sollten Sie sicherstellen, dass Ihr Datenbankschema mit dem Standardschema der Version 2.3 übereinstimmt.

Hier sind einige Skriptlösungen für die folgenden Inkonsistenzen:

Wenn Ihre Datenbank noch bit-Felder enthält, sollten Sie diese in tinyint(1) konvertieren.
...
Wenn eines dieser booleschen Felder nicht initialisiert ist, sollten Sie es initialisieren
...
Es sollte keine toten Referenzen geben. Löschen Sie verwaiste Datensätze.
...
Das Datenbankmodul sollte InnoDB sein.
...

Wenn Ihr System diesen Inkonsistenzen nicht unterliegt, sollten die Skripte keine Änderungen vornehmen.

Point 1

Point 2

ElasticSearch installieren

Programmdateien aktualisieren

Migration der Anwendung

Metadaten konvertieren

Suchmaschinenindex aufbauen

Bildderivate generieren

Workflows erstellen

Hierarchien erzeugen

Zeitungsverläufe migrieren

Clone this wiki locally