Installing UNIFYBroker Connectors

Overview

Connectors are the components that allow transfer of data from UNIFYBroker to target applications. As these connectors are specific to the design of an installation, the administration of these components is covered in their own product guides. Connectors for UNIFYBroker written by UNIFY Solutions will be supplied with their own product guides.

The major and minor versions of a connector must match the major and minor versions of the UNIFYBroker instance it is being installed into. For example, a connector with version 5.3.0.0 is compatible with any UNIFYBroker installation where the Broker version starts with v5.3, however when Broker is upgraded to v5.4.x.x, the connector must also be upgraded. Failing to align service and connector versions will most likely result in an inoperable service.

Installing UNIFYBroker Connectors

Installation from the desktop

To begin installation, locate and run the UNIFYBroker for {Connector Name}.msi installation package from either Windows Explorer or through command prompt.

The title screen of the installation wizard will be shown.

Click Next to continue.

Read and accept the UNIFY Software Licence Agreement.

Select an installation directory for the connector. This should match the installation directory of the UNIFYBroker service. The default installation will be C:\Program Files\UNIFY Solutions\Identity Broker

Select the installation type. Standard installs all connector components, IIS installs only the web interface components. Click Next to continue.

Confirm the values specified for this installation. Click Install to commence installation.

A progress bar will appear showing the progress of the installation.

Wait for the installation to complete.

Click Finish to close the installation window.

The connector has now been installed.

Unattended installation

An unattended installation may be performed by using the msiexec.exe command and supplying the installer package as the parameter:

msiexec.exe "UNIFYBroker for {Connector Name}.msi" ADDLOCAL=Service,Web

The ADDLOCAL parameter takes a comma-separated list of the desired components to install, which can be any of Service, Web or IIS_Web.

Confirming Installation

You can confirm successful installation of the connector by finding it in the list of installed programs.

You can also confirm successful installation of the connector by finding its plugin entry on the About page of the UNIFYBroker website.

Uninstalling connectors

Connectors can be uninstalled by selecting the component from the Programs control panel and choosing to remove it. Select the component in the list and click Uninstall. Alternatively, run the installer MSI again and select the Remove option.