How to configure Instance Availability Notification

vrindanayak edited this page Oct 12, 2016 · 6 revisions
Clone this wiki locally

Overview

As per IHE, Instance Availability Notification is sent for all the stored instances of a study which are referenced in MPPS.

Configuration with Use Cases

MPPS Supported

ian-mpps-supported.puml

This use case is applicable for the below two scenarios :

1. All Instances of a study referenced in MPPS, are not yet received by the archive.
2. Only some out of all stored instances of a study are referenced in MPPS.

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: dcmIanDestination
    dcmIanDestination: IANSCP
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmIanTimeout
    dcmIanTimeout: PT5M
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmIanOnTimeout
    dcmIanOnTimeout: TRUE
    -
    

    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) or on Application Entity Level (e.g: dicomAETitle=DCM4CHEE) of the Archive Configuration.

One may refer to Archive Device to understand the description of attributes.

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

MPPS Not Supported by Modality

ian-mpps-notSupported.puml

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: dcmIanDestination
    dcmIanDestination: IANSCP
    -
    
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmIanDelay
    dcmIanDelay: PT5M
    -
    

    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) or on Application Entity Level (e.g: dicomAETitle=DCM4CHEE) of the Archive Configuration.

One may refer to Archive Device to understand the description of attributes.

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

Note : Current sample archive ldap configuration already has the IANSCU queue object under dcm4chee-arc device and also dicomDevice 'ianscp' is configured to act as a destination of MPPS requests.

Export Triggered IAN

ian-export-triggered.puml

You may either

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

    version: 1
    dn: dcmExporterID=STORESCP,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmIanDestination
    dcmIanDestination: IANSCP
    -
    
    dn: dcmExporterID=STORESCP,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmRetrieveAET
    dcmRetrieveAET: STORESCP
    -
    
    dn: dcmExporterID=STORESCP,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmInstanceAvailability
    dcmInstanceAvailability: NEARLINE
    -
    

    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 Exporter Descriptor Level (e.g.: dcmExporterID=STORESCP) in the Archive Configuration.

One may refer to Exporter Descriptor to understand the description of attributes.

Testing

MPPS Supported

  1. Store a study on archive

      storescu -c DCM4CHEE@localhost:11112 /pathToStudy
    
  2. Start IANSCP

      ianscp -b IANSCP:11117
    
  3. Send MPPS request (do this step if MPPS is supported by modality)

      mppsscu -c DCM4CHEE@localhost:11112 /pathToStudy
    

After configured IAN timeout, one can see in the ianscp tool window that the Instance Availability notification has been received.

MPPS Not Supported

  1. Store a study on archive

      storescu -c DCM4CHEE@localhost:11112 /pathToStudy
    
  2. Start IANSCP

      ianscp -b IANSCP:11117
    

After configured IAN Delay, one can see in the ianscp tool window that the Instance Availability notification has been received.

Export Triggered

  1. Start STORESCP

      storescp -b STORESCP:11115
    
  2. Start IANSCP

      ianscp -b IANSCP:11117
    
  3. Either configure an auto export/forwarding of instances as explained in How to configure forwarding of received instances or manually trigger an export using Archive UI. If forwarding/export of instances to STORESCP is completed successfully and one has configured IAN destinations on Exporter Descriptor level only then, an instance availability notification is triggered automatically and one can see in the ianscp tool window that the Instance Availability notification has been received.