Versions Compared

Key

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

Please note that any existing Program Files (x86)\ConnexionV14\Connexion.AdvancedServices must be removed prior to installing the sprint 2 release. Any existing CXN_AdvancedServices database will also need to be manually deleted.

 

Provision Connexion

Provisioning of the Integrator network requires the following steps:

  1. Download Connexion (Developer Build) in the datacenter environment.
  2. 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.
  3. Copy the Hub database script files into the Program Files (x86)\ConnexionV14\Connexion.AdvancedServices folder. If this folder does not exist, create it.
  4. Continue running the install wizard. An 'Advanced Services' configuration page should appear as one of the tabs. 

  5. Continue the configuration process by stepping through the configuration wizard.
  6. 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
iconfalse

Video 1: Installing in the Datacenter (Shown in this video is the editing the .config file. This is no longer required. The dialog shown in (4) replaces the need to edit this file.)

Anchor
ExternalEndpoint
ExternalEndpoint

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

You now have all of the data center components installed and are ready to start provisioning remote customers. There is a well-defined workflow for provisioning a remote agent:

  1. 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.
  2. 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.
  3. Have the client run the installer, using the password you specified in step 1.
  4. Authorize the newly established connection from within the Remote Agent Management UI.

...

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
iconfalse

Video 2: Provision a remote agent

Installing the Remote Agent

You must provide 3 things to the customer:

  1. Remote Agent Installer
  2. Registration File
  3. Password

...

The remote agent (customer site) has now been successfully installed.

Info
iconfalse

Video 3: Installation of the Integrator Service (remote site)

Authorizing a Remote Agent

...

 Do not use the regular queue device for Integrator channels - use the 'Mongo Queue Device'.

Managing Remote Agent Channels

The Management UI does not let you create or edit channels. Channels must be created in the main Connexion UI and exported to a channel file. Since it is a cumbersome process to be switching into the Connexion UI to perform any channel edits, be as thorough as possible when initially creating the channel.

...

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
iconfalse

Video 4: Create and push channels to the Integrator

Creating Routes

In order to transfer data to/from the Remote Agent, we have created two new devices:

...

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
iconfalse

Video 5: Configure message transfer to/from Integrator