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:
In iManager, complete the following steps:
Select DirXML Utilities > Create Driver.
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.
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.
Click Next.
You are prompted for the following information:
Click Finish.
NOTE: You can configure and modify the driver's other parameters. For more information, refer to Configuring Driver Parameters.
If you use all of the defaults provided by the sample configuration, prepare locations for DirXML data:.
Add the containers Users\Active at the root level of your eDirectory tree.
On Windows, create the following two directories on your local file system:
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).
If you changed default data locations during configuration, ensure that the new locations exist before you start the driver.
In iManager, select DirXML Management > Overview.
Locate the driver in its driver set.
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.
Identity Manager synchronizes data as the data changes. If you want to synchronize all data immediately, you can do one of the following:
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:
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.
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.
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:
In iManager, select DirXML Management > Overview.
Locate the driver set containing the Delimited Text driver, then double-click the driver icon.
Click the appropriate migration button.
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.