Installing Weasis in DCM4CHEE

Skip to end of metadata
Go to start of metadata

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 (or other removable device) 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.
    • From the folder with the latest version number:
      • weasis.war
      • weasis-i18n.war - Optional for internationalization (translation)
    • From weasis-pacs-connector folder:
      • dcm4chee-web-weasis.jar
      • weasis-pacs-connector.war
Download issue
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.
      Download weasis-connector-default.properties and rename it weasis-pacs-connector.properties
      Download weasis-jnlp-default.xml and rename it weasis-jnlp.xml
      Download issue
      From github interface, click on "raw" button for downloading the file with the "save as..." menu of the browser.
    • Copy the files into a folder in the classpath of the servlet container. In JBoss (inferior to version 7), 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. It Allows to change Java VM properties and some parameters of the launcher.

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


For dcm4chee-web (classic - before 2.17.1)

dcm4chee version
dcm4chee-web.war has been built only for some dcm4chee versions. For other versions see Rebuild dcm4chee-web from any version)
  • 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
Embedding a Java Runtime for Windows
The executable (weasis-win32.exe) allows to embed a JRE in the directory "jre/windows" (weasis-portable/jre/windows/bin/java.exe). The embedded Java Runtime is used only when no runtime is available on the system. When Java is run from CD, it could be a little slow.
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Dec 30, 2010

    Anonymous says:

    Fantastic and worked like a charm.. way to go..

    Fantastic and worked like a charm..

    way to go..

  2. May 04, 2011

    Fabrizzio Salazar says:

    grettings i'm new in this solution, recently i installed the dcm4chee solution ...

    grettings

    i'm new in this solution, recently i installed the dcm4chee solution on a Windows Server 2003, using jboss ass a webserver, and it's works.

    now,i am trying  to incorporate this weasis solution, and i copied the two war files and reload the jboss wserver, but i don´t know how to modify the permissions. without the modification of the permissions all works fine, but the weasis icon doesn't appear.

    please help with that; and sorry about my english

    Fabrizzio Salazar

    Ecuador

    1. May 07, 2011

      Fabrizzio Salazar says:

      the problem was solve. the permission's folder was change in C:\apps\dcm4chee-2....

      the problem was solve. the permission's folder was change in C:\apps\dcm4chee-2.16.2-mysql\server\default\conf\dcm4chee-web, folder.permissions file

      and this version of weasis only works with java 6-24, with 6-25 doesn't.

      i hope this info helps others new users.

      Fabrizzio Salazar

      Ecuador

      1. May 09, 2011

        Nicolas Roduit says:

        Update to Weasis 1.0.9 for working with Java 6 update 25.

        Update to Weasis 1.0.9 for working with Java 6 update 25.

        1. May 09, 2011

          Fabrizzio Salazar says:

          hi, thanks for the help i already donwload the needed files, but when i go to j...

          hi, thanks for the help

          i already donwload the needed files, but when i go to jmx i don't found the service=webconfig,

          i use the jboss4.2.3, where is the exacly link for that

          thanks

          Fabrizzio Salazar

          Ecuador

          1. May 09, 2011

            Nicolas Roduit says:

            This config is for the new dcm4chee-web3 interface at http://sourceforge.net/pro...

            This config is for the new dcm4chee-web3 interface at http://sourceforge.net/projects/dcm4che/files/dcm4chee-web/

  3. Jun 26, 2012

    jeffrey a. mendoza says:

    Thank you very much, made it working.

    Thank you very much, made it working.