N.1 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. Browse to the driver, then click the upper right corner of the driver icon.

  3. Click Edit Properties > Driver Configuration.

In Designer:

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

  2. Click Properties > Driver Configuration.

N.1.1 Driver Module

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

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. Browse to the driver, then click the upper right corner of the driver icon.

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

In Designer:

  1. Open a project in the Modeler.

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

  3. Select the Driver Module tab.

    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.

    Remote Loader Client Configuration for Documentation

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

N.1.2 Driver Object Password

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. Browse to the driver, then click the upper right corner of the driver icon.

  3. Click Edit Properties > Driver Configuration > Driver Object Password > Set Password.

In Designer:

  1. Open a project in the Modeler.

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

  3. Click Driver Module > Connect to Remote Loader > Set Password.

    Option

    Description

    Driver Object 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.

N.1.3 Authentication

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

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. Browse to the driver, then click the upper right corner of the driver icon.

  3. Click Edit Properties > Driver Configuration > Authentication.

In Designer:

  1. Open a project in the Modeler.

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

  3. Click 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 account that the driver will use for authentication.

    Example: Administrator

    Authentication Context

    or

    Connection Information

    Specify 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

    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.

    Application Password

    or

    Set Password

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

    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.

N.1.4 Startup Option

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

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. Browse to the driver, then click the upper right corner of the driver icon.

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

In Designer:

  1. Open a project in the Modeler.

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

  3. Click 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 is started.

N.1.5 Driver Parameters

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. Browse to the driver, then click the upper right corner of the driver icon.

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

In Designer:

  1. Open a project in the Modeler.

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

  3. Click Driver Parameters.

    Parameter

    Description

    Driver parameters for server

    Species of displays the name or IP address of the server that the driver is associated with.

    Edit XML

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

    Driver Options

    Third-party JDBC driver class name

    Verify that the version of the jar or zip file that contains this class is compatible with the target database.

    Show database scoping parameters

    Controls how much of the database is visible to the JDBC driver.

    Table/view names

    The names of the tables or views to synchronize. For details, click the information icon.

    Time syntax

    Returns time-related data types as integers, canonical strings, or Java strings. For details, click the information icon.

    State directory

    The path of the folder where you want the JDBC driver to store state information. Changing the value while using triggerless publication can force all objects to be resynchronized.

    Show connectivity parameters?

    Hides or displays connectivity-related parameters.

    Show compatibility parameters?

    Hides or displays parameters that can enhance compatibility with third-party JDBC databases.

    Subscriber Options

    Disable subscriber?

    Specifies whether the driver ignores events that flow from Identity Manager to the database.

    Show primary key parameters?

    Hides or displays parameters that control how and when primary key values are generated.

    Disable statement-level locking?

    Specifies whether database resources are locked on a channel.

    Check update counts?

    Specifies whether the Subscriber channel checks to see if rows were updated after insert, update, or delete statements were executed against a table.

    Publisher Options

     

    Disable publisher?

    Specifies whether the Publisher channel ignores events that flow from the database to the Identity Vault.

    Publication mode

    Specifies whether the driver uses triggered or triggerless publication.

    Event log table name

    Names the table where publication events are stored.

    Delete processed rows?

    Specifies whether processed rows are deleted from the event log table. Performance decreases when processed rows remain in the table.

    Optimize updates?

    Specifies whether the Publisher channel optimizes update events before sending them to the engine. To optimize all update events, select Yes.

    Allow loopback?

    Specifies whether events that the Subscriber channel initiates loopback on the Publisher channel.

    Disable statement-level locking?

    Specifies whether database resources are locked on this channel.

    Enable future event processing?

    Specifies whether events in the event log table are processed according to their effective date or order of insertion, or whether the database local time is published with each event.

    Show polling-related parameters?

    Specifies whether to show parameters that control polling behavior.

    Heartbeat interval (in minutes)

    Specifies the number of minutes that the Publisher channel waits between events before sending a heartbeat document.