Setting Up the Driver

If you are upgrading an existing driver, setup is not required.

If this is the first time the Delimited Text driver has been used, complete the post-installation tasks in the following sections:

• Configuring the Driver
• Preparing Data Locations
• Starting the Driver
• Migrating and Resynchronizing Data
• Activating the Driver

Configuring the Driver

In iManager, complete the following steps:

1. Select DirXML Utilities > Create Driver.

2. Select a driver set.

   If you place this driver in a new driver set, you must specify a driver set name, context, and associated server.

3. Mark Import a Preconfigured Driver from the Server and select the DelimitedTextCSVSample.xml file.

   The driver configuration file is installed on the Web server when you set up iManager.

4. Click Next.

   You are prompted for the following information:

   Field	Description
   Driver Name	The eDirectory object name to be assigned to this driver.
   Container	The container in eDirectory where new users should be created. If this container doesn't exist, you must create it before you start the driver.
   Output File Path	Specify the platform-specific path to the local directory where output files should be created. (For example, on Windows the path is c:\csvsample\output.)
   Output File Extension	Specify the extension to append to output files when those files are created.
   Input File Path	Specify the platform-specific path to the local directory where input files exist.
   Input File Extension	Specify the extension used to designate input files.
   Rename File Extension	Specify the extension that an input file will be renamed with after the file has been processed. Leave this field blank if you want the file deleted.
   New User Container	Specify the DN of the container where new users are to be placed.
   Configure Data Flow	You can configure dataflow to one of the following options: Bidirectional: Delimited Text and eDirectory are both authoritative sources of the data synchronized between them. DT-to-eDirectory: Delimited Text is the authoritative source. eDirectory-to-DT: eDirectory is the authoritative source.
   Install Driver as Remote/Local	Configure the driver for use with the Remote Loader service by selecting the Remote option, or select Local to configure the driver for local use. If you select Local, you can skip the remaining parameters.
   Remote Host Name and Port	Specify the host name or IP address and port number for where the Remote Loader service has been installed and is running for this driver. The default port is 8090.
   Driver Password	The driver object password is used by the Remote Loader to authenticate itself to the DirXML server. It must be the same password that is specified as the driver object password on the DirXML Remote Loader.
   Remote Password	The Remote Loader password is used to control access to the Remote Loader instance. It must be the same password that is specified as the Remote Loader password on the DirXML Remote Loader.

5. Click Finish.

NOTE:  You can configure and modify the driver's other parameters. For more information, refer to Configuring Driver Parameters.

Preparing Data Locations

If you use all of the defaults provided by the sample configuration, prepare locations for DirXML data:.

1. Add the containers Users\Active at the root level of your eDirectory tree.

2. On Windows, create the following two directories on your local file system:

   • c:\cvsample\input
   • c:\cvsample\output

   On Solaris, Linux, or NetWare, create input and output directories wherever you'd like. Then update the driver configuration with the correct platform-specific paths. For more information, refer to Source File Path in the Publisher Settings section. (See Publisher Settings).

Starting the Driver

If you changed default data locations during configuration, ensure that the new locations exist before you start the driver.

1. In iManager, select DirXML Management > Overview.

2. Locate the driver in its driver set.

3. Click the driver status indicator in the upper right corner of the driver icon, then click Start Driver.

   Synchronization takes place on an object-by-object basis as changes are made to individual objects. If you want to have an immediate synchronization, you must initiate that process as explained in Migrating and Resynchronizing Data.

Migrating and Resynchronizing Data

Identity Manager synchronizes data as the data changes. If you want to synchronize all data immediately, you can do one of the following:

• Migrate new data into or from eDirectory.
• Resynchronize existing data by using the driver set Properties page.

The Migrate from eDirectory and Synchronize options usually behave independently of any driver. However, some issues exist with these options and the DirXML Driver for Delimited Text.

The following figure illustrates the buttons that select the Migrate from eDirectory and Synchronize options:

Migrating Data from eDirectory

To find eDirectory entries that do not have a DirXML association for the driver, click Migrate from eDirectory. Non-associated entries that are not vetoed by rules processing are written to the output file and will receive an association.

NOTE:  Entries that already have up-to-date associations aren't written to the output file. To output all associated entries, click Synchronize.

Migrating Data into eDirectory

With most DirXML drivers, migrating into eDirectory causes the DirXML engine to query the application through its driver. The query finds entries that can be synchronized from the application into eDirectory. These synchronized entries are created in eDirectory. The driver assigns an association value to each new entry.

The Migrate into eDirectory option has no function when used with the DirXML Driver for Delimited Text. This driver gets all of its input as files are placed in the input directory. Because the driver is always up-to-date concerning the files it processes, you don't need to do any additional processing or querying. If you do click Migrate into eDirectory, nothing happens because queries are disabled with this driver.

Synchronizing Data

When entries in eDirectory have an association with the selected driver, the Synchronize option causes those entries to synchronize again with the associated entries in the application. If the driver has a Subscriber channel, eDirectory is considered to be the authoritative source for the attributes in the Subscriber filter.

The DirXML Driver for Delimited Text can't query the application directly to determine what is out of sync. Therefore, the DirXML engine sends a Modify event to the driver for each associated entry. This event causes each of these entries to be written to an output file whenever you click Synchronize. If no Subscriber is configured, Synchronize will have no effect with the driver.

To use Migrating from eDirectory, Migrating into eDirectory, or Synchronize:

1. In iManager, select DirXML Management > Overview.

2. Locate the driver set containing the Delimited Text driver, then double-click the driver icon.

3. Click the appropriate migration button.

Activating the Driver

Activate the driver within 90 days of installation. Otherwise, the driver will stop working.

For information on activation, refer to "Activating Novell Identity Manager Products" in the Novell Nsure Identity Manager 2 Administration Guide.