2 Deploying the Connector

Deploying the connector involves the following steps:

• Step 1. Verifying Deployment Requirements

• Step 2: Configuring the Target System

• Step 3: Configuring the Oracle Identity Manager Server

• Step 4: Copying the Connector Files

• Step 5: Importing the Connector XML Files

• Step 6: Configuring Reconciliation

• Step 7: 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 system	Microsoft Exchange 5.5
Target system host platforms	Microsoft Windows NT 4.0 Server or Microsoft Windows 2000 Server
Other applications	Microsoft Windows NT Service Pack 6 (If Exchange 5.5 Server uses a NT domain controller, this pack would be needed on the domain controller) Microsoft Exchange 5.5 Service Pack 4 (on the Microsoft Exchange 5.5 server) Microsoft Active Directory If the Microsoft Exchange 5.5 server uses a Microsoft Windows 2003 domain controller, this service would be needed on the domain controller.

Step 2: Configuring the Target System

In addition to the requirements mentioned in the previous section, you must ensure that the following requirements are met:

• The LDAP protocol is enabled on the Microsoft Exchange 5.5 server.

• Microsoft Windows NT Service Pack 6 is installed, if the target server is running Microsoft Windows NT 4 Server.

• Microsoft Exchange 5.5 Service Pack 4 is installed on the target Microsoft Windows NT 4.0 or Microsoft Windows 2000 Server computer.

• If you are using Microsoft Exchange installed on a Microsoft Windows 2000 server that is controlled by a Primary Domain Controller along with a Microsoft Active Directory installation, then ensure that the following configuration is set:

  • The Windows account that is used to log in to the Oracle Identity Manager server before running Oracle Identity Manager must have Domain controller and Exchange Server Administrator rights.

  • The user credentials in Exchange IT Resource must correspond to a Windows account that has Domain controller and Exchange Server Administrator rights.

  Here, Xellerate User is the account used to log in to Oracle Identity Manager and Exchange IT Resource User is the account described in the administratorName and administratorPassword IT resource parameters.

Step 3: Configuring the Oracle Identity Manager Server

The steps to configure the Oracle Identity Manager server depend on the domain controller that is in use:

• If Microsoft Exchange 5.5 uses a Windows NT server as its domain controller:

  You must deploy the Microsoft Windows NT connector before you can deploy and use the Microsoft Exchange 5.5 connector.

  See Also:

  Oracle Identity Manager Connector Guide for Microsoft Windows NT 4.0

• If Microsoft Exchange 5.5 uses a Microsoft Windows 2000/2003 server as its domain controller, then you must deploy the Microsoft Active Directory connector before you can deploy and use the Microsoft Exchange 5.5 connector. Deploy the connector for Microsoft Active Directory in the following directory:

  xellerate_home\xellerate\XLIntegrations\ActiveDirectory
  
  

In addition, you must perform the following steps:

1. Configure and set the following DLLs in the system path:

   xellerate_home\xellerate\XLIntegrations\Exchange55\dll\ADsSecurity.dll
   xellerate_home\xellerate\XLIntegrations\Exchange55\dll\Exchange55.dll
   
   

2. Edit the following file:

   xellerate_home\xellerate\bin\xlStartServer.bat
   
   

   In this file, add the following line as the start:

   SET PATH=xellerate_home\xellerate\XLIntegrations\Exchange55\dll\ADsSecurity.dll;xellerate_home\xellerate\XLIntegrations\Exchange55\dll\Exchange55.dll
   
   

3. To register the DLLs, enter the following command:

   regsvr32 ADsSecurity.dll
   
   

4. Restart the Oracle Identity Manager server.

Step 4: 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 55 Rev 3.3.1.zip

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

Files in the Installation Media Directory	Destination Directory
The following files in the xml directory: Exchange55Object_DM.xml Exchange55SchedulerTask_DM.xml	xellerate_home\xellerate\XLIntegrations\Exchange55\xml
lib\xliExchange55.jar	xellerate_home\xellerate\JavaTasks
The following files in the Utilities\Exchange55Utility\dll directory: Exchange55.dll ADsSecurity.dll	xellerate_home\xellerate\JavaTasks xellerate_home\xellerate\ScheduleTask
The following contents of the docs directory: B31121_01.pdf html	xellerate_home\xellerate\docs

Step 5: 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 Exchange55Object_DM.xml file, which is in the xellerate_home\xellerate\XLIntegrations\Exchange55\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 55 Server - Dev IT resource is displayed.

8. Specify values for the parameters of the Exchange 55 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 5.5 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 Exchange55SchedulerTask_DM.xml file, which is in the xellerate_home\xellerate\XLIntegrations\Exchange55\xml directory.

After you import the connector XML files, proceed to the "Step 6: Configuring Reconciliation" section.

Defining IT Resources

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

Parameter Name	Parameter Description
Server	Host name of the target Microsoft Windows NT 4.0 computer on which Microsoft Exchange 5.5 server is installed Sample value: xchangehost
administratorName	User ID of the Microsoft Windows NT 4 admin account that is used to create users or mailboxes Sample value: administrator
administratorPassword	Password of the Microsoft Windows NT 4 admin account that is used to create users or mailboxes Sample value: password
domain	Domain of the Microsoft Exchange 5.5 server Sample value: adomain
administratorDN	Full distinguished name (DN) of the administrator Sample value: cn=administrator,cn=Recipients,ou=adoma in,o=engineering
organization	Organization name, as configured on the Microsoft Exchange 5.5 server Sample value: engineering
rootOrganizationDN	DN of the root element, with site and organization details Sample value: ou=adomain_site,o=engineering
site	Site name, as configured on the Microsoft Exchange 5.5 server Sample value: site
Last Check Time	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 6: 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 7: 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	Sample Value
Server	Name of the Exchange 5.5 IT Resource instance	Exchange 55 Server - Dev

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

Step 7: 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.

• Exch55 Add To Group

• Exch55 Create Group

• Exch55 mailbox creation

• Exch55 Delete Mailbox

• Exch55 Modify Property

• Exch55 modify secondary email address

• Exch55 Modify Property Size

• Exch55 Remove From Group

• Exch55 set contact information

• Set Time Stamp

• Exch55 set HR information

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.