Unable to Launch Mirth® Connect Administrator

Mirth® Connect by NextGen Healthcare User Guide

Opening the Java Client Console

If an error occurs on the Mirth® Connect server, you will typically see one or more entries appear in the Logs. If an error occurs in the Mirth Connect Administrator, it is possible that it is isolated to the client-side only, and so nothing will appear in the server-side logs. In cases like this, it is useful to enable the Java Client Console to see any exceptions that occur on your client-side Java virtual machine (JVM). To enable the console, first open the Java Control Panel: In your System Preferences (on OSX) or the Control Panel (on Windows), open the Java section. A new dialog will appear: Select on the Advanced tab. Select Show console. Select Apply, then select OK. Now when you launch the Administrator, you will see a second window also pop-up: Any exceptions that are logged to stdout / stderr on the client side will appear in that console. Parent topic: Troubleshooting

Mirth® Connect by NextGen Healthcare User Guide

Troubleshooting

This section is meant to capture some of the most common errors that may occur when using Mirth® Connect. It is by no means an exhaustive list. For additional help, you may be interested in our Extensions or Training offerings. Logs Configuration Mirth Connect Engine fails to start up Unable to Launch Mirth Connect Administrator This error occurs when you do not have connectivity from your local machine to the Mirth® Connect server over the HTTPS port. Clearing your Java Cache Opening the Java Client Console Out of Memory Errors By default, the max Java heap size for the Mirth® Connect server is set to 256 MB. For large production instances you will typically want to increase this value. Manually reset a password in the database

Mirth® Connect by NextGen Healthcare User Guide

Launch the Administrator

After you download the Administrator Launcher, you can perform the following steps to launch and log on to the Mirth® Connect Administrator. Using the Server Manager: On Windows/Linux, you can launch the Mirth® Connect Administrator using the Administrator button in the bottom-left corner of the Mirth® Connect Server Manager - Server page. Using the launch web page: Open a web browser and navigate to your launch page. This is usually http://localhost:8080 or https://localhost:8443, though you may need to edit the IP or port depending on your settings. Click the green Launch Mirth Connect Administrator button to start the Mirth Connect Administrator Launcher. Image showing log on from the launch web page. The Access Secure Site button takes you to the Web Dashboard Sign In page. Parent topic: Mirth Connect Administrator Overview Related concepts The Web Dashboard

Mirth® Connect by NextGen Healthcare User Guide

Mirth® Connect Administrator Overview

The Mirth® Connect Administrator is used to develop and manage all channels and can be run anywhere in relation to the Mirth® Connect server. The Mirth® Connect Administrator consists of menus and view panels that change depending on the task (for example, Dashboard, Channel, Edit Channel, Settings). Note: You no longer need to use Java Web Start. NextGen Healthcare has released a new Administrator Launcher that you can use instead. See Administrator Launcher Overview. Download the Administrator Launcher You must download the Administrator Launcher to use it to open the Administrator. Launch the Administrator After you download the Administrator Launcher, you can log on to the Mirth® Connect Administrator. Log On Use the Mirth® Connect Login window to authenticate yourself and log on to the Administrator. Logging on for the First Time When you log on to Mirth® Connect for the first time, you are required to set up your user account. Parent topic: Getting Started with Mirth Connect

Mirth® Connect by NextGen Healthcare User Guide

Log On

Use the Mirth® Connect Login window to authenticate yourself and log on to the Administrator. When you open the Administrator view, the following window appears: Image of the login window The Server field is pre-filled with the correct IP address and port, however, you can change the address, if needed. Note: If this is the first time you are logging on to Mirth® Connect, the default username is admin and the default password is admin. Enter your username and password in the fields. Select Login. Note: If Require Login Notification and Consent (Settings > Server) is set to Yes, a window appears displaying the notification text. Select Accept to continue. The window closes after 5 minutes of inactivity, returning to the logon window. Parent topic: Mirth Connect Administrator Overview

Mirth® Connect by NextGen Healthcare User Guide

Server Tab

The Server tab enables you to enter details about your ports, server memory, log levels, and view log files. The following fields are available on the Server page. Function Description Web Start Port Accesses the launch page for the Mirth® Connect Administrator. Default: 8080 Administrator Port This port is used by the Mirth Connect Administrator to communicate with the Mirth® Connect Server. Default: 8443 Server Memory (mb) The server's maximum available memory (Java max heap size). By default this is 256 MB, but for large production instances you will typically want to increase this value. Main Log Level Database Log Level Channel Log Level These fields enables you to select the applicable log level from the drop-down menus. Available options include: ERROR WARN INFO DEBUG TRACE Depending on the log level, messages of the selected level or lower will pass into that level's log when the system logs a certain-level message. Refresh Select this button to update the most recent list of l

Unable to Launch Mirth® Connect Administrator

Recommendations

Opening the Java Client Console

Troubleshooting

Launch the Administrator

Mirth® Connect Administrator Overview

Log On

Server Tab

Unable to Launch Mirth® Connect Administrator

Opening the Java Client Console

Troubleshooting

Launch the Administrator

Mirth® Connect Administrator Overview

Log On

Server Tab