Upgrading the Identity Broker Service

Overview

For an upgrade from a v3.0 installation, please see Upgrading from Identity Broker v3.0 below for additional details. Upgrades post-v4.0 are as simple as running the UNIFY Identity Broker.msi installer package.

Upgrading the Identity Broker Service

To begin installation, first ensure that all Identity Broker operations have finished and the service has been stopped.


ALERT: Back up the Identity Broker installation directory. Note that some files (for example Web.config) are not preserved.

Locate and run the UNIFY Identity Broker v5.2.msi installation package from Windows Explorer.

The title screen of the installation wizard will be shown.


Click Next to continue.

Read and accept the UNIFY Software License Agreement.


The v3.0 configuration directory step can be skipped for upgrades from an Identity Broker v4.0 installation and onwards. Please see Upgrading from Identity Broker v3.0 below for additional details for a v3.0 upgrade.


Configure database settings. The Attempt Upgrade option should be selected. If you wish to create manually upgrade the database, select the Manual Install option.


WARNING: In order to successfully upgrade an existing database, please ensure Microsoft DTC is correctly configured, as described in the Prerequisites.

Enter the credentials for the Windows account that the Service will run as.


CHECK: The chosen service account must have the Log on as service permission.

Select an installation directory for the Identity Broker Service. The default installation will be C:\Program Files\UNIFY Solutions\Identity Broker


Select an installation directory.

Confirm the values specified for this installation.


Confirm to begin the installation.

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


Wait for the installation to complete.

The installation has completed successfully.


Click Finish to close the installation window.

The Identity Broker service has now been upgraded.

WARNING: Each installed plugin may need upgrading. Please see the downloads sections for each of the respective products to check for the availability of updated versions.

Adding back modifications

As not all files are preserved during the upgrade (e.g. Web.config), any custom modifications that had been made to the file must be added back in from the backed up file.

Starting the Service

To start the service, first open the Services window from Administrative Tools. Alternatively, run services.msc from command prompt.

Open the Services page, and select Yes if prompted to continue.

Find the UNIFY Identity Broker service, and start it.


Start the UNIFY Identity Broker service.

Verifying Installation

To verify the installation, please see the Verifying Installation section of Installing the Identity Broker Service.

Upgrading from Identity Broker v3.0

An in place upgrade is not possible from v3.0 to v4.0. To begin, copy the Extensibility directory from the v3.0 installation directory to another folder. The default directory is C:\Program Files\UNIFY Solutions\Services\Extensibility\

WARNING: Make a copy of the configuration.

Next, the Identity Broker v3.0 service should be uninstalled. Please follow the steps on Uninstalling the Identity Broker Service. Uninstall all v3.0 plugins for Identity Broker, including Connectors. Follow the Upgrading the Identity Broker Service section above. However, select the directory containing the copied configuration from the v3.0 installation on the following screen:



Click the Browse button.

Navigate to the copied v3.0 configuration directory and click OK.

TIP: You may wish to take the opportunity to correct the columnMapping element such that the SourceColumn and TargetColumn are pointing to a base connector field and the target field respectively.

Continue with the rest of Upgrading the Identity Broker Service guide from the section above.

CHECK: Ensure that the configuration has upgraded correctly by checking the adapter schema, as well as the data on the import into the identity management platform.

Is this article helpful for you?