Mirth Migrator is a web-based tool that automates the transfer of Mirth Connect Enterprise Service Bus channels and code templates between Mirth environments. It as a strong focus on JavaScript functions stored in code templates, ensuring seamless migration and proper function integration with the channels that depend on them.

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

Key Features

• Transfer Channels and Code Templates
  Migrates channels and associated code templates between environments with ease, maintaining consistency across systems.
• Function-Dependency Analysis
  Detects and maps dependencies between JavaScript functions in code templates and their usage in channels or other functions. Identifies which channels and functions rely on specific functions, as well as where functions are used.
• Conflict Handling
  Resolves version conflicts during migration, ensuring compatibility between the source and target environments.
• Inconsistency Detection
  Analyzes channels and code templates to uncover inconsistencies or missing dependencies that could cause errors post-migration.
• Environment Comparison
  Allows for a detailed comparison of channels and functions between environments, helping maintain synchronization.
• Transparency in Function Usage
  Provides clear insights into which JavaScript functions are utilized by specific channels or other functions, aiding debugging and development.

Use Cases

• Environment Synchronization
  Maintain consistent code and channel configurations across development, testing, and production environments.
• Conflict Resolution
  Identify and handle mismatched versions of functions or channels during migrations.
• Code Audit and Optimization
  Detect unused functions or redundant code within the environment for optimization.
  Also detect missing function or function references in channels & functions, which will result in runtime errors.
• Dependency Mapping
  Gain a better understanding of how functions and channels interact, crucial for large or complex Mirth Connect installations.

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)