DICOM PS3.2 2018e - Conformance

B.4.4 Configuration (Current)
Prev | B.4 Networking | Next

### 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, IPaddresses 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.

Prev | Up | Next
B.4.3.3 IPv4 and IPv6 Support | Home | B.4.4.2 Parameters

DICOM PS3.2 2018e - Conformance