Running the Dircat task
Run the Dircat task to build a directory catalog initially. Then continue to run the task at scheduled intervals to keep the contents of the directory catalog synchronized with the contents of the source Domino® Directories and to keep the directory catalog synchronized with the directory catalog configuration selections. Always run the Dircat task on one server to build and update a particular directory catalog. If you run the Dircat task on more than one server against the same directory catalog, replication conflicts occur. Use the field Restrict aggregation to server in a directory catalog configuration document to ensure that the Dircat task on only one server can process a particular directory catalog.
Running the Dircat task on schedule
About this task
Schedule the Dircat task on a Dircat server to run at regular intervals by doing the following:
Procedure
- Make sure there is a directory catalog database with a completed configuration document.
- From the Domino® Administrator, click the Configuration tab.
- Expand , and choose Settings.
- Click the tab.
- Complete these fields, and then click Save &
Close:
Table 1. Directory Cataloger tab fields Field
Enter
Directory Catalog filenames
The file name(s) of the directory catalog(s) the Dircat task should process. Separate multiple file names with commas.
Schedule
Select Enabled.
Run Directory Catalog aggregator at
A time range or one or more specific times to update the source directory catalog. Separate multiple time entries with commas (,). The default is the range 08:00 AM to 10:00 PM.
Repeat interval of
A number representing the minutes between updates that are scheduled during a time range. The default is 360 minutes (every 6 hours). Consider reducing this interval to have the Dircat task run every 60 or 120 minutes.
Days of week
The days of week to run the Dircat task. The default is daily.
Running the Dircat task manually
About this task
To run the Dircat task manually on a Dircat server, issue this server command:
load dircat dc.nsf
where dc.nsf is the file name of a local directory catalog on the server.
You can do a full rebuild of a directory catalog. Keep in mind that a full rebuild removes and recreates all the aggregated documents so that the first replication after the rebuild will require a full replication of the database.
To do a full rebuild of a directory catalog, you can run the dircat task against the directory catalog using the -r switch, for example:
load dircat dc.nsf -r
Or you can do a full rebuild by clicking the Clear History button on the advanced tab of the directory catalog configuration document.
Pausing the Dircat task
About this task
Before you shut down a server that is in the middle of Dircat processing, pause the Dircat task. When you pause the Dircat task, the Dircat task finishes aggregating the directory catalog it is currently running on and then goes idle. if you don't pause the Dircat task before server shutdown, the Dircat task must reaggregate the directory catalog it was processing at the time of server shutdown from the beginning.
To pause the Dircat task, enter this server command:
Tell Dircat Pause
You can then shut down the server. Or, to resume Dircat processing, enter this server command:
Tell Dircat Resume