B.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.

To configure the Delimited Text 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 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, then click Edit Properties.

    By default, iManager displays the Identity Manager tab and the Driver Configuration option. This option has the following sections that you can edit:

    • Module

    • Driver Object Password

    • Authentication

    • Startup Option

    • Driver Parameters

In Designer:

  1. Open a project in the Modeler.

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

    You can edit settings on the following tabs:

    • Driver Module

    • Authentication

    • Startup Option

    • Driver Parameters

    • ECMAScript

B.1.2 Module

Table B-1 Driver Module Settings

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 for the Delimited Text driver.

B.1.3 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.

Table B-2 Driver Object Password

Option

Description

Driver Object Password

Specifies 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.

B.1.4 Authentication

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

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, the click Edit Properties.

  4. Click 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.

Table B-3 Authentication Settings

Option

Description

Authentication information for server

Displays or specifies the server that the driver is associated with.

Authentication ID

Specify a user application ID. This ID is used to pass Identity Vault subscription information to the application.

Example: Administrator

Authentication Context

or

Connection Information

Specify the IP address or name of the server that 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.

B.1.5 Startup Option

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

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.

In Designer:

  1. Open a project in the Modeler.

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

  3. Click Startup Option.

Table B-4 Startup Settings

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.

B.1.6 Driver Parameters

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.

In Designer:

  1. Open a project in the Modeler.

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

  3. Click Driver Parameters.

Table B-5 Driver Parameter Settings

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

Field Delimiter

Specifies the character that is used to delimit field values in the input files. It must be one character. The default is a comma.

If the values of any of the input fields contain this character, enclose the entire value in quotes to prevent it from being seen as a delimiter.

Changing this delimiter parameter to something other than a comma does not automatically change the delimiter character used in the output files when a Subscriber is used. To change the delimiter character in the output files, edit the Output Transform style sheet. The delimiter character is assigned to a variable near the top of that style sheet.

Field Names

Specifies a comma-separated list of attribute names that can be referred to in the Schema Mapping rule. In the input files, the fields of the records must correspond to the order and positioning of the names in this list. See Field Names.

Object Class Name

Specifies the Novell® eDirectory™ class name that should be used when creating new objects to correspond to input files.

Allow Driver to Consume Its Own Output?

Prevents you from inadvertently creating a situation in which the driver writes output files that are immediately read in again as input of the same driver.

The default is No. By default, the driver won't load if all the following conditions occur:

  • You have both a Subscriber channel and a Publisher channel.

  • The input and output directories are the same.

  • The input and output file extensions are the same.

If you want to feed the output of the Subscriber channel into the input of the Subscriber channel as a way to detect Identity Vault events to trigger other changes in the Identity Vault, set this parameter to Yes. For example, to update the Full Name attribute when the Given Name, Surname, or Initials attributes are updated, set this parameter to Yes.

Subscriber Options

Output File Path

Specifies the directory on the local file system where output files will be created. An error occurs if this directory doesn’t exist. See Output File Path.

Output File Extension

Output files have a unique name that ends with the characters in the Output File Extension parameter. If the output files from a Subscriber channel are used as input files for the Publisher channel of another Delimited Text driver, the destination file extension must match the source file extension parameter of the second driver.

Destination File Character Encoding (leave blank for default)

When this parameter contains no value, the default Java character encoding for your locale is used.

To use an encoding other than the default for your locale, enter one of the canonical names from the Supported Encodings table.

The Publisher and Subscriber channels can use different character encodings.

Maximum Number of Transactions per Output File

Specifies the maximum number of transactions that are written to a single output file. When the file transaction limit is reached, the file closes, and a new file is created for subsequent transactions. To limit the number of transactions that can be written to a single file, leave this parameter blank or set it to zero.

For more information, see the following item, Maximum Time in Seconds Before Flushing All Transactions.

Maximum Time in Seconds before Flushing All Transactions

If no new transactions have been written to the output file in the amount of time specified in this parameter, the file is closed. When new transactions need to be written, a new output file is created. If you don’t want to limit the time that can pass before the output file is closed, leave this parameter blank or set it to zero.

Time of Day (Local Time) to Flush All Transactions

If a value is supplied for this parameter, the current output file is closed at the specified time each day. Subsequent transactions are written to a new file. This parameter does not prevent the Maximum Number of Transactions per Output File or the Maximum Time in Seconds before Flushing All Transactions parameters from also acting as output file thresholds. If you use this parameter and only want one file per day, set the other two parameters to zero.

The format of this parameter can be HH:MM:SS (using the 24-hour clock) or H:MM:SS AM/PM. An hour is required, but the minutes and seconds are optional. Because the parameter assumes local time, any time zone information included in the value is ignored.

The previous three parameters (Maximum Number of Transactions per Output File, Maximum Time in Seconds before Flushing All Transactions, and Time of Day to Flush All Transactions) are all capable of acting as a threshold for the transaction size a file is able to grow to, or for the time that it remains open to accept new transactions.

As long as an output file is still open for writing by the Delimited Text driver, it shouldn’t be considered as finalized. Avoid opening the file in any other process until the driver closes the file. For this reason, one of the three previous parameters must be set to assure that output files don’t remain open indefinitely. To avoid this condition, if the driver detects that all three parameters are blank (or zero), it automatically sets the Maximum Number of Transactions per Output File to the value of 1.

Publisher Options

Input File Path

The Publisher channel looks for new input files in the Input File Path, which is a directory on the local file system. Example paths:

  • On Windows: c:\csvsample\input

  • On Solaris and Linux: /usr/lib/dirxml/rules/delim

  • For NetWare, you need to specify the volume (for example, sys:csvsample\input)

Input File Extension

The extension used to designate input files (for example, csv).

Source File Character Encoding (leave blank for default)

When this parameter contains no value, the default Java character encoding for your locale is used.

To use an encoding other than the default for your locale, enter one of the canonical names from the Supported Encodings table (http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html). Supported Encodings table.

If the Input File Extension parameter is .xml, the Source File Character Encoding can be indicated in one of two ways. For information, see Source File Character Encoding.

Rename File Extension

The Publisher channel uses only files that have the extension specified in the parameter. After the files have been processed, the value of the Rename File Extension parameter is appended to the filename, so the Publisher channel won’t try to process the same file again. If the value of the Rename File Extension parameter is left blank, the source file is deleted after it is processed.

IMPORTANT: If you change the default, use only characters that are valid in filenames on your platform. Invalid characters cause the rename to fail and the driver to reprocess the same file repeatedly.

Polling Rate (in Seconds)

When the Publisher channel has finished processing all source files, it waits the number of seconds specified in this parameter before checking for new source files to process.

B.1.7 ECMAScript

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