This tool works with the Open Source as well as the commercial version of Mirth Connect.
-
Code Templates and Channel Migration
Code templates, channels, and even entire Channel Groups or Code Template Libraries can be migrated between Mirth instances with a single click. Code templates of directly or indirectly referenced functions can be automatically migrated with the channels.
If a component already exists at the destination instance, conflict handling will be activated. The component to be migrated will be compared with the corresponding component of the target system, and the user can choose to skip its migration or overwrite the one on the target side. -
Consistency check
Channel and function inconsistencies are directly indicated. Mirth Migrator shows if a channel or function uses other functions but the referenced function is not defined anywhere. It further indicates if a function is used by a channel but the code template library containing this function is not referenced by a channel. These checkings are important as inconsistencies often do not occur directly at channel deployment but only when the business logic hits an errourneous spot. -
Meta Data and Source Code Viewing
When a component is selected, important metadata and the source code are displayed. -
Documentation
Upon clicking on a component, the relevant documentation is displayed. In the case of functions, this may include their descriptions, parameter definitions, and expected return values. In the case of channels, this may include a description and a change history. Multiple functions in one code template will be displayed as separate items. -
Compare
If a component selected at one instance already exists at the other instance, it will be highlighted, and a compare button will appear. The source code and metadata for components can be compared in two ways: side-by-side or inline. -
Function Dependency Checking
For each function, it is indicated which other functions it uses, as well as the channels and/or functions through which it is used. -
Channel Dependency Checking
For each channel, either directly or indirectly referenced functions are shown. It is further indicated which code template libraries it references and if these references are correct. Non-needed as well as missing library references are highlighted -
Web-Based Application
Mirth Migrator is a fully web-based application provided via a Mirth channel. There is no need for a separate user management system as it utilises the user pool of the Mirth installation, which runs the channel. - JSON in Java (A JSON implementation for Java)
- Difflib.js (for providing diffs)
- highlight.js (for code highlighting)
- Freepik (for background image)
Screenshots
Installation
Mirth Migrator runs locally as a Mirth channel - all your data remains internally in your organization.
| 1. | Place the "web" folder in your "Mirth Connect" folder |
| 2. | Reference MirthMigrator.jar that you find at ./web/MirthMigrator/jar/ as custom resource |
| 3. | Import the MIRTH_MIGRATOR channel and reference the custom resource |
| 4. | Deploy the MIRTH_MIGRATOR channel |
| 5. | Browse to |
When you access Mirth Migrator, it asks you to log in. Simply use your Mirth account of the Mirth instance at which the MIRTH_MIGRATOR channel is running.