Skip to content

Commit 25860ff

Browse files
authored
Merge pull request #26 from OpenIntegrationEngine/feature/#10-Readme-Refresh
#10 Readme Refresh
2 parents 83b4083 + 3e41cb9 commit 25860ff

File tree

1 file changed

+96
-76
lines changed

1 file changed

+96
-76
lines changed

README.md

Lines changed: 96 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -1,103 +1,123 @@
1-
# Mirth® Connect by NextGen Healthcare
1+
# Open Integration Engine
22

3-
1. [Useful Links](#useful-links)
4-
2. [General Information](#general-information)
5-
3. [Installation and Upgrade](#installation-and-upgrade)
6-
4. [Starting Mirth Connect](#starting-mirth-connect)
7-
5. [Running Mirth Connect in Java 9 or greater](#java9)
8-
6. [Java Licensing](#java-licensing)
9-
7. [License](#license)
3+
[![Website](https://img.shields.io/badge/website-openintegration.org-blue)](https://openintegration.org)
4+
[![Discord](https://img.shields.io/discord/943670759891554316?label=Join%20our%20Discord&logo=discord&style=flat)](https://discord.gg/azdehW2Zrx)
5+
[![Docker](https://img.shields.io/badge/docker-openintegrationengine-blue?logo=docker&style=flat)](https://hub.docker.com/u/openintegrationengine)
6+
[![LinkedIn](https://img.shields.io/badge/linkedin-follow-blue?logo=linkedin&style=flat)](https://www.linkedin.com/company/open-integration-engine)
107

11-
------------
8+
---
9+
## Table of Contents
1210

13-
<a name="useful-links"></a>
14-
## 1. Useful Links
15-
- [Downloads](https://github.com/nextgenhealthcare/connect/releases)
16-
- [User Guide](https://docs.nextgen.com/)
17-
- [Wiki](https://github.com/nextgenhealthcare/connect/wiki)
18-
- [FAQ](https://github.com/nextgenhealthcare/connect/wiki/Frequently-Asked-Questions)
19-
- [What's New in Mirth Connect](https://github.com/nextgenhealthcare/connect/wiki/Release-Notes)
20-
- [Forums](https://forums.mirthproject.io/)
21-
- [Slack Channel](https://mirthconnect.slack.com/)
22-
- [Slack Registration](https://join.slack.com/t/mirthconnect/shared_invite/zt-1prqon9tg-UQ_~6AsV8IwdITTo3z1aoA)
11+
- [Mission Statement](#mission-statement)
12+
- [Overview](#overview)
13+
- [Why Open Integration Engine?](#why-open-integration-engine)
14+
- [Core Features](#core-features)
15+
- [Who It’s For](#who-its-for)
16+
- [Project Values](#project-values)
17+
- [Community and Governance](#community-and-governance)
18+
- [History and Roadmap](#history-and-roadmap)
19+
- [Licensing](#licensing)
20+
- [Acknowledgments](#acknowledgments)
2321

24-
------------
22+
---
23+
## Mission Statement
2524

26-
<a name="general-information"></a>
27-
## 2. General Information
28-
##### The NextGen Solutions Mission
29-
NextGen Solutions help many of the nation&apos;s largest, most respected healthcare entities streamline their care-management processes to satisfy the demands of a regulatory, competitive healthcare industry. With Mirth Solutions, NextGen Healthcare&apos;s goal is to provide the healthcare community with a secure, efficient, cost-effective means of sharing health information. The natural product of this aim is a family of applications &mdash; which includes Mirth Connect &mdash; flexible enough to manage patient information, from small practices to large HIEs, so our clients and users can work confidently and effectively within the healthcare-delivery system.
30-
##### About Mirth Connect
31-
Like an interpreter who translates foreign languages into the one you understand, Mirth Connect translates message standards into the one your system understands. Whenever a &quot;foreign&quot; system sends you a message, Mirth Connect&apos;s integration capabilities expedite the following:
32-
- Filtering &mdash; Mirth Connect reads message parameters and passes the message to or stops it on its way to the transformation stage.
33-
- Transformation &mdash; Mirth Connect converts the incoming message standard to another standard (e.g., HL7 to XML).
34-
- Extraction &mdash; Mirth Connect can &quot;pull&quot; data from and &quot;push&quot; data to a database.
35-
- Routing &mdash; Mirth Connect makes sure messages arrive at their assigned destinations.
25+
To empower seamless healthcare interoperability through an open, community-driven integration engine that is accessible, extensible, and standards-based.
3626

37-
Users manage and develop channels (message pathways) using the interface known as the Administrator:
38-
![Administrator screenshot](https://i.imgur.com/tnoAENw.png)
27+
---
3928

40-
------------
29+
## Overview
4130

42-
<a name="installation-and-upgrade"></a>
43-
## 3. Installation and Upgrade
44-
Mirth Connect installers are available for individual operating systems (.exe for Windows, .rpm and .sh for Linux, and .dmg for Mac OS X). Pre-packaged distributions are also available for individual operating systems (ZIP for Windows, tar.gz for Linux, and tar.gz for Mac OS X). The installer allows you to automatically upgrade previous Mirth Connect installations (starting with version 1.5).
31+
The **Open Integration Engine Project** is an open-source initiative committed to advancing healthcare interoperability. Building upon the foundation of **Mirth Connect**, a widely adopted integration engine, this project aims to provide healthcare organizations with a robust, flexible, and cost-effective solution for connecting disparate systems and facilitating efficient data exchange.
4532

46-
Mirth Connect installers also come with the option to install and start a service that will run in the background. You also have the option of installing and running the Mirth Connect Server Manager, which allows you to start and stop the service on some operating systems, change Mirth Connect properties and backend database settings, and view the server logs.
33+
---
4734

48-
An optional Mirth Connect Command Line Interface can be installed, allowing you to connect to a running Mirth Connect Server using a command line. This tool is useful for performing or scripting server tasks without opening the Mirth Connect Administrator.
35+
## Why Open Integration Engine?
4936

50-
The Mirth Connect Administrator Launcher can also be installed, allowing you to manage connections to multiple Mirth Connect servers and configure options such as Java runtime, max heap size, and security protocols.
37+
- **Open Source Advantage**
38+
Transparency, innovation, and collaborative development within the healthcare IT community.
5139

52-
After the installation, the Mirth Connect directory layout will look as follows:
40+
- **Healthcare-Focused**
41+
Designed to address the unique challenges of healthcare data integration, supporting standards such as HL7, FHIR, and DICOM.
5342

54-
- /appdata/mirthdb: The embedded database (Do NOT delete if you specify Derby as your database). This will be created when the Mirth Connect Server is started. The path for appdata is defined by the dir.appdata property in mirth.properties.
55-
- /cli-lib: Libraries for the Mirth Connect Command Line Interface (if installed)
56-
- /client-lib: Libraries for the Mirth Connect Administrator
57-
- /conf: Configuration files
58-
- /custom-lib: Place your custom user libraries here to be used by the default library resource.
59-
- /docs: This document and a copy of the Mirth Connect license
60-
- /docs/javadocs: Generated javadocs for the installed version of Mirth Connect. These documents are also available when the server is running at `http://[server address]:8080/javadocs/` (i.e. `http://localhost:8080/javadocs/`).
61-
- /extensions: Libraries and meta data for Plug-ins and Connectors
62-
- /logs: Default location for logs generated by Mirth Connect and its sub-components
63-
- /manager-lib: Libraries for the Mirth Connect Server Manager (if installed)
64-
- /public_html: Directory exposed by the embedded web server
65-
- /server-launcher-lib: Libraries in this directory will be loaded into the main Mirth Connect Server thread context classloader upon startup. This is required if you are using any custom log4j appender libraries.
66-
- /server-lib: Mirth Connect server libraries
67-
- /webapps: Directory exposed by the embedded web server to host webapps
43+
- **Extensible and Customizable**
44+
Modular architecture for customization and expansion to meet evolving needs.
6845

69-
------------
46+
---
7047

71-
<a name="starting-mirth-connect"></a>
72-
## 4. Starting Mirth Connect
73-
Once Mirth Connect has been installed, there are several ways to connect to launch the Mirth Connect Administrator. On a Windows installation, there is a Mirth Connect Administrator item in the Start Menu which launches the application directly.
48+
## Core Features
7449

75-
If the option is not available, you can connect to the Mirth Connect Administrator launch page which by default should be available at `http://[server address]:8080` (i.e. `http://localhost:8080`). It is recommended to use the Administrator Launcher to start the Administrator, which can be downloaded by clicking on the Download Administrator Launcher button. Clicking the Launch Mirth Connect Administrator button will download the Java Web Start file for your server. Opening the file with the Administrator Launcher connects you to the server, which will be listening on `https://[server address]:8443` (i.e. `https://localhost:8443`).
50+
- **Data Transformation and Mapping**
51+
Convert between HL7, JSON, XML, and other formats to ensure cross-system compatibility.
7652

77-
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.
53+
- **Message Routing and Filtering**
54+
Route messages using flexible, rules-based logic to streamline workflows.
7855

79-
If you are launching the administrator for the first time, you will notice that the libraries for the Mirth Connect Administrator will be loaded. This feature allows you run the Administrator from any remote Mirth Connect server without having to download and install a separate client.
56+
- **Custom Scripting and Connectors**
57+
JavaScript-based scripting and support for protocols like HTTP/S, FTP, and database connectivity.
8058

81-
You may also notice a security warning when starting the administrator (dialog box depends on browser being used). This is because by default Mirth Connect creates a self-signed certificate for its web server. For now click Run to continue launching the administrator, but check out the User Guide for instructions on how to replace the certificate.
59+
- **Real-Time Monitoring and Alerts**
60+
Visual tools for tracking message flow, performance metrics, and setting up alerts.
8261

83-
------------
62+
---
8463

85-
<a name="java9"></a>
86-
## 5. Running Mirth Connect in Java 9 or greater
87-
In order to run Mirth Connect in Java 9 or greater, copy the options from `docs/mcservice-java9+.vmoptions` and append them to either mcserver.vmoptions or mcservice.vmoptions, depending on your deployment. Then restart Mirth Connect.
64+
## Who It’s For
8865

89-
To run the Mirth Connect Command Line Interface, create a new file named mccommand.vmoptions in the Mirth Connect root directory. Copy all of the options from `docs/mcservice-java9+.vmoptions` into mccommand.vmoptions and save before launching the Command Line Interface.
66+
- **Integration Engineers** – Looking for a flexible, open platform for managing interfaces
67+
- **Health IT Teams** – Connecting EHRs, LIS, RIS, and other healthcare systems
68+
- **EHR Vendors** – Enhancing interoperability within their products
69+
- **Researchers** – Requiring reliable, standards-based integration tools
9070

91-
------------
71+
---
9272

93-
<a name="java-licensing"></a>
94-
## 6. Java Licensing
95-
In 2019, Oracle significantly changed licensing for official Oracle Java releases. You must now purchase a license in order to receive updates to the commercial version of Oracle Java. In response to this change, we officially added support for OpenJDK in Mirth Connect. OpenJDK receives free updates from Oracle for a period of 6 months following each release. While the Oracle OpenJDK distribution is recommended for use with Mirth Connect, we strive to support third-party OpenJDK distributions as well such as AdoptOpenJDK, Azul Zulu and Amazon Corretto. Third party distributions may receive extended release updates from their respective communities, but these are not guaranteed.
73+
## Project Values
9674

97-
------------
75+
- **Community-Driven Development** – Innovation through global collaboration
76+
- **Vendor Neutrality** – Free from proprietary constraints
77+
- **Security and Compliance** – HIPAA/GDPR-compliant architecture
9878

99-
<a name="license"></a>
100-
## 7. License
101-
Mirth Connect is released under the [Mozilla Public License version 2.0](https://www.mozilla.org/en-US/MPL/2.0/ "Mozilla Public License version 2.0"). You can find a copy of the license in `server/docs/LICENSE.txt`.
79+
---
10280

103-
All licensing information regarding third-party libraries is located in the `server/docs/thirdparty` folder.
81+
## Community and Governance
82+
83+
Engage with the community and project through:
84+
85+
- 🌐 **Website**: [openintegration.org](https://openintegration.org)
86+
- 💬 **Discord**: [Join our server](https://discord.gg/azdehW2Zrx)
87+
- 📂 **GitHub Repo**: [github.com/OpenIntegrationEngine/engine](https://github.com/OpenIntegrationEngine/engine)
88+
- 📥 **Releases**: [Latest Releases](https://github.com/OpenIntegrationEngine/engine/releases)
89+
- 🗳️ **Governance**: [Governance Docs](https://github.com/OpenIntegrationEngine/governance)
90+
- 🐳 **Docker Hub**: [OpenIntegrationEngine on Docker Hub](https://hub.docker.com/u/openintegrationengine)
91+
- 🔗 **LinkedIn**: [Follow us on LinkedIn](https://www.linkedin.com/company/open-integration-engine)
92+
93+
Governance is structured to be transparent and inclusive, with decisions made collectively to reflect the community’s best interests.
94+
95+
---
96+
97+
## History and Roadmap
98+
99+
Forked from **Mirth Connect** following its shift to a proprietary model, this project continues the legacy of open healthcare integration.
100+
101+
### Roadmap
102+
103+
**Short-Term Goals**
104+
- Stabilize codebase
105+
- Improve documentation
106+
- Expand community involvement
107+
108+
**Long-Term Vision**
109+
- Support new healthcare standards
110+
- Enhance UX/UI
111+
- Grow plugin ecosystem
112+
113+
---
114+
115+
## Licensing
116+
117+
Licensed under the **Mozilla Public License 2.0** (MPL 2.0). See [LICENSE](./LICENSE) for details.
118+
119+
---
120+
121+
## Acknowledgments
122+
123+
Special thanks to the original **Mirth Connect** team and the broader open-source healthcare integration community.

0 commit comments

Comments
 (0)