Remote Application Entity - dcm4che/dcm4chee-arc-light GitHub Wiki

Configuration

Using Archive UI

Go to Menu -> Configuration, then on Devices page, select AE list tab which displays the complete list of configured AE titles. Use + to register a new application entity.
One may register the new application entity on by creating a new device or by selecting an existing device.
By default the network connection information is populated. One may choose to keep the values same or change them. Add an AE Title and select a Network Connection Reference and Apply it.

Using LDAP

One may adjust following LDIF file:

version: 1
# LDIF for adding a Device providing one Application Entity available on one Network connection
# Adjust Base DN (dc=dcm4che,dc=org), Device name (SAMPLE_DEVICE), AE Title (SAMPLE_AET),
# Hostname (sample.host.name) and Port number before import it into the LDAP server

# Unique AE Title
# (will fail if there is already an object for the same AE Title)
dn: dicomAETitle=SAMPLE_AET,cn=Unique AE Titles Registry,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomUniqueAETitle
dicomAETitle: SAMPLE_AET

# Device
dn: dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomDevice
dicomDeviceName: SAMPLE_DEVICE
dicomInstalled: TRUE

# Network Connection
dn: cn=dicom,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomNetworkConnection
cn: dicom
dicomHostname: sample.host.name
dicomPort: 12345

# Network Connection (secure)
# dn: cn=dicom-tls,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
# cn: dicom-tls
# objectClass: dicomNetworkConnection
# dicomHostname: sample.host.name
# dicomPort: 23456
# dicomTLSCipherSuite: TLS_RSA_WITH_AES_128_CBC_SHA
# dicomTLSCipherSuite: SSL_RSA_WITH_3DES_EDE_CBC_SHA

# Network Application Entity
dn: dicomAETitle=SAMPLE_AET,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
objectClass: dicomNetworkAE
dicomAETitle: SAMPLE_AET
dicomNetworkConnectionReference: cn=dicom,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
# dicomNetworkConnectionReference: cn=dicom-tls,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
dicomAssociationInitiator: TRUE
dicomAssociationAcceptor: TRUE

and importing it to the LDAP Server by using the ldapadd command line utility, e.g.:

> ldapadd -xWD "cn=admin,dc=dcm4che,dc=org" -f sample-device.ldif 
Enter LDAP Password: 
adding new entry "dicomAETitle=SAMPLE_AET,cn=Unique AE Titles Registry,cn=DICOM Configuration,dc=dcm4che,dc=org"

adding new entry "dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org"

adding new entry "cn=dicom,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org"

adding new entry "dicomAETitle=SAMPLE_AET,dicomDeviceName=SAMPLE_DEVICE,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org"

or the LDIF Import... function of Apache Directory Studio.

One may refer to Network Connection and Network AE to understand the description of attributes

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

Test

To test the connectivity to remote application entity, one may echo it. To do this :

Go to Configuration -> Devices -> AE list -> Echo (icon available against each AE).
On the popup that opens up, select a calling AET (available from configured own archive i.e. dcm4chee-arc AETs) to echo the remote application entity.
If the remote application entity is started, installed (on remote device) and listening on the configured port, the C-ECHO response is successful