華為軟件開發云:讓軟件研發變成快樂的事
1588
2025-04-02
Mirth Connect 是一個開源集成引擎,主要用于醫療保健領域。
這支持各種醫療保健標準(HL7、XML、EDI/X12、DICOM 等),這將幫助企業集成不同的系統,并讓它們以通用語言相互交流。
MirthConnect 接口引擎還支持各種標準協議(例如,TCP、HTTP、JDBS、SFTP 等)來連接兩個系統。
默認情況下,當您安裝 mirthconnect 時,它使用 Apache Derby 作為存儲引擎。但是,它支持幾乎所有流行的數據庫,包括 MySQL / MariaDB、PostgreSQL、Oracle 和 SQL Server。
在本教程中,我們將解釋如何安裝 MirthConnect 開源軟件,并將其配置為與 Linux 平臺上的 MySQL 數據庫通信。
開源版本支持以下連接器和格式:
連接器:TCP、MLLP、HTTP、FTP、DICOM、SOAP、SQL、JMS、文件系統、HTTPS、POP3、IMAP、ASTM、RS232
格式:XML、HL7、DICOM、NCDPP、X12、分隔文本、原始二進制
最近 NextGen 收購了 mirthconnect。商業版本支持一些額外的格式,如 CCD、C-CDA、ASTM。此外,商業版還有一些高級的企業擴展。例如:SSL 管理器、基于角色的訪問控制、高級警報、通道歷史、LDAP 身份驗證、HL7 消息生成器。
在本教程中,我們將解釋如何在 MySQL 數據庫上安裝 Mirth Connect 的開源版本。
第 1 步:先決條件:安裝 Java JDK
確保您的系統上安裝了 JDK 1.8,如下所示。
# java -version openjdk version "1.8.0_102" OpenJDK Runtime Environment (build 1.8.0_102-b14) OpenJDK 64-Bit Server VM (build 25.102-b14, mixed mode)
如果沒有安裝JDK,使用yum安裝,如下圖:
yum -y install java-1.8.0-openjdk
您應該會看到系統上安裝了以下與 JDK 相關的軟件包:
# rpm -qa | grep -i jdk java-1.8.0-openjdk-headless-1.8.0.102-1.b14.el7_2.x86_64 java-1.8.0-openjdk-1.8.0.102-1.b14.el7_2.x86_64 java-1.8.0-openjdk-devel-1.8.0.102-1.b14.el7_2.x86_64
第 2 步:安裝 MySQL/MariaDB
如前所述,默認情況下,mirthconnect 帶有 Apache Derby 作為默認數據庫。
但是,在本教程中,我們將安裝和配置 MySQL / MariaDB 數據庫,并將其用于 mirthconnect。
安裝 MySQL / MariaDB 服務器,如下所示。為此,您應該安裝以下兩個 mariadb 包。
yum install mariadb yum install mariadb-server
注意:如果您使用的是較舊版本的 Linux 發行版,其中 yum 存儲庫中沒有 mariadb-server 包,請安裝 mysql-server 包,如下所示。
yum install mysql-server
安裝 MariaDB 后,您將在系統上看到以下軟件包:
# rpm -qa | grep -i maria mariadb-5.5.50-1.el7_2.x86_64 mariadb-server-5.5.50-1.el7_2.x86_64 mariadb-libs-5.5.50-1.el7_2.x86_64
安裝 mariadb 后,啟動它并確保它正常運行。
systemctl start mariadb systemctl status mariadb
您可能還想運行以下命令來為您的 MySQL/MariaDB 安裝設置一些安全設置。這還將為您的數據庫分配一個 root 密碼。
/usr/bin/mysql_secure_installation
步驟 3:為 MirthConnect 創建 MySQL 數據庫
讓我們創建一個名為“thegeekstuff”的數據庫,mirthconnect 安裝將使用該數據庫。
為此,使用 mysql 命令和 mysql 的 root 用戶名和密碼,如下所示。
# mysql -u root -pMySQLRootPwd MariaDB [(none)]> create database tiamo;
創建數據庫后,創建一個名為“thegeekstuff”的用戶,并為此分配一個密碼。此帳戶將在 mirthconnect 配置中用于與數據庫對話。
MariaDB [(none)]> grant all on tiamo.* to 'tiamo'@'localhost' identified by 'DBSecretPwd!' with grant option; MariaDB [(none)]> flush privileges;
在此階段,您不會在此數據庫中看到任何與 mirthconnnect 相關的表。但是,一旦安裝了 mirthconnect,您就會在此處看到多個表。
# mysql -u root -pMySQLRootPwd MariaDB [(none)]> use sysadmin; Database changed MariaDB [sysadmin]> show tables; Empty set (0.00 sec)
第 4 步:下載并安裝 Mirth Connect
從這里下載 mirthconnect?。
您可以使用以下任何一種格式安裝 mirthconnect:1) RPM 2) tar.gz 2) 安裝程序
在本教程中,我們將使用 mirthconnect 安裝的 tar.gz 格式。
首先,獲取 tar.gz 的下載鏈接,然后使用 wget 命令將其發送到您的服務器,如下所示。
cd ~ wget http://downloads.mirthcorp.com/connect/3.4.2.8129.b167/mirthconnect-3.4.2.8129.b167-unix.tar.gz
下載后,解壓,如下圖所示。
tar xvfz mirthconnect-3.4.2.8129.b167-unix.tar.gz
默認情況下,這將在您的當前目錄下創建“Mirth Connect”目錄。
為了更好的管理這個,把它移到/opt目錄下,同時去掉名字中的“空格”,全部小寫,這樣在Linux環境下更容易管理。
在本例中,我們將“Mirth Connect”重命名為“mirthconnect”,同時將其移動到 /opt 目錄,如下所示。
mv Mirth\ Connect/ /opt/mirthconnect
注意:如果您想從 RPM 文件安裝它,請執行以下操作:
cd ~ wget http://downloads.mirthcorp.com/connect/3.4.2.8129.b167/mirthconnect-3.4.2.8129.b167-linux.rpm
使用 rpm 命令安裝 RPM mirthconnect 文件,如下所示:
rpm -ivh mirthconnect-3.4.2.8129.b167-linux.rpm
步驟 5:修改 MirthConnect 配置文件
主要的 mirthconnect 屬性文件是位于 /opt/mirthconnect/conf 目錄下的 mirth.properties。
vi /opt/mirthconnect/conf/mirth.properties
在該文件中,修改以下參數:
http.port = 8080 https.port = 8443 database = mysql database.url = jdbc:mysql://localhost:3306/tiamo database.username = tiamo database.password = DBSecretPwd!
在上面:
http.port – 8080 是默認的 mirthconnect HTTP 端口。您可以更改此值以匹配您的環境。
https.port – 8443 是默認的 mirthconnect HTTP 端口。您可以更改此值以匹配您的環境。
數據庫 - 默認情況下,這會說 derby。將此值更改為 mysql,如上所示。
database.url – 由于我們使用的是 MySQL 數據庫,因此將此 database.url 設置為上面顯示的值。默認情況下,這將指向默認的 derby 數據庫。更改此值。確保在 url 的末尾,它具有您之前創建的 mysql 數據庫名稱。如果您從配置文件注釋行復制/粘貼此值,則此處將包含 mirthdb。您應該將其更改為您的數據庫名稱。
database.username – 將其設置為我們之前創建的 mysql 用戶。
database.password – 將此值設置為您的 mysql 用戶名的相應密碼。
第 6 步:啟動 MirthConnect
現在,使用 mcservice 命令將 mirthconnect 作為服務啟動。
# /opt/mirthconnect/mcservice start Starting mcservice # /opt/mirthconnect/mcservice status The daemon is running.
您還可以執行 ps 并檢查在后臺運行的“mcservice”進程,如下所示。
# ps -ef | grep mcservice root 26665 1 0 07:41 pts/2 00:01:57 /usr/bin/java -Dinstall4j.jvmDir=/usr -Dexe4j.moduleName=/opt/mirthconnect/mcservice -Dinstall4j.launcherId=144 -Dinstall4j.swt=false -server -Xmx256m -Djava.awt.headless=true -Di4j.vmov=true -Di4j.vmov=true -Di4j.vpt=true -classpath /opt/mirthconnect/.install4j/i4jruntime.jar:/opt/mirthconnect/mirth-server-launcher.jar com.install4j.runtime.launcher.Launcher start com.mirth.connect.server.launcher.MirthLauncher false false true true false true true 0 0 20 20 Arial 0,0,0 8 500 version 3.4.2.8129.b167 20 40 Arial 0,0,0 8 500 -1
注意:當您第一次啟動 mirthconnect 時,它將連接到 MySQL 數據庫,并創建所有需要的表。
現在,如果您連接到 mysql,您將看到它創建了 mirthconnect 正常運行所需的 13 個新表。
MariaDB [tiamo]> show tables; +-----------------------+ | Tables_in_thegeekstuff| +-----------------------+ | ALERT | | CHANNEL | | CHANNEL_GROUP | | CODE_TEMPLATE | | CODE_TEMPLATE_LIBRARY | | CONFIGURATION | | D_CHANNELS | | EVENT | | PERSON | | PERSON_PASSWORD | | PERSON_PREFERENCE | | SCHEMA_INFO | | SCRIPT | +-----------------------+ 13 rows in set (0.00 sec)
第 7 步:將 Mirthconnect 添加到 Systemd
如果您運行的是 CentOS 7(或 RedHat),那么您可能需要將 mirthconnect 添加到 systemd 啟動中。
為此,創建以下 mirthconnect.service 文件
# vi /usr/lib/systemd/system/mirthconnect.service [Unit] Description=MirthConnect After=network.target [Service] Type=forking User=root Group=root ExecStart=/opt/mirthconnect/mcservice start ExecStop=/opt/mirthconnect/mcservice stop ExecRestart=/opt/mirthconnect/mcservice restart TimeoutSec=60 [Install] WantedBy=multi-user.target
注意:如果您已將 mirthconnect 安裝為 root 以外的其他用戶,則相應地更改上述文件中的用戶和組。
之后,您可以使用 systemctl 啟動和停止 mirthconnect,如下所示。
systemctl start mirthconnect systemctl stop mirthconnect
要使其在服務器重新啟動時自動啟動,請啟用此 systemd 服務器以進行啟動,如下所示。
systemctl enable mirthconnect
步驟 8:登錄 MirthConnect 管理員
您可以使用以下 HTTP 或 HTTPS 網址:
http://{您的 IP 地址}:8080
https://{您的 IP 地址}:8443
Mirth Connect UI 將有以下兩個選項:
MirthConnect Adminstartor – 這將使用 java webstart 啟動管理員 UI。
Web 儀表板登錄 - 如果您使用 http 啟動 URL,這將顯示“訪問安全站點”按鈕。單擊它以僅使用瀏覽器中的 mirthconnect。如果您使用 HTTPS url,這將在此處顯示用戶名和密碼文本框。
默認的 mirthconnect 用戶名和密碼是 admin/admin。
以下是 Mirth Connect Web Dashboard 的屏幕截圖:
當您單擊“啟動 mirthconnect 管理員”webstart 按鈕時,這會將名為“webstart.jnlp”的文件下載到您的系統。雙擊它以啟動 webstart。
第一次,這將啟動一個對話框,上面寫著“正在驗證應用程序”。這還將通過顯示正在啟動的 mirthconnect 位置的完整 URL 來顯示它正在啟動哪個 mirthconnect。
接下來,Java 將顯示一條警告消息并詢問您“是否要運行此應用程序”。點擊“運行”。這將最終顯示以下 mirthconnect 登錄框。默認情況下,服務器列將填充正確的 URL。如果您在此處沒有看到正確的值,請輸入:https://{your-ip-address}:8443
輸入用戶名和密碼。第一次做的時候,用戶名和密碼都是admin。
第一次登錄時,這將強制您更改管理員密碼。
最后,這將顯示 Mirthconnect 管理員儀表板,如下所示,從這里您可以通過創建和管理頻道來管理 mirthconnect。
Mirth Connect 啟動問題故障排除
如果 mirthconect 無法正常啟動,請檢查以下 mirth 日志文件是否有任何問題。
tail -100 /opt/mirthconnect/logs/mirth.log
此外,出于調試目的,您可能需要暫時禁用 firewalld 和 selinux,以確保它們不會出于某種原因阻止 mirthconnect。
要停止 firewalld,請執行以下操作:
systemctl stop firewalld
如下圖暫時禁用 SELinux:
setenforce 0
之后,再次啟動mirthconnect,看看它是否正常啟動。
Mirth Connect 目錄結構
默認情況下,在 /opt/mirthconnect 的安裝目錄下,您將看到以下目錄:
conf - 所有 mirthconnect 配置文件都將在這里
webapps – 這是 mirthconnect websserver 公開以托管 webapps 的目錄
server-lib – 所有 mirthconnect 服務器庫文件都在這里
public_html – mirthconnect 網絡服務器公開的用于托管 html 文件的目錄
manager-lib – 此目錄將保存 Mirthconnect 服務器管理器使用的所有庫
擴展 – 插件和連接器使用的所有庫和元數據都在這里
docs – 文檔目錄
custom-lib——在這個目錄中,顧名思義,你可以放置你所有的自定義庫文件。這些庫將在啟動期間加載到 mirthconnect 服務器。
cli-lib – Mirthconnect 命令行接口庫將在此目錄中
client-lib – 這將包含 mirthconnect 管理員庫
除了上述目錄,您還將看到以下文件:
mcservice.vmoptions 和 mcserver.vmoptions – Mirthconnect 的 Java 內存設置
mcservice - 用于啟動、停止和查看 Mirth Connect Service Deamon 的狀態
mcserver – 如果您不使用服務選項,請使用此選項以非服務模式啟動 Mirth Connect。
mcmanager – 這是 mirthconnect 服務器管理器
mccommand – Mirthconnect 命令行實用程序
mirth-server-launcher.jar, mirth-manager-launcher.jar, mirth-cli-launcher.jar – mirth 連接服務器、管理器和 cli 分別使用的 Jar 文件
Linux MySQL yum
版權聲明:本文內容由網絡用戶投稿,版權歸原作者所有,本站不擁有其著作權,亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容,請聯系我們jiasou666@gmail.com 處理,核實后本網站將在24小時內刪除侵權內容。
版權聲明:本文內容由網絡用戶投稿,版權歸原作者所有,本站不擁有其著作權,亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容,請聯系我們jiasou666@gmail.com 處理,核實后本網站將在24小時內刪除侵權內容。