Dcm4chee Ref PDF
Dcm4chee Ref PDF
Version: 2.9.1
Table of Contents
Preface ............................................................................................................................................ iv
1. Installation Instructions .............................................................................................................. 1
1.1. Minimum System Requirements and Supporting Software .................................................... 1
1.2. Installation Steps ................................................................................................................ 1
1.3. Verify the Installation ......................................................................................................... 4
2. dcm4chee Services ....................................................................................................................... 7
2.1. Overview ........................................................................................................................... 7
2.2. Service Reference .............................................................................................................. 7
2.2.1. Core Archive Services ............................................................................................. 7
2.2.1.1. AE Title Configuration Service ...................................................................... 7
2.2.1.2. Audit Logger ................................................................................................ 7
2.2.1.3. Compression Service .................................................................................... 7
2.2.1.4. Consistency Check Service ............................................................................ 7
2.2.1.5. Content Edit service ...................................................................................... 7
2.2.1.6. DICOM Server ............................................................................................. 8
2.2.1.7. Device Service ............................................................................................. 8
2.2.1.8. Echo Service ................................................................................................ 8
2.2.1.9. Teaching File and Clinical Trial Export Manager ............................................ 8
2.2.1.10. File Copy Service ....................................................................................... 8
2.2.1.11. FixPatientAttributes Service ........................................................................ 8
2.2.1.12. DICOM Forward Service ............................................................................ 8
2.2.1.13. File System Management Service ................................................................ 8
2.2.1.14. DICOM GPWL Feed Service ...................................................................... 8
2.2.1.15. DICOM GPWL Service Class Providers ....................................................... 8
2.2.1.16. DICOM GPWL SCU Service ...................................................................... 8
2.2.1.17. DICOM Hanging Protocol SCP ................................................................... 8
2.2.1.18. DICOM IAN/SCN SCU Service .................................................................. 8
2.2.1.19. DICOM Key Object Generation Service ....................................................... 9
2.2.1.20. DICOM Media Creation Management SCU .................................................. 9
2.2.1.21. MD5 Check Service .................................................................................... 9
2.2.1.22. Move SCU Service ..................................................................................... 9
2.2.1.23. MPPS Emulator .......................................................................................... 9
2.2.1.24. DICOM Modality Performed Procedure Step (MPPS) SCP ........................... 9
2.2.1.25. DICOM Modality Performed Procedure Step (MPPS) SCU ........................... 9
2.2.1.26. DICOM Modality Worklist SCP .................................................................. 9
2.2.1.27. Modality Worklist SCU ............................................................................... 9
2.2.1.28. Performed Procedure Step (PPS) Exception Managment ............................... 9
2.2.1.29. PPS SCU Service ........................................................................................ 9
2.2.1.30. DICOM Query/Retrieve SCP ....................................................................... 9
2.2.1.31. Simple SMTP Mail Sender .......................................................................... 9
2.2.1.32. DICOM Storage Commitment SCU/SCP ...................................................... 9
2.2.1.33. DICOM Storage SCP ................................................................................ 10
2.2.1.34. Study Information Service ......................................................................... 10
2.2.1.35. Study Reconciliation Service ..................................................................... 10
2.2.1.36. Study Status Service ................................................................................. 10
2.2.1.37. Private Study Management Service SCP ..................................................... 10
2.2.1.38. DICOM Modality Worklist SCU ............................................................... 10
2.2.1.39. Check File Status Service .......................................................................... 10
dcm4chee 2.9.1 ii
dcm4chee Open Source Image Manager/Archive
dcm4chee is an implementation of an IHE (Integrating the Healthcare Enterprise) compliant Image Archive and
Report Repository. This includes the capabilities
2. Grayscale Presentation States [GSPS], which specifies the presentations of images as grayscaling,
zoom, text and graphical annotations,
3. Key Objects [KO], which specifies a particular selection of images for a specified reason and with an
attached note,
to process HL7 notification messages from the Order Filler, about Procedure Scheduling, Procedure Up-
dates and Patient Information Updates,
to process DICOM Modality Performed Procedure Step [MPPS] messages from modalities and forward
them to the Order Filler.
dcm4chee is a server application. Its Web-based User Interface is intended for system configuration and monit-
oring by system adminstrators.
dcm4chee 2.9.1 iv
Chapter 1. Installation Instructions
512 MB RAM
100 MB hard disk space (in addition to archive disk space for object storage and caching)
dcm4chee requires a database to store transient and permanent information from the clinical workflow and ob-
jects. The authors of dcm4chee realize that database expertise varies from site to site, and has included support
for several different databases for deployment with the archive. The list of supported databases is:
PostgreSQL 8.1.x
MySQL 4.1+
Oracle 9i/10g
SQL Server
DB2 8.1+
dcm4chee is a Java-based application. It requires the installation of the JDK version 1.4.2 or higher. JDK ver-
sion 5 is recommended for the best performance and stability.
For image compression/decompression, dcm4chee 2.8.x utilizes Sun's Java Advanced Imaging (JAI) Image I/O
Tools 1.0_01. The binary distribution packages of dcm4chee 2.8.x already includes the necessary JARs and
native libraries for Windows and Linux i586. For Solaris support, you need to download the software package
from Sun at http://java.sun.com/products/java-media/jai/downloads/download-iio-1_0_01.html and
replace the Linux version of libclib_jiio.so in DCM4CHEE_DIST/bin/ with the file of the same name from the
Solaris JAI Image IO distribution.
dcm4chee depends heavily on the JBoss (http://www.jboss.org) application server for its infrastructure. It is
not necessary to download JBoss (as dcm4chee is pre-packaged within JBoss), but viewing the online (or
downloaded) JBoss documentation will assist a great deal in learning the dcm4chee directory structure, and
how the product operates under the covers. JBoss services such as XMBeans, JBossMQ (JMS), and EJB
(Session and Entity beans) are utilized by dcm4chee.
1. Download the binary distribution of dcm4chee for the database of your choice from the Files page of the
dcm4chee 2.9.1 1
Installation Instructions
2. Once downloaded, extract the distribution package into your desired destination directory. Avoid using a
directory path that contains spaces though, as that may cause problems when running the application from
the command line.
3. Install the database software of your choice (keeping in mind the supported database systems) if you have
not already done so. Keep in mind that the database software that you install (or have installed) must
match the version of dcm4chee that you downloaded. For example, if you want to use PostgreSQL with
dcm4chee then you should download the dcm4chee-standalone-psql-2.8.2.zip file from SourceForge.
4. If using a database other than MySQL or PostgreSQL you will need to copy an apropriate JDBC Driver
for the database to DCM4CHEE_DIST/server/default/lib/. This is not necessary for MySQL or Postgr-
eSQL because the binary distribution of dcm4chee already contains the correct JDBC drivers for these
database systems.
5. Verify that your database installation has TCP/IP socket access available.
For example, with PostgreSQL you can check the pg_hba.conf file for your database:
$PGDATA/pg_hba.conf:
# IPv4 local connections:
host all all 127.0.0.1/32 trust
With Oracle, you can verify that the TNS Listener is enabled:
C:\>netstat -b -p TCP
Active Connections
TCP localhost:1284 host.domain.com:1521 ESTABLISHED 1788
[ORACLE.EXE]
6. Initiate the archive database instance (named pacsdb) using the create DDL script located in
DCM4CHEE_DIST/sql/create.xxx.
dcm4chee 2.9.1 2
Installation Instructions
Note: If you wish to take advantage of specific features of your RDBMS such as tablespaces, partitioning,
etc. you will need to implement them on your own. This can sometimes be done with the tools that come
with the database, or by modifying the DDL script before running it. If you make changes to the DDL
script that you think might be useful to the wider audience, please submit them to the dcm4che-users list-
serv.
<!--example of how to specify class that determines if exception means connection should be destroyed-
<!--exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.DummyExceptionSorter</exception
<!-- this will be run before a managed connection is removed from the pool for use by a client-->
<!--<check-valid-connection-sql>select * from something</check-valid-connection-sql> -->
<!-- The minimum connections in a pool/sub-pool. Pools are lazily constructed on first use -->
<min-pool-size>5</min-pool-size>
<!-- sql to call on an existing pooled connection when it is obtained from pool
<check-valid-connection-sql>some arbitrary sql</check-valid-connection-sql>
-->
<!-- example of how to specify a class that determines a connection is valid before it is handed out f
<valid-connection-checker-class-name>fully qualified name of class to use</valid-connection-checker-cl
-->
<!-- Whether to check all statements are closed when the connection is returned to the pool,
this is a debugging feature that should be turned off in production
<track-statements/>
-->
[Windows]: DCM4CHEE_DIST/bin/run.bat:
[Linux/Unix]: DCM4CHEE_DIST/bin/run.conf
dcm4chee 2.9.1 3
Installation Instructions
Keep in mind the available RAM and memory requirements of other processes running on the hardware.
For example, iif only 512 MB RAM is available on the machine, you should decrease the default value
from -Xmx512m (on Windows to) -Xmx300.
10. Optional: Upon installation, all DICOM services are pre-configured with DCM4CHEE as the Application En-
tity Title (AE Title, or AET). Although it is possible to modify this default configuration at a later date
through the Web-based administrative console, it is more efficient to replace DCM4CHEE with YOUR_AET in
DCM4CHEE_DIST/server/default/conf/xmdesc/*.xml using utilities provided by your platform.
After verifying that the application is installed and running correctly, you may want to install it as a Win-
dows service or Unix daemon.
===============================================================================
.
JBoss Bootstrap Environment
.
JBOSS_HOME: C:\apps\dcm4chee-standalone-psql-2.8.2\bin\\..
.
JAVA: C:\jdk1.5.0_06\bin\java
.
JAVA_OPTS: -Dprogram.name=run.bat -Xms128m -Xmx512m
.
CLASSPATH: C:\jdk1.5.0_06\lib\tools.jar;
C:\apps\dcm4chee-standalone-psql-2.8.2\bin\\run.jar
.
===============================================================================
.
14:46:16,046 INFO [Server] Starting JBoss (MX MicroKernel)...
14:46:16,046 INFO [Server] Release ID: JBoss [Zion] 4.0.3SP1 (build:
CVSTag=JBoss_4_0_3_SP1 date=200510231054)
...
...
...
14:46:50,626 INFO -> [JkMain] Jk running ID=0 time=0/60 config=null
14:46:50,636 INFO -> [Server] JBoss (MX MicroKernel) [4.0.3SP1 (build:
CVSTag=JBoss_4_0_3_SP1 date=200510231054)] Started in 34s:580ms
dcm4chee 2.9.1 4
Installation Instructions
2. Connect to the JBoss JMX Console (default URL is http://localhost:8080/jmx-console/) and login in
using the default Administrator account admin, with password admin.
Follow the link service=FileSystemMgt to the File System Management service configuration page under
the dcm4chee.archive heading.
Invoke the operation addOnlineFileSystem(), with a directory path argument specifying where the archive
shall store received objects/images.
3. Optional: In the default configuration, received images are stored 'as is' - meaning that no compression is
performed. Lossless (or other types of) compression of received uncompressed images can be activated by
the CompressionRules attribute in the Storage SCP Service (service=StoreScp) configuration page. For
example, set it to JLSL, to compress all types of images received from any Storage SCU with JPEG-LS
Lossless codec.
4. Optional: The directory used for caching generated JPEG representations of archived images requested by
Web Access to DICOM Persistent Objects (WADO) can be specified by the CacheRoot attribute in the the
WADO Service (service=WADOService) configuration page. Default:
DCM4CHEE_DIST/server/default/wadocache.
The directory used for caching generated PDF representations of archived Structured Report Documents
requested by IHE Retrieve Information for Display (RID) Services can be specified with the CacheRoot at-
tribute in the RID Service (service=RIDService) configuration page. Default:
DCM4CHEE_DIST/server/default/ihe_rid_cache.
5. Send some objects/images to the archive's Storage SCP, using the send utility of the dcm4che14 package,
the dcm4che2 package, or another Storage SCU of your choice.
Refresh the Web Interface (http://localhost:8080/dcm4chee-web/), which should now show the the
list of received studies.
Expand a study row to show contained series. Expand one of these series to show contained instances. In
the case of images, you can follow the image icon on the right to invoke an HTTP WADO request for a
JPEG presentation of this image which will be displayed in a separate browser window.
6. To test object retrieval, you will need an external Storage SCP acting as the Destination using the DICOM
Receiver utility of the dcm4che14 package, the dcm4che2 package, or another Storage SCP of your
choice.
Before initiating the retrieve, you will need to configure an additional Application Entity (AE) Title identi-
fying your Move Destination using the "AE Management" function of the Web User Interface. For ex-
ample:
dcm4chee 2.9.1 5
Installation Instructions
AE Title: DCMRCV
Hostname: localhost
Port: 11112
7. Switch back to the Study List (the Folder view) and mark studies to retrieve using the check box on the
right. Select "DCMRCV" as the send destination in the combo box above and click on the send button left
from it.
Alternatively, you could initiate a C-MOVE with the utility of your choice with DCMRCV as the destina-
tion AE Title.
If everything worked, you are ready to start using dcm4chee. If not, post your questions to the dcm4che-users
listserv.
dcm4chee 2.9.1 6
Chapter 2. dcm4chee Services
2.1. Overview
dcm4chee contains a number of services... XMBean and EJB infrastructure... diagram...
The core archive services are implemented as EJBs and JBoss XMBeans. They provide services to the user in-
terface, DICOM server, HL7 server, etc. They are implemented within the dcm4chee-sar and dcm4chee-ejb
code modules, and are configured by manipulating their XML descriptor files.
Audit Logger
Compression Service
Sets up a schedule to automatically check the consistency of compressed images. You can set image compres-
sion rules in the Compression Service. You can also use it directly via JMX to manually check the consistency
of images.
Identifies where patient information and study information updates are sent and received.
Use the values in the CalledAETitle and the CallingAETitle aliteralributes to configure specific forwarding
rules in the StudyMgtScu Service for study information updates received from this Content Edit Service.
The Content Edit Service sends also PatientUpdated and SeriesUpdated JMX Notifications. This allows to
forward instances to systems not supporting either StudyMgtScu or HL7 ADT patient updates.
In this case the receiver must use the received instances for updating! Use the ForwardService to configure this
dcm4chee 2.9.1 7
dcm4chee Services
forward option.
DICOM Server
Sends incoming service reqest to registered DICOM services. When configuring, select the TCP port listening
port, the security protocol for communication, timeouts, and the maximum number of connected DICOM cli-
ents.
Device Service
Use the commands in this service to import device mapping files, delete device mappings, delete a specific
device, get a list of all devices for a specific protocol, and add the scheduled station name AE title, the name,
and the modality to the given SPS items.
Echo Service
Use this service to test the AE configurations (host and port and protocol) you defined with the AE Configura-
tion Service. First, you must set the CallingAETitle used in echo associations used to test those AE configura-
tions.
FixPatientAttributes Service
Specifies the location of file systems in which DICOM objects received from the Store SCP Server are stored.
You can also set up rules to delete the most infrequently accessed studies.
Used to add entries to the General Purpose Worklist, triggered by received MPPS N-Set messages.
Used to notify DICOM peers about available instances via Instance Available Notifications and Study Content
dcm4chee 2.9.1 8
dcm4chee Services
Notifications.
Used to check if the MD5 sum of the new object differs from the MD5 sum of the existing file. If the MD5 sum
does not match, the files may be corrupted.
rocess move orders. Invokes DICOM Retrieve requests, typically from the archive's own DICOM Query/Re-
trieve Service (SCP).
MPPS Emulator
Used to define the calling and called AE titles for receiving MPPS messages.
Provides a DICOM Storage Commitment Service in the Service Class Provider (SCP) and the Service Class
dcm4chee 2.9.1 9
dcm4chee Services
User (SCU) Role. When acting as the SCP, the service handles storage commitment requests that it receives
from modalities or evidence creators (workstations). When acting as the SCU, it may request storage commit-
ment for objects for itself that were retrieved from the archive to a remote application. Typically this applica-
tion is a further archive instance acting as a long-term or central archive.
used to update Study Status triggered by receive of General Purpose Performed Procedure Step N-CRE-
ATE-RQ with particular Performed Work Item Code by General Purpose Performed Procedure Step SCP.
used to forward messages received by private Study Management Service SCP Service. You must use the Con-
tent edit service to identify where study information updates are sent and received. Use the values in the
CalledAETitle and the CallingAETitle attributesto configure specific forwarding rules in this StudyMgtScu
Service for study information updates received from the Content Edit Service
TLS Configuration
XDS-I Service
dcm4chee 2.9.1 10
Chapter 3. User Interface Guide
3.1. Introduction
The dcm4chee User Interface Guide was written for system administrators responsible for the adminstration of
dcm4chee archive application. The unser interface consists of several dynamic web pages, and is named
dcm4chee-web. dcm4chee-web contains the following functionality: in:
AE Management
Offline Storage
Worklist Console
MPPS Console
User admin
Audit Repository
After logging in, the user will remain logged in until the web browser is closed. It is recommended that you log
out of the application whenever dcm4chee-web is not in use. This will avoid the security issue of having an act-
ive, idle session.
dcm4chee 2.9.1 11
User Interface Guide
Study List
Information regarding patients, studies, series, and images.
Search Filter
Specifies matching criteria for listed studies.
Function buttons
Invoke operations on selected list entires.
To expand the hierarchy of a line item, click on the + sign. To hide the hierarchy beneath a line item, click on
the - sign.
In the figure above the patient AAPM Test Pattern has four studies containing several OT series. The second
series has its instance-level hierarchy expanded, and contains three DICOM instances.
The label for a column can be seen at the top of each column. The information that is displayed at the Patient
level:
dcm4chee 2.9.1 12
User Interface Guide
Name
Patient ID
Birthdate
Sex
Date/Time
Study ID
Modalities
Clicking either Study Description or IUID allows teh user to toggle between Study Description and IUID
information within the column. If Study Instance UID becomes active, the Study ID search field will
change to Study IUID, and vice versa.
Accession Number
Referring Physician
Number of Series
Number of Instances
Data/Time
Series Number
Modality
Clicking either Series Description/Body Part or IUID will between the display of Series Description/Body
Part and IUID information within the column.
Vendor/Model
Number of Images
To filter the records in the study list, search criteria can be specified above the columns labels. It is possible to
search for Patient Name, Patient ID, Study ID, Study Data, Accession Number, Modality, or a combination
thereof. To perform a search just press "Return" on the keyboard or click the New Search button. The result of
dcm4chee 2.9.1 13
User Interface Guide
the search will be displayed in the list. If the list contains more than ten studies (records), the first ten records
will be shown. To show the next ten records press the Next Search Result button or go back using the Previous
Search Result button. Information regarding what is displayed, and the total amount of matching records can be
seen in the status line ex.:
The search can include a specific entry or part of an entry truncated with a question mark (?) or an asterisk (*).
A search including a question mark will only search for one character where it is placed, opposite a search with
an asterisk will include an unlimited amount of characters. It is possible to combine question marks and asterisk
in the same search.
All fields are case sensitive except the Patient Name Field.
The buttons for functions in dcm4chee-web can be divided into two the buttons placed in the header section
of the window, and the buttons placed next to the entities in the folder.
After typing in the search string in the related fields, a click on this button will perform a search in the database.
As an alternative, the "Return" button on the keyboard will also perform a search. For a more detailed descrip-
tion of the search field see Section 3.3.2, Search Filter.
A click on this button will show the previous page in the search. If the first page or the one and only page in a
search are shown, no activity is related to the button.
A click on this button will show the next page of records in the search (if the total amount of records is larger
than one page). If the last page or the one and only page in a search are shown, no activity is related to the but-
ton.
To add a new patient, click this button and fill out the fields in the window. The fields are:
Patient ID
The ID of the patient typically a person number, social security number, or another unique patient identi-
fier generated or handled by a Hospital Information System, Patient Administration System, or a Radiology
dcm4chee 2.9.1 14
User Interface Guide
Information System.
Issuer of Patient ID
Identifier of the assigning authority (system, organization, agency or department) that issued the Patient ID.
Patient Name
The name of the patient.
Sex
Choose sex between Female, Male, and Other (unknown) clicking on the arrow.
Birth Date
The birth date of the patient in the format yyyy/mm/dd
To merge two (or more) patients in dcm4chee-web, the patients must be marked (selected) by clicking the
checkbox next to the patients. The boxes will now contain a checkmark. It is not possible to merge patients by a
checkmark at the study or series level.
After the patients have been marked in the folder list, click on the button "Merge Selected Patients". This shows
the list of patients that will be merged. In the column Patient ID click the checkbox to mark which patient
should be the remaining patient. Click Merge to merge the patients or Cancel to cancel the operation.
dcm4chee 2.9.1 15
User Interface Guide
To move one or several items, the source and the destination must be selected. To select a source or a destina-
tion just mark it in the checkbox next to the entity.
The destination is always at the highest selected level in the hierarchic patient, study, series and instance.
The source will always be the entity (or entities) at the lowest level in the hierarchic patient, study, series,
and instance.
The sources have to be only one hierarchic level under the destination.
1. Click the checkbox next to the study (or studies) to mark it.
1. Click the checkbox next to the one (or several) series to mark it.
To export an entity or several entities (patient, study, series, or instance/image), click the checkbox next to the
line or lines to mark the entity/entities.
Click the button "Export selected instances to Teaching File Sytem" to export the entity or entities marked.
In the next window you can select different export options and define optional included additional Teaching
File Information.
dcm4chee 2.9.1 16
User Interface Guide
In the next window you can edit your XDS-I metadata, which will be exported with selected entities as Key
Objects.
To delete an entity or several entities (patient, study, series, or instance/image) click the checkbox next to the
line or lines to mark the entity/entities.
dcm4chee 2.9.1 17
User Interface Guide
Click the button "Delete Selected Entities" to delete the entity or entities marked. Confirm or cancel the opera-
tion by clicking the appropriate button in the ensuing confirmation pop-up window.
If you want to permanently delete the entities, you have to select the Trash folder and select the entities, which
you want to delete. then press the "Delete selected Entities" button to permanently delete the entities.
To undelete entities in the Trash folder you have to press the "Undelete" button.
To send an entity or several entities (patient, study, series, or instance/image) to a DICOM destination click the
checkbox next to the line or lines to mark the entity/entities.
From the drop-down menu choose which AE Title to send the entity or entities to.
Click the "Send Selected Entities to Specified Destination" button to send the entity or entities marked. Con-
firm or cancel the operation by clicking the appropriate button in the ensuing confirmation pop-up window.
Click the "Update" button to update the patient attributes or "Cancel" to quit without updating the attributes.
dcm4chee 2.9.1 18
User Interface Guide
Click the "Update" button to update the study attributes or "Cancel" to quit without updating the attributes.
Click the "Update" button to update the series attributes or "Cancel" to quit without updating the attributes.
dcm4chee 2.9.1 19
User Interface Guide
All fields can contain alphanumeric characters, except the Date/Time field, where the format yyyy/mm/dd
should be used.
Click the "Add Study" button to add the new study or "Cancel" to quit without adding a new study.
All fields can contain alphanumeric characters, except the Date/Time field, where the format yyyy/mm/dd
should be used.
dcm4chee 2.9.1 20
User Interface Guide
Click the "Add Series" button to add the new series or "Cancel" to quit without adding a new series.
Click the "View Image" button to show the image. Icon appearances are dependent on the instance type/state.
Click the "View Report as HTML" button to show the structured report as HTML document. Icon appearances
are dependent on the instance type/state.
Click the "View Report as PDF" button to show the structured report as pdf document. Icon appearances are de-
pendent on the instance type/state.
Click the "View WaveForm" button to show the WaveForm object as PDF. Icon appearances are dependent on
the instance type/state.
3.3.3.2.10. Offline
Indicates that the instance is offline. Icon appearances are dependent on the instance type/state.
dcm4chee 2.9.1 21
User Interface Guide
AE Title
The AE Title (AET) of the remote application
Hostname
Host name or IP-address of the host of the remote application.
Port
TCP port number of the remote application.
Cipher
TLS Cipher Suites which are supported on this connection. No entry implies a direct (unsecure) DICOM
connection (without TLS).
To create a new connection click button (Add New AET), and the window for creating a new
AET opens.
Fill in the appropriate information for AE Title, Hostname (or IP-Address), Port number, and Cipher (for TLS
connections over an un-trusted network connection). Be careful to type in the right information -
dcm4chee-web only checks if the Port number is a number (if not, the value is changed to "0"). Click on Create
to create the entry in the AET-list or Cancel to leave without creating the entry in the AET-list.
For DICOM over TLS connections you can configure support of up to 3 different Cipher Suites:
SSL_RSA_WITH_NULL_SHA
No Encryption, only Entity Authentication by RSA based certificates & Data Integrity check by SHA hash-
ing function
TLS_RSA_WITH_AES_128_CBC_SHA
Use AES_128_CBC for Encryption
SSL_RSA_WITH_3DES_EDE_CBC_SHA
Use Triple DES EDE, CBC Encryption
dcm4chee 2.9.1 22
User Interface Guide
1. TLS_RSA_WITH_AES_128_CBC_SHA
2. SSL_RSA_WITH_3DES_EDE_CBC_SHA
3. ...
Prefer AES Encryption, with Triple DES EDE, CBC Encryption being acceptable alternatives. Try to avoidus-
ing no Encryption (SSL_RSA_WITH_NULL_SHA ).
To change an entry in the AET-list click on the (Edit), and the information for this entry is shown.
After changing the information click "Apply Changes" to apply the new information to the AET list or Cancel
to leave without changing the information.
To delete an entry, click the (Delete) icon and click OK in the ensuing confirmation pop-up window. To
cancel the deletion click the Cancel button.
In the Media Status pull down list it is possible to choose one or more (using SHIFT of CTRL keys on the key-
board together with a click on the left mouse button) of the following statuses:
all
List all File Sets.
OPEN
Search for open file set file set that are not scheduled for media creation, and therefore new studies can be
added for offline storage
FAILED
dcm4chee 2.9.1 23
User Interface Guide
Search for filesets, that failed for one or another reason during media creation.
QUEUED
Search for filesets, that are queued scheduled for media creation.
TRANSFERRING
Search for filesets, that are transferring transfer files to media creation server.
CREATING
Search for filesets, that are during creation for the time being.
COMPLETED
Search for filesets, that are completed
It is also possible to search for items in a specific time interval. The search can be for all activities, for media
initialization dates, or for media modification dates. The time interval should be in the format: yyyy/mm/dd
hh:mm:ss.
Fileset ID
The ID of the fileset
Initialized
The date and time where the media content was scheduled
Modified
The last date and time where the scheduled media content was modified
Usage
The usage of the media (in KB, MB, or GB)
Status
Shows status of the file set:
Action
Schedule open file set for media creation.
Delete file set - so associated files will be reassigned to another file set for media storage.
A new search is performed by either pressing the (New Search) or the Enter key at the keyboard.
If dcm4chee's Media Creation Service is configured to manual actitvation of the burning process, the adminis-
trator will receive an e-mail with information about the media. The administrator can see the status at the web-
page and start the burning process by activating the start button .
dcm4chee 2.9.1 24
User Interface Guide
If dcm4chee's Media Creation Service is configured to automatic actitvation of the burning process, the admin-
istrator will only have to check the job status occasionally.
If a media has a status of failed you may try a manual restart of the burning process by activating the
start button .
By use of one or several search fields it is possible to search for specific information in the database. The
search fields are:
Patient
The patient name
Date
The date and time (format: yyyy/mm/dd hh:mm) where the search should begin.
dcm4chee 2.9.1 25
User Interface Guide
to
The date and time (format: yyyy/mm/dd hh:mm) where the search should end
Modality
Type of modality (e.g. MR, CT, CR, and US)
Station AET
The specific Application Entity Title of the modality
Accession No
The specific accession number for a study
The available functions are the (New Search) button that will perform the search (alternative: press the
Enter key) and the (Delete) button next to the records in the folder information. Pressing will delete the
record.
The modality worklist (MWL) information is shown in the table. The columns of the table are:
ID
Scheduled Procedure Step ID
Study IUID
Study Instance Unique Identifier
Req. Proc. ID
Requested Procedure ID
Acc. No.
Accession Number
Filler/Placer Order
Filler Order Number and the Placer Order Number.
Proc. Desc.
Requested Procedure Description.
SPS Desc.
Scheduled Procedure Step Description.
Start Date
Scheduled Start Date/Time for this Procedure Step.
Ref. Physician
Name of the Referring Physician
Station
Name of scheduled device (modality) for this Procedure Step.
Adm. ID
Admission ID (Visit Number)
Patient
The name (and ID) of the patient
dcm4chee 2.9.1 26
User Interface Guide
Birthdate
The date of birth for the patient
Sex
The sex of the patient
By using one or several search fields it is possible to search for specific information in the database. The search
fields are:
Patient
The patient name.
Date
The date and time (format: yyyy/mm/dd hh:mm) when the search should begin.
to
The date and time (format: yyyy/mm/dd hh:mm) where the search should end.
Modality
Type of modality (e.g. MR, CT, CR, and US).
Station AET
The specific Application Entity Title of the modality.
Accession No.
The specific accession number for a study. If box is checked the search will include unscheduled examina-
tions.
Status
[ANY]: Will include all types in the search.
IN PROGRESS: Will only include procedures, that are in progress, in the search.
COMPLETED: Will only include procedures, that are completed, in the search.
DISCONTINUED: Will only include procedures, that are discontinued, in the search.
The available functions are the (New Search) button that will perform the search (alternative: press the
dcm4chee 2.9.1 27
User Interface Guide
Enter key) and the (Next Search Results) button, which will show the next page of records in the search
result.
The information regarding the modality performed procedure step worklist (MPPS) are shown in the table. The
columns in the table are:
Acc. No.
The accession number of the study.
Status
IN PROGRESS: Will only include procedures, that are in progress, in the search.
COMPLETED: Will only include procedures, that are completed, in the search.
DISCONTINUED: Will only include procedures, that are discontinued, in the search.
Study IUID
The Study Instance UID.
Proc. Desc.
Description of the performed procedure.
Start Date
The date and time, when the procedure step started.
Station
Name of device (modality) on which this Procedure Step was performed.
NoI
The number of instances.
Patient
The patient name.
dcm4chee 2.9.1 28
User Interface Guide
Roles are shown for each user. The four roles that can be combined for a user are:
WebUser
A user in this role is allowed to use this web interface.
WebAdmin
A user in this role has administrative rights within the web interface. To have WebAdmin rights the user
also has to have the WebUser rights.
Admin
This role is used to allow configuration access via the JMX Console.
AuditRep
Members of this role are allowed to access the Audit Repository.
To add a new user click (add new user) and fill in the appropriate information in the following window:
dcm4chee 2.9.1 29
User Interface Guide
User ID
The user ID for the user should have.
Password
The belonging password.
Retype Password
The password again.
The roles for the user can be check with a in the appropriate checkboxes:
WebUser
A user in this role is allowed to use this web interface.
WebAdmin
A user in this role has admin rights in the web interface. To have WebAdmin rights the user also has to
have the WebUser rights.
Admin
This role is used to allow configuration access via the JMX Console.
AuditRep
Members of this role are allowed to access the Audit Repository.
Press Create to create the new user or Cancel to quit without creating the user.
ATTENTION: Modifications of User Configuration may take up to half an hour to become effective!
The roles are checked or unchecked by clicking in the appropriate box. A in the box indicate, that the user
WebUser
A user in this role is allowed to use this web interface.
WebAdmin
A user in this role has admin rights in the web interface. To have WebAdmin rights the user also has to
dcm4chee 2.9.1 30
User Interface Guide
Admin
This role is used to allow configuration access via the JMX Console.
AuditRep
Members of this role are allowed to access the Audit Repository.
To update the user profile press Update or Cancel to quit without changing the roles for the user.
ATTENTION: Modifications of the User Configuration may take up to half an hour to become effective!
To delete a user from dcm4chee-web click the (Delete) next to the user.
A confirmation pop-up window will appear. Press OK to delete the user or Cancel to quit without deleting the
user.
ATTENTION: Modifications of the User Configuration may take up to half an hour to become effective!
The list section shows the result from the search and selection done in the left side of the window. The columns
dcm4chee 2.9.1 31
User Interface Guide
Audit Event
The type of the event logged in the audit repository and shown in the list.
Host
The name of the host that sent the audit message.
Timestamp
The timestamp of the event. The format is: yyyy-mm-dd hh:mm:ss.sss
Information
A short description of the event.
In the search section it is possible to search for one of the following values, or for a combination of the follow-
ing values. It is not possible to type in part of a search value or to truncate a value in the search fields. If a value
is unknown, it is possible to use the search facility in the folder part to find the exact value to use in this sec-
tion.
Results to return
Typing in a figure in this field indicates how many results that should be shown on one page in the list.
Patient Name
The exact name of the patient that should be used in the search.
Patient ID
The exact patient ID that should be used in the search.
AE Title
The exact AE Title that should be used in the search.
Username
The exact username that should be used in the search.
Host
The hostname that should be used in the search.
TimeStamp
The two values (from and to) for exact time stamp, should be used in the search. The format is "yyyy-
mm-dd hh:mm:ss.sss" only whole values can be typed in (no truncation).
In this section you can filter your results by choosing (one or several) audit log event types:
ActorConfig
Generated for any configuration changes related to the actor.
ActorStartStop
Start-up and shutdown of any actor. Is distinct from hardware power-up and shutdown.
dcm4chee 2.9.1 32
User Interface Guide
AuditLogUsed
The audit trail repository has been accessed or modified by something other than the arrival of audit trail
messages.
BeginStoringInstances
Begin storing SOP Instances for a study. This may be a mix of instances.
DICOMInstancesDeleted
SOP Instances are deleted from a specific study.
DICOMInstancesUsed
Study is created, modified, or accessed. This report on addition of new instances to existing studies as well
as creation of new studies.
DicomQuery
A query has been received.
Export
Any export of PHI on media, either removable physical media such as CD-ROM or electronic transfer of
files such as email. Any printing activity, paper or film, local or remote, that prints PHI.
Import
Any import of PHI on media, either removable physical media such as CD-ROM or electronic transfers of
files such as email.
InstancesStored
Instances for a particular study have been stored on this system.
NetworkEntry
Mobile machine joins or leaves secure domain.
OrderRecord
Order record created, accessed, modified or deleted.
PatientRecord
Patient record created, modified, or accessed.
ProcedureRecord
Procedure record created, modified, accessed or deleted.
SecurityAlert
A secure node authentication failure has occurred during TLS negotiation, e.g. invalid certificate.
StudyDeleted
Shows events that have deleted studies.
UserAuthenticated
Shows events related to user authentication.
To se the detailed information from the list section click one of the events in the first column (Audit Event) or
the XML-hyperlink.
dcm4chee 2.9.1 33
User Interface Guide
The Audit Record Detailed View shows the host name, time and parameters for the event. The parameters will
be different for different types of events.
dcm4chee 2.9.1 34
Appendix A. Building from Source Code
A.1. Building the dcm4chee Archive
In order to build all components of the dcm4chee archive application you will need to download and install:
3. JBoss 4.0.3SP1 [http://labs.jboss.com/jbossas/download] (you have to fetch a binary package (e.g jboss-
4.0.3SP1.zip) and unpack it, running the installer does not work!)
5. Jakarta Cactus 1.7 for J2EE 1.3 [http://jakarta.apache.org/cactus/] (only needed to build test suite for
dcm4jboss-ejb - not need to build application)
Create an environment variable pointing to the Ant home directory (ANT_HOME) and add the
$ANT_HOME/bin directory to your PATH.
xdoclet.home=${user.home}/xdoclet-1.2.3
jboss.home=${user.home}/jboss-4.0.3SP1
fop.home=${user.home}/fop-0.20.5
cactus.home=${user.home}/jakarta-cactus-13-1.7
Instead of modifying the build script directly, you may adjust these values to your build environment by renam-
ing the file dcm4jboss-all/dcm4jboss-xxx/build.properties.default to
dcm4jboss-all/dcm4jboss-xxx/build.properties and modify the values in it.
if no patch utility is available [Windows] you have also to disable Oracle and DB2 build by setting or-
acle.nobuild=true and db2.nobuild=true in dcm4jboss-all/dcm4jboss-arr/build.properties and
dcm4jboss-all/dcm4jboss-ejb/build.properties.
cd dcm4jboss-all/dcm4jboss-build
and invoke:
ant dist
dcm4chee 2.9.1 35
Building from Source Code
target/dcm4chee-standalone-db2-%version%.zip
target/dcm4chee-standalone-hsql-%version%.zip
target/dcm4chee-standalone-mssql-%version%.zip
target/dcm4chee-standalone-mysql-%version%.zip
target/dcm4chee-standalone-oracle-%version%.zip
target/dcm4chee-standalone-psql-%version%.zip
dcm4chee 2.9.1 36