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