Lotus Domino Administrator 8 Help - Choosing which fields to aggregate in a directory catalog

DIRECTORY SERVICES

Choosing which fields to aggregate in a directory catalog
By default, a directory catalog aggregates the following fields from the documents supported for aggregation.

Field aggregated by default	Documents that use the field
Type¹	All
FirstName	Person
MiddleInitial	Person
LastName	LastName
Location	Person
MailAddress	Person
Shortname	Person
MailDomain	Person, Group, Mail-In Database, Resource
InternetAddress	Person, Group, Mail-In Database, Resource
MessageStorage	Person, Mail-In Database
Members¹	Group
AltFullName¹	Person
AltFullNameLanguage²	Person
GroupType

Note The FullName and ListName fields are always aggregated. These are required fields that ensure that each document aggregated in the directory catalog has a known name. The FullName field is used in Person, Mail-In Database, and Resource documents. The ListName field is used in Group documents.

²Aggregated by default only in an Extended Directory Catalog

Use the "Additional fields to include" field in a directory catalog configuration document to aggregate additional fields into a directory catalog. To avoid making a mistake, use IBM® Lotus® Domino™ Designer to copy and paste the fields from forms in the Domino Directory template. Be sure to copy the field itself, not the field label -- for example, copy the field OfficePhoneNumber, not the label Office phone.

If you use a directory catalog configuration option to exclude a particular type of document, that document isn't aggregated even if you specify a field from the document in the "Additional fields to include" field. For example, if you choose "None" next to the "Group types" option, the Dircat task does not aggregate group documents, even if the Members field is listed in the "Additional fields to include" field.

Guidelines for modifying the "Additional fields to include" field

Follow these general guidelines when modifying the "Additional fields to include" configuration field:

Do not remove the fields aggregated by default because these field selections are the optimum ones for mail addressing.
In an Extended Directory Catalog, aggregating all fields is recommended, since there is no way for servers to use directory assistance to look up missing information directly in the full Domino Directories themselves that are aggregated. To aggregate all fields from the aggregated documents, including custom documents added to a Domino Directory, leave the "Additional fields to include" field blank. If you don't aggregate all fields, then follow the guidelines described in the following table.
In a condensed Directory Catalog, aggregate as few fields as possible, to keep the directory catalog small. When possible avoid aggregating fields that change frequently, since doing so requires Domino frequently to update entries in the directory catalog and replicate the changes to other replicas of the directory catalog.
If the LDAP service searches an Extended Directory Catalog or condensed Directory Catalog on a server, consider aggregating fields that are not part of the default configuration if LDAP clients frequently search for these fields.
If you use a subform to customize a Domino Directory template, you can add fields from the subform to the "Additional fields to include" field. If you are adding custom fields to a condensed Directory Catalog, you must first copy and paste the subform from the Domino Directory into the Directory Catalog database that the Dircat task runs against.

In addition to the above general guidelines, follow these more specific guidelines:

Field to add	Condensed Directory Catalog used by clients	Extended Directory Catalog	Condensed Directory Catalog used by servers
Members field (from Group documents)	(Optional) Add only to allow IBM® Lotus® Notes® users who are not connected to the network to look up free time schedules of other users. Note that adding the Members fields is not generally recommended because it increases the directory catalog size and requires more replication. Use a server directory catalog or directory assistance to provide a way for servers to look up the members of groups from a secondary Domino Directory.	(Required) Allows Notes clients and servers to look up the members of groups from secondary Domino Directories.	(Required) Allows Notes clients and servers to look up the members of groups from secondary Domino Directories.
AltFullName, AltFullNameLanguage (from Person documents)	(Optional) Add if users in the directory catalog use alternate names in their certificates.	(Recommended) Include this field even if no certified alternate names are used in your organization; then if alternate certified names are put into use later, no directory catalog rebuild is necessary.	(Recommended) Include this field even if no certified alternate names are used in your organization; then if alternate certified names are put in use later, no directory catalog rebuild is necessary.
HTTPPassword (from Person documents)	Not recommended	(Optional) Add to enable servers to look up Internet passwords in the directory catalog for Internet client authentication.	(Optional) Add to enable servers to look up Internet passwords in the directory catalog for Internet client authentication.
UserCertificate (from Person documents)	Not recommended	(Optional) Add to enable servers to look up X.509 certificates in the directory catalog for Internet client authentication.	Not recommended

Planning directory catalogs

Directory Catalogs

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary