The HL7Connect Service Component includes the actual HL7Connect Service, along with supporting documentation and a Database and Service Management Utility. The HL7Connect Service can be installed on a cluster - see note #10 below.

The HL7Connect Development Environment is a suite of tools to assist an interface developer or analyst. It allows you to collect, browse and validate HL7 messages and CDA documents, and to develop scripts for HL7Connect.

You can install either component, or both. Although there is no direct dependence between the packages, the Development Environment will require access to an HL7Connect database when run and some functionality requires an HL7Connect service to be available. The database, and the HL7Connect Service Components that maintain it, can be located on different systems.

In addition, this package includes a mobile device client component. This package includes programs that can be installed on your mobile phone to monitor and control HL7Connect from anywhere as long as you have access to the HL7Connect web interface. The following mobile phone clients are included:

· Dot Net (use on any phone with mobile dot net installed)

· iPhone (*** not yet released ***)

From the mobile phone client, you can do the following things:

· view the status of interfaces

· start and stop interfaces

· enable users and fix their passwords

2. Known Issues with Data Execution Prevention

The Scripting and Web services implementations used in HL7Connect generate dynamic machine code. This technique causes "data" to be executed, which is disallowed by Windows Data Execution Prevention.

If DEP applies to HL7Connect, then any use of web services will cause an access violation, and any use of scripting will fail with an unpredictable error.

Because of this, the installation program will register HL7Connect in the DEP exception list. A restart will be required to make this addition to the list effective, but the installation program will not prompt a restart at the end of the installation.

The DEP exception list is ignored if the system DEP policy is "Always on". The installation program will not check or change the System DEP policy - the system administrator will need to change this manually

3. System Requirements

a. HL7Connect Certificate

During the installation you will require an HL7Connect Certificate. You can a get 30 day limited licence (evaluation) Certificate or you can purchase a full licence from http://www.hl7connect.com. At the end of the 30 day trial period HL7Connect will cease to function until a Full Licence Certificate is purchased.

b. HL7Connect Service

Installing the HL7Connect Service will require the following resources:

1. Windows XP/Vista/7/Server 2003/Server 2008 (32 or 64 bit)

2. Administrator Access to the System

3. A database server. See below for further information

4. Microsoft Script Engine (see below)

5. MSXML v4+ is required for schema validation (see below)

Interacting with the HL7Connect service requires a web browser. This browser does not need to be installed on the same computer as the service.

HL7Connect generally acts as a TCP server. If your windows system has a firewall (most do), you will have to add exemptions for any active ports (including the web and/or telnet servers built into HL7Connect) you wish to use across the network - or you can let the install For some features (i.e. OID lookup), the HL7Connect service requires http access to the internet. If this access is not available, the service will still run, but these specific operations will fail. This web access does not use wininet, does not cache files or run scripts, and offers no other features capable of creating security holes.

c. HL7Connect Development Environment

1. Microsoft Script Engine (see below)

2. MSXML v4+ is required for schema validation (see below)

The HL7Connect Development Environment will require read-only access to an HL7Connect database when it runs.

d. Hardware Requirements

The hardware requirements for HL7Connect will vary greatly depending on the throughput of messages, and the interface configuration. Disk storage depends on how many messages are received, and how long messages are stored in the database.

The minimum requirements for a small installation of HL7Connect, with few interfaces and low message traffic would be 512MB of RAM. As the scale on which HL7Connect is being used increases, correspondingly so do it's hardware requirements. If HL7Connect is being installed as an Enterprise HL7 Interface Engine, then the system should include the following specifications:

· 500MHz + cpu (at least two cpu's or dual core)

· at least 2 GB RAM

There are a variety of factors which may influence how much hardware you may require. For example:

· Expected message throughput? The busier HL7Connect is, the more resources will be used

· Number of interfaces

· Will you be doing much scripting? If so, how complex are the scripts?

· Does the database backend reside on the same server as HL7Connect or a separate server? If it's on the same server, then that will use its own resources too which needs to be considered.

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.

4. HL7 Software

HL7Connect requires a source of HL7 v2 message definitions ("The HL7 Dictionary" in order to function. By default, HL7Connect is based on the definitions as found in the HL7 Access Database.

If you want to replace these definitions with your own definitions (for instance, to introduce support for specific country localizations of HL7), you must purchase a copy of the access database directly from HL7 Inc. (http://www.hl7.org), make your modifications, and then configure HL7Connect to use that modified database. Note that since HL7Connect automatically supports unexpected messages, segments, fields, repeats, etc, such a modified dictionary is only useful for validation, or if scripts need to refer to modified definitions.

This installation package also installs the HL7 v2 schemas for use in validation, and for reference. These are the schemas as published by HL7. Issues with the content of the schemas should be referred to HL7.

5. Supported RDBMS platforms

HL7Connect requires a database of its own. Currently, the following RDBMS Systems are supported as:

· Microsoft SQL Server v7,0, 2005, and 2008

· MySQL v5.1

There are no plans to add other database support at this time. Most databases - including all that have ODBC support - can be used from scripts.

Specific Platform Notes:

· Microsoft SQLServer
You must install the 2008 sql server driver in order to use MS SQLServer 2008 - you cannot use the 2005 drivers.
HL7Connect can be configured to use Windows Authentication with Microsoft SQL Server. You need to pay attention to what account the service runs under if you set it up like this, and ensure that this account has access to the appropriate database. The installation program will always configure the service to run under the system default service account; you can change this through the Windows Services Applet.

· MySQL
Only version 5.1 is supported at this time. You can use the Community or Enterprise Edition.
We recommend the choice of "Multifunctional Database" mode and "Online Transaction Processing (OLTP)".

Note that the HL7Connect database can grow rapidly when storing CDA documents and HL7 messages. When the messages store gets over 4 million records or so, performance starts to deteriorate quickly. This can be resolved by deleting or archiving messages. The impact of the total database size on backup and server load during backup also needs to be monitored. Note that archiving messages does not decrease the overall size of the database. 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.

6. Database Access & Permission Requirements

HL7Connect will require access to the database both during installation and whenever the software is running. All three software components (HL7Connect, the HL7Connect Manager, and the Development Environment) require database access. A database must be created by the administrator prior to installing HL7Connect using the appropriate tools for either Microsoft SQL Server or MySQL.

When you connect to the database, you must provide a username and password that HL7Connect will use during normal operation. This account must provide select/insert/update/delete access to the HL7Connect database. dbo/sa/administrator type access is not required for this account. This password will be stored encrypted in the HL7Connect Configuration files.

During the installation, HL7Connect will connect to the specified database and create the required tables and indexes. During installation, a different username and password may be supplied. If none is supplied, the normal account described above will be used. The account used for installation must have administrator access, with DBO alias. The alternative account, if provided, is not stored by HL7Connect.

Although the database should be entirely for the use of HL7Connect, HL7Connect can share databases with other applications. All HL7Connect table names begin with the character sequence "gw..", "kk.." or "lex.."

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).

7. Web Browser Requirements

Interacting with HL7Connect requires a Web Browser with full HTML 4 & DOM support.The following browsers have been tested and are believed to work:

· Microsoft Internet Explorer v4.0+

· Browsers based on Mozilla/5.0 with Gecko/20031007+ such as Firefox

· Browsers based on WebKit, inluding Chrome and Safari (including on iPhone)

8. Microsoft Script Engine

The scripting engine used in HL7Connect requires the Microsoft Scripting Engine to be installed. This is usually installed on most Windows systems.

If it is not installed, HL7Connect will still run, but any attempt to run scripts will fail. You can download and install the Microsoft Script Engine from http://msdn.microsoft.com/scripting

NOTE: 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: http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=c717d943-7e4b-4622-86eb-95a22b832caa

9. Microsoft XML Core Services

HL7Connect uses the Microsoft Core XML Services for XML Schema validation. If you use XML schema validation then you will require MSXML v4. If it is not installed, HL7Connect will still run, but any attempt to use CDA documents, transforms, or schema validation will fail. You can download and install the Microsoft Core XML Services from http://msdn.microsoft.com/xml

Note: most computers have MSXML 4+ installed.

10. Windows Cluster Support

a. Requirements

HL7Connect can be installed on a Windows 2008 cluster. Before installing HL7Connect, ensure that the cluster is fully installed and set up, and set up the database that HL7Connect will use. HL7Connect can use a database server either on the same cluster, or another server somewhere else that may also be (would usually be) a cluster.

In addition to the database, HL7Connect requires a cluster storage. This storage is used for

· configuration information

· LOINC and Snomed-CT caches

· log files

· Temporary storage for file processing

· script storage

In HL7Connect, the location of logs and scripts is configurable; on a cluster, you must choose to store these on the cluster storage assigned to HL7Connect when you are configuring it.

The base storage requirement - excluding logs and file processing requirements - is around 150MB. The overall size depends on configuration, how many log files and what their sizes are, and how many file interfaces, and how much information flows through them. Given the cost of setting up a cluster, and the importance of keeping HL7Connect running, we recommend allocating at least 1GB more than the highest expected requirement.

b. Installing HL7Connect

HL7Connect must be installed on each node in the cluster. The first install is special: this "initial install" is responsible for creating or upgrading the HL7Connect database and populating the HL7Connect storage. All the following installs simply install the program files to each node and configure HL7Connect to use the cluster storage. You must select the initial task in the installer ("Perform Initial Cluster Install" on the tasks page), or only a add-node install will be performed.

Note: if the task "Perform Initial Cluster Install" does not appear on the tasks page even though you are installing on a cluster, please consult HL7Connect.com support.

The HL7Connect Storage must be on-line on the node where the install is happening for the initial install. For the add-node installs, the storage does not need to be on-line. As additional nodes are added to the cluster, HL7Connect must be installed on the node.

During the install, HL7Connect will create a cluster application definition for HL7Connect. This may fail for reasons related to network configuration. If it does, creating the HL7Connect application definition is very straight forward. It is a Generic Service with the following properties:

· The service "HL7Connect"

· The storage selected during the install

· a virtual name and address.

The installation program will not bring HL7Connect on line at the end of the install. The cluster administrator will need to at least configure the details of the ip address assigned to HL7Connect.

If you are installing HL7Connect to run on the same Cluster as Microsoft SQL Server:
The installation configures the HL7Connect service to run under the default account. On Windows Server, this is "Local System" or some equivalent. This local system account will be able to login to the SQL Server databases when both HL7Connect and SQLServer are running on the same node, but not when they are on different nodes (assuming SQL Server is configured Active/Passive). If you want to be able to run HL7Connect in a different node to SQLServer on the cluster, you will either need to configure SQLServer to used mixed-mode authentication, and give HL7Connect a native SQL Server login when configuring the database connection, or configure the service to run under a different account using the Windows Services Applet.

c. Uninstalling HL7Connect

Because of the way the installation process works, the node from which the first install was done must be the last to be uninstalled, as it will remove the contents of the HL7Connect storage. If you need to uninstall HL7Connect from this node before removing it from the cluster, do the uninstall while the storage is off-line.

d. Development Environment

The Development Environment is cluster aware - you can only use it on the node that is active for HL7Connect. Be sure to store any files you work with on the HL7Connect storage to avoid confusing the Development Environment as it moves between nodes.

e. Fail Over Notes

HL7Connect starts and stops fairly quickly - generally within a few seconds. SQL Server tends to do so a whole lot slower. If a node fails, and both SQL Server and HL7Connect are transferred to a backup node, HL7Connect must wait for the database. The standard approach to handling this - with service dependencies - isn't applicable. And cluster dependencies have additional side effects that means that these mightn't be an appropriate solution to this problem. As a consequence, when the HL7Connect service is starting on a cluster, it will wait up to 90seconds for a database to be available, instead of 30 seconds like normal. Consult the HL7Connect log too see why start up is slow.