mirth-cli-config.properties File

Mirth® Connect by NextGen Healthcare User Guide

mirth.properties File

This 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. You can also set other security and encryption options. The following properties are supported: Property Default Value Description Directories dir.appdata appdata The location of the Application Data Directory. dir.tempdata ${dir.appdata}/temp The location of the temporary files directory, by default set inside of the Application Data Directory. Ports http.port 8080 The HTTP port to make the web server available from. This is used to access the launch page and download signed client resources from. If this property is omitted or commented out, the web server only starts up on the HTTPS port. https.port 8443 The HTTPS port to make the web server available from. This is used to access the secure opening of a page, web dashboard, and all REST API traffic (which includes the Administrator and CLI) . Password Requirements passwo

Mirth® Connect by NextGen Healthcare User Guide

Other Files and Folders

The various files and folders present in the installation directory are used to contain application configuration files and other executables. Other files and folders present in the Installation Directory include the following: cli-lib: Libraries used by the Command Line Interface. These should not be changed. client-lib: Libraries used by the Mirth Connect Administrator. These should not be changed. custom-lib: Custom libraries can be dropped in this folder, to be used by the default library resource. docs: Contains license information for Mirth® Connect and all third-party libraries. Also contains the Javadoc documentation used by User API. extensions: Extension libraries used by the Server, Administrator, and CLI. These should not be changed. logs: This is the default location that server logs will be written into. This can be changed from the log4j2.properties file. manager-lib: Libraries used by the Server Manager. These should not be changed. mccommand(.exe): The entrypoint scrip

Mirth® Connect by NextGen Healthcare User Guide

Mirth® Connect REST API

The Administrator and Command Line Interface both use a well-defined API to communicate with the Mirth® Connect server. You can also use the same API to create custom integrations of your own. The API is documented at https://localhost:8443/api (change the IP / port as needed), or you can select View Client API in Administrator via Other Tasks: Select the View Client API action to open the API documentation in your default browser. Note: You may see a warning in your browser if your Mirth® Connect instance is still using the auto-generated self-signed certificate. You can select Advanced and allow the browser to continue to the page. To resolve this warning, look at Application Data Directory for instructions on installing your own certificate. Select the arrow button on one of the endpoint group rows to view its operations. This list shows the operation's HTTP method type, request URL, and a description for each endpoint. Select on one of the endpoint rows to view its details. If desi

Mirth® Connect by NextGen Healthcare User Guide

Mirth® Connect Command Line Interface

The Command Line Interface is an alternate, lightweight way to interact with your Mirth® Connect server. Not everything you can do through the Administrator is available in the CLI (like editing channels), but common monitoring and management operations are supported: List deployed status / statistics of all channels Deploy/undeploy/start/stop/halt/pause/resume channels Enable/disable/remove channels Import/export channels, alerts, code templates, libraries, or the entire server configuration And more... The CLI comes packaged with the standard Mirth® Connect distribution. It is also available as a standalone client from the Downloads page. If using the standalone client, simply extract the archive in a location of your choice. Running the Command Line Interface Using Non-interactive Scripting

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

Running the Command Line Interface

The CLI has both interactive and non-interactive modes. With the interactive mode, you can choose to store your username/password in a file, or enter your username/password every time you launch the CLI. From a terminal / shell: In a terminal / shell, run the mccommand executable script, with the following options: mccommand -a https://localhost:8443 -u user -p pass Change the address, username, and password as necessary You can also set the address / username / password in the "conf/mirth-cli-config.properties" file, so that you do not need to enter it every time. Once connected, you will see a welcome prompt: Connected to Mirth® Connect server @ https://127.0.0.1:8443 (3.5.0.8232)$ From here, you can type help to view all available commands. Parent topic: Mirth Connect Command Line Interface

mirth-cli-config.properties File

Recommendations

mirth.properties File

Other Files and Folders

Mirth® Connect REST API

Mirth® Connect Command Line Interface

Configuration Directory

Running the Command Line Interface

mirth-cli-config.properties File

mirth.properties File

Other Files and Folders

Mirth® Connect REST API

Mirth® Connect Command Line Interface

Configuration Directory

Running the Command Line Interface