How to configure Study Retention Policy

vrindanayak edited this page Oct 20, 2016 · 7 revisions
Clone this wiki locally

Overview

One can retain studies/series for specified periods of time and expire them automatically once the retention period is over.

study-retention-policy.puml

Configuration

You may either

  • create a LDIF file (e.g.):

    version: 1
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmRejectExpiredStudiesPollingInterval
    dcmRejectExpiredStudiesPollingInterval: P1D
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmRejectExpiredStudiesPollingStartTime
    dcmRejectExpiredStudiesPollingStartTime: 00:00:00
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmAllowRejectionForDataRetentionPolicyExpired
    dcmAllowRejectionForDataRetentionPolicyExpired: NEVER
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmRejectExpiredStudiesFetchSize
    dcmRejectExpiredStudiesFetchSize: 10
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmRejectExpiredSeriesFetchSize
    dcmRejectExpiredSeriesFetchSize: 10
    -
    
    dn: cn=THIN_SLICE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: add
    objectClass: dcmStudyRetentionPolicy
    objectClass: top
    dcmRetentionPeriod: P2W
    cn: THIN_SLICE
    -
    
    dn: cn=THIN_SLICE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmExpireSeriesIndividually
    dcmExpireSeriesIndividually: TRUE
    -
    
    dn: cn=THIN_SLICE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmProperty
    dcmProperty: SendingApplicationEntityTitle=MODALITY1
    -
    
    dn: cn=THIN_SLICE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmProperty
    dcmProperty: SliceThickness=0.75
    -
    
    dn: cn=THIN_SLICE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmRulePriority
    dcmRulePriority: 1
    -
    

    and import it to the LDAP Server by using the ldapmodify command line utility.

  • or use the Add Attribute... and Add Value... function of Apache Directory Studio to add attributes on Device level (e.g.: dicomDeviceName=dcm4chee-arc) in the Archive Configuration.

One may refer to Archive Device and Study Retention Policy to understand the description of attributes.

Refer ISO-8601 Duration format for more know-how on Durations.

Testing

  1. Store a study to archive whose objects have slice thickness as 0.75 (as shown above in configuration)

      storescu -c DCM4CHEE@localhost:11112  /path_to_study.dcm
    
  2. Using the user interface of archive, see the expiration date set in the private attributes as shown in screenshot below