Specifying the Domino® Directories for the Dircat task to aggregate

You use the Directories to include field in a directory catalog configuration document to indicate which source Domino® Directories the Dircat task aggregates. The Dircat task runs on replicas of the specified directories, in the order in they are listed in the Directories to include field. Use commas to separate source directory file names.

Additionally, if the option Remove duplicate users is enabled, and a user's distinguished name is listed in more than one Person document, the Dircat task aggregates information from only the first Person document that includes the name that the Dircat task encounters, based on the order in which the source directories are listed in the Directories to include field.

As the following table shows, you can store a source Domino® Directory locally on a Dircat server, or on a remote server that the Dircat server accesses over the network. It's best to store the source directory replicas locally for high availability and quick access. If you store replicas of the source directories locally, make sure to keep them up-to-date by regularly replicating with the replicas on the remote servers.

If a Dircat server accesses the source Domino® Directories over the network, it must have certifiers in common with the servers that store the remote directories, or must be cross-certified with those servers.

Table 1. How to reference Domino® Directories

Location of source Domino® Directory

Enter

Locally

The file name -- for example, EASTNAMES.NSF

Locally in a linked directory

The file name, preceded by the linked directory -- for example, DIRECTORIES\EASTNAMES.NSF

Over the network on a mapped drive

The file name and path -- for example, U:\DIRSERVER\NAMES.NSF

Over the network through Domino®

The file name in this syntax:

portname!!!servername!!filename

where:

  • portname is the name you gave to the port
  • servername is the hierarchical name of the server that stores the directory
  • filename is the file name for the directory on the server

For example:

TCPIP!!!dirserv/east/renovations!!names.nsf

If you don't care which port is used, omit the port, for example:

DIRSERV/EAST/RENOVATIONS!!NAMES.NSF

Note: The server running the Dircat task must have a certifier in common with the remote server, or be cross-certified with that server.