Frequently Asked Questions - tonygermano/connect GitHub Wiki

What are the key components of the NextGen Connect architecture?

NextGen Connect consists of the NextGen Connect Server, NextGen Connect Administrator, NextGen Connect Server Manager, and NextGen Connect Command Line Interface.

  • NextGen Connect Server contains the back-end for the management interface and the integration engine component, which performs message filtering, transformation, and transmission.
  • NextGen Connect Administrator is the graphical user interface that connects to the NextGen Connect Server and allows you to configure interfaces, monitor interface activity, and browse the message store.
  • NextGen Connect Server Manager is a graphical user interface that manages the NextGen Connect service, displays log files, and contains other configuration settings for the NextGen Connect Server.
  • NextGen Connect Command Line Interface (CLI) is a command line tool that allows connections to the NextGen Connect Server to deploy/import/export channels and perform other administrative tasks.

How do I start NextGen Connect?

Once NextGen Connect has been installed, there are several ways to launch the NextGen Connect Administrator. On a Windows installation, there is a NextGen Connect Administrator item in the Start Menu which launches the application directly. If the NextGen 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 NextGen Connect Administrator launch page which by default should be available at http://\<ip-address>:8080. Clicking the Launch Mirth Connect Administrator button will connect you to the server which will be listening on https://\<ip-address>: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 NextGen Connect Administrator is a Java application that is downloaded from the NextGen Connect Server and launched on the local system. You can connect to any NextGen Connect installation by launching its Administrator, regardless of the version.

If you are launching the Administrator for the first time, you will notice that its libraries will be downloaded. This feature allows you run the Administrator from any remote NextGen Connect Server without having to download and install a separate client.

What are the default username and password for NextGen Connect?

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

Which ports need to be opened to access NextGen Connect from outside of a network?

  • TCP 8080 – Required for viewing the NextGen Connect Administrator launch page
  • TCP 8443 – NextGen Connect Administrator port for communicating with NextGen Connect Server

How can I increase the amount of memory allocated to the NextGen Connect Server/Service?

If you are running the NextGen Connect Server Manager, there is an option for changing the amount of memory the NextGen Connect Service is allocated from the default of 256MB to something larger.

The value can also be changed manually by editing the %MIRTH_HOME%/mcservice.vmoptions file and changing -Xmx256m to a different value. Other JVM options can also be added to this file. You can add one option per line, and the last line in this file must be a blank line.

If you are not using the NextGen Connect Service and are running the NextGen Connect Server manually through its executable (mcserver), then you should edit the mcserver.vmoptions file instead.

How can I change the database that NextGen Connect uses for its data store?

First, make sure to export your channels and message data (if needed) since the new database you are switching to will not have any of your current data.

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

To manually change the database you can edit the %MIRTH_HOME%/conf/mirth.properties file and set the database property to the database of your choice, choosing from the list of examples in the properties file. You will also need to set the database.url, database.username, and database.password properties.

How do I run the Windows installer in unattended mode?

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