B.1 Identity Manager: Driver Configuration

In Designer:

  1. Open a project in the Modeler, then right-click the driver line.

  2. Click Properties > Driver Configuration.

In iManager:

  1. Click Identity Manager > Identity Manager Overview, then click Search to search for the driver set that is associated with the driver.

  2. Select the Exchange 5_5 driver.

  3. Click the driver’s status indicator, in the upper right corner of the driver icon, then select Edit Properties.

    Figure B-2 Options in the Status Indicator

  4. Click Driver Configuration.

To configure the Exchange driver, set parameters on the following:

B.1.1 Driver Module

The driver module changes the driver from running locally to running remotely or the reverse.

In Designer:

  1. Open a project in the Modeler.

  2. Right-click the driver icon or driver line, then select Properties > Driver Configuration.

  3. Select the Driver Module tab.

In iManager:

  1. Click Identity Manager > Identity Manager Overview.

  2. Click Search to search for the driver set that is associated with the driver.

  3. Click the upper right corner of the driver icon.

  4. Click Edit Properties > Driver Configuration > Driver Module.

Table B-1 Settings: Driver Module

Option

Description

Java

Used to specify the name of the Java class that is instantiated for the shim component of the driver. This class can be located in the classes directory as a class file, or in the lib directory as a .jar file. If this option is selected, the driver is running locally.

Native

Used to specify the name of the .dll file that is instantiated for the application shim component of the driver. If this option is selected, the driver is running locally.

Connect to Remote Loader

Used when the driver is connecting remotely to the connected system.

Driver Object Password: Set Password

Use this option to set a password for the driver object. If you are using the Remote Loader, you must enter a password on this page. Otherwise, the remote driver does not run. The Remote Loader uses this password to authenticate itself to the remote driver shim.

Remote Loader Client Configuration for Documentation: Include in documentation

Includes information on the Remote Loader client configuration when Designer generates documentation on the driver.

B.1.2 Authentication

The authentication section stores the information required to authenticate to the connected system.

In Designer:

  1. Open a project in the Modeler.

  2. Right-click the driver icon or driver line, then select Properties > Driver Configuration.

  3. Click Authentication.

In iManager:

  1. Click Identity Manager > Identity Manager Overview.

  2. Click Search to search for the driver set that is associated with the driver.

  3. Click the upper right corner of the driver icon.

  4. Click Edit Properties > Driver Configuration > Authentication.

Table B-2 Settings: Authentication

Option

Description

Authentication information for server

Displays or specifies the IP address or server name that the driver is associated with

Authentication DN

or

Authentication ID

Specifies the DN of the LDAP account that the driver will use for authentication.

Example: Administrator

Authentication Context

or

Connection Information

Specifies the IP address or name of the server the application shim should communicate with.

Remote Loader Connection Parameters

or

Host name

Port

KMO

Other parameters

Used only if the driver is connecting to the application through the Remote Loader. The parameter to enter is hostname=xxx.xxx.xxx.xxx port=xxxx kmo=certificatename, when the host name is the IP address of the application server running the Remote Loader server and the port is the port the Remote Loader is listening on. The default port for the Remote Loader is 8090.

The kmo entry is optional. It is used only when an SSL connection exists between the Remote Loader and the Metadirectory engine.

Example: hostname=10.0.0.1 port=8090 kmo=IDMCertificate

Application Password

or

Set Password

Specify the password for the user object listed in the Authentication ID field.

Driver Cache Limit (kilobytes)

or

Cache limit (KB)

Specify the maximum event cache file size (in KB). If it is set to zero, the file size is unlimited.

Click Unlimited to set the file size to Unlimited in Designer.

Remote Loader Password

or

Set Password

Used only if the driver is connecting to the application through the Remote Loader. The password is used to control access to the Remote Loader instance. It must be the same password specified during the configuration of the Remote Loader on the connected system.

B.1.3 Startup Option

The Startup Option allows you to set the driver state when the Identity Manager server is started.

In Designer:

  1. Open a project in the Modeler.

  2. Right-click the driver icon or driver line, then select Properties > Driver Configuration.

  3. Click Startup Option.

In iManager:

  1. Click Identity Manager > Identity Manager Overview.

  2. Click Search to search for the driver set that is associated with the driver.

  3. Click the upper right corner of the driver icon.

  4. Click Edit Properties > Driver Configuration > Startup Option.

Table B-3 Settings: Startup Option

Option

Description

Auto start

The driver starts every time the Identity Manager server is started.

Manual

The driver does not start when the Identity Manager server is started. The driver must be started through Designer or iManager.

Disabled

The driver has a cache file that stores all of the events. When the driver is set to Disabled, this file is deleted and no new events are stored in the file until the driver state is changed to Manual or Auto Start.

Do not automatically synchronize the driver

This option applies only if the driver is deployed and was previously disabled. If this is not selected, the driver re-synchronizes the next time it starts.

B.1.4 Driver Parameters

In Designer:

  1. Open a project in the Modeler.

  2. Right-click the driver icon or driver line, then select Properties > Driver Configuration.

  3. Click Driver Parameters.

    Parameter

    Description

    Driver parameters for server

    Displays or specifies the server name or IP address of the server whose driver parameters you want to modify.

    Edit XML

    Opens an editor so that you can edit the driver’s configuration file.

    Driver Options

    Exchange LDAP Server

    Specifies the IP address of the Exchange LDAP server.

    Create NT Security Account 0=Yes 1=No

    Specifies whether to create an NT account when a new mailbox is created. Usually, this is Yes. If you do not want a security account associated with the mailbox account, specify No.

    Exchange Server

    Specifies the IP address or host name of the Exchange Server. The driver makes LDAP queries to this server.

    Exchange Site

    Specifies the site that the driver administers.

    Authoritative Bind

    Specifies whether to bind authoritatively or anonymously. The default is authoritative ( Yes). See Section 5.7, Using Authoritative Bind.

    Subscriber Options

    NT Domain Server

    Specifies the IP address or host name of the Exchange Server. The driver makes LDAP queries to this server.

    Publisher Options

    Polling Rate (in Seconds)

    Specifies how long the driver suspends processing between each Exchange connection.

In iManager:

  1. Click Identity Manager > Identity Manager Overview.

  2. Click Search to search for the driver set that is associated with the driver.

  3. Click the upper right corner of the driver icon.

  4. Click Edit Properties > Driver Configuration > Driver Parameters.

B.1.5 ECMAScript

Enables you to add ECMAScript resouce files. The resources extend the driver’s functionality when Identity Manager starts the driver.