2 Deploying the Connector

Deploying the connector involves the following steps:

• Step 1: Verifying Deployment Requirements

• Step 2: Configuring the Target System

• Step 3: Copying the Connector Files

• Step 4: Importing the Connector XML Files

• Step 5: Configuring Reconciliation

• Step 6: Compiling Adapters

Step 1: Verifying Deployment Requirements

The following table lists the deployment requirements for the connector.

Item	Requirement
Oracle Identity Manager	Oracle Identity Manager release 8.5.3 or later
Target systems	Microsoft Exchange 2000 and 2003
Target system host platforms	Microsoft Windows Server 2000 or 2003
Other systems	Microsoft Active Directory

Note:

You must deploy the Microsoft Active Directory connector before you can deploy and use the Microsoft Exchange connector.

Refer to Oracle Identity Manager Connector Guide for Microsoft Active Directory for instructions to deploy the Microsoft Active Directory connector.

Step 2: Configuring the Target System

For using this connector, you do not need to perform any configuration steps on the target system.

Step 3: Copying the Connector Files

The connector files to be copied and the directories to which you must copy them are given in the following table.

Note:

The directory paths given in the first column of this table correspond to the location of the connector files in the following ZIP file on the installation media:

Collaboration and Messaging Applications\Microsoft Exchange\Microsoft Exchange Rev 3.3.0.zip

Refer to "Files and Directories That Comprise the Connector" for more information about these files.

File in the Installation Media Directory	Destination Directory
The following files in the xml directory: xliExchangeObject.xml xliExchangeSchedulerTask.xml	xellerate_home\xellerate \XLIntegrations\Exchange\xml\
lib\xliExchange.jar	xellerate_home\xellerate\JavaTasks xellerate_home\xellerate\ScheduleTask
The following contents of the docs directory: B31120_01.pdf html	xellerate_home\xellerate\XLIntegrations\Exchange\docs

Step 4: Importing the Connector XML Files

To import the connector XML files into Oracle Identity Manager:

1. Open the Oracle Identity Manager Administrative and User Console.

2. Click the Deployment Management link on the left navigation bar.

3. Click the Import link under Deployment Management. A dialog box for locating files is displayed.

4. Locate and open the xliExchangeObject.xml file, which is in the xellerate_home\xellerate\XLIntegrations\Exchange\xml directory. Details of this XML file are shown on the File Preview page.

5. Click Add File. The Substitutions page is displayed.

6. Click Next. The Confirmation page is displayed.

7. Click Next. The Provide IT Resource Instance Data page for the Exchange Server - Dev IT resource is displayed.

8. Specify values for the parameters of the Exchange Server - Dev IT resource. Refer to the table in the "Defining IT Resources" section for information about the values to be specified.

9. Click Next. The Provide IT Resource Instance Data page for a new instance of the Exchange Server - Dev IT resource type is displayed.

10. Click Skip to specify that you do not want to define another IT resource. The Confirmation page is displayed.

    See Also:

    If you want to define another IT resource, then refer to Oracle Identity Manager Tools Reference Guide for instructions.

11. Click View Selections.

    The contents of the XML file are displayed on the Import page. You may see a cross-shaped icon along with some nodes. You must remove these nodes. To do this, right-click each such node and then select Remove.

12. Click Import. The connector XML file is imported into Oracle Identity Manager.

13. Perform the same procedure to import the xliExchangeSchedulerTask.xml file, which is in the xellerate_home\xellerate\XLIntegrations\Exchange\xml directory.

After you import the connector XML file, proceed to the "Defining IT Resources" section.

Defining IT Resources

You must specify values for the Exchange Server - Dev IT resource parameters listed in the following table.

Parameter Name	Parameter Description
Server Name	Host name of the Microsoft Windows computer on which Microsoft Exchange 2000 and 2003 is installed Sample value: W2K_HOST Note: The value must be specified in uppercase.
Store Name	Mailbox store name Sample value: Mailbox Store (OWX-INT-2K3) Here, OWX-INT-2K3 is the host name of the Microsoft Exchange 2000 and 2003 Server.
Last Modified Time Stamp	Time at which the last reconciliation run was completed This is in the timestamp format YYYYMMDDHHMMSSZ. At the end of each reconciliation run, the value is updated with the target system timestamp at that instance. Sample value: 19721001000000Z The initial value must be 0.

After you specify values for these IT resource parameters, go to Step 9 of the procedure to import connector XML files.

Step 5: Configuring Reconciliation

Configuring reconciliation involves creating the reconciliation scheduled task. To create this scheduled task:

1. Open the Oracle Identity Manager Design Console.

2. Expand the Xellerate Administration folder.

3. Select Task Scheduler.

4. Click Find. The details of the predefined scheduled task are displayed.

5. Enter a number in the Max Retries field. This number represents the number of times Oracle Identity Manager should attempt to complete the task before assigning the ERROR status to the task.

6. Ensure that the Disabled and Stop Execution check boxes are cleared.

7. In the Start region, double-click the Start Time field. From the date-time editor that is displayed, select the date and time at which you want the task to run.

8. In the Interval region, set the following schedule parameters:

   • To set the task to run on a recurring basis, select the Daily, Weekly, Recurring Intervals, Monthly, or Yearly option.

     If you select the Recurring Intervals option, then you must also specify the time interval at which you want the task to run on a recurring basis.

   • To set the task to run only once, select the Once option.

9. Provide values for the attributes of the scheduled task. Refer to the appropriate table in the "Specifying Values for the Scheduled Task Attributes"section for information about the values to be specified.

   See Also:

   Oracle Identity Manager Design Console Guide for information about adding and removing task attributes

10. Click Save. The scheduled task is created. The INACTIVE status is displayed in the Status field, because the task is not currently running. The task is run at the date and time that you set in Step 7.

After you create the scheduled task, proceed to the "Step 6: Compiling Adapters" section.

Specifying Values for the Scheduled Task Attributes

You must specify values for the following attributes of the reconciliation scheduled task.

Note:

Attribute values are predefined in the connector XML file that you import. Specify values only for those attributes that you want to change.

Attribute Name	Description	Default/Sample Value
ADServer	Name of the Microsoft Active Directory IT resource	Active Directory Server - Dev
Server	Name of the Microsoft Exchange 2000 and 2003 IT resource	Exchange Server - Dev

After you specify values for these scheduled task attributes, go to Step 10 of the procedure to create scheduled tasks.

Step 6: Compiling Adapters

The following adapters are imported into Oracle Identity Manager when you import the connector XML file. You must compile these adapters before you can use them to provision accounts on the target system.

• check user process ordered

• Exchange Delete Mailbox

• AD Set User Property

• Set Time Stamp

• Get Value Form User Process

• Chk Value Set

• Exchange Create Mailbox

• Exchange Set User Properties

• DB Prepopulate UserLogin

To compile adapters by using the Adapter Manager form:

1. Open the Adapter Manager form.

2. To compile all the adapters that you import into the current database, select the Compile All option.

   To compile multiple (but not all) adapters, select the adapters you want to compile. Then, select the Compile Selected option.

   Note:

   Click Compile Previously Failed to recompile only those adapters that were not compiled successfully. Such adapters do not have an OK compilation status.

3. Click Start. Oracle Identity Manager compiles the adapters that you specify.

To view detailed information about an adapter:

1. Highlight the adapter in the Adapter Manager form.

2. Double-click the row header of the adapter, or right-click the adapter.

3. Select Launch Adapter from the shortcut menu that is displayed. Details of the adapter are displayed.

Note:

To compile multiple adapters simultaneously, use the Adapter Manager form. To compile one adapter at a time, use the Adapter Factory form. Refer to Oracle Identity Manager Tools Reference Guide for information about how to use these forms.