Video Demos
Free HL7Connect Videos Did you know that we have some video demonstrations to ease you into HL7Connect?

Click here to see them!

HL7Connect Installation Guide

The HL7Connect install program will either install new HL7Connect or upgrade an existing system. The install program will install HL7Connect in one of two modes: a production server, which runs as a windows service in the background, or in developer mode, where HL7Connect runs as a desktop application. If you have a purchased certificate, this will dictate what kind of mode is installed. If you are evaluating HL7Connect, then you can choose which mode to install.

HL7Connect requires a database in order to operate. Two database servers are supported: Microsoft SQL Server (versions 2005, 2008, 2012) and MySQL (versions 5.1+). If you have an existing installed database, then you can configure HL7Connect to use that. Otherwise, choose to install the Dedicated HL7Connect MySQL Service - this is a full MySQL server (v5.5.27) specially installed to support HL7Connect (though you can choose to use for other purposes if you want). Note that HL7Connect is able to interact with data in almost any database, but requires either Microsoft SQL Server or MySQL for it's own primary database.

HL7Connect is cluster aware. For information about installing on a cluster, see Cluster Installation.

System Requirements

  • Any supported version of Microsoft Windows (32 or 64 bit, though HL7Connect is only 32 bit)
  • Administrator Access to the System (only required for installation)
  • A web browser (IE 8+, Firefox, Safari, or Chrome)
  • A database server, as described above
  • Microsoft Script Engine (usually installed, or see
  • MSXML Core Services(usually installed, or see
  • Internet access is required for some functionality

The hardware requirements for HL7Connect vary greatly depending on the transaction load and how scripts are used. Disk storage requirements depends how long HL7Connect is configured to retain content. A standard hospital with information flow rates of around 1 message or document per second should be able to run HL7Connect on a standard entry level server.


  • Scripting has been known to behave bizarrely if a scripting version older than 5.6 is installed. It appears to be impossible to determine what version of Windows Script Host is installed. You may find the information here helpful:
  • The HL7Connect database can grow rapidly when storing CDA documents and HL7 messages. As the database size grows, performance can deteriorate quickly. System administrators should pay attention to messages archive and deletion policies, and carefully monitor the overall performance of the database using the RDBMS management facilities.
  • For normal operation, HL7Connect does not require dbo/sa/administrator/root access to it's database. There is facility to provide account details for administrative account during install/upgrade. HL7Connect will not apply any permission settings to the databases created. If permission control is sought, this should be reviewed after installation (consult the HL7Connect documentation for assistance with this process).

What is installed?

The following features may be installed depending on the options selected during the installation:

  • HL7Connect Service - The production service that can exchange contents with other systems.
  • Developer - A set of HL7 and script development tools. If the HL7Connect Service is not installed (Developer Mode), it also loads the core module that provides all the HL7Connect functionality
  • Manager - a tool to manage the database and terminology definitions
  • COM Library - The COM interface to HL7Connect. There is no run-time license requirement to use the COM library, and it can be used on PC's on which HL7Connect is not installed.
  • Mobile Clients - helps mobile phones to control HL7Connect (or just use a browser)
  • HL7 v2 schemas - for use in validation, and for reference (refer issues to HL7!)
  • LOINC - LOINC codes and definitions in the knowledge base
  • MySQL - MySQL Community Server 5.5.27 - on port 9557

Which parts are installed depends on the options selected when the installer runs.

:.   What now?

What now?
A triangle Trial download FAQ's
A triangle Download trial version
A triangle Return to top of page