Installing latest DCM4CHEE and Weasis web viewer with MS SQL or My SQL


DCM4CHEE sites entitled detailed installation and website can found here

Step 1: Download your latest favorable database version DCM4CHEE , I exercised with My SQL and MS SQL from this link.

Now go to your system drive any C: D: or any and create folder "apps" and full path will be c:\apps or d:\apps

Extract and move the downloaded dcm4chee to c:\apps\ in such way that the full exact path would be  C:\apps\dcm4chee-2.18.0-mssql

Step 2: Download and Install MS SQL Server or My SQL Server.

if you are comfort with using MS SQL server you should follow below DCM4CHEE site link for the SQL Server configuration.

I have gone through and succeed, also faced some sql server configuration problem like 1443 port should open etc.. but can resolve easily.

If you want to use My SQL Server version then Download MySQL server
I downloaded mysql-5.1.73-winx64.msi from 
depends on your OS 32 bit or 64 bit.

Step 3: Download and Install JBOSS 4.2.3 GA 

I have downloaded and integrated

After download please extract same way as you done for step 1 DCM4CHEE download and then path will be C:\apps\jboss-4.2.3.GA

Step 4: Download and Extract Audit Report Repository

I used C:\apps\dcm4chee-arr-3.0.12-mssql latest version and available at
and of course there might be latest version you can use it.

To install dcm4chee navigate using command prompt (cmd.exe) (type cmd in Start menu>run box then right click on the cmd.exe that shows up and select Run as Adminstrator) to  C:\apps\dcm4chee-2.18.0-mssql\bin then type install_jboss.bat c:\apps\jboss-4.2.3.GA

Step 5: Setting up My SQL or MS SQL database

While still in command prompt, navigate to: 


or Open My SQL command prompt

type the following commands: mysql -uroot -p it will ask for your password. Put the password you used when installing MySQL. Then mysql> will appear. Follow below: 

mysql> create database pacsdb; 
mysql> grant all on pacsdb.* to ‘pacs’@’localhost’ identified by ‘pacs';  
mysql> \q > mysql -upacs -ppacs pacsdb < create.mysql 

then setup arrdb 
mysql> create database arrdb; 

and for arrdb it would be 
mysql> grant all on arrdb.* to ‘arr’@’localhost’ identified by ‘arr’;

For MS SQL, follow tutorial from DCM4CHEE as i stated above.

Step 6: Setup ARR into DCM4CHEE

Navigate to  C:\apps\dcm4chee-2.18.0-mssql\bin and type 

install_arr.bat C:\apps\dcm4chee-arr-3.0.12-mssql

Step 7: Install Weasis web viewer into DCM4CHEE

DCM4CHEE site instructions are available at
Download latest version of weasis , go to the below URL and download latest weasis.war

Also download latest devloped weasis pacs connector from below url

Place these files into the deploy folder (C:\apps\dcm4chee-2.18.0-mssql\server\default\deploy) of dcm4chee 

Download also DCM4CHEE web for your picked database either MySQL or MS SQL from below link

exctract same way as mentioned in step1 and path would be


Move to the bin folder of C:\apps\dcm4chee-web-3.0.4-mssql\bin and execute the command install.bat  and point to the installation of your dcm4chee install.bat C:\apps\dcm4chee-2.18.0-mssql 

Step 8: Activate Weasis

Now download and installation has been done, its time to run the setup

Go to C:\apps\dcm4chee-2.18.0-mssql\bin
and type run.bat
Open your web browser and type:


Input your username: admin and password: admin

To activate Weasis, go in jmx-console of dcm4chee:
In dcm4chee.web 
select service=WebConfig and
 set these two values:
From weasis-pacs-connector 5.0 WebviewerBaseUrl can have different values:
Launch Weasis as an external application (default value when NONE): WebviewerBaseUrl = weasis:/weasis-pacs-connector/viewer
Launch Weasis as an Applet in the web browser: 
WebviewerBaseUrl = weasis:/weasis-pacs-connector/viewer-applet
Click the Apply Changes button.

Step 9: Launch the Show

Setup should be finished now. 

To start dcm4chee you can use run.bat from


and wait untill below server started message appear

Open your browser and point it to:

and after logged in same admin/admin you can assign role to view add patient and edit studies.

To pull DICOM images or studies or patient data into DCM4CHEE you can use my standalone utility.

and setup zip file and instructions are available at!topic/dcm4che/xgVpR6YY7y8


Correct Way to Update AE Title:

1 . Go to jmx-console
  1. Follow the link "service=AE" to the configuration page for AE (Application Entity - a DICOM term for a DICOM node on the network) service under the "dcm4chee.archive" heading.
  2. Invoke the operation updateAETitle with the old AE Title (DCM4CHEE if unchanged from the default), and new AE Title as parameters.

2. if weasis image open  not working then go through below tutorial at Point Configure Weasis

and place these renamed file into server/default/conf  and then it will work.


  1. I will provide more resolution if anyone stuck during installation and other configuration to make DCM4CHEE work all the way.


  2. I used DCMSEND Utility and HL7TOXML Converter Utility and worked perfect as my needs, thanks for posting..

  3. Hi Aifaz,
    I did the same setup as described here. Have JBoss running and log into dcm4chee. Used dcm4che toolkit 'dcmsend' to send a dcm image to dcm4chee without success. Execute the 'dcmsend' command did not generate any error message. But searching the archive in dcm4chee UI resulted in nothing. Search database, pacsdb, for values in the table Query the table for study, series, all returned empty set. Looked into the server.log at the time when the dcm file was sent, there were lots of this statement issued.

    2015-09-09 21:31:12,538 INFO -> (Thread-53) [org.dcm4chex.archive.mbean.FileSystemMgt2Service] Check file system group ONLINE_STORAGE for deletion of orphaned private files

    But occasionally, throughout the entire log, I saw this statement:

    2015-09-09 21:30:35,643 WARN -> (http- [org.dcm4chee.web.common.login.LoginResources] Could not get locale us for login page

    Can you tell me what might have gone wrong?
    I have use another PACS to sent dcm files to my dcm4chee. The files were sent without error but dcm4chee never received them.

    All these file transfer were within my computer and not over a network. I had turned off the firewall to see if that was the cause of the problem. Same result. Any suggestion?

    1. This comment has been removed by the author.

  4. hi, can you share your source code for the stand alone utility to pull studies on dcm4chee, or some instructions of how to do applications for my own, thank you, yours very truly, kF

    1. setup zip file and instructions are available at!topic/dcm4che/xgVpR6YY7y8

  5. Hi,
    I need help in installing DCM4CHEE.. I have downloaded and extracted all the above said files with the paths:
    but when i try to install jboss ,
    C:\apps\dcm4chee-2.18.3-mysql\bin>install_jboss.bat C:\apps\jboss-4.2.3.GA
    it shows
    'install_jboss.bat' is not recognized as an internal or external command,
    operable program or batch file.

    Pls help me go forward

    1. install_jboss.bat should be in the dcm4chee\bin directory, Could you pls check bin directory

    2. Hi
      Thanks.. Installed Jboss

      But still there is problem in verification problem.
      when i execute run.bat it shows error ( I am using Windows10)

      ‘MySQL’ is not recognized as an internal or external command,
      operable program or batch file.
      ‘MySQL’ is not recognized as an internal or external command,
      operable program or batch file.

      JBoss Bootstrap Environment

      JBOSS_HOME: C:\apps\dcm4chee-2.18.1-mysql

      JAVA: C:\Program Files\Java\jdk1.8.0_91\bin\java

      JAVA_OPTS: -Djava.library.path=”C:\apps\dcm4chee-2.18.1-mysql\bin\native” -server -Xms128m -Xmx512m -XX:MaxPermSize=128m -Djboss.messaging.ServerPeerID=0 -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000

      CLASSPATH: C:\Program Files\Java\jdk1.8.0_91\lib\tools.jar;C:\apps\dcm4chee-2.18.1-mysql\bin\run.jar

    3. Que: Hi Aifaz
      I sorted out the MySql problem.. but still there are some issues in executing run.bat


      JBoss Bootstrap Environment

      JBOSS_HOME: C:\app\dcm4chee-2.18.1-mysql

      JAVA: C:\Program Files (x86)\Java\jdk1.6.0_45\bin\java

      JAVA_OPTS: -Djava.library.path="C:\app\dcm4chee-2.18.1-mysql\bin\native" -server -Xms128m -Xmx512m -XX:MaxPermSize=128m -Djboss.messaging.ServerPeerID=0 -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000

      CLASSPATH: C:\Program Files (x86)\Java\jdk1.6.0_45\lib\tools.jar;C:\app\dcm4chee-2.18.1-mysql\bin\run.jar

      Answer : I believe MySql no longer supports "TYPE=InnoDB". This syntax has been changed to "ENGINE=InnoDB" instead. If you can change this in your table create script that might fix the issue.

      The work around is to find this file

      Open it in a text editor. Find all instances of type=. Replace them with engine=.


    4. Hi Aifaz,

      Everything corrected. But still its :


      JBoss Bootstrap Environment

      JBOSS_HOME: C:\app\dcm4chee-2.18.1-mysql

      JAVA: C:\Program Files (x86)\Java\jdk1.6.0_45\bin\java

      JAVA_OPTS: -Djava.library.path="C:\app\dcm4chee-2.18.1-mysql\bin\native" -server -Xms128m -Xmx512m -XX:MaxPermSize=128m -Djboss.messaging.ServerPeerID=0 -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000

      CLASSPATH: C:\Program Files (x86)\Java\jdk1.6.0_45\lib\tools.jar;C:\app\dcm4chee-2.18.1-mysql\bin\run.jar

      Caused by: org.jboss.resource.JBossResourceException: Could not create connection; - nested throwable: (java.sql.SQLException: Access denied for user 'pacs'@'localhost' (using password: YES))

  6. Hi Aifaz,
    First of all thank you for taking the time to post this helpful instructions and assit others.

    I'm having trouble install the arr
    I'm uisng "dcm4chee-arr-4.1.0-mysql" and "dcm4chee-2.18.1-mysql"

    When I run this command:

    C:\pacsdb\dcm4chee-2.18.1-mysql\bin>install_arr.bat c:\pacsdb\dcm4chee-arr-4.1.0-mysql

    I get this:

    Could not locate dcm4chee-arr in c:\pacsdb\dcm4chee-arr-4.1.0-mysql.

    1. Please check/edit install_arr.bat and see there should be version of your file arr-4.1.0, if not then make this version, and it will work.

    2. Try using dcm4chee-arr-3.0.11-mysql

  7. In JMX Console i dont find any service=WebConfig .. :(

  8. Hi I have a question. In the instruction No.8: activate weasis

    Input your username: admin and password: admin

    To activate Weasis, go in jmx-console of dcm4chee:
    In dcm4chee.web
    select service=WebConfig and

    when I click the select service=WebConfig. it go HTTP status 500.
    what can I do next?

  9. hello ,
    This is bothering me a lot , what is the difference between dcm4chee-2.x & dcm4chee-arc-light ?


Post a Comment

Popular posts from this blog

Create 270 X12 Eligibility Request Message using C# (MS .NET)

SQL - Queries Tuning and Optimization Techniques