|Previous Contents Index Next|
|iPlanet Meta-Directory Configuration and Administration Guide|
Chapter 8 Configuring The Universal Connector
The Universal connector is included with Meta-Directory to allow administrators to configure connectors for external data sources not directly supported by Meta-Directory. The following sections are included in this chapter:
Function of the Universal Connector
Function of the Universal Connector
Meta-Directory includes a generic connector named the Universal Connector (also known as the Universal Text Connector or UTC). When configured, this connector enables data transfer to and from its connector view. It is termed an indirect connector because it creates a view of the external data source in LDAP (connector view) that enables the transfer of data to and from the proprietary data sources.
iPlanet provides the Universal Text Parser (UTP), a suite of scripts, to help the Meta-Directory administrator configure connectors for manipulating data from external data sources whose data can be exported or dumped into a text file. This enables the administrator to synchronize data to a meta view using a data source not specifically configured for Meta-Directory. iPlanet supports data or text files in the following text file formats:
Besides their dependence on the Universal Connector, the UTP, NT Domain Connector, and Active Directory Connector each require their own special configuration setup. To configure the UTP, see Chapter 9 "Configuring the Universal Text Parser." To configure the NT Domain Connector, see Chapter 10 "Configuring the NT Domain Connector." To configure the Active Directory Connector, see Chapter 11 "Configuring the Active Directory Connector."
Before configuring one or more of these connectors, it is recommended that you first configure the Universal Connector, as documented in the following sections.
Creating a Universal Connector Instance
From the iPlanet Console window, right-click Server Group. A context menu appears.
Select Create Instance Of, and select the desired connector. The New Instance Creation dialog box appears.
Click OK in the New Instance Creation dialog box. If the changelog is not enabled, the following message appears:
- Provide input for the following data fields:
View Base DN
Data Server URL
Data Server Bind DN
Data Server Bind Password
Perl Script Absolute Path
Enter a path and file name if you want Meta-Directory to extract the Perl script and then parse a third-party database. Instead of entering the information here, you can alternatively supply the path and file name in the Script tab window. For information on this procedure, see "To include scripts for the Universal Text Connector".
- If you click Enable Changelog NOW, the Enable Changelog dialog box appears.
Enter a directory where you want to store the changelog. For Solaris systems, make sure you change the directory permission mode of the file to allow the console to create the changelog directory. It is recommended that you issue the following command against the directory where you want to create the changelog directory:The Load Schema appears whenever you add a new view if the base entry does not exist. If the schema already exists, you do not need to click Yes. If you click Yes, a dialog box appears that informs you of progress while the installer is loading the schema. The message "Instance Creation Succeeded" appears after the instance has been created.
Either accept the changelog suffix default or provide your own.
- chmod -R 777
Click OK. A message appears reminding you to restart the Directory Server.
Restart the Directory Server:
From the iPlanet Console, select the Directory Server object, then right-click.
From the context menu, select Stop Server. Click Yes in the Stop Server message box. A message appears stating that the Directory Server has been stopped.
Select the Directory Server object again, then right-click.
From the context menu, select Start Server. A message appears stating that the Directory Server has been started.
To remove a connector instance
From the iPlanet Console, highlight the instance you want to delete, then right-click. A context menu appears.
Select Remove Server and click yes in the message box. Another message box appears.
If you click Yes, the connector view is removed. If it is a participating view of the join engine, it will also be removed. This does not remove connector view data from the LDAP DIT, however.
Configuring a Universal Connector Instance
You can use the windows associated with the instance to perform the following tasks:
Specify how updates are handledThe examples for the procedures below apply to the Universal Text Connector. This connector has an extra window, called Script, that is not present when you configure the NT Domain Connector or Active Directory Connector.
To specify how updates are handled
Click on the instance you want to configure. The General tab window appears. The Name and Connector View Location fields are read-only. You specified this information when you created the instance.
Select the desired attribute flow, filter, and default values from the drop-down lists. You configured these values in Chapter 7 "Connectors and Connector Rules."
Indicate how you want to send and receive updates by selecting the appropriate radio button, then clicking Save before continuing. The updates can be modifications, deletions, and additions to the external directory and/or to the connector view.
To configure the schedule from and to connector views
Click the Schedule tab. The Schedule window appears.
Select either To Connector View or From Connector View, and indicate in the text boxes when updates should be sent.
Optional: Alternatively, you can manually provide settings in a tabular format. To do so, click Advanced. The Advanced Schedule Options dialog box appears.
- For every scheduled synch cycle, the Universal Connector launches the accessor to create a dump file of all the external directory entries. If the accessor did not succeed in creating the dump file and it is empty, the Universal Connector thinks that all the entries from the external directory are deleted.
- Consequently, the Universal Connector then attempts to delete the external directory-owned entries from the connector view. However, after restarting the server and restarting the Universal UTC, the accessor launches and a new dump file is created. All the external directory-owned entries are then resynchronized back to the connector view.
Click OK to return to the Schedule window, then click Save before continuing.
- Provide values for the following fields:
Day of the Week Specifier
- You can use either a single number or an expression as described below.
* */step x-y x-y/step x x/step x,y,z... x-y,z-q
To configure attributes for log files
Click the Log tab. The Log window appears.
Provide information for the following fields:
Log File Location
Prefix for Log File Name
Maximum Size of Each File
Maximum Disk Usage
The maximum available disk space must be at least twice the size of the maximum log file size, because the service always stores one backup log file. If the maximum available disk space is less than twice the maximum log file size, the new file cannot reach its maximum size.
Minimum Reserved Free Space
New Log File Every
Delete Log Files Older Than
Flush Buffered Log Data to Disk at
Determines when the log data buffered in memory is to be flushed to the disk. If you enter 0 in this field, every message is flushed. Although this is helpful for debugging, a performance degradation will occur.
Off suppresses logging.
Specifies how much information is logged for a given module. The modules are functional areas of the Join Engine and connector, and are created during installation. Choose a verbosity level of 0 - 3 by selecting a module, then clicking on its corresponding level until you have selected the desired number. The higher the number, the greater the amount of information displayed.
To add external attributes for connectors
You can create a list of attributes that you want to flow from the external data source for UTC-based connectors. For example, in a task.cfg file for the Universal Text Parser, you might have the following line format:
Since ALTEREGO, REALNAME, and LASTNAME are not LDAP attribute names, you would want to declare uid, cn, and sn as attribute names, which will correspond to the schema defined in the directory DIT.
You can store the external attributes as described in the following procedure.
Click the Attributes tab. The Attributes window appears.
Click New. A blank field appears below the Attribute label.
Click within the blank field, then type the name of an external attribute you want to map to an internal attribute.
Repeat the steps above to add other attributes, then click Save. The order of the attributes you create is unimportant. After you click Save, they are sorted when you refresh the console.
See "To Configure an Attribute Flow Rule" to map the external attributes with connector view attributes.
To include scripts for the Universal Text Connector
You can provide special settings for the Universal Text Connector specific to the source directory on which it operates. This is handled by a plug-in tab called Script.
Click the Script tab. The Script window appears.
Specify a path and file name in the field, or click Browse to select the path. Meta-Directory will extract the Perl script and parse a third-party database. Do not specify a package name in the script.
- The Browse button is enabled and error checking implemented only if the Universal Connector is installed on the same system as the console. If the Browse button is disabled, you need to type in the absolute path for the script where the connection is installed.
Restarting a Connector Instance
You must restart the connector instance to activate your configuration. Both instance-specific and shared configurations will not become effective for a given instance until you have restarted the instance.
Stop the connector by right-clicking on the connector instance. A context menu appears.
Select Stop Server. A message appears stating that the stop command has been issued to the component.
Start the connector by right-clicking on the connector instance. A context menu appears.
Select Start Server. A message appears stating that the start command has been issued to the component.
Implementing the Configuration
After you start the join engine and enable the connector view, your data can flow to the meta view. The following sections provide procedures for doing these tasks.
Starting the Join Engine
Before you start the join engine, ensure that you have already enabled the changelog in the Directory Server configuration.
To start the join engine
Select the join-engine object from the navigation tree and right-click. A context menu appears.You can also start the server from the iPlanet Console. To do this, select the Join Engine object and right-click. Select Start Server from the context menu.
Select Start Server. A message appears stating that the server has been started.
Enabling the Connector View
From the iPlanet Meta-Directory window, click on the Status tab.
Click on the Join Engine object. The Operations tab window appears.
Select the participating view you want to enable.
Select Enable from the Operation list menu, then click Submit Request.
Select Refresh from the Operation List Window, then select either Meta View or Connector View from the Traverse menu list.
- This option disables the Traverse drop-down menu. You can only enable the participating view if the configuration for setting up the view is valid. Any error in the configuration automatically changes the view to a disable status.
Refreshing the View
You can optionally refresh the view if you want to observe updates immediately and bypass the regularly scheduled refresh synchronization. Note that after any type of refresh, you might see a "None" group in the meta view Contents or connector view Contents, particularly with non Primary Domain Controller systems. "None" is a valid group in Windows NT.
From the iPlanet Meta-Directory window, click on the Status tab.
Click on the NT Domain connector instance object. The Operations tab window appears. The only operation available is Refresh.
In the "Updates to the" drop-down list, select either External Directory or Connector.
Click Start. The Modify Task Status dialog box appears.
- If you are refreshing the external directory, the following version of the box appears:
- You must select a filter for the second and third options. Only filters configured for the "NoSubtreesExcept" option are displayed when you click Select Filter, not filters configured for the "AllSubtreesExcept" option.
Previous Contents Index Next
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated April 08, 2002