Install Mirth Connect 2.1 on Ubuntu 10.10 with MySQL Server

Mirth Connect, SOA, ESB, HL7

Mirth Connect is a Service Oriented Integration Platform based on Mule ESB. Mirth Connect is specifically designed for HL7 (Health Level Seven – set of standards for the health messages exchanging) message exchange.

Mirth Connect as a SOA Platform provides tools for developing, testing, deploying, and monitoring interfaces (channel for the exchange of HL7 messages).

Mirth Connect Architecture

Mirth Connect Architecture

Mirth Connect is a project Open Source with Mozilla Public License 1.1 (MPL 1.1) and can be downloaded from here

Well, we will explain how to install on Ubuntu and how to switch Derby database server to MySQL server.

1. Install Java

amawta@yachaywasi:~$ sudo apt-get install openjdk-6-jdk

2. Install Mirth Connect

1. Download and setup execution permissions:

amawta@yachaywasi:~$ chmod +x
amawta@yachaywasi:~$ sudo ./

2. Verify Mirth Connect installation:

Go to http://localhost:8080 where you can access to Mirth Connect Server via Java App Admin console.
The administrator user and password are admin and admin, change it!.
If you can not connect to server, then start it.

3. Start Mirth Connect from Manager (mcmanager), Server (mcserver) or as Service (mcservice).

amawta@yachaywasi:/opt/mirthconnect$ sudo ./mcservice start

verify again Mirth Connect is running.

3. Switch from Derby database to MySQL server

1. Install MySQL:

amawta@yachaywasi:~$ sudo apt-get install mysql-server mysql-client

and verify if MySQL is running:

amawta@yachaywasi:~$ netstat -tulpan

or starting:

amawta@yachaywasi:~$ sudo service mysql start

after, connect to MySQL:

amawta@yachaywasi:~$ mysql -u root -p

2. Create an empty database and an user for Mirth Connect:

GRANT ALL ON mirthdb.* TO mirthuser@'localhost' IDENTIFIED BY 'demodemo' WITH GRANT OPTION;
GRANT ALL ON mirthdb.* TO mirthuser@'%' IDENTIFIED BY 'demodemo' WITH GRANT OPTION;

If you want to connect from other PC different to localhost, then edit /etc/mysql/my.cnf
and comment the line “bind-address =”, after re-start MySQL.

3. Stop Mirth Connect:

amawta@yachaywasi:/opt/mirthconnect$ sudo ./mcservice stop

4. Edit the %MIRTH_HOME%/conf/ file and set the “database” property to the database of your choice, for example “mysql” (no quotes).
Also, set the “database.url”, “database.username”, and “database.password” properties. In this case are:

database = mysql
database.url =jdbc:mysql://localhost:3306/mirthdb
database.username = mirthuser
database.password = demodemo

6. Restart the Mirth Connect Server and check logs.
Mirth Connect server will create a new database schema:

amawta@yachaywasi:/opt/mirthconnect$ sudo ./mcserver
INFO  2011-05-09 16:52:13,769 [Thread-1] com.mirth.connect.server.Mirth: Mirth Connect (Built on April 25, 2011) server successfully started.
INFO  2011-05-09 16:52:13,771 [Thread-1] com.mirth.connect.server.Mirth: This product was developed by Mirth Corporation ( and its contributors (c)2005-2011.
INFO  2011-05-09 16:52:13,772 [Thread-1] com.mirth.connect.server.Mirth: Running OpenJDK Server VM 1.6.0_20 on Linux (2.6.35-22-generic, i386), mysql, with charset UTF-8.

To verify new schema do the following:

amawta@yachaywasi:~$ mysqlshow -u mirthuser -p mirthdb
Enter password:
Database: mirthdb
|       Tables       |
| ALERT              |
| ALERT_EMAIL        |
| ATTACHMENT         |
| CHANNEL            |
| EVENT              |
| MESSAGE            |
| PERSON             |
| SCHEMA_INFO        |
| SCRIPT             |
| TEMPLATE           |

7. Now you could connect to Mirth, go to http://localhost:8080, start Mirth Connect Administrator, the default user and password will be admin/admin, change it again.

Mirth Connect Administration

Mirth Connect Administration



Tagged with: , ,
Posted in EIP, ESB, Health Care, Open Source, SOA
9 comments on “Install Mirth Connect 2.1 on Ubuntu 10.10 with MySQL Server
  1. whofeih says:

    doesn’t work on me. mirth 2.1

  2. Jim E says:

    Rather than setting Mirth Connect Manager up to access only a single Mirth server, do you know if it is possible to create multiple connection profiles and then be able to select the particular profile at start?

    In my case, I connect to several different Mirth servers and thus need to be able to modify the connection details (e.g. IP) for the Mirth server as well as the corresponding MySQL database.

  3. chlink says:

    Replace the OpenJDK install with the Sun JRE to satisfy issues with Mirth administrator login failures

  4. Thomas M says:

    Your instructions worked exactly as advertised on a CentOs 5.3 server by just switching apt-get with yum :)
    Thanks so much.

  5. Shamil says:

    For the version 3.0 of the Mirth Connect, frustrated by the lack of any supported information, I wrote the developer’s level guide which covers installation as well. The guide can be found here –
    That’s FYI.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: