DICOM PS3.2 2019b - Conformance

B.4.4 Configuration

B.4.4.1 AE Title/Presentation Address Mapping

B.4.4.1.1 Local AE Titles

All local applications use the AE Titles and TCP/IP Ports configured via the Service/Installation Tool. The Field Service Engineer can configure the TCP Port via the Service/Installation Tool. No Default AE Titles are provided. The AE Titles must be configured during installation. The local AE Title used by each individual application can be configured independently of the AE Title used by other local applications. If so configured, all local AEs are capable of using the same AE Title.

Table B.4.4-1. AE Title Configuration Table

Application Entity

Default AE Title

Default TCP/IP Port

Storage

No Default

104

Workflow

No Default

Not Applicable

Hardcopy

No Default

Not Applicable


B.4.4.1.1.1 Obtaining Local Configuration From LDAP Server

The Service/Installation Tool can be used to specify that an LDAP Server be the master of local configuration information. The Query LDAP Server transaction of the Network Configuration Profile is used to obtain configuration information. The LDAP

Server will be queried for updated information at boot time but the query can also be manually invoked from the Service/Installation Tool. A search is performed for an LDAP entity within the DICOM configuration sub-tree having an identical device name (as entered in the Service/Installation Tool). The local configuration will be updated to match the central configuration (i.e., AE Titles, TCP Port Numbers, Peer AEs, Private Data, etc). The central configuration information will be checked for consistency before the local configuration is updated.

The configuration parameters that can be updated by the central LDAP server and can affect the local configuration for the device are listed in the Table below:

Table B.4.4-2. Device Configuration Parameters Obtained From LDAP Server

LDAP object class

LDAP attribute

Local Meaning

dicomDevice

dicomDescription

Displayed in the Service/Installation Tool

dicomDevice

dicomVendorData

Private device configuration parameters (e.g., examination protocol codes and parameters)

dicomDevice

dicomDeviceType

Displayed in the Service/Installation Tool


The Application Entities described by the LDAP server are matched to the supported local application entities (Storage, Workflow or Hardcopy) by inspecting the private information within the dicomVendorData attribute for each dicomNetworkAE.

The configuration parameters that can be updated by the central LDAP server and affect the local configuration for each supported local AE are listed in the Table below:

Table B.4.4-3. AE Configuration Parameters Obtained From LDAP Server

LDAP object class

LDAP attribute

Local Meaning

dicomNetworkAE

dicomAETitle

Local AE Title(s)

dicomNetworkAE

dicomDescription

Displayed in the Service/Installation Tool

dicomNetworkAE

dicomNetworkConnectionReference

Associated network connection parameters

dicomNetworkAE

dicomPeerAETitle

Default collection of Peer AE

dicomNetworkAE

dicomVendorData

Private AE configuration parameters (e.g., timeouts, max PDU lengths, maximum number of simultaneous associations).

dicomNetworkAE

dicomApplicationCluster

Displayed in the Service/Installation Tool


The configuration parameters that can be updated by the central LDAP server and affect the local configuration for the network connection are listed in the Table below:

Table B.4.4-4. Network Connection Configuration Parameters Obtained From LDAP Server

LDAP object class

LDAP attribute

Local Meaning

dicomNetworkConnection

dicomHostname

Hostname

dicomNetworkConnection

dicomPort

TCP Port


B.4.4.1.1.2 Publishing Local Configuration to LDAP Server

The Service/Installation Tool can be used to publish local configuration information to the LDAP Server.

The LDAP client will bind to the server using LDAP Basic Authentication (or anonymously if LDAP Basic Authentication is not configured). The LDAP Client expects that the necessary DICOM Root objects exist in the LDAP DIT and performed searches to identify the following information:

  1. The DN of the dicomConfigurationRoot identifying the root if all DICOM Configuration information.

  2. The DN of the dicomDevicesRoot under which new devices can be inserted

  3. The DN of the dicomUniqueAETitlesRegistryRoot under which unique AE Titles can be registered

  4. The DN of any existing dicomDevice object that represents the device hosting the LDAP client (dicomDeviceName identical to locally configured device name).

Modifications can be made to existing LDAP entries for the device or new entries will be created if necessary. It is possible to manually assign AE Titles for each local Application Entity or to automatically generate random AE Titles. In both cases, the LDAP server is queried to determine that the AE Titles are currently unused.

Two different methods (Manual and Automatic) are supported to update the LDAP server and an appropriate method must be selected depending on the security policies enforced by the LDAP server.

Manual Update

  • An LDIF file (RFC 2489) will be created containing all new or updated LDAP objects and attributes. The objects will be appropriately located in the server's LDAP tree. The LDIF file will be written to the local file system or to exchangeable media (e.g., floppy). The file can be transferred to the LDAP server and imported using server specific tools.

Automatic Update

  • The LDAP client will attempt to register unique AE Titles. If the manually chosen AE Titles are manually already in use the update will be aborted and new AE Titles must be chosen. If AE Titles were randomly selected the LDAP client will use the random AE Title allocation technique described by the "Update LDAP Server" transaction of the DICOM Application Configuration Management Profile.

  • The LDAP client will create new LDAP objects or update existing objects as necessary at appropriate locations in the server's LDAP tree.

  • If the server refuses any object creation or update operation the Automatic Update will be aborted. In case of failure, the LDAP server may contain partial configuration information that must be corrected by the LDAP server administrator.

The same set of LDAP objects and attributes will be entered into the LDAP DIT for both the Manual and Automatic Update methods. Values for all configurable attributes can be entered using Service/Installation Tool. Table B.4.4-5 lists the attributes and default values created for the installed device.

Table B.4.4-5. Device Configuration Parameters Updated On LDAP Server

LDAP object class

LDAP attribute

Configurable (Yes/No)

Default Value

dicomDevice

dicomDeviceName

Yes

dicomDescription

Yes

Radio-Fluoroscopic Image Acquisition Modality

dicomManufacturer

No

EXAMPLE-IMAGING-PRODUCTS

dicomManufacturerModelName

No

Example-Integrated-Modality

dicomVersion

No

1

dicomPrimaryDeviceType

No

RF

dicomVendorData

Yes


Table B.4.4-6 lists the attributes and default values used to describe the network configuration:

Table B.4.4-6. Network Connection Configuration Parameters Updated On LDAP Server

LDAP object class

LDAP attribute

Configurable (Yes/No)

Default Value

dicomNetworkConnection

dicomHostname

Yes

dicomPort

Yes

104


The Table below lists the attributes and default values used to describe the Storage AE:

Table B.4.4-7. Storage AE Configuration Parameters Updated On LDAP Server

LDAP object class

LDAP attribute

Configurable (Yes/No)

Default Value

dicomNetworkAE

dicomAETitle

Yes

dicomDescription

Yes

Storage Application

dicomPeerAETitle

Yes

dicomVendorData

Yes

dicomApplicationCluster

Yes

dicomAssociationInitiator

No

TRUE

dicomAssociationAcceptor

No

TRUE

dicomTransferCapability

dicomSOPClass

No

X-Ray Radiofluoroscopic Image Storage

Grayscale Softcopy Presentation State Storage

Storage Commitment Push Model

dicomTransferRole

No

SCU

dicomTransferSyntax

Yes

Explicit VR Little Endian

Implicit VR Little Endian


The Table below lists the attributes and default values used to describe the Workflow AE:

Table B.4.4-8. Workflow AE Configuration Parameters Updated On LDAP Server

LDAP object class

LDAP attribute

Configurable (Yes/No)

Default Value

dicomNetworkAE

dicomAETitle

Yes

dicomDescription

Yes

Workflow Application

dicomPeerAETitle

Yes

dicomVendorData

Yes

dicomApplicationCluster

Yes

dicomAssociationInitiator

No

TRUE

dicomAssociationAcceptor

No

FALSE

dicomTransferCapability

dicomSOPClass

No

Modality Worklist Information Model - FIND

Modality Performed Procedure Step

dicomTransferRole

No

SCU

dicomTransferSyntax

Yes

Explicit VR Little Endian

Implicit VR Little Endian


The Table below lists the attributes and default values used to describe the Hardcopy AE:

Table B.4.4-9. Hardcopy AE Configuration Parameters Updated On LDAP Server

LDAP object class

LDAP attribute

Configurable (Yes/No)

Default Value

dicomNetworkAE

dicomAETitle

Yes

dicomDescription

Yes

Hardcopy Application

dicomNetworkConnectionReference

n/a

dicomPeerAETitle

Yes

dicomVendorData

Yes

dicomApplicationCluster

Yes

dicomAssociationInitiator

No

TRUE

dicomAssociationAcceptor

No

FALSE

dicomTransferCapability

dicomSOPClass

No

Basic Grayscale Print Management Meta

Presentation LUT

dicomTransferRole

No

SCU

dicomTransferSyntax

Yes

Explicit VR Little Endian

Implicit VR Little Endian


B.4.4.1.2 Remote AE Title/Presentation Address Mapping

The AE Title, host names and port numbers of remote applications are configured using the EXAMPLE-INTEGRATED-MODALITY Service/Installation Tool.

B.4.4.1.2.1 Storage

The EXAMPLE-INTEGRATED-MODALITY Service/Installation Tool must be used to set the AE Titles, port-numbers, host-names and capabilities for the remote Storage SCPs. Associations will only be accepted from known AE Titles and associations from unknown AE Titles will be rejected (an AE Title is known if it can be selected within the Service/Installation Tool). Multiple remote Storage SCPs can be defined. Any Storage SCP can be configured to be an "Archive" device causing storage commitment to be requested for images or presentation states transmitted to the device.

If an LDAP server is available, the Service/Installation Tool will search for suitable remote Storage SCPs and present these for selection. If the LDAP object for the Storage AE contains one or more dicomPeerAETitle attributes then only these Peer AEs will be available for selection. Otherwise, remote AEs will only be available for selection if they support compatible SOP Classes as an SCP. If a remote AE is attached to a device containing a dicomDeviceType attribute with value "ARCHIVE" it will be automatically configured as an "Archive" device provided the AE also supports Storage Commitment as an SCP.

These LDAP-assisted selection policies can be overridden and a search performed for a specific device or AE Title.

B.4.4.1.2.2 Workflow

The EXAMPLE-INTEGRATED-MODALITY Service/Installation Tool must be used to set the AE Title, port-number, host-name and capabilities of the remote Modality Worklist SCP. Only a single remote Modality Worklist SCP can be defined.

If an LDAP server is available, the Service/Installation Tool will search for suitable remote Modality Worklist SCPs and present these for selection. Remote AEs will only be available for selection if they support the Modality Worklist SOP Class as an SCP. If a remote AE is attached to a device containing a dicomDeviceType attribute with value "DSS" (Department System Scheduler) it will be presented as the preferred selection.

The EXAMPLE-INTEGRATED-MODALITY Service/Installation Tool must be used to set the AE Title, port-number, host-name and capabilities of the remote MPPS SCP. Only a single remote MPPS SCP can be defined.

If an LDAP server is available, the Service/Installation Tool will search for suitable remote MPPS SCPs and present these for selection. Remote AEs will only be available for selection if they support the MPPS SOP Class as an SCP. If a remote AE is attached to a device containing a dicomDeviceType attribute with value "DSS" (Department System Scheduler) it will be presented as the preferred selection.

B.4.4.1.2.3 Hardcopy

The EXAMPLE-INTEGRATED-MODALITY Service/Installation Tool must be used to set the AEs' AE Titles, port-numbers, host-names, IP­addresses and capabilities for the remote Print SCPs.

Multiple remote Print SCPs can be defined.

If an LDAP server is available, the Service/Installation Tool will search for suitable remote Print SCPs and present these for selection. Remote AEs will only be available for selection if they support the Basic Grayscale Print Management Meta SOP Class as an SCP. If a remote AE is attached to a device containing a dicomDeviceType attribute with value "PRINT" (Hard Copy Print Server) it will be presented as the preferred selection.

DICOM PS3.2 2019b - Conformance