Skip to content

Latest commit

 

History

History
138 lines (80 loc) · 3.68 KB

README.MD

File metadata and controls

138 lines (80 loc) · 3.68 KB

MIRTH CONNECT EXAMPLES ON DOCKER

Authors: Marly Cormar, Surya Prasanna, Dileep Rajput.

Prerequisites

Current Examples

The goal of this multi-container docker is to test the functionalities of Mirth Connect.

Channels included:

  1. json_to_hl7_dest_channel_writer: This channel receives a json file over an HTTP request, transforms it into an hl7 message, and sends it to another channel.

     Datatype: JSON -> HL7v2.x, HL7v2.x -> HL7v2.x
 Source: HTTP Listener
 Source Transformer: json to hl7
 Destination: Channel Writer

  2. hl7FileReader_to_dbWriter: Reads a file containing an hl7 message and updates a mysql db accordingly.

     Datatype: HL7v2.x
 Source: File Reader
 Destination Transformer: creates steps from the hl7 template
 Destination: Database Writer

  3. secure_json_to_hl7_dest_channel_writer: This channel receives a json file over an HTTP request, transforms it into an hl7 message, and sends it to another channel. Optionally, you may change/add credentials to secure the connection. Please see the documentation on channels/secure_json_to_hl7_dest_channel_writer.

     Datatype: JSON -> HL7v2.x, HL7v2.x -> HL7v2.x
 Source: HTTP Listener
 Source Transformer: json to hl7
 Destination: Channel Writer

Configuration

  1. Create all the containers in detached mode:

     docker-compose up -d

  2. Open Mirth Connect by double clicking file webstart.jnlp. Use credentials:

     https://0.0.0.0:8443
 admin
 admin

  3. Once Mirth Connect is open, import the example channel you will be using. Click on Channels located on the left menu.

  4. Also on the left menu, click Import Channel and add the channel ./mirth-connect/channel.xml

  5. Deploy channel.

  6. Optional: Inside the mirth container, you may modify the file /opt/mirth-connect/conf/mirth.properties to allow, for example, that user accounts are locked after 10 unsuccessful login attempts:

     password.lockoutperiod = 1
 password.expiration = 10

Web Interface

  • Admin interface at:

      https://127.0.0.1:8443/webadmin/DashboardStatistics.action

  • Channel interface at:

      https://127.0.0.1:8443/api/

Troubleshoot

If the java applet webstart.jnlp fails to connect to the containers:

  1. Delete the contents of the folder data:

     rm -r data/*

  2. Check the ports on which the server is running:

     docker ps

  3. Download mirth connect admin by going to:

     127.0.0.1:<8080_PORT>/webstart.jnlp

  4. Provide the following configuration:

     host: https://localhost:<8443_PORT>
 username: admin
 password: admin

Useful:

  • stop all containers:

      docker stop $(docker ps -a -q) && docker rm $(docker ps -a -q) && docker volume rm $(docker volume ls)

  • remove all docker containers:

      docker rm $(docker ps -a -q)

  • remove all docker images:

      docker rmi $(docker images -q)

  • ssh into container:

      docker exec -it <mycontainer_id> bash

  • prune the system:

      docker system prune

  • list volumes:

      docker volume ls

  • remove volumes:

      docker volume rm $(docker volume ls)

  • database credentials:

      database: mirth-test
  user: mirth
  password: password

  • the local folder ./shared_folder/ is shared with the docker container that has mirth. The contents of such folder are being mapped to /var/shared_volume in the mirth container.

  • open ports:

    • mirth-connect:

        8002->8002
  8080->8080
  8443->8443

    • mysql:

        3306->3306