During installation, the Configuration Wizard will be displayed. The configuration wizard requires you to input license information, service and database accounts, and network settings critical to the Connexion service. The Configuration wizard is installed as a separate application which can be run to re-configure Connexion after installation has completed.

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

Database Installation Credentials

Enter the target SQL Server instance name or address and windows or SQL Server credentials which have SysAdmin privileges in the target SQL Server instance. These credentials will only be used to install the Connexion database and add the default Connexion user (if required).

Service Credentials

Choose the account which the Connexion service will be run under. We recommend using the default option (__cxn_usr__ account) as this account has limited privileges and is therefore more secure than the Local System account. For operations which require elevated permissions, the Connexion service can impersonate other user accounts.

Database Credentials

Choose the account which the Connexion service will use to connect to the Connexion database during normal operation. By default, the service credentials specified in the previous step will be used.

Options

Update the port used for communications between the service and the UI, set the change tracking behavior, and specify which users and/or groups will be allowed to connect to the service using the UI.

Clicking the next button will display a summary of configuration tasks to be performed:

Clicking the next button will run each configuration task, displaying a summary of any warnings or errors. If the configuration wizard was launched by the installer, then clicking next will return control to the installer, otherwise clicking next will exit the configuration application.

Initial Startup

Connecting to the service

After installation, launch the user interface via the desktop icon  or start menu (or it will be launched automatically by the  installer). The UI will attempt to connect to the Connexion  integration engine on the port specified during configuration. If the connection is successful, it should appears as follows:

If you are unable to establish a connection, install the client on the same machine as the service and confirm that the service is running. If you are unable to connect the client to the service (on the same machine), please contact Inner Harbor Software for support. If you are connecting to the service from a different machine, you may be asked for credentials:

Ensure that the domain field is populated with either the target machine's domain, or the target machine NETBIOS name.

Configure Email Settings

We recommend that you click the 'Administrator Email Settings Missing' link which will take you to the settings screen. Errors and important notifications will be sent to the email addresses you specify.

Connexion Database Backup Settings

We also recommend that you click the 'Database Backup Not Configured' link to configure the database backup settings. The database backup is important because it includes maintenance routines which help keep Connexion running efficiently. You will need to enter user credentials  will sufficient privileges to write the backup to the hard drive.

Application Overview

The Connexion UI is organized/grouped as follows:

• Server: Represents an instance of the Connexion service at a specific Uri (host and port). Multiple servers can be displayed within the user interface.
• Channel Group: Represents an arbitrary grouping of channels. Channels can be members one or more groups.
• Channel: Represents a collection of devices which together create a workflow.
• Device: Represents a specific task or unit of work. For example, an HL7 Reader device reads and HL7 stream, a File Writer device writes to the file system...
  
  

The 'Server Bar' is divided into the following areas:

• Server Channel: A channel which contains specific devices pertaining to a service instance: Documentation, Settings, Event Logging, Database Backup, and Channel Change Tracking.
• Server Statistics: An aggregate of all channel statistics contained within this server.
• Server Operations: Server-level operations, such adding/importing a channel, exporting channels, connection settings etc.

More server-level and system-wide operations are exposed by right-clicking on the server bar.

Channel grouping operations are accessed by right-clicking the tab name:

And channel-level operations are accessed both via the channel bar and by right-clicking the channel bar. Right-clicking a device will display the device context menu.: