Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Wiki Markup
{style}
.panel {-moz-border-radius: 7px;
border-radius: 7px;}
.panelMacro table {-moz-border-radius: 15px;
border-radius: 15px;}
{style}



Panel
borderWidth2
borderStylesolid

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.

Table of Contents
 

Gallery
includedcm4chee-arc-light.png,

...

weasis-dcm4chee-web3.png,dcm4chee.png
pageHome

...

Table of Contents

For dcm4chee-web3 (new web interface)

...


For dcm4chee-arc-light

  • Install dcm4chee, if not already done.

  • Go here and download these Weasis files.
    • From the folder with the latest version number:
      • weasis.war
      • weasis-i18n.war (Optional for internationalization)
    • From weasis-pacs-connector folder:
      • weasis-pacs-connector.war

    Note
    titleDownload 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.


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


  • Configure weasis-pacs-connector (Required to change the default WADO configuration)
    The default configuration is stored in two files inside weasis-pacs-connector.war.
    To override the default configuration:
    • Go here.

      Requires weasis-pacs-connector 6.x and superior: Download the current weasis-connector-default.properties and rename it weasis-pacs-connector.properties, and download dicom-dcm4chee.properties (configuration of the dcm4chee archive)

      Note
      titleDownload issue

      From github interface, click on "raw" button for downloading the file with the "save as..." menu of the browser.


    • Copy the files into wildfly/standalone/configuration.
    • As the default configuration of dicom-dcm4chee.properties is defined for dcm4chee-web3, it is necessary to modify at least:   
      • The WADO url of arc-light: arc.wado.url=${server.base.url}/dcm4chee-arc/aets/DCM4CHEE/wado
      • To accept all the syntaxes (otherwise arc-light will uncompress all the images): wado.addparams=&transferSyntax=*

    • 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.properties (Change pacs.host, pacs.port, and pacs.aet).
    • To add new properties or arguments in the JNLP file, see configuration of weasis-pacs-connector


  • To activate Weasis in dcm4chee-arc-light user interface (required 5.10.2 or superior), you need need to changes two attributes in the configuration

Anchor
web3
web3

For dcm4chee-web3

  • Install dcm4chee, if not already done. For security see also how to limit the server access.
    • 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.

      Tip

      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)
    • dcm4chee-web3/From weasis-pacs-connector folder:
      • dcm4chee-web-weasis.jar
      dcm4chee-web3/
      • weasis-pacs-connector.war

        Note
        titleDownload 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:

      Code Block
      WebviewerNames = weasis
      WebviewerBaseUrl = NONE
      

      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
      WebviewerBaseUrl = NONE
      • Launch Weasis as an Applet in the web browser (not recommended as several browsers block Java plugin) : WebviewerBaseUrl = weasis:/weasis-pacs-connector/viewer-applet

        Note
        titleweasis-pacs-connector configuration

        The new way of launching Java Westart file (jnlp) will require an absolute URL:

        • weasis:jnlp://YOUR-host:8080/weasis-pacs-connector/viewer
        • weasis:jnlps://YOUR-host:8443/weasis-pacs-connector/viewer (SSL connection)

        From dcm4chee 2.18.3, it possible to reuse the host name of dcm4chee:

        • weasis:jnlp://${server.host}:8080/weasis-pacs-connector/viewer
        • weasis:jnlps://${server.host}:8443/weasis-pacs-connector/viewer


    • Click the Apply Changes button
  • Configure Weasis (This step is optional if you just want to keep the default configuration. It is required when the AETitle DCM4CHEE has been changed)
    The default configuration of Weasis is stored in two files inside weasis-pacs-connector.war.
    To override the default configuration, :
    • Go here.

      Select the latest version and navigate to src/main/resources
      Download

      weasis-pacs-connector 4.x and 5.x: Download weasis-connector-default.properties and rename it weasis-pacs-connector.properties

      Download

      weasis-pacs-connector 6.x and superior: Download the current weasis-

      jnlp

      connector-default.

      xml

      properties and rename

      it weasis-jnlp.xml

      it weasis-pacs-connector.properties, and download dicom-dcm4chee.properties (configuration of the dcm4chee archive)

      Note
      titleDownload issue

      From github interface, click on "raw" button for downloading the file with the "save as..." menu of the browser.


    • Copy the files to into a folder in the classpath . The 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 or dicom-dcm4chee.properties for weasis-pacs-connector 6.x. Change pacs.host, pacs.port, and pacs.aet. Changes to weasis-jnlp.xml are needed less often.
    • To add new properties or arguments in the JNLP file, see configuration of weasis-pacs-connector

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

...

For dcm4chee-web (

...

old web interface - before 2.17.1)

...

  • 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.

...

  • 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

    Info
    titleEmbedding a Java Runtime for Windows

    The executable (

...

  • viewer-win32.exe) allows to embed a JRE in the relative directory "jre/windows" (e.g. weasis-portable/jre/windows/bin/java.exe)

...

  • . To support 32 and 64-bit architecture, copy 32-bit Java Rutime from its installed directory.

    Note: 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.