Metamerge logo
Search

Advanced Search
*
*
*
* HOME DOCUMENTS & RESOURCES DOWNLOADS EARLY TECH ACCESS SUPPORT FAQ KNOWN ISSUES OLD VERSIONS
*

 

IBM SecureWay Changelog Connector

(Netscape/iPlanet Changelog Connector)

Overview

The Changelog Connectors (SecureWay and Netscape/iPlanet ) are a specialized instance of the LDAP Connector (for iPlanet Directory 5.0 and later see Notes). This Connector contains logic to iterate the ChangeLog.  It will return various attributes, one being the changes attribute: The Connector will return changes as something that looks like a standard attribute, but it is in fact of the Entry class.

The Connector can be used in batch oriented runs where it starts at a specific change number and terminates after the last ChangeLog entry. It can also be run in continuous mode where you specify the timer values for periodically checking for the next ChangeLog entry.

The Connector will read ChangeLog entries and automatically increase the ChangeLog counter by one for each iteration. When the Connector tries to read a non existing ChangeLog entry the Connector goes to sleep for a while (nsSleepInterval). If the total time the Connector is waiting for a new entry exceeds the nsTimeout value the Connector returns to the caller with a null value (end of iteration).

Configuration

The Connector needs the following parameters:

Parameter

Description

connectorType com.architech.connector.rscLdap
ldapUrl The LDAP URL for the connection. (ldap://host:port)
ldapUsername The distinguished name used for authentication to the server
ldapPassword The credentials (password)
ldapAuthenticationMethod The authentication method.  Possible values are

CRAM-MD5 - use the CRAM-MD5 (RFC-2195) SASL mechanism

none - use no authentication (anonymous)

simple - use weak authentication (cleartext password)

If not specified default (simple) is used. If ldapUsername and ldapPassword is blank then anonymous is used.

ldapSearchBase The search base where the ChangeLog is kept. The standard DN for this is cn=changelog
nsChangenumber Specifies the starting changenumber. Each ChangeLog entry is named changenumber=intvalue and the Connector will start at the number specified by this parameter and automatically increment by one.
nsTimeout Specifies the number of seconds the Connector will wait for the next ChangeLog entry.
nsSleepInterval Specifies the number of seconds the Connector will sleep between each poll.

 Notes

iPlanet Directory 5.0 has changed the change log to a proprietary format (see http://docs.iplanet.com/docs/manuals/directory/51/html/ag/replicat_new.htm#1 ).  You will have to install the Retro Change Log Plug-in for accessing the change log. Here is an extract from the Change Log section of the iPlanet documentation:

In iPlanet Directory Server 5.0, the format of the change log was modified. In earlier versions of Directory Server, the change log was accessible over LDAP. Now, however, it is intended only for internal use by the server. If you have applications that need to read the change log, you need to use the Retro Change Log Plug-in for backward compatibility. For more information, refer to "Using the Retro Change Log Plug-In".

 

 

*
  Metamerge Integrator version 4.6 ©Copyright Metamerge AS 2000-2002 Last edited 2002-06-10 contact us