Upgrading the Microsoft Exchange Connector

7 Upgrading the Microsoft Exchange Connector

If you have already deployed an earlier release of this connector, then upgrade the connector to the current release.

The following sections discuss the procedure to upgrade the connector:

Note:

Before you perform the upgrade procedure:

It is strongly recommended that you create a backup of the Oracle Identity Manager database. Refer to the database documentation for information about creating a backup.
Upgrade the Microsoft Active Directory connector.
As a best practice, first perform the upgrade procedure in a test environment.

7.1 Preupgrade Steps

Preupgrade involves performing certain procedures such as performing a reconciliation run to fetch all the latest updates to Oracle Identity Manager and then disabling the scheduled tasks, defining the source connector and so on.

Perform the following preupgrade steps:

Perform a reconciliation run to fetch all latest updates to Oracle Identity Manager.
Perform the preupgrade procedure documented in Managing Connector Lifecycle of Oracle Fusion Middleware Administering Oracle Identity Manager.
Define the source connector (an earlier release of the connector that must be upgraded) in Oracle Identity Manager. You define the source connector to update the Deployment Manager XML file with all customization changes made to the connector. See Managing Connector Lifecycle in Oracle Fusion Middleware Administering Oracle Identity Manager for more information.

7.2 Upgrade Steps

This is a summary of the procedure to upgrade the connector for both staging and production environments.

Depending on the environment in which you are upgrading the connector, perform one of the following steps:

Staging Environment

Perform the upgrade procedure by using the wizard mode.
Production Environment

Perform the upgrade procedure by using the silent mode.

See Managing Connector Lifecycle in Oracle Fusion Middleware Administering Oracle Identity Manager for detailed information about the wizard and silent modes.

7.3 Postupgrade Steps

Postupgrade involves copying connector code files, configuring the IT resource and scheduled tasks, running the FVC utility and so on.

Perform the following procedure:

Perform the postupgrade procedure documented in Managing Connector Lifecycle of Oracle Fusion Middleware Administering Oracle Identity Manager.
If you are using Oracle Identity Manager release 11.1.2.x or later, then all changes made to the Form Designer of the Design Console must be done in a new UI form as follows:
1. Log in to Oracle Identity System Administration.
2. Create and activate a sandbox.
3. Create a new UI form to view the upgraded fields.
4. Associate the newly created UI form with the application instance of your target system. To do so, open the existing application instance for your resource, from the Form field, select the form (created in Step 2.c), and then save the application instance.
5. Publish the sandbox.
Run the Form Version Control (FVC) utility to manage data changes on a form after an upgrade operation. To do so:
1. In a text editor, open the fvc.properties file located in the OIM_DC_HOME directory and include the following entries:
```
ResourceObject;Exchange User
FormName;UD_MSEXCHG
FromVersion;v1
ToVersion;v_11.1.1.6.0
Parent;UD_MSEXCHG_RECIPIENTTYPE;UserMailbox
ParentParent;UD_MSEXCHG_EXCHANGEITRESOURCE;UD_MSEXCHG_SERVER
```
2. Run the FVC utility. This utility is copied into the following directory when you install the design console:
  
  For Microsoft Windows:
  
  OIM_DC_HOME/fvcutil.bat
  
  For UNIX:
  
  OIM_DC_HOME/fvcutil.sh
  
  When you run this utility, you are prompted to enter the login credentials of the Oracle Identity Manager administrator, and the logger level and log file location.
Update the Connector Server bundle DLLs as described in Copying and Extracting the Connector Bundle to the Connector Server.
Re-configure the IT resource of the source connector (an earlier release of the connector that must be upgraded).