第壹課-Install：Mirth Connect在Win10下的安装步骤

 

1.安装JDK，推荐安装JDK8 64位，版本jdk-8u201-windows-x64.exe.

 

安装JDK后，同时必须配置win10的系统环境变量【示例如下】：

 

JAVA_HOME ： F:\Java\jdk8

 

JAVA_TOOL_OPTIONS ： -Dfile.encoding=UTF-8 -Duser.language=en -Duser.country=US

 

CLASSPATH ： .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;

 

Path环境变量需要添加一个变量值:

点'新建'后直接把%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin输入进去。

• 变量值：%JAVA_HOME%\bin
• 变量值：%JAVA_HOME%\jre\bin

注意：输入的时候不要有分号

 

特别说明：不要安装jdk-8u281-windows-x64.exe及以上版本的JDK,因oracle公司在此版本已经对JDK策略进行变更，安装此版本后Mirth将无法启动！！！

安装完JDK后，请打开‘控制面板’——‘java’,更改不再检查更新(非常重要，否则jdk自动更新后，原本正常运行的mirth会启动不了！！！).

2.安装Mirth，推荐安装3.10.1 64 位，版本mirthconnect-3.10.1.b280-windows-x64.exe，安装说明如下：

 （图1，安装目录不要带有空格）

 （图2，不勾选安装Administrator Launcher）

 （图3，启动URL地址 https://localhost:8443 ）

3.安装客户端启动工具，推荐安装1.1.0 64 位，版本mirth-administrator-launcher-1.1.0-windows-x64.exe，安装说明如下：

 （图4，安装在第2步的根目录下且目录不能有空格）

4.停止Mirth服务，设置‘系统环境变量’，配置说明如下：

（图5，右键‘我的电脑’，设置系统环境变量，解决Mirth客户端界面中文GBK乱码问题）

在安装目录中有个 F:\MirthConnect\custom-lib文件夹，这里是扩展Mirth功能，此目录放置的是用户自定义JAR包功能扩展库；因此需要把此路径加到‘系统的环境变量’CLASSPATH的配置中：

CLASSPATH ： .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;F:\MirthConnect\custom-lib;

JDK8安装特别说明：首先java8安装目录不能使用默认目录，必须是手动选择安装到非空格非中文的目录；

然后配置JAVA_HOME系统变量，如上图所示。

经过大量测试，如果java8安装在默认的有空格目录，web service channel信道会报错，用不了，报错截图如下：

特别提示：改变环境变量，mirth 驾驶舱的管理界面正常显示不再有乱码；

但信道描述和日志的中文显示会乱码；但接收和发送中文不受影响。

故这样改系统环境变量后再使用 mirth 时，建立信道写信道相关描述或日志请用英文。

5.安装FHIR信道扩展，推荐版本fhir-3.10.1.b286.zip；

安装步骤，解压fhir-3.10.1.b286.zip后，拷贝解压后的fhir整个目录到mirth服务插件目录F:\MirthConnect\extensions中，如图所示：

 

 

 

（图6，解压FHIR扩展并拷贝到mirth服务的扩展extensions根目录）

6.启动Mirth服务；然后以管理员模式启动F:\MirthConnect\AdministratorLauncher目录中的mirth administrator launcher程序launcher.exe，如图所示：

（图7，管理客户端截图）

特别说明：

导入FHIR部署实例：

https://github.com/Fdawgs/ydh-fhir-listeners

 （图8，扩展视图中可见FHIR扩展已经导入且启用）

（图9，Mirth完整安装包）

 

MIRTH CONNECT README

            Contents

==================================================

1. General Information

2. Installation and Upgrade

3. Starting Mirth Connect

4. Running Mirth Connect in Java 9 or greater

5. More Information

 

1. General Information

==================================================

Mirth Connect is an open source health care integration engine. By supporting numerous standards (like HL7, EDI/X12, XML, NCPDP, DICOM, and Delimited Text) and protocols (like TCP/LLP, HTTP, JDBC, and File/FTP/SFTP), Mirth Connect allows for the filtering, transformation, and routing of messages between disparate systems to allow them to share data.

2. Installation and Upgrade

==================================================

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).

Mirth Connect installers also come with the option to install and start a service which will run 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.

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.

After the installation, the Mirth Connect directory layout will look as follows:

/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.

/cli-lib: Libraries for the Mirth Connect Command Line Interface (if installed)

/client-lib: Libraries for the Mirth Connect Administrator

/conf: Configuration files

/custom-lib: Place your custom user libraries here. These libraries will be loaded on the Mirth Connect Server classpath when it is started, making them accessible to channel scripts.

/docs: This document and a copy of the Mirth Connect license

/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/).

/extensions: Libraries and meta data for Plug-ins and Connectors

/logs: Default location for logs generated by Mirth Connect and its sub-components

/manager-lib: Libraries for the Mirth Connect Server Manager (if installed)

/public_html: Directory exposed by the embedded web server

/server-lib: Mirth Connect server libraries

/webapps: Directory exposed by the embedded web server to host webapps

3. Starting Mirth Connect

==================================================

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.

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). Clicking the Launch Mirth Connect Administrator button will connect you to the server which will be listening on https://[server address]:8443 (i.e. https://localhost: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.

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.

You may also notice a security warning when starting the administrator (dialog box depends on browser being used). This is normal and you should click Run to continue launching the administrator.

4. Running Mirth Connect in Java 9 or greater

==================================================

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.

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.

5. More Information

==================================================

You can find the latest Mirth Connect release information, documentation, and more at: https://www.nextgen.com/products-and-services/integration-engine

Join the Mirth Connect Community at: http://www.mirthcorp.com/community/registration