Mercurial > hg > orthanc-book

comparison Sphinx/source/faq/features.rst @ 998:bd7fbe3042f7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
recycling/protection
author Alain Mazy <am@osimis.io>
date Mon, 18 Dec 2023 09:47:49 +0100
parents 1316bc62b5d5
children 2e103fb1fa11
comparison
equal deleted inserted replaced
997:e12cf25cc93b 998:bd7fbe3042f7
31 .. _recycling: 31 .. _recycling:
32 32
33 Recycling/Protection 33 Recycling/Protection
34 -------------------- 34 --------------------
35 35
36 Because of its focus on low-end computers, Orthanc implements **disk 36 Because of its focus on low-end computers, Orthanc may implement **disk
37 space recycling**: The patient that has been stored for the longest 37 space recycling**: The patient that has been stored for the longest
38 time inside Orthanc can be automatically deleted when the disk space 38 time inside Orthanc can be automatically deleted when the disk space
39 used by Orthanc grows above a threshold, or when the number of stored 39 used by Orthanc grows above a threshold, or when the number of stored
40 patients grows above a threshold. This feature enables the automated 40 patients grows above a threshold. This feature enables the automated
41 control of the disk space dedicated to Orthanc. Note that each time 41 control of the disk space dedicated to Orthanc. Note that each time
45 Recycling is controlled by the ``MaximumStorageSize`` and the 45 Recycling is controlled by the ``MaximumStorageSize`` and the
46 ``MaximumPatientCount`` options in the :ref:`Orthanc configuration 46 ``MaximumPatientCount`` options in the :ref:`Orthanc configuration
47 file <configuration>`. Setting both these values to 0 will disable 47 file <configuration>`. Setting both these values to 0 will disable
48 recycling. 48 recycling.
49 49
50 Starting with version 1.11.2, Orthanc also implements another **rejection**
51 behaviour when the ``MaximumStorageSize`` or ``MaximumPatientCount`` is
52 reached. In this case, patients are not recycled but Orthanc rejects new incoming
53 data. Check the ``MaximumStorageMode`` option in the :ref:`Orthanc configuration
54 file <configuration>`.
55
50 It is possible to prevent important data from being automatically 56 It is possible to prevent important data from being automatically
51 recycled. This mechanism is called **protection**. Each patient can be 57 recycled. This mechanism is called **protection**. Each patient can be
52 individually protected against recycling by using the 58 individually protected against recycling by using the
53 ``Unprotected/Protected`` switch that is available from Orthanc 59 ``Unprotected/Protected`` switch that is available from Orthanc
54 Explorer. 60 Explorer.
58 recycling. The rationale is that we think it is important to keep 64 recycling. The rationale is that we think it is important to keep
59 available all the data related to one patient. Unwillingly losing a 65 available all the data related to one patient. Unwillingly losing a
60 study/series that is part of the same patient might lead to a loss in 66 study/series that is part of the same patient might lead to a loss in
61 consistency with respect to the medical history of this patient. 67 consistency with respect to the medical history of this patient.
62 68
63 Starting with version 1.11.2, Orthanc also implements another **rejection** 69 To protect/unprotect a patient, one must call the ``/patients/../protected`` route::
64 behaviour when the ``MaximumStorageSize`` or ``MaximumPatientCount`` is 70
65 reached. In this case, patients are not recycled but Orthanc rejects new incoming 71 $ curl -X PUT http://localhost:8042/patients/0946fcb6-cf12ab43-bad958c1-bf057ad5-0fc6f54c/protected -d "1"
66 data. Check the ``MaximumStorageMode`` option in the :ref:`Orthanc configuration 72 $ curl -X PUT http://localhost:8042/patients/0946fcb6-cf12ab43-bad958c1-bf057ad5-0fc6f54c/protected -d "0"
67 file <configuration>`. 73
68 74
69 .. _compression: 75 .. _compression:
70 76
71 Compression 77 Compression
72 ----------- 78 -----------