Remote Application Entity

Register a new application entity on an existing remote device or on a new created remote device.

Configuration

Using Archive UI

1. 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.
2. One may register the new application entity on by creating a new device or by selecting an existing device.
3. 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.

See also DICOM Part 15: Data Model Component Objects

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