Skip to content

Forwarding of MPPS N‒CREATE and N‒SET messages

Vrinda edited this page Mar 27, 2023 · 1 revision

Overview

One may configure forwarding of MPPS messages N-CREATE and N-SET to one or several remote Application Entities on either

  • Device level : to forward MPPS messages received by any Application Entity of the Archive. OR
  • Application Entity level : to forward MPPS messages received by this Application Entity of the Archive.

Configuration

Using Archive UI

  • To configure on Archive Device level :
  1. Go to Menu->Configuration, then on Devices page Edit the dcm4chee-arc device. Go to Extensions and Edit extension of Device Extension. Again go to its Extensions and Edit extension of Archive Device.
  2. Select value(s) for field Mpps Forward Destination and click Save.
  • To configure on Application Entity level :
  1. Go to Menu->Configuration, then on Devices page Edit the dcm4chee-arc device. Go to its Child Objects and select the Application Entity for which you need this feature. Go to its Extensions and click on Edit extension of Network AE extension. Again go to its Extensions and click on Edit extension of Archive Network AE. Select value(s) for field Mpps Forward Destination and click Save.

Using LDAP

One may either

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

      version: 1
      # Configure forwarding of MPPS N-CREATE and N-SET messages received by any AE of the Archive
      # to remote AE: MPPSSCP
      dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      changetype: modify
      add: dcmFwdMppsDestination
      dcmFwdMppsDestination: MPPSSCP
      -
      
      # Configure additional remote AE: OTHER_MPPSSCP
      dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      changetype: modify
      add: dcmFwdMppsDestination
      dcmFwdMppsDestination: OTHER_MPPSSCP
      -
      
      # Configure forwarding of MPPS N-CREATE and N-SET messages received by AE: DCM4CHEE of the Archive
      # to remote AE: MPPSSCP2
      dn: dicomAETitle=DCM4CHEE,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      changetype: modify
      add: dcmFwdMppsDestination
      dcmFwdMppsDestination: MPPSSCP2
      -
    

    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 Attribute dcmFwdMppsDestination to the Device Entry (e.g.: dicomDeviceName=dcm4chee-arc) or an Application Entity Entry (e.g: dicomAETitle=DCM4CHEE) of the Archive Configuration.

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

Note: Also configure a Remote Application Entity for each of the specified AE Titles of MPPS Forward Destinations.

One may also modify the default configuration for retries of failed attempts to forward MPPS messages, by changing values of attributes of the Queue Entry dcmQueueName=MPPSSCU

  • by creating a LDIF file (e.g.):

      dn: dcmQueueName=MPPSSCU,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
      changetype: modify
      # Specifies initial interval between retries in ISO-8601 Duration format PnDTnHnMn.nS
      replace: dcmRetryDelay
      dcmRetryDelay: PT30S
      -
      # Specifies multiplier of interval between retries from retry to retry in procent
      replace: dcmRetryDelayMultiplier
      dcmRetryDelayMultiplier: 200
      -
      # Specifies maximal interval between retries in ISO-8601 Duration format PnDTnHnMn.nS
      replace: dcmMaxRetryDelay
      dcmMaxRetryDelay: PT10M
      -
      # Specifies maximal number of retries
      replace: dcmMaxRetries
      dcmMaxRetries: 10
      -
    

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

  • or use the Edit Entry... function of Apache Directory Studio.

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

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

Go to the Control tab on Configuration page in archive UI and reload the configuration.

Clone this wiki locally