Upgrade Mirth® Connect

Mirth® Connect by NextGen Healthcare User Guide

Version-Specific Upgrade Instructions

If you are upgrading to one of the versions listed in the following sections, view the version-specific upgrade instructions. If you are upgrading through multiple versions, be sure to review all version upgrade instructions that you are upgrading through. 4.6.1 Upgrade Notes This topic covers the improvements and new features included in Mirth® Connect version 4.6.1. Parent topic: Upgrade Guide

Mirth® Connect by NextGen Healthcare User Guide

4.6.0 Upgrade Notes

This topic coveres the improvements and the new features included in Mirth® Connect version 4.6.0. Change in Licensing Model With the release of 4.6, Mirth® Connect has transitioned from a dual license model (open-source and commercial) to a single Enterprise license model that is closed-source and proprietary. This change is designed to enhance the quality and reliability of our product, ensuring that you receive the best possible experience. Upgrading to Mirth® Connect 4.6 is similar to previous releases. However, if you are using an open-source version, you need to contact our sales team at mirthconnectsales@nextgen.com to obtain a license, this allows you to download the software. For current clients, you can download the software from the Success Community and proceed with the upgrade as usual. For more details about this change please refer to our FAQs. Updating Custom Extensions To update the custom extensions, refer to the topic 4.6.0 Updating Custom Extensions. New Docker Imag

Mirth® Connect by NextGen Healthcare User Guide

4.3.0 Upgrade Notes

Application upgrades for the 4.3.0 release. New Functionality for the Mirth® Connect Setup Wizard New features are added to the Mirth® Connect Setup Wizard that include, but are not limited to, the following: Added more information on the screens with links to the What's New, Upgrade Guide, and documentation. This helps users understand what information to enter on the screens. Added the ability to install your extensions at the time the application is installed or upgraded. This simplifies the process so that users no longer have to install extensions manually and restart the service. Added the ability to enter your license key for extensions. This will default to the license.key value from your mirth.properties file during an upgrade. Added the updated logo and a list of each dialog screens so that users know exactly where they are in the process. Resource Classloaders Load Classes Child-First By Default Resources now load classes "child-first" instead of "parent-first" by default. I

Mirth® Connect by NextGen Healthcare User Guide

4.4.0 Upgrade Notes

Added New Functionality to the Mirth® Connect Setup Wizard (Installation Process) The following new features are added to the Mirth® Connect Setup Wizard: You can download and install your Mirth® Connect commercial extensions at the time Mirth® Connect is installed or upgraded. This simplifies the process so that users no longer have to download commercial extensions prior to the installation. When upgrading Mirth® Connect, the Setup Wizard displays the existing values for the destination directory, license key, network ports, and password requirements from your mirth.properties file rather than the standard default values or the values that were entered previously. Note: For Linux users upgrading from 4.3.0, new URL links have been added to the Mirth® Connect windows of the setup wizard to enable navigating to the desired version from the main document/wiki pages. To get the updated links, you must uninstall and then re-install Mirth® Connect. Default Digest Algorithm Changed The defa

Mirth® Connect by NextGen Healthcare User Guide

3.8.0 Upgrade Notes

In version 3.8 we upgraded the MySQL JDBC driver to version 8.0.16, so that the latest MySQL 8.x can be used. However the new driver doesn't support versions of MySQL older than 5.6. Since these older versions are over 10 years old and are already listed as End-Of-Life by Oracle, we have made the decision to adjust our system requirements to reflect that 5.6+ is now the minimum supported version for MySQL. If you still need to connect to an older version of MySQL, do not worry you still can! Connecting via a Database Reader/Writer or in JavaScript Download the appropriate MySQL JDBC Driver JAR for the version of MySQL you need to connect to. Place this JAR into a folder of your choice on the system running Mirth Connect. Create a new library resource (Settings -> Resources tab) pointing to that folder. Link your connector/channel to your new resource (Summary tab -> Set Dependencies). Make sure you are using the old driver class name, "com.mysql.jdbc.Driver". Using an Old Version of My

Mirth® Connect by NextGen Healthcare User Guide

Before You Upgrade

Before upgrading, NextGen Healthcare highly recommends that you backup both your Mirth® Connect Server Configuration and your Mirth® Connect database using the following steps. Note: mirth_home directory. Backup server configuration: Before proceeding, it is important that you backup your existing server configuration. This can be done through the Mirth Connect Administrator (Settings>Server Tab>Server Tasks – Backup Config). The server configuration includes channels, code templates, alerts, and global scripts. User accounts and stored messages will not be backed up. Backup database: If you use the embedded Derby database, create a backup of the "mirth_home/appdata/mirthdb" folder. Note that appdata is the database folder as defined in the "mirth_home/conf/mirth.properties" file. For additional information, see mirth.properties File. If you use an external database (for example, PostgreSQL, MySQL), create a backup of your database using your preferred database administration tool (for

Upgrade Mirth® Connect

Recommendations

Version-Specific Upgrade Instructions

4.6.0 Upgrade Notes

4.3.0 Upgrade Notes

4.4.0 Upgrade Notes

3.8.0 Upgrade Notes

Before You Upgrade

Upgrade Mirth® Connect

Version-Specific Upgrade Instructions

4.6.0 Upgrade Notes

4.3.0 Upgrade Notes

4.4.0 Upgrade Notes

3.8.0 Upgrade Notes

Before You Upgrade