Mirth Migrator automates the transfer of Mirth Connect Enterprise Service Bus channels and code templates from one instance to another. It further allows to check the validity of channels & code templates.

This tool works with the Open Source as well as the commercial version of Mirth Connect.

Features

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

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 $\textsf{\color{blue}{http://<YourMirthServer>:1339/mirthMigrator}}$




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.

Kudos

Mirth Migrator makes use of a number of other open source projects:
• JSON in Java (A JSON implementation for Java)
• Difflib.js (for providing diffs)
• highlight.js (for code highlighting)
• Freepik (for background image)