HL7 over HTTP Relay

• HL7 over HTTP Relay
• Downloading
  • Testing It Out
  • Configuring
• Installing as a Windows Service
  • Uninstalling
• Installing as a Linux Daemon
  • Enabling the Service on RedHat / CentOS
  • Enabling the Service on Debian / Ubuntu

Downloading

To install the HL7 over HTTP Relay, first you should download the latest version from the HAPI download area.

Next, verify that your system has a suitable Jave Runtime Environment (JRE) installed. Open a console window and execute the following command. Note that a version of 1.5.xx or newer is required. If the following command does not work, or if a version below 1.5.xx is found, you will need to upgrade or install Java.

Next, unzip/untar the archive into an appropriate directory. Note that the application is entirely self-contained, meaning that any configuration files live entirely within the directory structure that is created when the application is unzipped. This means that it is possible to run multiple instances of the application with different configurations simply by having multiple installations in different directories.

The default installation contains configuration which listens for MLLP connections on port 8079, and relays incoming messages to the URL: http://localhost:8080/relayURI (note that the this configuration is only for demonstration purposes, and can be changed using the instructions on the next page here)

Installing as a Windows Service

The relay may be installed the Relay as a Window Service, meaning that it will start automatically after a system reboot.

First, you should note: By default the relay will have a service name of "hl7overhttp-relay" and a service description of "HAPI - HL7 over HTTP Relay". If you want to edit this (which is particularly important if you want to have more than one instance of the Relay installed concurrently), edit the "wrapper.conf" file found in the conf directory to modify the following properties:

• wrapper.ntservice.name
• wrapper.ntservice.displayname

Next, to install the service, execute the following command from a console:

To start and stop the service, open the "services" dialog in the Windows Control Panel, and locate the HAPI HL7 over HTTP Relay. You may right click and select "properties" to set up the service to automatically start on reboot, and to recover from unexpected failures.

Installing as a Linux Daemon

The Relay can be installed on a Linux system as a daemon which is started automatically on system startup. This should be possible on any distribution, but the following instructions are known to work on RedHat/CentOS, Debian, and Ubuntu.

The following instructions assume that the Relay has been installed in "/opt/hl7overhttp-relay". You will need to adjust the script if you wish to install somewhere else.

First, extract the relay to /opt/hl7overhttp-relay

The daemon directory in the installation contains an init.d script