dcm4chee-arc-light admin/user manual

1,840 views
Skip to first unread message

Ben Sip

unread,
Feb 10, 2022, 1:27:56 PM2/10/22
to dcm4che
Hi,

I am completely new to PACS &  DICOM stuffs.

I have managed to install dcm4chee-arc-light 5.25.1 I have access to the UI but don't know how to configure dcm4chee-arc-light to accept ORM, create worklist, retrieve the order on modality, process and send back to archive for storage.

Any pointer will be highly appreciated. 
Screenshot_20220210_192640.png

Paul

unread,
Feb 11, 2022, 12:59:57 PM2/11/22
to dcm4che
I think their github wiki is the main source of user-friendly manuals.

Ben Sip

unread,
Feb 13, 2022, 5:32:35 PM2/13/22
to dcm4che
"By default, the archive is pre-configured with a * HL7 Application which implies that it can receive any of the configured accepted message types irrespective of the Receiving application and facility name (MSH-5 and MSH-6) values in the incoming HL7 messages."


Using HL7 Inspector I don't get any acknowlegement:
Message send
Waiting for acknowledge message...


This is the sample message I sent:
MSH|^~\&|MESA_OF|XYZ_RADIOLOGY|MESA_IM|XYZ_IMAGE_MANAGER|202202131512||ORM^O01|100112|P|2.3.1|||||||
PID|||M4001^^^ADT1||KING^MARTIN||19450804|M||WH|820 JORIE BLVD^^CHICAGO^IL^60523|||||||20-98-4000||||||||||||||||||||
PV1||E|ED||||1234^WEAVER^TIMOTHY^P^^DR|5101^NELL^FREDERICK^P^^DR|0000^Consulting^Doctor^P^^DR|HSR|||||AS||0000^Admitting^Doctor^P^^DR||V100^^^ADT1|||||||||||||||||||||||||200008201100|||||||V
ORC|NW|A100Z^MESA_ORDPLC|B100Z^MESA_ORDFIL||SC||1^once^^^^S||200008161510|^ROSEWOOD^RANDOLPH||7101^ESTRADA^JAIME^P^^DR|Enterer^^Location^EL^00000|(314)555-1212|200008161510||922229-10^IHE-RAD^IHE-CODE-231|
OBR|1|A100Z^MESA_ORDPLC|B100Z^MESA_ORDFIL|P1^Procedure 1^ERL_MESA^X1_A1^SP Action Item X1_A1^DSS_MESA|||||||||xxx||Radiology^^^^R|7101^ESTRADA^JAIME^P^^DR||$ACCESSION_NUMBER$|$REQUESTED_PROCEDURE_ID$|$SCHEDULED_PROCEDURE_STEP_ID$||||MR|||1^once^^^^S|||WALK|||||||||||A|||$PROCEDURE_CODE$
ZDS|1.2.4.0.13.1.432252867.1552647.1^100^Application^DICOM

Vrinda Nayak

unread,
Feb 14, 2022, 3:30:42 AM2/14/22
to dcm4che
Not reproducible with hl7snd tool. Success acknowledgement is received without any issues and MWL is created in archive

hl7snd -c localhost:2575 /home/vrinda/test.hl7  
09:28:23.776 INFO  - Initiate connection from 0.0.0.0/0.0.0.0:0 to localhost:2575
09:28:23.794 INFO  - Established connection Socket[addr=localhost/127.0.0.1,port=2575,localport=45975]
09:28:23.805 INFO  - Socket[addr=localhost/127.0.0.1,port=2575,localport=45975] << MSH|^~\&|MESA_OF|XYZ_RADIOLOGY|MESA_IM|XYZ_IMAGE_MANAGER|202202131512||ORM^O01|100112|P|2.3.1|||||||
PID|||M4001^^^ADT1||KING^MARTIN||19450804|M||WH|820 JORIE BLVD^^CHICAGO^IL^60523|||||||20-98-4000||||||||||||||||||||
PV1||E|ED||||1234^WEAVER^TIMOTHY^P^^DR|5101^NELL^FREDERICK^P^^DR|0000^Consulting^Doctor^P^^DR|HSR|||||AS||0000^Admitting^Doctor^P^^DR||V100^^^ADT1|||||||||||||||||||||||||200008201100|||||||V
ORC|NW|A100Z^MESA_ORDPLC|B100Z^MESA_ORDFIL||SC||1^once^^^^S||200008161510|^ROSEWOOD^RANDOLPH||7101^ESTRADA^JAIME^P^^DR|Enterer^^Location^EL^00000|(314)555-1212|200008161510||922229-10^IHE-RAD^IHE-CODE-231|
OBR|1|A100Z^MESA_ORDPLC|B100Z^MESA_ORDFIL|P1^Procedure 1^ERL_MESA^X1_A1^SP Action Item X1_A1^DSS_MESA|||||||||xxx||Radiology^^^^R|7101^ESTRADA^JAIME^P^^DR||$ACCESSION_NUMBER$|$REQUESTED_PROCEDURE_ID$|$SCHED
ULED_PROCEDURE_STEP_ID$||||MR|||1^once^^^^S|||WALK|||||||||||A|||$PROCEDURE_CODE$
ZDS|1.2.4.0.13.1.432252867.1552647.1^100^Application^DICOM

09:28:23.806 DEBUG - Socket[addr=localhost/127.0.0.1,port=2575,localport=45975] << MSH|^~\&|MESA_OF|XYZ_RADIOLOGY|MESA_IM|XYZ_IMAGE_MANAGER|202202131512||ORM^O01|100112|P|2.3.1|||||||
PID|||M4001^^^ADT1||KING^MARTIN||19450804|M||WH|820 JORIE BLVD^^CHICAGO^IL^60523|||||||20-98-4000||||||||||||||||||||
PV1||E|ED||||1234^WEAVER^TIMOTHY^P^^DR|5101^NELL^FREDERICK^P^^DR|0000^Consulting^Doctor^P^^DR|HSR|||||AS||0000^Admitting^Doctor^P^^DR||V100^^^ADT1|||||||||||||||||||||||||200008201100|||||||V
ORC|NW|A100Z^MESA_ORDPLC|B100Z^MESA_ORDFIL||SC||1^once^^^^S||200008161510|^ROSEWOOD^RANDOLPH||7101^ESTRADA^JAIME^P^^DR|Enterer^^Location^EL^00000|(314)555-1212|200008161510||922229-10^IHE-RAD^IHE-CODE-231|
OBR|1|A100Z^MESA_ORDPLC|B100Z^MESA_ORDFIL|P1^Procedure 1^ERL_MESA^X1_A1^SP Action Item X1_A1^DSS_MESA|||||||||xxx||Radiology^^^^R|7101^ESTRADA^JAIME^P^^DR||$ACCESSION_NUMBER$|$REQUESTED_PROCEDURE_ID$|$SCHED
ULED_PROCEDURE_STEP_ID$||||MR|||1^once^^^^S|||WALK|||||||||||A|||$PROCEDURE_CODE$
ZDS|1.2.4.0.13.1.432252867.1552647.1^100^Application^DICOM

09:28:25.242 INFO  - Socket[addr=localhost/127.0.0.1,port=2575,localport=45975] >> MSH|^~\&|MESA_IM|XYZ_IMAGE_MANAGER|MESA_OF|XYZ_RADIOLOGY|20220214092823.810||ACK^O01^ACK|1809439318|P|2.3.1|||||||
09:28:25.242 DEBUG - Socket[addr=localhost/127.0.0.1,port=2575,localport=45975] >> MSH|^~\&|MESA_IM|XYZ_IMAGE_MANAGER|MESA_OF|XYZ_RADIOLOGY|20220214092823.810||ACK^O01^ACK|1809439318|P|2.3.1|||||||
MSA|AA|100112|

09:28:25.242 INFO  - Close connection Socket[addr=localhost/127.0.0.1,port=2575,localport=45975]

mwl.png

Ben Sip

unread,
Feb 14, 2022, 12:56:07 PM2/14/22
to dcm4che
Still the same with hl7snd.
my aets
[{"dicomAETitle":"AS_RECEIVED","dicomDescription":"Retrieve instances as received","dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"},{"dicomAETitle":"DCM4CHEE","dicomDescription":"Hide instances rejected for Quality Reasons","dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"},{"dicomAETitle":"IOCM_EXPIRED","dicomDescription":"Only show instances rejected for Data Retention Expired","dcmHideNotRejectedInstances":true,"dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"},{"dicomAETitle":"IOCM_PAT_SAFETY","dicomDescription":"Only show instances rejected for Patient Safety Reasons","dcmHideNotRejectedInstances":true,"dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"},{"dicomAETitle":"IOCM_QUALITY","dicomDescription":"Only show instances rejected for Quality Reasons","dcmHideNotRejectedInstances":true,"dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"},{"dicomAETitle":"IOCM_REGULAR_USE","dicomDescription":"Show instances rejected for Quality Reasons","dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"},{"dicomAETitle":"IOCM_WRONG_MWL","dicomDescription":"Only show instances rejected for Incorrect Modality Worklist Entry","dcmHideNotRejectedInstances":true,"dcmAllowDeletePatient":"WITHOUT_STUDIES","dcmAllowDeleteStudyPermanently":"REJECTED"}]

What am I missing?

Ben Sip

unread,
Feb 14, 2022, 2:42:50 PM2/14/22
to dcm4che
my startup log
log.txt

Vrinda Nayak

unread,
Feb 15, 2022, 3:53:51 AM2/15/22
to dcm4che
The attached log does not show any reference of HL7 message sent to archive and any possible failure related to it. You may do a quick test by starting bare minimum unsecured archive and send hl7 message with hl7snd tool

Ben Sip

unread,
Feb 15, 2022, 6:49:36 AM2/15/22
to dcm4che
[org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-1) Accept connection Socket[addr=/192.168.0.2,port=38444,localport=2575]
log.txt

Ben Sip

unread,
Feb 15, 2022, 7:22:33 AM2/15/22
to dcm4che
2022-02-15 13:02:07,101 INFO  [org.dcm4che3.hl7.MLLPConnection] (EE-ManagedExecutorService-default-Thread-1) Socket[addr=/192.168.0.2,port=38444,localport=2575] >> MS>
2022-02-15 13:02:07,102 INFO  [org.dcm4che3.net.Connection] (EE-ManagedExecutorService-default-Thread-1) Close connection Socket[addr=/192.168.0.2,port=38444,localpor>
2022-02-15 13:02:07,106 WARN  [org.dcm4chee.arc.ups.process.impl.UPSProcessingScheduler] (EE-ManagedExecutorService-default-Thread-1) Failure on processing UPSProcess>
       at org.jboss...@3.1.8.Final//org.jboss.weld.bean.proxy.ContextBeanInstance.getInstance(ContextBeanInstance.java:85)
       at org.jboss...@3.1.8.Final//org.jboss.weld.bean.proxy.ProxyMethodHandler.getInstance(ProxyMethodHandler.java:131)
       at deployment.dcm4chee-arc-ear-5.25.1-mysql.ear.dcm4chee-arc-query-5.25.1.jar//org.dcm4chee.arc.query.impl.QueryServiceImpl$Proxy$_$$_WeldClientProxy.createUP>
       at deployment.dcm4chee-arc-ear-5.25.1-mysql.ear//org.dcm4chee.arc.ups.process.impl.UPSProcessingScheduler$ProcessWorkitems.processMatching(UPSProcessingSchedu>
       at deployment.dcm4chee-arc-ear-5.25.1-mysql.ear//org.dcm4chee.arc.ups.process.impl.UPSProcessingScheduler$ProcessWorkitems.run(UPSProcessingScheduler.java:171)
       at org.jbo...@26.0.1.Final//org.jboss.as.ee.concurrent.ControlPointUtils$ControlledRunnable.run(ControlPointUtils.java:125)
       at org.wildfly.secu...@1.18.3.Final//org.wildfly.security.auth.server.SecurityIdentity.runAsConsumer(SecurityIdentity.java:376)
       at org.wildfly.secu...@1.18.3.Final//org.wildfly.security.auth.server.Scoped.runAsConsumer(Scoped.java:112)
       at org.wildfly.secu...@1.18.3.Final//org.wildfly.security.auth.server.Scoped.runAs(Scoped.java:60)
       at org.jbo...@26.0.1.Final//org.jboss.as.ee.concurrent.SecurityIdentityUtils.lambda$doIdentityWrap$1(SecurityIdentityUtils.java:63)
       at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:515)
       at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264)
       at org.glassfish.javax.enterprise.concurrent//org.glassfish.enterprise.concurrent.internal.ManagedFutureTask.run(ManagedFutureTask.java:117)
       at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
       at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
       at java.base/java.lang.Thread.run(Thread.java:829)

Ben Sip

unread,
Feb 15, 2022, 7:27:15 AM2/15/22
to dcm4che

Full server.log
server.log

Vrinda Nayak

unread,
Feb 17, 2022, 8:38:04 AM2/17/22
to dcm4che
Have you tried quick test by starting bare minimum unsecured archive and send hl7 message with hl7snd tool suggested in an earlier? Also, in your attached log the ADT messages have just MSH logged whereas order message is fully logged which does not look right - as archive normally logs only MSH segment of received / sent HL7 messages.

Ben Sip

unread,
Feb 17, 2022, 9:17:45 AM2/17/22
to dcm4che
Hi,

I was able to send a HL7 ORM and received ack. See file attached but,

1. Had to do the installation on ubuntu 16 xenial instead debian 11

2. For opendj I changed  cp $DCM4CHEE_ARC/ldap/opendj/* $OPENDJ_HOME/config/schema/ to
cp $DCM4CHEE_ARC/ldap/opendj/* $OPENDJ_HOME/template/config/schema/ before running setup.

All other instructions were followed as stated in the wiki. I will load the UI now and see how it goes.

Thanks...

hl7.ack

Ben Sip

unread,
Feb 17, 2022, 9:33:22 AM2/17/22
to dcm4che

can see the order.
Screenshot_20220217_153207.png
Reply all
Reply to author
Forward
0 new messages