Versions Compared

Version Old Version 5 New Version Current
Changes made by

Nick Judson (Unlicensed)

Nick Judson

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Software

Connexion will run on any Windows platform which supports the .NET 4.0 framework and SQL Server 2008 with Advanced Services. Typically this means Windows XP and above and Windows 2003 and above.

Note

...

SQL Server does not need to be installed on the same machine as Connexion.

Hardware - Summary

Connexion has no minimum hardware check during installation, and does not require heavy-weight hardware to give adequate performance. We generally recommend a quad-core cpu, 4 gigabytes of memory, and 30 gigabytes of free space as adequate for simpler systems. If you require high-performance, many channels, complex channels, or will be processing large messages (MB instead of KB) then read the 'Hardware - Advanced' section below or contact Inner Harbor Software for recommendations.

Hardware - Advanced

It is difficult to provide specific hardware recommendations in this document, as there are many variables to consider when sizing systems. If you need help specifying hardware, please contact Inner Harbor Software.

The following should be considered when sizing hardware for Connexion:

  • Number of Channels: Are you expecting to run 5 channels or 100? If you will be using the 'execution groups' feature of Connexion to isolate channels, an extra ~100 MB of memory will be required per group.
  • Channel Complexity: Are your channels performing simple operations like reading/writing HL7 and simple transformations, or are you performing heavy string manipulation or running complex database queries?
  • Message Composition: Are the messages you are processing 100K or 30MB? Memory requirements increase dramatically as message size increases.
  • Performance Expectations: What is the expected peak load? Do you have latency requirements?
  • Redundancy: Additional resources will be required if you are using one of SQL Server's fail-over features (mirroring, always on, etc.)

 

Image Removed

Licensing

The first tab of the configuration wizard is for adding license information. You will need to email the Hardware ID and Licensee to Inner Harbor Software who will reply with a License Key. Paste the license key into the 'License Key' box.

 

Once a valid license key is entered, proceed to the next stepBefore installing Connexion, please review the OS and software requirements. We strongly recommend you also review the hardware notes when sizing systems for production environments. 

Info

Prerequisites

We recommend installing the .NET framework 4.8 or higher before installing Connexion. We also recommend that you have an instance of SQL Server 2008R2 or 2012 available before installing Connexion.  Connexion does not require SQL Server to be installed on the same machine, however, this typically provides the best performance.

Downloads:

The latest release can be found here: Connexion v16 Releases

Connexion is packaged as a single executable file for 64-bit systems only.

Components: 

Connexion includes the following components:

  • Connexion Server (Windows Service): The core engine which hosts and runs all channels/workflows.

  • Connexion Client: The management application which allows for the creation and configuration of channels as well as administration of the Connexion server. It can be run on the same machine as the server, or on separate machines which have network connectivity with the server.

  • Configuration Wizard: A server-side configuration utility that modifies global server settings (management ports, accounts, etc).

  • System Tray Application (Server-side, Windows Application): A small utility which shows an icon in the system tray. This icon provides short-cuts to load the client and configuration wizard applications, as well as options to start, stop, and restart the Connexion Engine service.

Image Added

Step-by-step Installation:

Once the Connexion installation package has been downloaded to the server, launch the installer.

...

Set the destination folder, choose the components to be installed, and accept the EULA. Click 'Next.'

...

It is preferable to have .NET installed prior to installing Connexion, however, if you do not have installed, the Connexion setup will perform the upgrade as required.

Once .NET is finished installing, click 'Next.'

At this point, the Connexion setup will run the Configuration Wizard. This wizard will guide you through specifying the connection settings needed by the service/application.