This page describes how to install Weasis.

Weasis is launched from the dcm4chee administrative web interface, as shown in the pictures below. It may also be copied to a CD with images.

For dcm4chee-web3 (new web interface)

• Install dcm4chee, if needed. The latest version and installation instructions can be found here.
  • dcm4chee-web3 is not compatible with versions of dcm4chee before 2.16.0
  • dcm4chee 2.16.0 to 2.17.0 are compatible with dcm4chee-web3, but the older dcm4chee-web is installed by default.
  • For dcm4chee 2.17.1+, dcm4chee-web3 is already installed. To check if it is the latest version, start dcm4chee-web3 (http://localhost:8080/dcm4chee-web3/), log in, and mouse over the dcm4chee.org icon in the upper right corner.

• Go here and download these Weasis files.
  • weasis.war
  • weasis-i18n.war - Optional for internationalization (translation)
  • dcm4chee-web3/dcm4chee-web-weasis.jar
  • dcm4chee-web3/weasis-pacs-connector.war
    Some browsers (Internet Explorer) may rename war files to zip. If so, use the Save As option when downloading. Change the name back to war.

• Place these files in the dcm4chee deploy folder (server/default/deploy/).

• To activate Weasis, go to the JMX console (at http://localhost:8080/jmx-console)
  • In dcm4chee.web select service=WebConfig and set these two values:
    WebviewerNames = weasis
    WebviewerBaseUrl = NONE
  • Click the Apply Changes button

• Configure Weasis
  The default configuration of Weasis is stored in two files inside weasis.war.
  To override the default configuration,
  • Go here.
    Select the latest version and navigate to src/main/resources
    Download weasis-connector-default.properties and rename it weasis-pacs-connector.properties
    Download weasis-jnlp-default.xml and rename it weasis-jnlp.xml
  • Copy the files to the classpath. The best location would typically be server/default/conf.
  • 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 been changed.
    If so, edit weasis-pacs-connector.properties. Change pacs.host, pacs.port, and pacs.aet.
    Changes to weasis-jnlp.xml are needed less often.

That's all, now restart dcm4chee and launch Weasis from the dcm4chee-web3 portal.

For dcm4chee-web (classic - before 2.17.1)

• Download at http://sourceforge.net/projects/dcm4che/files/Weasis/
  • The last Weasis version: weasis.war
  • The Weasis internationalization (translation): weasis-i18n.war (optional)
  • The modified dcm4chee web interface (dcm4chee-web/version/dcm4chee-web.war)

• Place these three files into the deploy folder (server/default/deploy/) of dcm4chee.

• Modify the permission in /dcm4jboss-web/src/etc/conf/dcm4chee-web/folder.permissions or in server/default/conf/dcm4chee-web if dcm4chee is already installed

folder.*=edit,move,delete,view,*export,edit.newStudyUID,mergepat,study_permission,study_permission.free_role_action,query_has_issuer folder.*export=export_tf,export_xds

...

folder=WebUser(send,view);DatacareUser(edit,move,delete,export_xds,view);WebAdmin(*)

That's all, now restart dcm4chee and launch Weasis from the web portal.

Write weasis-portable to DICOM CDs with dcm4chee-cdw

• Install dcm4chee-cdw (see doc/INSTALL.txt in the archive)
• Extract weasis-portable.zip into the ../dcm4chee/server/default/data/mergedir directory
• Go to the dcm4che jmx console (dcm4chee.cdw):
  •  Select the MediaCreationMgtSCP item and set to true the value of DefaultIncludeDisplayApplication
  •  Select the MakeIsoImage item and set to 4 the value of isoLevel
• Click on the Apply Changes button