comparison Sphinx/source/faq/troubleshooting.rst @ 193:99ba212989cc

Added entry related to MD5 integrity file checking
author bgo-osimis
date Sun, 03 Feb 2019 14:44:14 +0100
parents 60c91045bf2a
children 011b01ccf52d
comparison
equal deleted inserted replaced
192:14735c696623 193:99ba212989cc
106 advantage of this patch, you need to statically link Orthanc against 106 advantage of this patch, you need to statically link Orthanc against
107 DCMTK by using the ``-DUSE_SYSTEM_DCMTK=OFF`` flag `when invoking 107 DCMTK by using the ``-DUSE_SYSTEM_DCMTK=OFF`` flag `when invoking
108 CMake 108 CMake
109 <https://bitbucket.org/sjodogne/orthanc/src/default/LinuxCompilation.txt>`__. 109 <https://bitbucket.org/sjodogne/orthanc/src/default/LinuxCompilation.txt>`__.
110 110
111 Checking DICOM file integrity
112 -----------------------------
113 Orthanc stores, in its database, an `MD5 hash <https://en.wikipedia.org/wiki/MD5>`_ of the DICOM file contents.
114
115 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``).
116
117 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):
118
119 ``curl -X POST http://localhost:8042/instances/f257b066-f3992cc4-ca6a5e5f-3f8dcf3a-d4958939/attachments/dicom/verify-md5 -d ''``
120
121 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.
122
123 You can retrieve the stored MD5 hash of a DICOM instance as follows:
124
125 ``curl http://localhost:8042/instances/f257b066-f3992cc4-ca6a5e5f-3f8dcf3a-d4958939/attachments/dicom/md5``
111 126
112 Windows-specific issues 127 Windows-specific issues
113 ----------------------- 128 -----------------------
114 129
115 * Under Windows, Orthanc creates the "OrthancStorage" folder, and 130 * Under Windows, Orthanc creates the "OrthancStorage" folder, and