This project builds a Docker image for the DCM4CHEE medical image manager/archive. The Docker image includes DCM4CHEE 2.18.1 running on a JBoss webapp server, backed by a MySQL database. Installing DCM4CHEE from scratch is a non-trivial exercise, so using a pre-built Docker image can save a lot of time. This image improves on dpatriarche dcm4chee-2.17.3 image.
The 'dcm4chee' image is built as follows:
docker build --rm=true -t dcm4chee .
Once built the 'dcm4chee' image is run as follows:
docker run -p 8080:8080 -p 11112:11112 -p 3306:3306 --name="pacs" dcm4chee
Note that three ports must be mapped. Port 8080 is used by the DCM4CHEE web UI, while port 11112 is the DICOM port through which PACS workstations can perform DICOM network actions such as searching the archive, and downloading and uploading medical images. Port 3306 is optional, and exposed in order to access the MySQL DB through (e.g.) MySQLWorkbench.
For convenience, shell scripts for the above actions are provided: build.bash to build the image, and run.sh to run a container based on the image.
This image has been successfully built based on Ubuntu 14.04 and Debian Wheezy.
Java 6=>7 seems to work (web3 and arr UI start correctly) but there are some exceptions from JBoss.
Once a dcm4chee container is running its web UI available at http://localhost:8080/dcm4chee-web3. Audit repository is available at http://localhost:8080/dcm4chee-arr.
The default Administrator login is 'admin', password 'admin'. This admin password can be changed in the web UI, and new users with reduced permissions can be added.
Also included is the dcm4che-2.0.29 toolkit in order to be able to upload DICOM files.
The server's default Application Entity (AE) title is 'DCM4CHEE'. If you need to change the AE title (for example beause you already have a server with the same name) it is done through the JMX management interface at http://localhost:8080/jmx-console. Follow the link service=AE to the configuration page for the AE service (under the 'dcm4chee.archive' heading). Invoke the operation updateAETitle(), specifying the old AE title 'DCM4CHEE' and your AE title as parameters.
DICOM communications between two parties, such as a client image viewer app and a DCM4CHEE server, require the AE info of each party to be configured on the other party to allow them to talk to each other. So on your client app you must at least configure theserver's AE title, host name (or IP address), and port number, and on the server you must at least configure the client's AE title, host, and port. The DCM4CHEE web UI provides a 'DICOM Echo' facility to test the server to client connection, and your client app should also provide a similar facility to send a DICOM Echo to the server. Once you have finished configuring AE info, and you have verified that each side can successfully send a DICOM Echo to the other side, you are ready to store DICOM images to your DCM4CHEE server.