Installation Directory

Mirth® Connect by NextGen Healthcare User Guide

Application Data Directory

This directory stores configuration files and temporary data created by Mirth® Connect after starting up. Usually the name of this directory is "appdata" and it resides directly inside your installation directory. However the name and location of this directory can be modified from mirth.properties. The main files/folders of note here are as follows: configuration.properties extension.properties keystore.jks server.id temp configuration.properties extension.properties The extension.properties file stores the current state of all installed extensions. Typically you do not need to edit this file, as enabling and disabling of extensions can be done using the Extensions view. keystore.jks server.id temp Parent topic: Installation Directory

Mirth® Connect by NextGen Healthcare User Guide

Configuration Directory

This directory contains the main configuration files Mirth® Connect needs in order to start up correctly. Modifying the configuration requires a restart of Mirth® Connect. The following files are found here: dbdrivers.xml File log4j2.properties File log4j2-cli.properties File mirth.properties File mirth-cli-config.properties File dbdrivers.xml File log4j2.properties File The log4j2.properties file specifies where to write log files to and how verbose the logs should be. log4j2-cli.properties File The log4j2-cli.properties files is the same as the log4j2.properties file, except that it is specific to the Command Line Interface. mirth.properties File is the main configuration file that tells Mirth® Connect where to store application data, what web server ports to listen on, and which database to connect to. mirth-cli-config.properties File Parent topic: Installation Directory

Mirth® Connect by NextGen Healthcare User Guide

configuration.properties

This stores the current state of the Configuration Map. The file is formatted as a standard properties file key = value # This is a comment for key "clientAddress"clientAddress = 10.0.1.123 The configuration map is edited from the Configuration Map Settings Tab. If you instead edit the properties file manually, Mirth® Connect will not pick up those changes until you restart the server. Parent topic: Application Data Directory

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

Mirth® Connect by NextGen Healthcare User Guide

keystore.jks

This is a critical file that stores your server's local certificate keypair (for the web server and API), and also the secret key used for encrypting message data, exports, and anything else. Note that usually the name of this file is "keystore.jks" and it resides inside of appdata, but the keystore name and location can be modified from mirth.properties File. Warning: If you plan on making any changes to this file, BACK IT UP first! If you lose this file, any data (messages, exports, etc.) encrypted with it will be lost forever! Changing The Server Certificate When Mirth® Connect starts up for the first time, it will automatically create a new self-signed certificate, which it will use for web server and secure API access. After installing Mirth® Connect, you should replace this with an appropriate company certificate signed by a Certificate Authority (CA). Use the following steps to install a new certificate: BACK UP your current keystore.jks file. Have your new keypair ready to impo

Mirth® Connect by NextGen Healthcare User Guide

Configuration

Often times issues occur because of mistakes in initial configuration. The main configuration for Mirth® Connect by NextGen Healthcare is done in the mirth.properties file in the "conf" folder inside your Installation Directory. Parent topic: Troubleshooting

Installation Directory

Recommendations

Application Data Directory

Configuration Directory

configuration.properties

Before You Upgrade

keystore.jks

Configuration

Application Data Directory

Configuration Directory

configuration.properties

Before You Upgrade

keystore.jks

Configuration