Skip to content

4.5.0 Upgrade Guide

jdo edited this page Mar 8, 2024 · 14 revisions

Updating Minimum Supported Java Version in Mirth Connect 4.7.0

NOTICE (UPDATED): After reviewing community feedback, we have decided that starting in Mirth Connect version 4.7.0, we will be switching our minimum supported Java version from Java 8 to Java 17.

Updated DUO Authentication to use the Universal Prompt

We have updated the DUO Authentication to use the new Universal Prompt because the Traditional Prompt will no longer be accessible after March 30, 2024. If you are using the DUO Authentication with the Multi-Factor Authentication Plugin, do the following:

  1. Upgrade to 4.5.0 from a previous version
  2. Start Mirth Connect (login will look the same for DUO authentication)
  3. Go to your DUO account
  4. Select Applications and Mirth Connect Application
  5. Select Show New Universal Prompt
  6. Restart Mirth Connect (login will change to the new prompt)

If you choose not to upgrade before March 30, 2024, you need to disable your DUO setting.

Removed Libraries

We have removed and replaced the following libraries from all Mirth Connect Components:

  1. Apache commons-lang-2.6.jar -> Apache commons-lang3-3.13.0.jar
  2. Apache commons-digester-2.0.jar -> Apache commons-digester3-3.2.jar
  3. jdom-1.1.1.jar -> jdom2-2.0.6.1.jar

If you are referencing these libraries in your code, please refer to the upgraded libraries instead.

We have removed the following libraries from all Mirth Connect Components:

  1. Jasypt-1.7.1.jar
  2. policy-xmlbeans-1.5.jar
  3. soapui-4.0.1.jar
  4. soapui-xmlbeans-4.0.1.jar
  5. stax2-api-3.1.4.jar
  6. woodstox-core-5.0.3
  7. xbean-fixed-2.4.0.jar

If you are referencing any of these libraries in your code, please include them in your custom libraries instead.

Change of Functionality of "Generate Envelope" in the Web Service Sender

As noted above, we removed the SoapUI library as a dependency of Mirth Connect. That library previously provided the functionality for generating SOAP envelope templates in the Web Service Sender, as well as in the Interoperability Suite Senders. In 4.5.0, the "Generate Envelope" function may produce different SOAP envelopes than it did in previous versions, and it may produce incomplete SOAP envelopes for more complex schemas. Please refer to your vendors to ensure you're sending the correct SOAP envelopes in your outgoing messages.

Health Data Hub Plugin

If you previously experienced issues upgrading to 4.2.0 or later when using the Health Data Hub Plugin, then upgrading to 4.5.0 will fix those issues. You can upgrade directly to 4.5.0 from any version of Mirth Connect whether it is before or after 4.2.0.

Clone this wiki locally