MAN page from Mandrake Other ldap-servers-3.3-3.i386.rpm

CENTIPEDE

Section: Maintenance Commands (8C)
Updated: 2 December 1995
Index

NAME

centipede - LDAP centroid index generation and maintenance program

SYNOPSIS

/usr/sbin/centipede[-f filter][-F] [-R][-f filter] [-t directory][-m authmethod] [-b binddn] [-p passwd] [-c cachesize]-s sourceurl -d desturl attributes

DESCRIPTION

The centipede program is used to extract centroid or other indexinformation from one LDAP server and install it in another. Althoughindex information can be extracted from any LDAP server, only aslapd(8)LDAP server will understand the information and thus be capable ofmaking use of it as indexing information (i.e., you should onlyinstall index information in aslapd(8)LDAP server).

The basic form of the command is as follows

        /usr/sbin/centipede [options]                -s "ldap://[host/]subtree-to-index-dn"                -d "ldap://[host/]parent-of-index-entry-dn"                attributes

where the-soption specifies the subtree for which index information is tobe generated, and the-doption specifies the parent under which the index information is tobe installed.

For example, suppose you are running anLDAP server on the hostbabs.comfor an organization called "BabsCo" based in the US, and you want togenerate index information for the cn, sn and objectclass attributes ofall the people entries in your subtree. You want to install the indexinformatioin in the indexingslapd(8)running on the hostvertigo.rs.itd.umich.eduunder the c=US entry.This way, when an LDAP client connects to theslapd(8)on vertigo and does a subtree search of c=US,slapd(8)can consult the index information to tell whether it should refer theclient to your server or not. You could accomplish this with a commandlike this:

        /usr/sbin/centipede -f '(objectclass=person)'                -m simple -b your-rootdn -p your-rootdnpw                -s "ldap://babs.com/o=BabsCo, c=US"                -d "ldap://vertigo.rs.itd.umich.edu/c=US"                cn sn objectclass

Note the-band-poptions can be used to authenticate as an entity able to read allthe information you want.

See "The SLAPD and SLURPD Administrator's Guide" for more details onusing this program.

OPTIONS

-v: Turn on verbose mode. This option can be given multiple times to increasethe level of verbosity.
-n: Do not actually install index information. Useful in conjunction with-vfor seeing whatcentipedeis up to.
-f ldapfilter: Specify a filter used to select the entries for which to generate indexinginformation.ldapfiltershould be a string LDAP filter as described by RFC 1588.
-F: Generate full, as opposed to relative, index information.
-R: Generate relative, as opposed to full, index information. Full informationis still generated if there is no previous information available fromwhich to generate the relative information. This is the default.
-t directory: Specify the directory in which to create temporary files, find existingindex information, and put new index information. The default iswhatever is used by tempnam.
-b binddn: Specify the DN to authenticate with when extracting index information.
-p passwd: Specify the password to use for simple authentication when extractingindex information.
-m authmethod: Specify the authentication method to use when extracting index information.authmethodshould be either "simple" or "kerberos".
-B binddn: Specify the DN to authenticate with when installing index information.
-P passwd: Specify the password to use for simple authentication when installingindex information.
-M authmethod: Specify the authentication method to use when installing index information.authmethodshould be either "simple" or "kerberos".
-c cachesize: Specify the size in bytes of the cache used when building the newindex information. Upping this number can cause a big performance boost,if you've got the memory for it.

NOTES

This is all very experimental at the moment, and is subject to change.

Currently,centipedeonly handles value-based index information. A future version of centipedewill allow other types of index information to be manipulated (e.g.,word-based indexes, substring indexes, phonetic indexes, hash indexes,etc.). A future version may also allow weights to be generated.

This document was created byman2html,using the manual pages.