The database replication history

About this task

In the Basics tab of the Database Properties box, there is a button "Replication History," which opens the window of the same name. The first time one server replica successfully replicates with a replica on another server, Domino® creates an entry in the replication history. The entry contains the name of the other server, as well as the date and time of the replication. Separate entries are created when a replica sends information and when a replica receives it. On each subsequent replication with a specific server, Domino® updates the entry in the history to reflect the most recent replication.

Domino® uses the replication history to determine which documents to scan for changes during the next replication. For example, if a database successfully replicated with the HR-E/East/Acme server 24 hours ago, Domino® replicates only those documents that were added, modified, or deleted in the replica on HR-E/East/Acme within the last 24 hours.

Before replication starts between two databases, Domino® checks the replication history of both databases to make sure that they agree. If they don't, Domino® scans each document created or modified since the date specified in the "Only replicate incoming documents saved or modified after" setting on the Other panel of the Replication Settings dialog box

If a database doesn't replicate successfully, Domino® doesn't update the replication history.

To display a replication history

Procedure

  1. Make sure that you have Reader or higher access in the database ACL.
  2. Open the database.
  3. Choose File - Replication - History.
  4. Click Done when you finish reviewing the history.

Results

Tip: To copy the entire replication history to the Clipboard, click Copy.

Clearing the replication history

About this task

If you have Manager access to a database, you can clear the database replication history if you think the database doesn't contain all the documents it should or if the database replication history is not synchronized with that of other replicas. Clear the replication history only as a last resort to solve replication problems. If you clear the history, during the next replication, Domino® scans each document created or modified since the data specified in the "Only replicate incoming documents saved or modified after" setting on the Other panel of the Replication Settings dialog box. If you clear the "Only replicate incoming documents saved or modified after" setting, Domino® scans all documents in the database. Scanning all these documents can be time consuming, especially over dial-up connections.

Within a server cluster, the Cluster Replicator stores replication history information in memory and updates the replication history about once an hour.

To clear a replication history

Procedure

  1. Make sure you have Manager access in the database ACL.
  2. Open the database.
  3. Choose File - Replication - History.
  4. Do one of the following:
    • To clear one entry, select it, click Clear, then click Yes.
    • To clear the entire replication history, click Clear All, then click Yes.
  5. Click Done.

Results

For more information on the "Only replicate incoming documents saved or modified after" setting, see Administering the Domino® System. For information on viewing cluster replication data, see Administering Domino® Clusters.