Mercurial > hg > orthanc-book
changeset 193:99ba212989cc
Added entry related to MD5 integrity file checking
author | bgo-osimis |
---|---|
date | Sun, 03 Feb 2019 14:44:14 +0100 |
parents | 14735c696623 |
children | d4c0b7c25126 |
files | .hgignore Sphinx/source/faq/troubleshooting.rst |
diffstat | 2 files changed, 17 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/.hgignore Sat Feb 02 17:39:00 2019 +0100 +++ b/.hgignore Sun Feb 03 14:44:14 2019 +0100 @@ -1,2 +1,3 @@ Sphinx/build -Sphinx/env \ No newline at end of file +Sphinx/env +.vscode/
--- a/Sphinx/source/faq/troubleshooting.rst Sat Feb 02 17:39:00 2019 +0100 +++ b/Sphinx/source/faq/troubleshooting.rst Sun Feb 03 14:44:14 2019 +0100 @@ -108,6 +108,21 @@ CMake <https://bitbucket.org/sjodogne/orthanc/src/default/LinuxCompilation.txt>`__. +Checking DICOM file integrity +----------------------------- +Orthanc stores, in its database, an `MD5 hash <https://en.wikipedia.org/wiki/MD5>`_ of the DICOM file contents. + +This MD5 corresponds to the hash of the DICOM file in memory, before it is written to the disk by Orthanc. This information is safely stored inside the database for any incoming DICOM file (provided that the ``StoreMD5ForAttachments`` configuration option is set to ``true``). + +It ispossible to ask Orthanc to check by itself whether the DICOM file was corrupted (i.e. to check whether the MD5 hash stored in the database corresponds to the hash of the file on the disk): + +``curl -X POST http://localhost:8042/instances/f257b066-f3992cc4-ca6a5e5f-3f8dcf3a-d4958939/attachments/dicom/verify-md5 -d ''`` + +This MD5 may be different if errors occurred while the DICOM file was initially written to the storage, or if the file contents were tampered with afterwards. + +You can retrieve the stored MD5 hash of a DICOM instance as follows: + +``curl http://localhost:8042/instances/f257b066-f3992cc4-ca6a5e5f-3f8dcf3a-d4958939/attachments/dicom/md5`` Windows-specific issues -----------------------