| Video 1: Installing in the Datacenter |
| Video 2: Provision a remote agent |
| Video 3: Installation of the Integrator Service (remote site) |
| Video 4: Manage remote agents, add and edit channels, create routes. Create and push channels to the Integrator |
| Video 5: Configure message transfer to/from Integrator |
| Info |
|---|
Please note that any existing Program Files (x86)\ConnexionV14\Connexion.AdvanceServices AdvancedServices must be removed prior to installing the sprint 2 release. Any existing CXN_AdvancedServices database will also need to be manually deleted. |
...
- Download Connexion (Developer Build) in the datacenter environment.
- Run the installer, but do not yet run through the configuration wizard. The installer will deploy the files to the Program Files (x86)\ConnexionV14 folder.
- Copy the Hub database script files into the Program Files (x86)\ConnexionV14\Connexion.AdvanceServices AdvancedServices folder. If this folder does not exist, create it.
- Open the connexion.exe.config file in the Program Files (x86)\ConnexionV14 directory and set the Hub to enabled.
If your database server for Connexion is not local, it is probably the case that your CXN_AdvancedServices database is also not local. If so, you will need to edit the connexion.exe.config file and update the database connection string for the CXN_AdvancedServices database.
The portion of the string that needs to change is
If you are using Sql Server authentication, and connecting to a machine named "dbserver1", with user "sa", and password "mypassword", the connection string would look like this:
If you are using LocalDB, set the above connection string to:Code Block language css <add name="AdvancedServiceContext" connectionString="metadata=res://Connexion.Integrator.Hub/Model.csdl|res://*/Model.ssdl|res://Connexion.Integrator.Hub/Model.msl;provider=System.Data.SqlClient;provider connection string="data source=(localdb)\.\ConnexionV14;initial catalog=CXN_AdvancedServices;integrated security=True;MultipleActiveResultSets=True;App=EntityFramework"" providerName="System.Data.EntityClient" />
NOTE: If you are unfamiliar with database connection strings, please seek help from your IT staff.
- Continue the configuration process by stepping through the configuration wizard.
- Add a link to the Integrator Management UI by right clicking on the Program Files (x86)\ConnexionV14\Connexion.Integrator.Management.Ui.exe and choosing Send To > Desktop.
| Info | ||
|---|---|---|
| ||
Video 1: Installing in the Datacenter |
| Anchor | ||||
|---|---|---|---|---|
|
...
External Endpoint
When testing on the same network, you can ignore this step.
...
Open the Management UI and click the edit hubs button. Update the host and port, and click save.
Provision a Remote Agent
...
- Create a registration file unique for the customer we're going to provision. You will be prompted to save a registration file as well as provide a password.
- Securely send that registration file and the Remote Agent Installer to the client, and have them place both files into a new folder on their PC.
- Have the client run the installer, using the password you specified in step 1.
- Authorize the newly established connection from within the Remote Agent Management UI.
...
Open the Management Ui and select the "Pending Remote Agents" tab.
Now click the "Provision New Remote Agent" button.
The "Add/Edit Remote Agent" dialog will be displayed. Enter the name of the customer (Site Name). You can optionally add keywords (which are searchable), notes, and contact details.
Click "Save". A save file dialog will appear prompting for a location to save the registration file created for this customer. Choose any convenient location and continue. A password dialog will be displayed. You should enter a reasonable strong password here (for production), but since the customer will need this password to install the Remote Agent, you must remember it.
We now have a row in our pending table. Notice the 'Status' shows 'Awaiting Connection'. The hub is now waiting for a remote agent with a specific signature to connect. The signature is contained within the registration file we just created. Let's install the Remote Agent software and connect to the hub.
| Info | ||
|---|---|---|
| ||
Video 2: Provision a remote agent |
Installing the Remote Agent
You must provide 3 things to the customer:
- Remote Agent Installer
- Registration File
- Password
...
Once the client has all three items (preferably with the installer and registration file in the same folder), launch the installer.
Accept the EULA and click Next.
If the path to the registration file is not already filled in, add it. Enter the password you used to create the registration file. Once the correct password has been entered, the 'Registration Info' field should display the site name (customer name) and the public URL of the hub.
Click the 'Install' button to start installing the Remote Agent components. If the .NET 4.5 framework isn't installed, then it can take several minutes for it to be downloaded and installed prior to the progress bar moving. Once the install is complete close the installer via the 'Close' button.
To verify that all the required Remote Agent components were installed, open the task manager, select the Services tab, and ensure the following are present:
The remote agent (customer site) has now been successfully installed.
| Info | ||
|---|---|---|
| ||
Video 3: Installation of the Integrator Service (remote site) |
Authorizing a Remote Agent
...
Open the management UI, select the 'Pending Remote Agents' tab, and find the entry corresponding to the given customer.
Notice the status has changed from 'Awaiting Connection' to 'Awaiting Authorization'. The 'Source', 'IP Lookup' (if coming from an external network), 'Last Register', 'Time Zone', and 'Machine Name' fields should all be filled. If this information shows expected values, you can authorize this Remote Agent. Authorization will record the signature of that remote agent, and that signature will be used to authenticate all future connections / method calls.
...
The current row will be remove from the 'Pending Remote Agents' tab and will now appear in the 'Remote Agents' tab. All remote agents displayed in the 'Remote Agents' tab are authorized.
Notice our customer connection state is 'Connected', and the Hub displays the endpoint that this Remote Agent is connecting through. Congratulations you have now installed all the components to create a Connexion network, and established an authorized connection between both endpoints.
Devices
Please note that not all devices are supported on the remote agent - specifically the Branch and Queue devices. We have developed a special queue device for Integrator channels.
In order to create integrator channels with queueing functionality, you will need to import our "Mongo Queue Device" via the Connexion repository. In the Connexion V14 UI, open the device repository and use the following steps to import the Integrator queue:
- Open the repository screen
- Select the Devices tab and then click the 'Show All Package Versions' button
- Select the 'Connexion.Queue.Mongo' package and click install, the click OK on the import summary screen.
You should now have three devices in the 'Remote Integrator' category:
Do not use the regular queue device for Integrator channels - use the 'Mongo Queue Device'.
Managing Remote Agent Channels
...
Please note that not all devices are supported by the Integrator. You cannot use use the Branch device or standard Queue device. Please use the Mongo Queue Device located in the Remote Integrator category (when creating your channel in Connexion).
Once you have created the channel file, switch to the Remote Agent Manager and click the add channel button. Point to the channel file you created from the Connexion UI and click open.
<INSERT>
The following channel operations are supported:
- Start (click the start button)
- Stop (click the stop button)
- Replace(overwrites the existing channel)
- Export (export the channel to a file and the import it into ConnexionV14).
- Delete
- View (double click on the device icon)
You can double click on a device icon to view its configuration:
Unofficially, you can edit this configuration and then use the 'ctrl + s' keystroke or the save button on the channel to commit your changes. This functionality is currently being evaluated.
| Info | ||
|---|---|---|
| ||
Creating Routes
In order to transfer data to/from the Remote Agent, we have created two new devices:
...
These devices are listed in the Remote Agent category when building / editing channels in Connexion. These devices need to be deployed in pairs - ie - when sending data from the Remote Agent to Connexion, the Remote Agent channel will use a Remote Agent Outbound Connector device at the end of a channel, and the receiving channel (in Connexion) will start with a Remote Agent Inbound Connector device.
From the Remote Agent:
To Connexion:
In the above example, the Remote Agent will be receiving HL7 from one of the customer's systems, pushing the HL7 through a transform device, and then to Connexion via the Remote Agent Outbound Connector Device. Notice the 'To Connexion' box at the end of the channel which isn't set yet.
...
Simpy having both Outbound and Inbound devices is not enough to transfer data between channels. We must also specify a route, to tell the system which channels should be paired. This is done by choosing the target channel name in the 'To Connexion' box at he end of the channel. If you don't see the target channel listed, click the refresh button in the top-right corner of the 'To Connexion' box.
We have now successfully created a route which will forward data from 'Some Channel' on the Remote Agent to the 'From Remote Agent' channel in Connexion.
To reverse the flow and send messages from Connexion to the Remote Agent, we simply invert the location of the Inbound and Outbound devices.
From Connexion:
To the Remote Agent:
Notice the route box now appears at the beginning of the channel, and instead of specifying which channel you are sending to (in Connexion), you specify which channel you are receiving from (in Connexion).
| Info | ||
|---|---|---|
| ||
Video 4: Manage remote agents, add and edit channels, create routes.5: Configure message transfer to/from Integrator |