Archiv-Server Fehler bereinigen

Als synedra AIM-Betreuer/-in bereinigen Sie in synedra Control Center in Archiv > Archiv-Server die Fehler, die beim Importieren von Dateien in synedra AIM aufgetreten sind.

Hinweise
Es ist wichtig, dass Sie Archiv-Server Fehler regelmäßig und zeitnah bereinigen. Archiv-Server Fehler verweisen auf Daten, die nicht archiviert werden konnten. Diese sind für die Benutzer nicht auffindbar!

Die fehlerhaften Daten sind auf dem synedra AIM Server nicht ausfallsicher gespeichert. Bei einem Festplattendefekt besteht die Gefahr, dass sie verloren gehen.

synedra AIM Backend Release-Updates können nur durchgeführt werden, wenn keine Archiv-Server Fehler bestehen.

Anleitung für AIM-Betreuer/-innen

So bereinigen Sie Archiv-Server Fehler:

1. Zunächst erhalten Sie eine E-Mail Benachrichtigung vom synedra Monitoring mit Verweis auf das Sammelticket für Archiv-Server Fehler.

Die Abkürzung PROD steht für Produktivsystem, TEST steht für Testsystem. 'Prozess' beinhaltet das Servertag des ArchiveServer-Prozesses, das Ihnen hilft, in synedra Control Center verschiedene ArchiveServer-Prozesse zu unterscheiden.

Abbildung 1. Archiv-Server Fehler Alarm

Wichtig
Der Archiv-Server Fehler Alarm wird nur dann ausgelöst, wenn sich der Zustand von „0 Fehler" zu „Fehler vorhanden" ändert. Es ist deshalb wichtig, dass Sie auf den Alarm zeitnah reagieren. Es besteht sonst die Gefahr, dass sich viele Archivierungsfehler anhäufen, ohne dass Sie davon Notiz nehmen.

2. Gehen Sie in synedra Control Center auf Archiv > Archiv-Server. Hier werden die laufenden ArchiveServer-Prozesse angezeigt. Der Eintrag ohne 'Server-Tag' entspricht dem Standard-ArchiveServer-Prozess in Ihrem AIM-System. Mit Klick auf eine Zeile wechseln Sie zur Archiv-Server Detailseite. Diese zeigt Ihnen alle fehlgeschlagenen Importe, die dieser ArchiveServer-Prozess entgegengenommen hat. Eine Zeile entspricht einer Datei, die nicht archiviert werden konnte.

3. Verschaffen Sie sich einen Überblick über die Fehler. Um zusammengehörige Dateien besser zu erkennen, sortieren Sie die Ergebnisliste anhand von mehreren Spalten. Dazu klicken Sie mit gedrückter Umschalt/Shift-Taste auf die Spaltennamen.

4. Klicken Sie mit gedrückter <Strg=Ctrl>-Taste auf eine Zeile in der Fehlerliste, um Details zu diesem Fehler in einem eigenen Tab anzuzeigen.

Die Archiv-Server Fehler-Detailseite gibt Ihnen Hinweise zur Datenquelle und zur Fehlerursache.

• 'Dateiname'
• 'Produzent': die Organisationseinheit, die die Daten produziert hat.
• 'Aufrufender Host/AET': das Gerät/die Modalität, die die Daten gesendet hat.
• 'Nachname, Vorname': Patientendaten
• 'Versuch': Anzahl der bisher erfolgten Importversuche
• 'Fehler': Aus der Fehlermeldung erlesen Sie die Ursache. Teilweise müssen Sie dazu nach rechts scrollen. Je nach Fehlerursache, wählen Sie eine Strategie zur Lösung.

Wechseln Sie zurück zur Fehlerliste auf der Archiv-Server Detailseite im anderen Tab oder klicken Sie den Zurück-Knopf .

5. In der Fehlerliste markieren Sie alle Fehler, auf die Sie eine Lösungsstrategie anwenden wollen.

Reparieren und erneut versuchen versucht, den Importfehler unter Ausführung eines konfigurierbaren Groovy-Skripts zu reparieren, das aus dem Dropdown-Listenfeld gewählt werden kann. Anschließend wird erneut versucht, die Daten zu importieren. Der Standardwert ist 'default'. Dabei handelt es sich um ein Skript, das häufige Fehler von Modalitäten repariert.

Tipp
Sie können als ersten Bereinigungsversuch alle Fehler auswählen und Reparieren und erneut versuchen. Fehler, die übrig bleiben, prüfen Sie dann im Detail.

Erneut versuchen veranlasst einen neuerlichen Versuch, die Daten unverändert zu archivieren.

Tipp
Diese Lösungsstrategie bietet sich an, wenn die Daten korrekt sind und zum Zeitpunkt des Imports ein Archivfehler oder ein Verbindungsfehler auftrat, der inzwischen behoben wurde. Für Datenqualitätsfehler ist diese Strategie ungeeignet.

Herunterladen lädt die Daten herunter, die nicht erfolgreich archiviert werden konnten.

Tipps
Diese Möglichkeit bietet sich an, wenn Sie die Daten in einem geeigneten Programm betrachten wollen, z. B. DICOM-Daten in synedra View.

Laden Sie fehlerhafte DICOM-Daten herunter und öffnen Sie diese in synedra View Betrachten. Schalten Sie die Ansicht um auf die Metadatenansicht , um den DICOM-Header zu überprüfen. Suchen Sie nach dem DICOM-Tag, das in der Fehlermeldung erwähnt wurde, um den Wert zu überprüfen. Um das Symbol für die Metadatenansicht einzublenden, aktivieren Sie unter Extras - Einstellungen... - Erweitert den Eintrag 'Metadatenansicht aktivieren'.

Datenqualitätsfehler müssen an der Quelle, z. B. an der erzeugenden Modalität, behoben werden. Ist dies nicht möglich, z. B. bei Patienten CDs, gibt es in synedra View in Bearbeiten > Anonymisieren die Möglichkeit, fehlerhafte Werte in DICOM-Tags zu korrigieren, und die korrigierten Dateien anstelle der fehlerhaften Daten mit synedra View zu archivieren. Der entsprechende Archiv-Server Fehler kann danach in synedra Control Center gelöscht werden.

Löschen Führen Sie diese Aktion nur aus, wenn Sie sicher sind, dass die Daten bereits anderweitig importiert wurden, nach einer Korrektur erfolgreich archiviert wurden oder nicht benötigt werden, z. B. Testdaten.

Wichtig
Löschen entfernt die Daten unwiederbringlich. Sie sind nicht wiederherstellbar.

Abbildung 2. Archiv-Server Fehler Lösungsstrategien

6. Wenn Sie für bestimmte Fehler keine Lösung finden, teilen Sie das Problem dem synedra Support-Team im Sammelticket für Archiv-Server Fehler mit. Dringende Fehler melden Sie bitte telefonisch.

7. Wenn Sie auf alle Fehler eine passende Lösungsstrategie angewandt haben und keine Fehler mehr in der Liste aufscheinen, erhalten Sie eine E-Mail Benachrichtigung vom synedra Monitoring mit Verweis auf das Sammelticket für Archiv-Server Fehler.
Archiv-Server Fehler Entwarnung

Abbildung 3. Archiv-Server Fehler Entwarnung

Häufige Archiv-Server Fehler und passende Lösungen

1. Datenqualitätsprobleme (DataIntegrityViolationException)

Folgende Datenqualitätsprobleme lassen sich mit Reparieren und erneut versuchen mit dem als default hinterlegten Skript lösen.

Fehlende Patienten-ID (Missing PID, Fehlermeldung nach rechts scrollen: ERROR: new row for relation "patient" violates check constraint "pat_id_not_empty"): eine provisorische Patienten-ID wird aus dem Präfix „repair_" und der StudyInstanceUID zusammengesetzt, um das Dokument archivieren zu können.

In der Folge müssen Sie diese Daten in Daten > Patientenkorrektur mit der korrekten Patienten-ID verknüpfen.

Abbildung 4. Leere Patienten-ID

Ungültige Werte für Geschlecht DICOM-Tag (0010,0040) <PatientSex> werden durch gültige Werte ersetzt, sofern sich auf den korrekten Wert schließen lässt, z. B. „W", „w" oder „f" wird ersetzt durch „F", „U" oder „u" wird ersetzt durch „O". Gültige Werte gemäß DICOM-Standard sind „M" für männlich, „F" für weiblich und „O" für andere (englisch other).

Ein leerer Wert (Fehlermeldung: Detail: Key (sex_fk)=(1) is not present in table "sex") kann nicht automatisch ersetzt werden. Solche Daten müssen an der Quelle korrigiert oder heruntergeladen und in synedra View korrigiert werden.

Zu lange Werte werden in bestimmten DICOM-Tags abgeschnitten, z. B. StationName, Manufacturer, ManufacturersModelName, InstitutionName.

Ausgewählte DICOM-Tags mit zu langen Werten werden entfernt (Procedure ID, Scheduled Procedure Step ID)

Ungültige Werte in DICOM-Tags, die gemäß DICOM-Standard nur ganze Zahlen (integer) enthalten dürfen, werden mit „0" ersetzt (SeriesNumber, InstanceNumber).

Hinweis
Korrekturen, die durch das default-Reparaturskript /opt/synedra/scripts/archiverepair/default.groovy erfolgen, werden beim erneuten Importversuch im ArchiveServer-Logfile geloggt.

Alle anderen Datenqualitätsprobleme müssen an der Quelle oder durch Herunterladen und Korrektur in synedra View oder einem anderen Programm behoben werden, z. B. ungültiger Wert „PDF" im DICOM-Tag Modality.

2. synedra AIM bedingte Fehler

Archiv-Server Fehler, die auf eine temporäre Störung in synedra AIM zurückzuführen sind, bereinigt das synedra Support-Team. Typische Ursachen sind Speicherplatz nicht verfügbar, Verbindungs-/Netzwerkproblem, Archiv-Locks.

Wenn sich AIM bedingte Fehler durch einmaliges Erneut versuchen nicht lösen lassen, teilen Sie das Problem dem synedra Support-Team im Sammelticket für Archiv-Server Fehler mit. Dringende Fehler melden Sie bitte telefonisch.

Hier finden Sie diesen Beitrag als PDF zum download.