FAQ

Mirth Connect is an open source standards-based healthcare integration engine. Mirth Connect facilitates the routing, filtering, and transformation of messages between health information systems over a variety of protocols (like LLP, Database, and FTP) with support for numerous standards (such as HL7, XML, and DICOM).

Mirth Connect consists of the Mirth Connect Server, Mirth Connect Administrator, and Mirth Connect Server Manager.

• Mirth Connect Server contains the back-end for the management interface and the integration engine component, which performs message filterting, transformation, and transmission.
• Mirth Connect Administrator is the graphical user interface that connects to the Mirth Connect Server and allows you to configure interfaces, monitor interface activity, and browse the message store.
• Mirth Connect Server Manager is a Windows-only graphical user interface that manages the Mirth Connect service, displays log files, and contains other configuration settings for the Mirth Connect Server.

• Sun Java JRE 1.5/5.0 or newer
• 1GB of RAM recommended
• A browser to launch the Mirth Connect Administrator

Once Mirth has been installed, there are several ways to launch the Mirth Connect Administrator. On a Windows installation, there is a Mirth Administrator item in the Start Menu which launches the application directly. If the Mirth Connect Server Manager is installed, there is a “Launch Administrator” button in the lower left corner which will also start the application.

If the option is not available, you can connect to the Mirth Administrator launch page which by default should be available at http://:8080. Clicking the Launch Mirth Administrator button will connect you to the server which will be listening on https://:8443. If running a new installation, the default username and password for the login screen is admin and admin. This should be changed immediately for security purposes.

The Administrator is a Java application that is downloaded from the Mirth Connect Server and launched on the local machine. You can connect to any Mirth Connect installation by launching its Administrator, regardless of the version.

If you are launching the administrator for the first time, you will notice that the libraries for the Mirth Administrator will be loaded. This feature allows you run the Administrator from any remote Mirth server without having to download and install a separate client.

You may also notice a security warning when starting the administrator (dialog box depends on browser being used). This is normal, and you should click Run to continue launching the administrator.

The default username and password are both “admin”, although we strongly recommend changing these after your first time logging in.

• 8080 – Required for viewing the Mirth Connect Administrator launch page
• 8443 – Mirth Connect Administrator port for communicating with Mirth Connect Server
• 1099 – User by Mirth Connect Administrator for viewing interface status and statistics

This can be done by opening the %MIRTH_HOME%/conf/wrapper.conf file and setting the wrapper.java.maxmemory value to a larger value.

First, make sure to export your channels and message data (if needed) since switching to a different database will clear out all of your data.

If you are using Mirth Connect on a Windows machine and have the Mirth Connect Server Manager installed, you can change the database type in the Database tab. Set the URL, username, and password, and restart the service. Mirth Connect will create the necessary tables on the new database.

To manually change the database:

• Shutdown the Mirth Connect Server.
• Edit the %MIRTH_HOME%/conf/mirth.properties file and set the “database” property to the database of your choice, for example “postgres” (no quotes).
• Edit the %MIRTH_HOME%/conf/-SqlMapConfig.properties file, where the database name would be “postgres”, and set the “url”, “username”, and “password” properties.
• Restart the Mirth Connect Server.

You can run the installer in unattended mode (no user interface with default settings) by adding “–mode unattended” when executing the EXE file.

Mirth Connect currently supports: Apache Derby (default), PostgreSQL, MySQL, Oracle 10+, MS SQLServer, and MS SQLServer 2005. Note that this does not represent the only databases that can be connected to using the Database Reader and Writer connectors. The Database Reader and Database Writer support any type of database as long as the proper client libraries are added to the custom folder of the Mirth Connect install directory.

Mirth Connect is released under the Open Source Initiative (OSI) approved MPL 1.1. For more information, please visit Mozilla Public License 1.1.