Embedding in dcm4chee

This page explains how to integrate Weasis with dcm4chee-arc-light using weasis-pacs-connector. To launch Weasis without the connector, follow the alternative instructions.

Follow these steps for the integration with weasis-pacs-connector:

1. Install dcm4chee, if not already done (Installation with Docker is straightforward).

2. Go here and download weasis-pacs-connector.war — See Configuration Matrix below for the recommended version according to your dcm4chee-arc-light version.

3. Open the WildFly management console (at http://<your-host>:9990). Note: with some Keycloak versions, the management console may not be accessible.

   • Select the “Deployments” tab
   • Add weasis-pacs-connector.war using the “Add” button (Choose Upload a new deployment or select Replace when the file already exists)
     Note

     Alternatively one may deploy the .war using JBoss Command Line Interface Console.

4. Configure weasis-pacs-connector (optional if default settings are sufficient).
   The default configuration is stored in two files inside weasis-pacs-connector.war. To override the default configuration:

   • Download the current download>weasis-pacs-connector.properties and download>dicom-dcm4chee-arc.properties (configuration of the dcm4chee archive)
   • Edit the configuration as needed. For example, dcm4chee may be running on a different computer than Weasis, or the AE Title of dcm4chee may have been changed. If so, edit weasis-pacs-connector.properties or dicom-dcm4chee-arc.properties (Change pacs.host, pacs.port, and pacs.aet).
   • Copy weasis-pacs-connector.properties and dicom-dcm4chee-arc.properties into $WILDFLY_HOME/standalone/configuration (where $WILDFLY_HOME is the path of the running Wildfly).
     With the docker installation use the docker copy command ($ docker cp …)
     Tip

     Instead of copying the files into $WILDFLY_HOME/standalone/configuration, JBoss Command Line Interface Console can be used to override files in the war. Add the two configuration files with the deployment-overlay command:
     

     deployment-overlay add --name=dcm4chee-arc --deployments=weasis-pacs-connector.war --content=WEB-INF/classes/weasis-pacs-connector.properties=/tmp/weasis-pacs-connector.properties,WEB-INF/classes/dicom-dcm4chee-arc.properties=/tmp/dicom-dcm4chee-arc.properties --redeploy-affected

   • To apply the new configuration, from the management console “Disable” weasis-pacs-connector.war then “Enable”

5. To activate Weasis in the dcm4chee-arc-light user interface (See also Invoke Image Display in dcm4chee): you need to add attributes by either editing docker-compose.env (from 5.22.0) or from the left menu Configuration > Devices > dcm4chee-arc > Extensions > Edit extension > Child Objects > Web Applications > DCM4CHEE:

   • Configure the URL for a view button at patient or study level and then copy the properties from Configuration Matrix.
     • From dcm4chee-arc-light 5.10.2 to 5.19.0, the left menu: Configuration > Devices > dcm4chee-arc > Extensions > Archive Device
     • From dcm4chee-arc-light 5.19.1 the left menu: Configuration > Devices > dcm4chee-arc > Extensions > Edit extension > Child Objects > Web Applications > DCM4CHEE
     • From dcm4chee-arc-light 5.22.0 by editing docker-compose.env (allows applying properties at deploy time). Note: the character & must be escaped (e.g., IID_STUDY_URL=../../weasis-pacs-connector/weasis?studyUID={{studyUID}}\\&access_token={{access_token}})
       Note

       URL parameters

       • access_token is necessary in secure mode (secured RESTful services) from dcm4chee-arc-light 5.15.1
       • _self avoids opening a new empty window in the browser
         
   • InfoOptional Add other properties in the URL.
   • Refresh the web page and the view button should appear as in the screenshot above
   • To launch the viewer from the web portal, the client computer must have installed the Weasis package.

Configuration Matrix

dcm4chee-arc-light 5.10.2 to 5.19.0

Unsecured Mode

Secured Mode (from 5.15.1)

dcm4chee-arc-light 5.19.1 to 5.22.1

Unsecured Mode

Secured Mode

dcm4chee-arc-light 5.22.2 to 5.30.x

Unsecured Mode

Secured Mode

dcm4chee-arc-light 5.31.0+

Unsecured Mode

Secured Mode