Mirth Connect es un motor de integración de código abierto que se utiliza principalmente en el dominio de la atención médica.
Esto es compatible con varios estándares de atención médica (HL7, XML, EDI/X12, DICOM, etc.) que ayudarán a las empresas a integrar diferentes sistemas y les permitirán comunicarse entre sí en un lenguaje común.
El motor de interfaz MirthConnect también admite varios protocolos estándar (por ejemplo, TCP, HTTP, JDBS, SFTP, etc.) para conectar dos sistemas.
De forma predeterminada, cuando instala mirthconnect, utiliza Apache Derby como motor de almacenamiento. Pero es compatible con casi todas las bases de datos populares, incluidas MySQL/MariaDB, PostgreSQL, Oracle y SQL Server.
En este tutorial, explicaremos cómo instalar el software de código abierto MirthConnect y configurarlo para comunicarse con la base de datos MySQL en la plataforma Linux.
Los siguientes conectores y formatos son compatibles con la versión de código abierto:
- Conectores:TCP, MLLP, HTTP, FTP, DICOM, SOAP, SQL, JMS, Sistema de archivos, HTTPS, POP3, IMAP, ASTM, RS232
- Formatos:XML, HL7, DICOM, NCPDP, X12, texto delimitado, binario sin procesar
Recientemente, NextGen adquirió mirthconnect. La versión comercial admite algunos formatos adicionales, como CCD, C-CDA, ASTM. Además, la versión comercial tiene algunas extensiones empresariales avanzadas. Por ejemplo:administrador SSL, control de acceso basado en funciones, alertas avanzadas, historial de canales, autenticación LDAP, generador de mensajes HL7.
En este tutorial, explicaremos cómo instalar la versión de código abierto de Mirth Connect en la base de datos MySQL.
Paso 1:requisito previo:instalar Java JDK
Asegúrese de tener instalado JDK 1.8 en su sistema como se muestra a continuación.
# 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)
Si no tiene JDK instalado, use yum para instalarlo como se muestra a continuación:
yum -y install java-1.8.0-openjdk
Debería ver los siguientes paquetes relacionados con JDK instalados en su sistema:
# 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
Paso 2:Instalar MySQL/MariaDB
Como se mencionó anteriormente, por defecto, mirthconnect viene con Apache Derby como base de datos predeterminada.
Pero, en este tutorial, instalaremos y configuraremos la base de datos MySQL/MariaDB y la usaremos para mirthconnect.
Instale el servidor MySQL/MariaDB como se muestra a continuación. Para esto, debe instalar los siguientes dos paquetes mariadb.
yum install mariadb yum install mariadb-server
Nota:si está utilizando una versión anterior de la distribución de Linux, donde el paquete mariadb-server no está disponible en el repositorio de yum, instale el paquete mysql-server como se muestra a continuación.
yum install mysql-server
Una vez que MariaDB esté instalado, verá los siguientes paquetes en su sistema:
# 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
Una vez que mariadb esté instalado, inícielo y asegúrese de que funciona correctamente.
systemctl start mariadb systemctl status mariadb
También es posible que desee ejecutar lo siguiente para configurar algunas configuraciones de seguridad para su instalación de MySQL/MariaDB. Esto también asignará una contraseña de root para su base de datos.
/usr/bin/mysql_secure_installation
Paso 3:Cree una base de datos MySQL para MirthConnect
Vamos a crear una base de datos llamada "thegeekstuff", que será utilizada por la instalación de mirthconnect.
Para esto, use el comando mysql con el nombre de usuario y la contraseña de root de mysql como se muestra a continuación.
# mysql -u root -pMySQLRootPwd MariaDB [(none)]> create database thegeekstuff;
Una vez creada la base de datos, cree un usuario llamado “thegeekstuff” y asígnele una contraseña. Esta cuenta se usará en la configuración de mirthconnect para hablar con la base de datos.
MariaDB [(none)]> grant all on thegeekstuff.* to 'thegeekstuff'@'localhost' identified by 'DBSecretPwd!' with grant option; MariaDB [(none)]> flush privileges;
En esta etapa, no verá ninguna tabla relacionada con mirthconnnect en esta base de datos. Pero, una vez que haya instalado mirthconnect, verá varias tablas aquí.
# mysql -u root -pMySQLRootPwd MariaDB [(none)]> use sysadmin; Database changed MariaDB [sysadmin]> show tables; Empty set (0.00 sec)
Paso 4:Descarga e instala Mirth Connect
Descarga mirthconnect desde aquí.
Puede instalar mirthconnect usando cualquiera de estos formatos:1) RPM 2) tar.gz 2) Instalador
Para este tutorial, usaremos el formato tar.gz de la instalación de mirthconnect.
Primero, obtenga el enlace de descarga para tar.gz y use el comando wget para enviarlo a su servidor como se muestra a continuación.
cd ~ wget http://downloads.mirthcorp.com/connect/3.4.2.8129.b167/mirthconnect-3.4.2.8129.b167-unix.tar.gz
Una vez descargado, descomprímalo como se muestra a continuación.
tar xvfz mirthconnect-3.4.2.8129.b167-unix.tar.gz
De forma predeterminada, esto creará el directorio "Mirth Connect" en su directorio actual.
Para administrar esto mejor, muévalo al directorio /opt, y también elimine el "espacio" en el nombre, y póngalo en minúsculas, lo que es más fácil de administrar en un entorno Linux.
En este ejemplo, cambiaremos el nombre de "Mirth Connect" a "mirthconnect" y, al mismo tiempo, lo moveremos al directorio /opt como se muestra a continuación.
mv Mirth\ Connect/ /opt/mirthconnect
Nota:si desea instalarlo desde un archivo RPM, haga lo siguiente:
cd ~ wget http://downloads.mirthcorp.com/connect/3.4.2.8129.b167/mirthconnect-3.4.2.8129.b167-linux.rpm
Instale el archivo RPM mirthconnect usando el comando rpm como se muestra a continuación:
rpm -ivh mirthconnect-3.4.2.8129.b167-linux.rpm
Paso 5:Modificar los archivos de configuración de MirthConnect
El archivo principal de propiedades de mirthconnect es mirth.properties ubicado en el directorio /opt/mirthconnect/conf.
vi /opt/mirthconnect/conf/mirth.properties
En este archivo, modifique los siguientes parámetros:
http.port = 8080 https.port = 8443 database = mysql database.url = jdbc:mysql://localhost:3306/thegeekstuff database.username = thegeekstuff database.password = DBSecretPwd!
En lo anterior:
- http.port:8080 es el puerto HTTP predeterminado de mirthconnect. Puede cambiar este valor para que coincida con su entorno.
- https.port:8443 es el puerto HTTP predeterminado de mirthconnect. Puede cambiar este valor para que coincida con su entorno.
- base de datos:de forma predeterminada, dirá derby. Cambie este valor a mysql como se muestra arriba.
- database.url:dado que estamos utilizando la base de datos MySQL, establezca esta base de datos.url en el valor que se muestra arriba. De forma predeterminada, esto apuntará a la base de datos derby predeterminada. Cambie este valor. Asegúrese de que al final de la URL tenga el nombre de la base de datos mysql que creó anteriormente. Si está copiando/pegando este valor de las líneas de comentarios del archivo de configuración, tendrá mirthdb aquí. Debe cambiar esto a su nombre de base de datos.
- database.username:configúrelo para el usuario mysql que creamos anteriormente.
- database.password:establezca este valor en la contraseña correspondiente para su nombre de usuario mysql.
Paso 6:Inicie MirthConnect
Ahora, inicie mirthconnect como un servicio usando el comando mcservice.
# /opt/mirthconnect/mcservice start Starting mcservice # /opt/mirthconnect/mcservice status The daemon is running.
También puede hacer un ps y verificar el proceso "mcservice" que se está ejecutando en segundo plano, como se muestra a continuación.
# 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
Nota:Cuando inicie mirthconnect por primera vez, se conectará a la base de datos MySQL y creará todas las tablas requeridas.
Ahora, si se conecta a mysql, verá que ha creado 13 tablas nuevas que son necesarias para que mirthconnect funcione correctamente.
MariaDB [thegeekstuff]> 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)
Paso 7:Agregar Mirthconnect a Systemd
Si está ejecutando CentOS 7 (o RedHat), es posible que desee agregar mirthconnect al inicio de systemd.
Para ello, cree el siguiente archivo 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
Nota:si instaló mirthconnect como un usuario diferente al root, cambie el Usuario y el Grupo en el archivo anterior según corresponda.
Después de eso, puede usar systemctl para iniciar y detener mirthconnect como se muestra a continuación.
systemctl start mirthconnect systemctl stop mirthconnect
Para que se inicie automáticamente cuando se reinicia el servidor, habilite este servidor systemd para el inicio como se muestra a continuación.
systemctl enable mirthconnect
Paso 8:Inicie sesión en el administrador de MirthConnect
Puede utilizar la siguiente URL HTTP o HTTPS:
- http://{su-dirección-ip}:8080
- https://{tu-dirección-ip}:8443
La interfaz de usuario de Mirth Connect tendrá las siguientes dos opciones:
- MirthConnect Administartor:esto iniciará la interfaz de usuario del administrador usando java webstart.
- Iniciar sesión en el panel web:si inició la URL con http, se mostrará el botón "Acceder al sitio seguro". Haga clic en eso para usar mirthconnect desde el navegador. Si usa la URL HTTPS, aquí se mostrará el cuadro de texto de nombre de usuario y contraseña.
El nombre de usuario y la contraseña predeterminados de mirthconnect son admin/admin.
La siguiente es la captura de pantalla del panel web de Mirth Connect:
Al hacer clic en el botón de inicio web "Iniciar administrador de mirthconnect", se descargará un archivo llamado "webstart.jnlp" en su sistema. Haga doble clic en esto para iniciar el inicio web.
La primera vez, se abrirá un cuadro de diálogo que dice "Verificando la aplicación". Esto también mostrará qué mirthconnect está iniciando al mostrar la URL completa de la ubicación de mirthconnect que está iniciando.
A continuación, Java mostrará un mensaje de advertencia y le preguntará "¿Desea ejecutar esta aplicación?". Haga clic en "Ejecutar". Esto finalmente mostrará el siguiente cuadro de inicio de sesión de mirthconnect. La columna del servidor se completará de forma predeterminada con la URL correcta. Si no ve los valores correctos aquí, ingrese esto:https://{your-ip-address}:8443
Introduzca el nombre de usuario y la contraseña. Cuando lo haces por primera vez, el nombre de usuario y la contraseña son admin.
La primera vez que inicie sesión, esto lo obligará a cambiar la contraseña de administrador.
Finalmente, esto mostrará el panel del administrador de Mirthconnect como se muestra a continuación, desde aquí puede administrar mirthconnect creando y administrando canales.
Resolución de problemas de inicio de Mirth Connect
Si mirthconect no se inicia correctamente, consulte los siguientes archivos de registro de mirth para ver si hay algún problema.
tail -100 /opt/mirthconnect/logs/mirth.log
Además, para fines de depuración, es posible que desee desactivar temporalmente firewalld y selinux para asegurarse de que no estén bloqueando mirthconnect por algún motivo.
Para detener el firewalld, haga lo siguiente:
systemctl stop firewalld
Deshabilite temporalmente SELinux como se muestra a continuación:
setenforce 0
Después de eso, vuelva a iniciar mirthconnect y compruebe si se inicia correctamente.
Estructura de directorio de Mirth Connect
De forma predeterminada, en el directorio de instalación de /opt/mirthconnect, verá los siguientes directorios:
- conf:todos los archivos de configuración de mirthconnect estarán aquí
- webapps:este es el directorio expuesto por el servidor web mirthconnect para alojar aplicaciones web
- server-lib:todos los archivos de la biblioteca del servidor mirthconnect estarán aquí
- public_html:directorio expuesto por el servidor web mirthconnect para alojar archivos html
- manager-lib:este directorio contendrá todas las bibliotecas que utiliza Mirthconnect Server Manager
- extensiones:todas las bibliotecas y metadatos utilizados por sus complementos y conectores estarán aquí
- docs:directorio de documentos
- custom-lib:en este directorio, como sugiere el nombre, puede colocar todos sus archivos de biblioteca personalizados. Estas bibliotecas se cargarán en el servidor mirthconnect durante el inicio.
- cli-lib:las bibliotecas de interfaz de línea de comandos de Mirthconnect estarán en este directorio
- client-lib:tendrá las bibliotecas de administrador de mirthconnect
Además del directorio anterior, también verá los siguientes archivos:
- mcservice.vmoptions y mcserver.vmoptions:configuración de memoria Java para Mirthconnect
- mcservice:se utiliza para iniciar, detener y ver el estado de Mirth Connect Service Deamon
- mcserver:si no está utilizando la opción de servicio, utilícela para iniciar Mirth Connect en un modo sin servicio.
- mcmanager:este es el administrador del servidor mirthconnect
- mccommand:utilidad de línea de comandos de Mirthconnect
- mirth-server-launcher.jar, mirth-manager-launcher.jar, mirth-cli-launcher.jar:archivos jar utilizados por mirth connect server, manager y cli respectivamente